@prestyj/editor 0.7.1

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

@@ -0,0 +1,53 @@
+/**
+ * Lazy / re-detecting host adapter.
+ *
+ * The original architecture bound a single VideoHost instance at startup —
+ * if the user opened DaVinci Resolve *after* launching ezeditor, every
+ * subsequent tool call still went into the NoneAdapter even though the
+ * footer's polling loop could see Resolve was now alive.
+ *
+ * createLazyHost() returns a VideoHost that re-detects the running NLE on
+ * demand. Detection is cached for `redetectIntervalMs` (default 2s) so we
+ * don't spawn `ps -axo` on every tool call. When the detected host *name*
+ * changes, the previous adapter (Resolve / Premiere bridges) is shut down
+ * cleanly before the new one is instantiated.
+ *
+ * The proxy preserves the VideoHost contract:
+ *   - `name` / `displayName` are getters returning the live adapter's value.
+ *   - Optional methods (`openPage`, `smartReframe`, `setClipVolume`,
+ *     `executeCode`) are exposed via getters that return either a bound
+ *     function or `undefined`, so existing existence checks
+ *     (`if (host.openPage)`, `typeof host.openPage === 'function'`) remain
+ *     authoritative against the live adapter at the moment of the check.
+ *   - `shutdown()` (not part of VideoHost) cleans up the underlying adapter
+ *     for the CLI's exit handler.
+ *
+ * The agent's startup-baked system prompt should treat host identity as
+ * informational, not contractual. Workflow rule #1 already says
+ * "host_info first" — host_info reads the live adapter, so the agent always
+ * gets fresh ground truth.
+ */
+import type { HostName } from "../../types.js";
+import type { VideoHost } from "./types.js";
+export interface LazyHostOptions {
+    /**
+     * Force a specific host instead of auto-detecting. When set, the proxy
+     * still acts as a normal adapter but never re-detects.
+     */
+    forced?: HostName;
+    /**
+     * Min ms between detection probes. Detection is a `ps` spawn (~5-15ms),
+     * cheap individually but death by a thousand cuts if we ran it on every
+     * tool call. Default 2000ms — fast enough that opening Resolve mid-session
+     * lights up within 2s of the next agent tool call.
+     */
+    redetectIntervalMs?: number;
+}
+export interface LazyHost extends VideoHost {
+    /** Shut down the underlying adapter (closes Resolve/Premiere bridges). */
+    shutdown(): void;
+    /** Force a re-detection on the next call (bypasses the cache). */
+    invalidate(): void;
+}
+export declare function createLazyHost(opts?: LazyHostOptions): LazyHost;
+//# sourceMappingURL=lazy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../../src/core/hosts/lazy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,QAAS,SAAQ,SAAS;IACzC,0EAA0E;IAC1E,QAAQ,IAAI,IAAI,CAAC;IACjB,kEAAkE;IAClE,UAAU,IAAI,IAAI,CAAC;CACpB;AAmBD,wBAAgB,cAAc,CAAC,IAAI,GAAE,eAAoB,GAAG,QAAQ,CA+HnE"}

package/dist/core/hosts/lazy.js

@@ -0,0 +1,143 @@
+import { logInfo } from "../logger.js";
+import { detectHost } from "./detect.js";
+import { NoneAdapter } from "./none/adapter.js";
+import { PremiereAdapter } from "./premiere/adapter.js";
+import { ResolveAdapter } from "./resolve/adapter.js";
+function instantiate(name) {
+    switch (name) {
+        case "resolve":
+            return new ResolveAdapter();
+        case "premiere":
+            return new PremiereAdapter();
+        default:
+            return new NoneAdapter();
+    }
+}
+function shutdownAdapter(adapter) {
+    if (!adapter)
+        return;
+    if (adapter instanceof ResolveAdapter)
+        adapter.shutdown();
+    if (adapter instanceof PremiereAdapter)
+        adapter.shutdown();
+}
+export function createLazyHost(opts = {}) {
+    const interval = opts.redetectIntervalMs ?? 2000;
+    let current = null;
+    let lastDetectAt = 0;
+    function resolve() {
+        if (opts.forced) {
+            if (!current || current.name !== opts.forced) {
+                shutdownAdapter(current);
+                current = instantiate(opts.forced);
+            }
+            return current;
+        }
+        const now = Date.now();
+        if (current && now - lastDetectAt < interval) {
+            return current;
+        }
+        lastDetectAt = now;
+        const detected = detectHost().name;
+        if (!current || current.name !== detected) {
+            logInfo("host", "change", { from: current?.name ?? "none", to: detected });
+            shutdownAdapter(current);
+            current = instantiate(detected);
+        }
+        return current;
+    }
+    // Eagerly resolve once so `name` / `displayName` are correct immediately
+    // after construction (before the first method call).
+    resolve();
+    // Optional methods are exposed via getters so `if (host.openPage)` reads
+    // the live adapter's support at check time. Required methods are
+    // straight delegations — re-resolves on every call so the user opening
+    // their NLE mid-session is picked up within `redetectIntervalMs`.
+    const lazy = {
+        get name() {
+            return resolve().name;
+        },
+        get displayName() {
+            return resolve().displayName;
+        },
+        capabilities: () => resolve().capabilities(),
+        getTimeline: () => resolve().getTimeline(),
+        addMarker: (m) => resolve().addMarker(m),
+        cutAt: (track, frame) => resolve().cutAt(track, frame),
+        rippleDelete: (track, range) => resolve().rippleDelete(track, range),
+        appendClip: (track, mediaPath) => resolve().appendClip(track, mediaPath),
+        importTimeline: (filePath) => resolve().importTimeline(filePath),
+        render: (renderOpts) => resolve().render(renderOpts),
+        listRenderPresets: () => resolve().listRenderPresets(),
+        replaceClip: (clipId, mediaPath) => resolve().replaceClip(clipId, mediaPath),
+        cloneTimeline: (newName) => resolve().cloneTimeline(newName),
+        saveProject: () => resolve().saveProject(),
+        addTrack: (kind) => resolve().addTrack(kind),
+        insertClipOnTrack: (insOpts) => resolve().insertClipOnTrack(insOpts),
+        getMarkers: () => resolve().getMarkers(),
+        createTimeline: (createOpts) => resolve().createTimeline(createOpts),
+        importToMediaPool: (paths, bin) => resolve().importToMediaPool(paths, bin),
+        setClipSpeed: (clipId, speed) => resolve().setClipSpeed(clipId, speed),
+        applyLut: (clipId, lutPath, nodeIndex) => resolve().applyLut(clipId, lutPath, nodeIndex),
+        setPrimaryCorrection: (clipId, cdl) => resolve().setPrimaryCorrection(clipId, cdl),
+        copyGrade: (sourceClipId, targetClipIds) => resolve().copyGrade(sourceClipId, targetClipIds),
+        importSubtitles: (srtPath) => resolve().importSubtitles(srtPath),
+        shutdown() {
+            shutdownAdapter(current);
+            current = null;
+        },
+        invalidate() {
+            // Set sentinel that's always older than `now - interval` so the next
+            // resolve() re-detects regardless of cache window.
+            lastDetectAt = Number.NEGATIVE_INFINITY;
+        },
+    };
+    // Optional methods: defineProperty getters return either the bound
+    // function from the live adapter or `undefined`. This preserves the
+    // semantics existing tools rely on:
+    //   open-page.ts:    `if (typeof host.openPage !== "function") return err(...)`
+    //   smart-reframe.ts: `if (!host.smartReframe)       return err(...)`
+    //   set-clip-volume.ts: same pattern.
+    Object.defineProperty(lazy, "openPage", {
+        enumerable: true,
+        configurable: false,
+        get() {
+            const live = resolve();
+            return live.openPage ? live.openPage.bind(live) : undefined;
+        },
+    });
+    Object.defineProperty(lazy, "smartReframe", {
+        enumerable: true,
+        configurable: false,
+        get() {
+            const live = resolve();
+            return live.smartReframe ? live.smartReframe.bind(live) : undefined;
+        },
+    });
+    Object.defineProperty(lazy, "setClipVolume", {
+        enumerable: true,
+        configurable: false,
+        get() {
+            const live = resolve();
+            return live.setClipVolume ? live.setClipVolume.bind(live) : undefined;
+        },
+    });
+    Object.defineProperty(lazy, "executeCode", {
+        enumerable: true,
+        configurable: false,
+        get() {
+            const live = resolve();
+            return live.executeCode ? live.executeCode.bind(live) : undefined;
+        },
+    });
+    Object.defineProperty(lazy, "executeFusionComp", {
+        enumerable: true,
+        configurable: false,
+        get() {
+            const live = resolve();
+            return live.executeFusionComp ? live.executeFusionComp.bind(live) : undefined;
+        },
+    });
+    return lazy;
+}
+//# sourceMappingURL=lazy.js.map

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

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

package/dist/core/hosts/lazy.test.d.ts

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

package/dist/core/hosts/lazy.test.d.ts.map

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

package/dist/core/hosts/lazy.test.js

@@ -0,0 +1,117 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { createLazyHost } from "./lazy.js";
+/**
+ * The lazy host has two responsibilities:
+ *   1. Re-detect the running NLE on demand (so opening Resolve mid-session
+ *      is picked up without a CLI restart).
+ *   2. Preserve the optional-method semantics existing tools rely on:
+ *      `if (host.openPage)` must reflect the LIVE adapter, not the one we
+ *      had at construction.
+ *
+ * We test these without booting Resolve / Premiere by stubbing the
+ * detectHost module.
+ */
+let mockDetected = { name: "none" };
+vi.mock("./detect.js", () => ({
+    detectHost: () => ({
+        name: mockDetected.name,
+        displayName: mockDetected.name === "resolve"
+            ? "DaVinci Resolve"
+            : mockDetected.name === "premiere"
+                ? "Adobe Premiere Pro"
+                : "No NLE detected",
+        matched: [],
+    }),
+}));
+beforeEach(() => {
+    mockDetected = { name: "none" };
+});
+afterEach(() => {
+    vi.useRealTimers();
+});
+describe("createLazyHost — name reflects the live adapter", () => {
+    it("starts as 'none' when nothing is detected", () => {
+        const host = createLazyHost({ redetectIntervalMs: 0 });
+        expect(host.name).toBe("none");
+        host.shutdown();
+    });
+    it("flips to 'resolve' after Resolve appears, with cache invalidation", () => {
+        const host = createLazyHost({ redetectIntervalMs: 0 });
+        expect(host.name).toBe("none");
+        mockDetected = { name: "resolve" };
+        expect(host.name).toBe("resolve");
+        expect(host.displayName).toBe("DaVinci Resolve");
+        host.shutdown();
+    });
+    it("respects redetectIntervalMs cache (won't see new host until interval elapses)", () => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date(0));
+        const host = createLazyHost({ redetectIntervalMs: 5000 });
+        expect(host.name).toBe("none");
+        mockDetected = { name: "resolve" };
+        // Same tick — cache returns the original adapter.
+        expect(host.name).toBe("none");
+        // Advance past interval — re-detects.
+        vi.setSystemTime(new Date(6000));
+        expect(host.name).toBe("resolve");
+        host.shutdown();
+    });
+});
+describe("createLazyHost — optional-method getters", () => {
+    // The getter contract: return whatever the live adapter exposes, bound
+    // so `this` resolves correctly. NoneAdapter defines every optional
+    // method (they throw HostUnreachableError on call) — so the lazy host's
+    // getters return functions, not undefined, in the host=none case. The
+    // tools that probe `if (host.openPage)` rely on this faithful forwarding
+    // (the `force-strip` tests in new-tools.test simulate adapters that
+    // genuinely omit a method).
+    it("openPage forwards a callable from the live adapter", () => {
+        const host = createLazyHost({ redetectIntervalMs: 0 });
+        expect(typeof host.openPage).toBe("function");
+        mockDetected = { name: "resolve" };
+        expect(typeof host.openPage).toBe("function");
+        host.shutdown();
+    });
+    it("the bound openPage rejects with HostUnreachableError when host=none", async () => {
+        const host = createLazyHost({ redetectIntervalMs: 0 });
+        const fn = host.openPage;
+        expect(fn).toBeDefined();
+        await expect(fn("color")).rejects.toThrow(/No NLE attached/);
+        host.shutdown();
+    });
+    it("smartReframe forwards a callable from the live adapter", () => {
+        const host = createLazyHost({ redetectIntervalMs: 0 });
+        expect(typeof host.smartReframe).toBe("function");
+        host.shutdown();
+    });
+    it("setClipVolume forwards a callable from the live adapter", () => {
+        const host = createLazyHost({ redetectIntervalMs: 0 });
+        expect(typeof host.setClipVolume).toBe("function");
+        host.shutdown();
+    });
+});
+describe("createLazyHost — forced mode", () => {
+    it("never re-detects when forced", () => {
+        const host = createLazyHost({ forced: "none", redetectIntervalMs: 0 });
+        expect(host.name).toBe("none");
+        mockDetected = { name: "resolve" };
+        // Forced means we ignore detection entirely.
+        expect(host.name).toBe("none");
+        host.shutdown();
+    });
+});
+describe("createLazyHost — invalidate()", () => {
+    it("forces a fresh detection on the next access", () => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date(0));
+        const host = createLazyHost({ redetectIntervalMs: 60_000 });
+        expect(host.name).toBe("none");
+        mockDetected = { name: "resolve" };
+        // Within cache window — still returns 'none'.
+        expect(host.name).toBe("none");
+        host.invalidate();
+        expect(host.name).toBe("resolve");
+        host.shutdown();
+    });
+});
+//# sourceMappingURL=lazy.test.js.map

package/dist/core/hosts/lazy.test.js.map

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

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

@@ -0,0 +1,74 @@
+import type { ClipInfo, Frame, FrameRange, HostCapabilities, MarkerInfo, TimelineState } from "../../../types.js";
+import { type VideoHost } 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 declare class NoneAdapter implements VideoHost {
+    readonly name: "none";
+    readonly displayName = "No NLE (file-only mode)";
+    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>;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

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

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,91 @@
+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 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;
+        mediaKind?: "video" | "audio";
+    }): Promise<ClipInfo>;
+    importSubtitles(srtPath: string): Promise<{
+        imported: boolean;
+        attached: boolean;
+        note?: string;
+    }>;
+    executeCode(code: string): Promise<{
+        result: unknown;
+        stdout?: 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":"AAEA,OAAO,KAAK,EACV,QAAQ,EACR,KAAK,EACL,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,aAAa,EACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAuBzE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IACpC,QAAQ,CAAC,WAAW,wBAAwB;IAE5C,OAAO,CAAC,MAAM,CAAwB;IAIhC,YAAY,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA0BzC,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;IAIrC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IASnD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI/D,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAShE,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAInC,cAAc,CAAC,IAAI,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWX,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/E,oBAAoB,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QACJ,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,IAAI,CAAC;IAQV,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzE,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOtC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAIzD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAY3E,iBAAiB,CAAC,IAAI,EAAE;QAC5B,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;KAC/B,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOf,eAAe,CACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAO7D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAI9E,QAAQ,IAAI,IAAI;IAKhB,MAAM,CAAC,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAK1D,MAAM,CAAC,6BAA6B,CAAC,CAAC,EAAE,qBAAqB,GAAG,WAAW;YAM7D,cAAc;CAuB7B"}