@kenkaiiii/gg-editor 0.1.0

package/dist/core/hosts/resolve/bridge.js

@@ -0,0 +1,270 @@
+import { spawn, spawnSync } from "node:child_process";
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir, platform } from "node:os";
+import { join } from "node:path";
+import { BRIDGE_PY } from "./bridge-source.js";
+export class ResolveBridge {
+    child;
+    pending = new Map();
+    buffer = "";
+    readyPromise;
+    nextId = 1;
+    bridgePath;
+    /**
+     * Start the bridge. Idempotent — subsequent calls return the same readiness
+     * promise.
+     */
+    ensureStarted() {
+        if (this.readyPromise)
+            return this.readyPromise;
+        this.readyPromise = new Promise((resolve, reject) => {
+            const py = findPython();
+            if (!py) {
+                reject(new Error("No Python interpreter found. Install Python 3 (python3 / python / 'py -3') and ensure it's on PATH."));
+                return;
+            }
+            // Write the embedded source to a temp dir on first launch.
+            const dir = mkdtempSync(join(tmpdir(), "gg-editor-resolve-"));
+            const scriptPath = join(dir, "bridge.py");
+            writeFileSync(scriptPath, BRIDGE_PY, { encoding: "utf8" });
+            this.bridgePath = scriptPath;
+            const env = resolveEnv();
+            const child = spawn(py.cmd, [...py.args, scriptPath], {
+                env,
+                stdio: ["pipe", "pipe", "pipe"],
+                // Don't let Resolve's huge env or our pipe inherit a TTY on Windows.
+                windowsHide: true,
+            });
+            this.child = child;
+            child.stdout.setEncoding("utf8");
+            child.stderr.setEncoding("utf8");
+            // Capture stderr for diagnostics. Resolve's Python imports can emit
+            // warnings on stderr we don't want to crash on.
+            let stderrBuf = "";
+            child.stderr.on("data", (chunk) => {
+                stderrBuf += chunk;
+                if (stderrBuf.length > 8192)
+                    stderrBuf = stderrBuf.slice(-8192);
+            });
+            child.on("error", (err) => {
+                reject(new Error(`Failed to spawn Python: ${err.message}`));
+            });
+            child.on("exit", (code, signal) => {
+                const reason = signal ? `signal ${signal}` : `exit ${code}`;
+                const err = new Error(`Resolve bridge died (${reason}).${stderrBuf ? "\nstderr: " + stderrBuf.slice(-500) : ""}`);
+                // Reject every pending call.
+                for (const [, pending] of this.pending)
+                    pending.reject(err);
+                this.pending.clear();
+                if (!this.handshakeDone)
+                    reject(err);
+            });
+            child.stdout.on("data", (chunk) => {
+                this.buffer += chunk;
+                // Split on either \n or \r\n.
+                let nl;
+                while ((nl = this.buffer.search(/\r?\n/)) >= 0) {
+                    const line = this.buffer.slice(0, nl);
+                    // Skip the matched separator (1 or 2 bytes).
+                    const skip = this.buffer[nl] === "\r" && this.buffer[nl + 1] === "\n" ? 2 : 1;
+                    this.buffer = this.buffer.slice(nl + skip);
+                    if (line.trim())
+                        this.handleLine(line, resolve, reject);
+                }
+            });
+            // Safety: if Python imports take too long or the bridge silently fails
+            // to print _ready, time out.
+            setTimeout(() => {
+                if (!this.handshakeDone) {
+                    reject(new Error("Resolve bridge handshake timed out after 10s. Check Resolve is running, " +
+                        "external scripting is enabled (Preferences → System → General), and Studio is licensed."));
+                    this.kill();
+                }
+            }, 10_000).unref();
+        });
+        return this.readyPromise;
+    }
+    handshakeDone = false;
+    handleLine(line, onReady, onReadyFail) {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            // Ignore non-JSON noise (Python warnings, etc.)
+            return;
+        }
+        // Bootstrap messages.
+        if (msg.id === "_ready" && msg.ok) {
+            this.handshakeDone = true;
+            onReady();
+            return;
+        }
+        if (msg.id === "_bootstrap" && msg.ok === false) {
+            this.handshakeDone = true; // failed-but-resolved: prevent timeout double-reject
+            onReadyFail(new Error(msg.error ?? "Bridge bootstrap failed."));
+            this.kill();
+            return;
+        }
+        // Regular call response.
+        if (typeof msg.id === "string" && this.pending.has(msg.id)) {
+            const pending = this.pending.get(msg.id);
+            this.pending.delete(msg.id);
+            if (msg.ok) {
+                pending.resolve(msg.result);
+            }
+            else {
+                const err = new Error(msg.error ?? "Unknown bridge error.");
+                if (msg.trace)
+                    err.trace = msg.trace;
+                pending.reject(err);
+            }
+        }
+    }
+    /**
+     * Send a method call to the bridge. Resolves with the `result` payload,
+     * rejects with a BridgeError if the bridge reports `ok: false`.
+     */
+    async call(method, params = {}, opts = {}) {
+        await this.ensureStarted();
+        if (!this.child || this.child.killed) {
+            throw new Error("Resolve bridge is not running.");
+        }
+        if (opts.signal?.aborted) {
+            throw Object.assign(new Error("call aborted before send"), { name: "AbortError" });
+        }
+        const id = String(this.nextId++);
+        const payload = JSON.stringify({ id, method, params }) + "\n";
+        return new Promise((resolve, reject) => {
+            const onAbort = () => {
+                // We can't kill the in-flight Python call mid-flight (it would tear
+                // the bridge down for every other pending caller). Best we can do is
+                // stop waiting on the JS side and let the bridge's response — if it
+                // ever arrives — be silently discarded by the dispatcher.
+                if (this.pending.delete(id)) {
+                    reject(Object.assign(new Error("call aborted while waiting for bridge response"), {
+                        name: "AbortError",
+                    }));
+                }
+            };
+            opts.signal?.addEventListener("abort", onAbort, { once: true });
+            this.pending.set(id, {
+                resolve: (v) => {
+                    opts.signal?.removeEventListener("abort", onAbort);
+                    resolve(v);
+                },
+                reject: (err) => {
+                    opts.signal?.removeEventListener("abort", onAbort);
+                    reject(err);
+                },
+            });
+            this.child.stdin.write(payload, (err) => {
+                if (err) {
+                    this.pending.delete(id);
+                    opts.signal?.removeEventListener("abort", onAbort);
+                    reject(err);
+                }
+            });
+        });
+    }
+    kill() {
+        if (this.child && !this.child.killed) {
+            try {
+                this.child.stdin.end();
+            }
+            catch {
+                /* ignore */
+            }
+            this.child.kill();
+        }
+        this.child = undefined;
+    }
+    get scriptPath() {
+        return this.bridgePath;
+    }
+}
+/**
+ * Probe for a working Python 3 interpreter. Order matters:
+ *   1. python3   — macOS/Linux standard
+ *   2. python    — Windows default name; also macOS with pyenv
+ *   3. py -3     — Windows launcher (when only the launcher is on PATH)
+ *
+ * We verify each candidate prints a 3.x version before accepting it.
+ */
+export function findPython() {
+    const candidates = [
+        { cmd: "python3", args: [] },
+        { cmd: "python", args: [] },
+        { cmd: "py", args: ["-3"] },
+    ];
+    for (const c of candidates) {
+        const r = spawnSync(c.cmd, [...c.args, "--version"], {
+            encoding: "utf8",
+            windowsHide: true,
+        });
+        if (r.status === 0) {
+            const out = (r.stdout || r.stderr || "").trim();
+            if (/Python 3\./.test(out))
+                return c;
+        }
+    }
+    return undefined;
+}
+/**
+ * Build the env block the Python bridge needs. Sets RESOLVE_SCRIPT_API,
+ * RESOLVE_SCRIPT_LIB, and prepends the Modules dir to PYTHONPATH if not
+ * already configured.
+ *
+ * Honours pre-set env vars (so power users with custom installs aren't
+ * overridden).
+ */
+export function resolveEnv() {
+    const env = { ...process.env };
+    const apiDefault = defaultApiPath();
+    const libDefault = defaultLibPath();
+    if (!env.RESOLVE_SCRIPT_API && apiDefault)
+        env.RESOLVE_SCRIPT_API = apiDefault;
+    if (!env.RESOLVE_SCRIPT_LIB && libDefault)
+        env.RESOLVE_SCRIPT_LIB = libDefault;
+    // Prepend Modules to PYTHONPATH so DaVinciResolveScript imports.
+    if (env.RESOLVE_SCRIPT_API) {
+        const sep = platform() === "win32" ? ";" : ":";
+        const modulesDir = join(env.RESOLVE_SCRIPT_API, "Modules");
+        const existing = env.PYTHONPATH ?? "";
+        if (!existing.split(sep).includes(modulesDir)) {
+            env.PYTHONPATH = existing ? `${modulesDir}${sep}${existing}` : modulesDir;
+        }
+    }
+    // UTF-8 stdio on Windows. No-op elsewhere.
+    env.PYTHONIOENCODING = env.PYTHONIOENCODING ?? "utf-8";
+    // Don't write .pyc to the embedded script's tempdir.
+    env.PYTHONDONTWRITEBYTECODE = "1";
+    return env;
+}
+function defaultApiPath() {
+    switch (platform()) {
+        case "darwin":
+            return "/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting";
+        case "linux":
+            return "/opt/resolve/Developer/Scripting";
+        case "win32":
+            return process.env.PROGRAMDATA
+                ? join(process.env.PROGRAMDATA, "Blackmagic Design", "DaVinci Resolve", "Support", "Developer", "Scripting")
+                : undefined;
+        default:
+            return undefined;
+    }
+}
+function defaultLibPath() {
+    switch (platform()) {
+        case "darwin":
+            return "/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/fusionscript.so";
+        case "linux":
+            return "/opt/resolve/libs/Fusion/fusionscript.so";
+        case "win32":
+            return "C:\\Program Files\\Blackmagic Design\\DaVinci Resolve\\fusionscript.dll";
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/core/hosts/resolve/bridge.js.map

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

package/dist/core/hosts/resolve/bridge.test.d.ts

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

package/dist/core/hosts/resolve/bridge.test.d.ts.map

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

package/dist/core/hosts/resolve/bridge.test.js

@@ -0,0 +1,50 @@
+import { describe, expect, it } from "vitest";
+import { findPython, resolveEnv } from "./bridge.js";
+describe("findPython", () => {
+    it("returns a python3 candidate or undefined cleanly", () => {
+        const py = findPython();
+        if (py) {
+            expect(typeof py.cmd).toBe("string");
+            expect(Array.isArray(py.args)).toBe(true);
+            expect(["python3", "python", "py"]).toContain(py.cmd);
+        }
+        // If undefined, that's also a valid environment (CI without Python 3).
+    });
+});
+describe("resolveEnv", () => {
+    it("sets PYTHONIOENCODING and PYTHONDONTWRITEBYTECODE", () => {
+        const env = resolveEnv();
+        expect(env.PYTHONIOENCODING).toBe("utf-8");
+        expect(env.PYTHONDONTWRITEBYTECODE).toBe("1");
+    });
+    it("preserves a pre-set RESOLVE_SCRIPT_API", () => {
+        const before = process.env.RESOLVE_SCRIPT_API;
+        process.env.RESOLVE_SCRIPT_API = "/custom/path";
+        try {
+            const env = resolveEnv();
+            expect(env.RESOLVE_SCRIPT_API).toBe("/custom/path");
+        }
+        finally {
+            if (before === undefined)
+                delete process.env.RESOLVE_SCRIPT_API;
+            else
+                process.env.RESOLVE_SCRIPT_API = before;
+        }
+    });
+    it("prepends Modules dir to PYTHONPATH when API path is set", () => {
+        const before = process.env.RESOLVE_SCRIPT_API;
+        process.env.RESOLVE_SCRIPT_API = "/x/y/Scripting";
+        try {
+            const env = resolveEnv();
+            expect(env.PYTHONPATH).toContain("/x/y/Scripting");
+            expect(env.PYTHONPATH).toContain("Modules");
+        }
+        finally {
+            if (before === undefined)
+                delete process.env.RESOLVE_SCRIPT_API;
+            else
+                process.env.RESOLVE_SCRIPT_API = before;
+        }
+    });
+});
+//# sourceMappingURL=bridge.test.js.map

package/dist/core/hosts/resolve/bridge.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.test.js","sourceRoot":"","sources":["../../../../src/core/hosts/resolve/bridge.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErD,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACxD,CAAC;QACD,uEAAuE;IACzE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,cAAc,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACtD,CAAC;gBAAS,CAAC;YACT,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;;gBAC3D,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,MAAM,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,gBAAgB,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YACnD,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;gBAAS,CAAC;YACT,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;;gBAC3D,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,MAAM,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/hosts/types.d.ts

@@ -0,0 +1,167 @@
+import type { ClipInfo, Frame, FrameRange, HostCapabilities, HostName, MarkerInfo, TimelineState } from "../../types.js";
+/**
+ * VideoHost — the NLE-agnostic interface every adapter implements.
+ *
+ * The agent only ever sees these methods. The adapter is responsible for
+ * picking the fastest tier (API → hotkey → GUI fallback) for each op,
+ * and surfacing capability differences via `capabilities`.
+ */
+export interface VideoHost {
+    readonly name: HostName;
+    readonly displayName: string;
+    /** Read host capabilities. Cached after first call. */
+    capabilities(): Promise<HostCapabilities>;
+    /** Read the current timeline state (clips, markers, framerate). */
+    getTimeline(): Promise<TimelineState>;
+    /** Add a marker on the timeline at a specific frame. */
+    addMarker(marker: MarkerInfo): Promise<void>;
+    /** Cut (razor) at the given frame on the given track. */
+    cutAt(track: number, frame: Frame): Promise<void>;
+    /** Ripple-delete a frame range (closes the gap). */
+    rippleDelete(track: number, range: FrameRange): Promise<void>;
+    /** Append a media clip to the end of a track. Returns the new clip info. */
+    appendClip(track: number, mediaPath: string): Promise<ClipInfo>;
+    /**
+     * Import an EDL/FCPXML/AAF file. Use this when bulk timeline mutation is
+     * faster than per-op calls (e.g. rebuilding from a 200-cut decision list).
+     */
+    importTimeline(filePath: string): Promise<void>;
+    /** Render the current timeline. `preset` is a host-specific preset name. */
+    render(opts: {
+        preset: string;
+        output: string;
+    }): Promise<void>;
+    /** List available render presets the host knows about. */
+    listRenderPresets(): Promise<string[]>;
+    /**
+     * Replace a clip's underlying media reference. Used to swap a draft asset
+     * for an updated render (lower-thirds, animations, B-roll renders) without
+     * destroying the in/out timing or any grade applied to the clip.
+     */
+    replaceClip(clipId: string, mediaPath: string): Promise<void>;
+    /**
+     * Duplicate the active timeline / sequence under a new name. Used as a
+     * safety net BEFORE destructive ops (import_edl, render). On success the
+     * cloned timeline becomes the active one (Resolve) or is opened alongside
+     * (Premiere best-effort).
+     */
+    cloneTimeline(newName: string): Promise<{
+        name: string;
+    }>;
+    /** Save the current project. Resolve uses ProjectManager.SaveProject(); Premiere uses app.project.save(). */
+    saveProject(): Promise<void>;
+    /**
+     * Add a new empty track to the active timeline. `kind` is the track type;
+     * adapters that don't support a kind throw HostUnsupportedError.
+     */
+    addTrack(kind: "video" | "audio" | "subtitle"): Promise<{
+        track: number;
+    }>;
+    /**
+     * Set a clip's audio gain in dB. 0 = unchanged, -6 = quieter, +3 = louder.
+     * Resolve only — Premiere requires Lumetri-adjacent rigging that's not exposed
+     * to ExtendScript reliably.
+     */
+    setClipVolume?(clipId: string, volumeDb: number): Promise<void>;
+    /**
+     * Insert a clip onto a specific track at a specific timeline frame range.
+     * Used for B-roll over A-roll — the agent places cutaways above the main
+     * video on a higher track without disturbing it.
+     *
+     * Resolve: uses MediaPool.AppendToTimeline with a clipInfo dict including
+     *   recordFrame + trackIndex.
+     * Premiere: uses videoTracks[i].insertClip(item, recordSec).
+     */
+    insertClipOnTrack(opts: {
+        mediaPath: string;
+        track: number;
+        recordFrame: number;
+        sourceInFrame?: number;
+        sourceOutFrame?: number;
+    }): Promise<ClipInfo>;
+    /**
+     * Trigger Resolve Studio's Smart Reframe AI on a clip. Resolve only.
+     * Aspect: "9:16" / "1:1" / "4:5" / "16:9" / "4:3".
+     * Frame interest: "all" (every keyframe), "keyframes" (existing keyframes),
+     * or "reference-frame" (a specified frame).
+     */
+    smartReframe?(clipId: string, opts: {
+        aspect: "9:16" | "1:1" | "4:5" | "16:9" | "4:3";
+        frameInterest?: "all" | "keyframes" | "reference-frame";
+        referenceFrame?: number;
+    }): Promise<void>;
+    /** Read existing markers from the active timeline. */
+    getMarkers(): Promise<MarkerInfo[]>;
+    /**
+     * Create a new (empty) timeline / sequence on the host.
+     * Resolve: media_pool.CreateEmptyTimeline + frame-rate / resolution settings.
+     * Premiere: app.project.createNewSequence using a preset (best-effort).
+     */
+    createTimeline(opts: {
+        name: string;
+        fps: number;
+        width?: number;
+        height?: number;
+    }): Promise<void>;
+    /** Import media files into the project's media pool / project bins (no append). */
+    importToMediaPool(paths: string[], bin?: string): Promise<void>;
+    /** Retime a clip on the active timeline. `speed` is a multiplier (1 = 100%, 0.5 = slow-mo, 2 = fast). */
+    setClipSpeed(clipId: string, speed: number): Promise<void>;
+    /**
+     * Apply a LUT to a clip's grading node. Resolve only — Premiere's Lumetri
+     * presets are not scriptable. nodeIndex is 1-based; node 1 always exists.
+     */
+    applyLut(clipId: string, lutPath: string, nodeIndex?: number): Promise<void>;
+    /**
+     * Apply a primary CDL correction (slope/offset/power/saturation) to a clip.
+     * Resolve only. Cannot create nodes, touch wheels, curves, or qualifiers —
+     * what we expose is what's actually scriptable.
+     */
+    setPrimaryCorrection(clipId: string, cdl: {
+        slope?: [number, number, number];
+        offset?: [number, number, number];
+        power?: [number, number, number];
+        saturation?: number;
+        nodeIndex?: number;
+    }): Promise<void>;
+    /**
+     * Copy the current grade from a source clip to one or more target clips.
+     * Resolve only. The Color page may need to be open for the copy to take
+     * effect — call openPage('color') first if it errors.
+     */
+    copyGrade(sourceClipId: string, targetClipIds: string[]): Promise<void>;
+    /**
+     * Import an SRT subtitle file and attach it to the active timeline.
+     * Returns a result describing whether the host auto-attached the SRT to a
+     * subtitle/captions track, plus an optional human-readable note for the
+     * agent to surface (e.g. Premiere requires manual drag-onto-track).
+     */
+    importSubtitles(srtPath: string): Promise<{
+        imported: boolean;
+        attached: boolean;
+        note?: string;
+    }>;
+    /**
+     * Switch the host UI to a workspace page. Resolve only — Premiere does not
+     * have a page concept. Adapters that don't support it should omit this method.
+     */
+    openPage?(name: "media" | "cut" | "edit" | "fusion" | "color" | "fairlight" | "deliver"): Promise<void>;
+}
+/**
+ * Thrown by adapters when an op is not supported by the live host API.
+ * The agent can catch this and fall back (e.g. emit an EDL instead).
+ */
+export declare class HostUnsupportedError extends Error {
+    readonly host: HostName;
+    readonly op: string;
+    constructor(host: HostName, op: string, message?: string);
+}
+/**
+ * Thrown when the host is detected but its scripting bridge is unreachable
+ * (e.g. Resolve free version, Premiere with no panel installed).
+ */
+export declare class HostUnreachableError extends Error {
+    readonly host: HostName;
+    constructor(host: HostName, message: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/hosts/types.d.ts.map

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

package/dist/core/hosts/types.js

@@ -0,0 +1,27 @@
+/**
+ * Thrown by adapters when an op is not supported by the live host API.
+ * The agent can catch this and fall back (e.g. emit an EDL instead).
+ */
+export class HostUnsupportedError extends Error {
+    host;
+    op;
+    constructor(host, op, message) {
+        super(message ?? `Host '${host}' does not support op '${op}' via the live API.`);
+        this.host = host;
+        this.op = op;
+        this.name = "HostUnsupportedError";
+    }
+}
+/**
+ * Thrown when the host is detected but its scripting bridge is unreachable
+ * (e.g. Resolve free version, Premiere with no panel installed).
+ */
+export class HostUnreachableError extends Error {
+    host;
+    constructor(host, message) {
+        super(message);
+        this.host = host;
+        this.name = "HostUnreachableError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/core/hosts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/hosts/types.ts"],"names":[],"mappings":"AAyLA;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAE3B;IACA;IAFlB,YACkB,IAAc,EACd,EAAU,EAC1B,OAAgB;QAEhB,KAAK,CAAC,OAAO,IAAI,SAAS,IAAI,0BAA0B,EAAE,qBAAqB,CAAC,CAAC;QAJjE,SAAI,GAAJ,IAAI,CAAU;QACd,OAAE,GAAF,EAAE,CAAQ;QAI1B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAE3B;IADlB,YACkB,IAAc,EAC9B,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAU;QAI9B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/core/keyframes.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Keyframe sampling + easing curve helpers.
+ *
+ * Used by file-only ffmpeg helpers (Ken-Burns zoompan, speed-ramp curves)
+ * and by tests that want to verify FCPXML emission lines up with the
+ * mathematical sampled trajectory.
+ *
+ * Convention: t is normalized 0..1. Curves are pure functions of t so they
+ * compose cleanly. easeIn / easeOut use simple quadratic curves; smooth is
+ * smoothstep (3t² − 2t³). Linear is the identity.
+ */
+import type { Keyframe } from "./fcpxml.js";
+/** Linear interpolation. f(t) = t. */
+export declare function linear(t: number): number;
+/** Quadratic ease-in. f(t) = t². Slow start, fast finish. */
+export declare function easeIn(t: number): number;
+/** Quadratic ease-out. f(t) = 1 − (1−t)². Fast start, slow finish. */
+export declare function easeOut(t: number): number;
+/** Smoothstep. f(t) = 3t² − 2t³. Symmetric ease-in-out. */
+export declare function smooth(t: number): number;
+/** Resolve an "interp" string to its curve function. */
+export declare function curveFor(interp: "linear" | "easeIn" | "easeOut" | "smooth" | undefined): (t: number) => number;
+/**
+ * Sample a scalar keyframe sequence at a given clip-relative frame.
+ *
+ * Behaviour:
+ *   - Empty list → throws (caller bug).
+ *   - Single keyframe → returns its value (constant).
+ *   - Frame before first kf → first value (clamp).
+ *   - Frame after last kf → last value (clamp).
+ *   - Otherwise → interpolate between the two surrounding kfs using the
+ *     LEFT keyframe's `interp` setting.
+ */
+export declare function sampleCurve(kfs: Keyframe<number>[], frame: number, _fps: number): number;
+//# sourceMappingURL=keyframes.d.ts.map

package/dist/core/keyframes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframes.d.ts","sourceRoot":"","sources":["../../src/core/keyframes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,sCAAsC;AACtC,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,6DAA6D;AAC7D,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxC;AAED,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzC;AAED,2DAA2D;AAC3D,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxC;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CACtB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAC7D,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAYvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBxF"}