@kenkaiiii/gg-editor 0.1.0

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

@@ -0,0 +1,187 @@
+import { existsSync } from "node:fs";
+import { platform } from "node:os";
+import { join } from "node:path";
+import { HostUnsupportedError } from "../types.js";
+import { toResolveColor } from "../../marker-colors.js";
+import { findPython, ResolveBridge, resolveEnv } from "./bridge.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 class ResolveAdapter {
+    name = "resolve";
+    displayName = "DaVinci Resolve";
+    cachedCapabilities;
+    bridge = new ResolveBridge();
+    async capabilities() {
+        if (this.cachedCapabilities)
+            return this.cachedCapabilities;
+        const reachable = this.checkReachable();
+        this.cachedCapabilities = {
+            canMoveClips: false,
+            canScriptColor: true,
+            canScriptAudio: false,
+            canTriggerAI: true,
+            preferredImportFormat: "edl",
+            isAvailable: reachable.ok,
+            unavailableReason: reachable.ok ? undefined : reachable.reason,
+            // Resolve uses Blackmagic's first-party Python scripting API — no
+            // deprecation pressure, unlike the Adobe CEP/UXP situation.
+            runtime: "native",
+        };
+        return this.cachedCapabilities;
+    }
+    async getTimeline() {
+        return this.bridge.call("get_timeline");
+    }
+    async addMarker(marker) {
+        // Normalize lowercase / mixed-case names to Resolve's Title-Case form.
+        // Numeric color (Premiere style) doesn't apply here — Resolve uses names.
+        const color = typeof marker.color === "string" ? toResolveColor(marker.color) : "Blue";
+        await this.bridge.call("add_marker", {
+            frame: marker.frame,
+            note: marker.note,
+            color,
+            durationFrames: marker.durationFrames ?? 1,
+        });
+    }
+    async cutAt(_track, _frame) {
+        // Resolve's Python API does not expose a direct razor. The agent should
+        // fall back to either:
+        //   (a) writing a fresh EDL/FCPXML and calling importTimeline(), or
+        //   (b) the (not yet implemented) accessibility-hotkey path.
+        throw new HostUnsupportedError("resolve", "cutAt", "Resolve's API has no scriptable razor. Use importTimeline() with a fresh EDL " +
+            "(write an EDL containing the cut points) or set the playhead and send ⌘B via " +
+            "the accessibility-hotkey path (not yet implemented).");
+    }
+    async rippleDelete(_track, _range) {
+        throw new HostUnsupportedError("resolve", "rippleDelete", "Not exposed via the Resolve API. Use importTimeline() with a rebuilt EDL.");
+    }
+    async appendClip(track, mediaPath) {
+        return this.bridge.call("append_clip", { track, mediaPath });
+    }
+    async importTimeline(filePath) {
+        await this.bridge.call("import_timeline", { filePath });
+    }
+    async render(opts) {
+        await this.bridge.call("render", opts);
+    }
+    async getMarkers() {
+        return this.bridge.call("get_markers");
+    }
+    async createTimeline(opts) {
+        await this.bridge.call("create_timeline", opts);
+    }
+    async importToMediaPool(paths, bin) {
+        await this.bridge.call("import_to_media_pool", { paths, bin });
+    }
+    async setClipSpeed(clipId, speed) {
+        await this.bridge.call("set_clip_speed", { clipId, speed });
+    }
+    async applyLut(clipId, lutPath, nodeIndex) {
+        await this.bridge.call("apply_lut", { clipId, lutPath, nodeIndex });
+    }
+    async setPrimaryCorrection(clipId, cdl) {
+        await this.bridge.call("set_primary_correction", { clipId, ...cdl });
+    }
+    async copyGrade(sourceClipId, targetClipIds) {
+        await this.bridge.call("copy_grade", { sourceClipId, targetClipIds });
+    }
+    async listRenderPresets() {
+        return this.bridge.call("list_render_presets");
+    }
+    async replaceClip(clipId, mediaPath) {
+        await this.bridge.call("replace_clip", { clipId, mediaPath });
+    }
+    async cloneTimeline(newName) {
+        return this.bridge.call("clone_timeline", { newName });
+    }
+    async saveProject() {
+        await this.bridge.call("save_project");
+    }
+    async addTrack(kind) {
+        return this.bridge.call("add_track", { kind });
+    }
+    async setClipVolume(clipId, volumeDb) {
+        await this.bridge.call("set_clip_volume", { clipId, volumeDb });
+    }
+    async insertClipOnTrack(opts) {
+        return this.bridge.call("insert_clip_on_track", opts);
+    }
+    async smartReframe(clipId, opts) {
+        await this.bridge.call("smart_reframe", { clipId, ...opts });
+    }
+    async importSubtitles(srtPath) {
+        return this.bridge.call("import_subtitles", { srtPath });
+    }
+    async openPage(name) {
+        await this.bridge.call("open_page", { name });
+    }
+    /**
+     * 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() {
+        this.bridge.kill();
+    }
+    // ── Private ────────────────────────────────────────────────
+    /**
+     * 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.
+     */
+    checkReachable() {
+        const env = resolveEnv();
+        const apiPath = env.RESOLVE_SCRIPT_API;
+        const libPath = env.RESOLVE_SCRIPT_LIB;
+        if (!apiPath || !existsSync(apiPath)) {
+            return {
+                ok: false,
+                reason: `RESOLVE_SCRIPT_API not found (looked at ${apiPath ?? "<unset>"}). ` +
+                    `Install DaVinci Resolve Studio or set RESOLVE_SCRIPT_API to its Developer/Scripting dir.`,
+            };
+        }
+        if (!libPath || !existsSync(libPath)) {
+            return {
+                ok: false,
+                reason: `RESOLVE_SCRIPT_LIB not found (looked at ${libPath ?? "<unset>"}).`,
+            };
+        }
+        // The Modules dir is what actually gets put on PYTHONPATH. Sanity-check it.
+        const modules = join(apiPath, "Modules");
+        if (!existsSync(modules)) {
+            return {
+                ok: false,
+                reason: `Resolve API Modules dir missing at ${modules}. Reinstall Resolve Studio.`,
+            };
+        }
+        if (!findPython()) {
+            return {
+                ok: false,
+                reason: platform() === "win32"
+                    ? "Python 3 not on PATH. Install from python.org or the Microsoft Store; verify 'python --version' or 'py -3 --version'."
+                    : "Python 3 not on PATH. Install via Homebrew (macOS) or your package manager (Linux); verify 'python3 --version'.",
+            };
+        }
+        return { ok: true };
+    }
+}
+//# sourceMappingURL=adapter.js.map

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

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

package/dist/core/hosts/resolve/bridge-source.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Embedded Python source for the Resolve bridge. Written to a temp file at
+ * first launch and spawned with python3.
+ *
+ * Protocol: one JSON object per stdin line (request), one JSON object per
+ * stdout line (response). All Resolve API access is wrapped in try/except so
+ * a single failed call cannot kill the bridge.
+ *
+ *   Request:  {"id": "1", "method": "get_timeline", "params": {}}
+ *   Response: {"id": "1", "ok": true,  "result": {...}}
+ *             {"id": "1", "ok": false, "error": "..."}
+ *
+ * The bridge keeps the resolve / project / timeline references fresh by
+ * re-fetching them per call (cheap, and handles the user switching projects).
+ */
+export declare const BRIDGE_PY: string;
+//# sourceMappingURL=bridge-source.d.ts.map

package/dist/core/hosts/resolve/bridge-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-source.d.ts","sourceRoot":"","sources":["../../../../src/core/hosts/resolve/bridge-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,QAmoBrB,CAAC"}