@kenkaiiii/gg-editor 0.1.0

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

@@ -0,0 +1,99 @@
+import { HostUnreachableError, HostUnsupportedError } from "../types.js";
+/**
+ * Bypass adapter — no NLE attached.
+ *
+ * In this mode the agent does NOT manipulate a live host. Instead, it works
+ * entirely against media files on disk via ffmpeg and emits an EDL/FCPXML
+ * the user can import into any NLE later.
+ *
+ * All host ops throw HostUnsupportedError. The agent should rely on the
+ * stand-alone tools (extract_audio, transcribe, write_edl, render_ffmpeg).
+ */
+export class NoneAdapter {
+    name = "none";
+    displayName = "No NLE (file-only mode)";
+    async capabilities() {
+        return {
+            canMoveClips: false,
+            canScriptColor: false,
+            canScriptAudio: false,
+            canTriggerAI: false,
+            preferredImportFormat: "edl",
+            isAvailable: true,
+            unavailableReason: undefined,
+        };
+    }
+    async getTimeline() {
+        throw new HostUnsupportedError("none", "getTimeline");
+    }
+    async addMarker(_marker) {
+        throw new HostUnsupportedError("none", "addMarker");
+    }
+    async cutAt(_track, _frame) {
+        throw new HostUnsupportedError("none", "cutAt");
+    }
+    async rippleDelete(_track, _range) {
+        throw new HostUnsupportedError("none", "rippleDelete");
+    }
+    async appendClip(_track, _mediaPath) {
+        throw new HostUnsupportedError("none", "appendClip");
+    }
+    async importTimeline(_filePath) {
+        throw new HostUnsupportedError("none", "importTimeline");
+    }
+    async render(_opts) {
+        throw new HostUnsupportedError("none", "render");
+    }
+    async getMarkers() {
+        throw new HostUnreachableError("none", "No NLE attached — cannot read markers.");
+    }
+    async createTimeline(_opts) {
+        throw new HostUnreachableError("none", "No NLE attached — cannot create timeline.");
+    }
+    async importToMediaPool(_paths, _bin) {
+        throw new HostUnreachableError("none", "No NLE attached — nothing to import into.");
+    }
+    async setClipSpeed(_clipId, _speed) {
+        throw new HostUnreachableError("none", "No NLE attached — cannot retime.");
+    }
+    async applyLut(_clipId, _lutPath, _nodeIndex) {
+        throw new HostUnreachableError("none", "No NLE attached — cannot apply LUT.");
+    }
+    async setPrimaryCorrection(_clipId, _cdl) {
+        throw new HostUnreachableError("none", "No NLE attached — cannot grade.");
+    }
+    async copyGrade(_sourceClipId, _targetClipIds) {
+        throw new HostUnreachableError("none", "No NLE attached — cannot copy grade.");
+    }
+    async listRenderPresets() {
+        return [];
+    }
+    async replaceClip(_clipId, _mediaPath) {
+        throw new HostUnreachableError("none", "No NLE attached — cannot replace clip.");
+    }
+    async cloneTimeline(_newName) {
+        throw new HostUnreachableError("none", "No NLE attached — cannot clone timeline.");
+    }
+    async saveProject() {
+        throw new HostUnreachableError("none", "No NLE attached — nothing to save.");
+    }
+    async addTrack(_kind) {
+        throw new HostUnreachableError("none", "No NLE attached — cannot add track.");
+    }
+    async setClipVolume(_clipId, _volumeDb) {
+        throw new HostUnreachableError("none", "No NLE attached — cannot set clip volume.");
+    }
+    async insertClipOnTrack(_opts) {
+        throw new HostUnreachableError("none", "No NLE attached — cannot insert clip.");
+    }
+    async smartReframe(_clipId, _opts) {
+        throw new HostUnreachableError("none", "No NLE attached — cannot Smart Reframe.");
+    }
+    async importSubtitles(_srtPath) {
+        throw new HostUnreachableError("none", "No NLE attached — cannot import subtitles.");
+    }
+    async openPage(_name) {
+        throw new HostUnreachableError("none", "No NLE attached — no page concept.");
+    }
+}
+//# sourceMappingURL=adapter.js.map

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

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

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

@@ -0,0 +1,87 @@
+import type { ClipInfo, Frame, FrameRange, HostCapabilities, HostRuntime, MarkerInfo, TimelineState } from "../../../types.js";
+import { type VideoHost } from "../types.js";
+import { type PremiereTransportKind } from "./bridge.js";
+/**
+ * Adobe Premiere Pro adapter.
+ *
+ * Drives Premiere via ExtendScript through `osascript` on macOS (see
+ * ./bridge.ts). Each call generates a self-contained JSX file and asks
+ * Premiere to evalFile it; the JSX writes a JSON result to a temp file.
+ *
+ * Requirements:
+ *   - macOS (Windows path requires a CEP panel — deferred)
+ *   - Premiere Pro running with a project + active sequence
+ *
+ * Capability map (verified against current Premiere Pro APIs):
+ *   - canMoveClips: true (Premiere has direct timeline mutation)
+ *   - canScriptColor: false (Lumetri preset application is limited)
+ *   - canScriptAudio: true (track levels, mute, gain via TrackItem)
+ *   - canTriggerAI: false (Speech-to-Text + Auto Reframe not exposed)
+ *   - preferredImportFormat: xml (FCPXML)
+ *
+ * Unsupported via live API (use write_edl + import_timeline):
+ *   - cut_at — QE DOM razor is undocumented and version-fragile
+ *   - ripple_delete — same reason
+ *   - render — requires Adobe Media Encoder integration; deferred
+ */
+export declare class PremiereAdapter implements VideoHost {
+    readonly name: "premiere";
+    readonly displayName = "Adobe Premiere Pro";
+    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;
+    }>;
+    insertClipOnTrack(opts: {
+        mediaPath: string;
+        track: number;
+        recordFrame: number;
+        sourceInFrame?: number;
+        sourceOutFrame?: number;
+    }): Promise<ClipInfo>;
+    importSubtitles(srtPath: string): Promise<{
+        imported: boolean;
+        attached: boolean;
+        note?: string;
+    }>;
+    shutdown(): void;
+    static _snapColorToPremiereForTest(color: unknown): string;
+    static _mapTransportToRuntimeForTest(t: PremiereTransportKind): HostRuntime;
+    private checkReachable;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

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

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

@@ -0,0 +1,218 @@
+import { spawnSync } from "node:child_process";
+import { platform } from "node:os";
+import { PREMIERE_COLOR_INDEX, RESOLVE_TO_PREMIERE_INDEX } from "../../marker-colors.js";
+import { HostUnsupportedError } from "../types.js";
+import { PremiereBridge } from "./bridge.js";
+/**
+ * Translate the bridge's internal transport kind to the runtime label exposed
+ * via HostCapabilities. Pure function — exported via the static helper for
+ * unit testing.
+ */
+function mapTransportToRuntime(t) {
+    switch (t) {
+        case "http-uxp":
+            return "uxp";
+        case "http-cep":
+            return "cep";
+        case "osascript-cep":
+            return "osascript";
+    }
+}
+/** Inverse of PREMIERE_COLOR_INDEX — numeric index back to color name. */
+const PREMIERE_INDEX_TO_NAME = Object.fromEntries(Object.entries(PREMIERE_COLOR_INDEX).map(([name, idx]) => [idx, name]));
+/**
+ * Adobe Premiere Pro adapter.
+ *
+ * Drives Premiere via ExtendScript through `osascript` on macOS (see
+ * ./bridge.ts). Each call generates a self-contained JSX file and asks
+ * Premiere to evalFile it; the JSX writes a JSON result to a temp file.
+ *
+ * Requirements:
+ *   - macOS (Windows path requires a CEP panel — deferred)
+ *   - Premiere Pro running with a project + active sequence
+ *
+ * Capability map (verified against current Premiere Pro APIs):
+ *   - canMoveClips: true (Premiere has direct timeline mutation)
+ *   - canScriptColor: false (Lumetri preset application is limited)
+ *   - canScriptAudio: true (track levels, mute, gain via TrackItem)
+ *   - canTriggerAI: false (Speech-to-Text + Auto Reframe not exposed)
+ *   - preferredImportFormat: xml (FCPXML)
+ *
+ * Unsupported via live API (use write_edl + import_timeline):
+ *   - cut_at — QE DOM razor is undocumented and version-fragile
+ *   - ripple_delete — same reason
+ *   - render — requires Adobe Media Encoder integration; deferred
+ */
+export class PremiereAdapter {
+    name = "premiere";
+    displayName = "Adobe Premiere Pro";
+    cachedCapabilities;
+    bridge = new PremiereBridge();
+    async capabilities() {
+        if (this.cachedCapabilities)
+            return this.cachedCapabilities;
+        const reachable = await this.checkReachable();
+        // Map our internal transport kind to a public runtime label, and attach a
+        // deprecation notice for anything on the CEP/ExtendScript sunset path.
+        const transport = this.bridge.getTransportKind();
+        const runtime = transport ? mapTransportToRuntime(transport) : undefined;
+        const deprecationNotice = runtime === "cep" || runtime === "osascript"
+            ? "Adobe is removing CEP/ExtendScript support in September 2026. " +
+                "Install the UXP panel for Premiere 25.6+: " +
+                "`npx @kenkaiiii/gg-editor-premiere-panel install --uxp`."
+            : undefined;
+        this.cachedCapabilities = {
+            canMoveClips: true,
+            canScriptColor: false,
+            canScriptAudio: true,
+            canTriggerAI: false,
+            preferredImportFormat: "xml",
+            isAvailable: reachable.ok,
+            unavailableReason: reachable.ok ? undefined : reachable.reason,
+            ...(runtime ? { runtime } : {}),
+            ...(deprecationNotice ? { deprecationNotice } : {}),
+        };
+        return this.cachedCapabilities;
+    }
+    async getTimeline() {
+        return this.bridge.call("get_timeline");
+    }
+    async addMarker(marker) {
+        // Snap any agent-supplied color (incl. Resolve-only hues) to Premiere's
+        // native 8-name palette BEFORE sending to JSX. JSX's _markerColor only
+        // recognises 8 names — anything else fell back to blue. Now we send the
+        // hue-snapped equivalent (e.g. pink → red, mint → green) consistent
+        // with the snap table the rest of the codebase uses.
+        const color = snapColorToPremiere(marker.color);
+        await this.bridge.call("add_marker", {
+            frame: marker.frame,
+            note: marker.note,
+            color,
+            durationFrames: marker.durationFrames ?? 1,
+        });
+    }
+    async cutAt(_track, _frame) {
+        throw new HostUnsupportedError("premiere", "cutAt", "QE DOM razor exists but is undocumented and version-fragile. " +
+            "Use write_edl + import_timeline for reliable bulk cuts.");
+    }
+    async rippleDelete(_track, _range) {
+        throw new HostUnsupportedError("premiere", "rippleDelete", "Use write_edl + import_timeline for reliable bulk operations.");
+    }
+    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) {
+        throw new HostUnsupportedError("premiere", "render", "Premiere render via ExtendScript requires Adobe Media Encoder integration. " +
+            "Use Premiere's File > Export menu manually for now.");
+    }
+    async getMarkers() {
+        return this.bridge.call("get_markers");
+    }
+    async createTimeline(opts) {
+        // Premiere's createNewSequence requires a .sqpreset file. We pass through
+        // the requested name; the JSX side falls back to cloning the active
+        // sequence if no preset path is provided. fps/width/height are advisory
+        // unless a matching preset exists on disk.
+        void opts.fps;
+        void opts.width;
+        void opts.height;
+        await this.bridge.call("create_timeline", { name: opts.name });
+    }
+    async importToMediaPool(paths, bin) {
+        await this.bridge.call("import_to_media_pool", { paths, bin });
+    }
+    async setClipSpeed(_clipId, _speed) {
+        throw new HostUnsupportedError("premiere", "setClipSpeed", "Premiere's TrackItem has no scriptable setSpeed (QE DOM is undocumented). " +
+            "Use write_fcpxml with explicit timeMap rates per clip, then import_edl.");
+    }
+    async applyLut(_clipId, _lutPath, _nodeIndex) {
+        throw new HostUnsupportedError("premiere", "applyLut", "Lumetri preset application via ExtendScript is limited; use Resolve for color or apply manually. apply_lut via Lumetri preset XML is deferred.");
+    }
+    async setPrimaryCorrection(_clipId, _cdl) {
+        throw new HostUnsupportedError("premiere", "setPrimaryCorrection", "Lumetri primary CDL is not exposed to ExtendScript; use Resolve for color or grade manually.");
+    }
+    async copyGrade(_sourceClipId, _targetClipIds) {
+        throw new HostUnsupportedError("premiere", "copyGrade", "Lumetri attribute copy is not scriptable; use Resolve for color or copy/paste attributes manually.");
+    }
+    async listRenderPresets() {
+        // Premiere render presets live in Adobe Media Encoder; not exposed to
+        // ExtendScript without launching AME. Return the empty list with no error
+        // so the agent gracefully falls back to common preset names.
+        return [];
+    }
+    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) {
+        throw new HostUnsupportedError("premiere", "addTrack", "Premiere's TrackCollection.add is not exposed via ExtendScript on all versions. " +
+            "Use Sequence → Add Tracks manually, or rebuild via FCPXML with the desired track count.");
+    }
+    // setClipVolume intentionally NOT implemented — Lumetri Audio gain isn't
+    // reliably scriptable. Use Resolve for clip-level volume.
+    async insertClipOnTrack(opts) {
+        return this.bridge.call("insert_clip_on_track", opts);
+    }
+    // smartReframe is intentionally NOT implemented — Premiere uses Auto Reframe
+    // via the effects panel, not scriptable via ExtendScript.
+    async importSubtitles(srtPath) {
+        return this.bridge.call("import_subtitles", { srtPath });
+    }
+    // openPage is intentionally NOT implemented — Premiere has no page concept.
+    // The agent should consult host_info.caps before calling it.
+    shutdown() {
+        this.bridge.shutdown();
+    }
+    // Exposed for unit testing.
+    static _snapColorToPremiereForTest(color) {
+        return snapColorToPremiere(color);
+    }
+    // Exposed for unit testing.
+    static _mapTransportToRuntimeForTest(t) {
+        return mapTransportToRuntime(t);
+    }
+    // ── Private ────────────────────────────────────────────────
+    async checkReachable() {
+        const platformOk = await PremiereBridge.checkReachable();
+        if (!platformOk.ok)
+            return platformOk;
+        if (platform() === "darwin") {
+            // Even if the panel is reachable, sanity-check Premiere is running.
+            const r = spawnSync("osascript", [
+                "-e",
+                'tell application "System Events" to (name of processes) contains "Adobe Premiere Pro"',
+            ], { encoding: "utf8" });
+            if (r.status === 0 && r.stdout.trim() === "true") {
+                return { ok: true, transport: platformOk.transport };
+            }
+            return { ok: false, reason: "Premiere Pro is not running." };
+        }
+        return { ok: true, transport: platformOk.transport };
+    }
+}
+/**
+ * Resolve any agent-supplied marker color (string name OR numeric Premiere
+ * index) to one of Premiere's 8 native color names that JSX `_markerColor`
+ * recognises. Resolve-only hues snap via `RESOLVE_TO_PREMIERE_INDEX`.
+ * Unknown / undefined inputs default to "blue".
+ */
+function snapColorToPremiere(input) {
+    if (typeof input === "number") {
+        return PREMIERE_INDEX_TO_NAME[input] ?? "blue";
+    }
+    if (typeof input !== "string" || !input.trim())
+        return "blue";
+    const idx = RESOLVE_TO_PREMIERE_INDEX[input.toLowerCase()];
+    if (idx === undefined)
+        return "blue";
+    return PREMIERE_INDEX_TO_NAME[idx] ?? "blue";
+}
+//# sourceMappingURL=adapter.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * ExtendScript runtime for the Premiere bridge.
+ *
+ * Design: per-call self-contained JSX file. Each invocation generates a
+ * complete script that:
+ *   1. Defines small helpers (frame conversion, file writer)
+ *   2. Reads command + params hard-coded into the file
+ *   3. Writes result JSON to a known output path
+ *   4. Always wraps work in try/catch so a Premiere-side exception still
+ *      yields a parseable result file
+ *
+ * We keep JSX minimal — agent-facing logic lives in the TS adapter; JSX is
+ * only the thin glue that walks app.project.* and writes JSON.
+ *
+ * Modern Premiere (2018+) ships with full ECMAScript 5 JSON support. We
+ * don't polyfill; older versions get a clear error.
+ */
+/**
+ * Generate a self-contained JSX script for one method invocation.
+ * @param method   Method name (must match METHODS)
+ * @param params   JSON-encoded params (will be JSON.parsed in JSX as `P`)
+ * @param outPath  Absolute path where the result JSON is written
+ */
+export declare function buildJsxScript(method: string, params: Record<string, unknown>, outPath: string): string;
+export declare const PREMIERE_METHODS: string[];
+//# sourceMappingURL=bridge-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-source.d.ts","sourceRoot":"","sources":["../../../../src/core/hosts/premiere/bridge-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA4SH;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,GACd,MAAM,CAgBR;AAED,eAAO,MAAM,gBAAgB,UAAuB,CAAC"}