@prestyj/editor 0.7.1

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

@@ -0,0 +1,219 @@
+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";
+    bridge = new PremiereBridge();
+    // Capabilities are re-checked on every call so a closed-Premiere session is
+    // visible immediately to host_info instead of being masked by a stale cache.
+    async capabilities() {
+        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 @prestyj/editor-premiere-panel install --uxp`."
+            : undefined;
+        return {
+            canMoveClips: true,
+            canScriptColor: false,
+            canScriptAudio: true,
+            canTriggerAI: false,
+            preferredImportFormat: "xml",
+            isAvailable: reachable.ok,
+            unavailableReason: reachable.ok ? undefined : reachable.reason,
+            ...(runtime ? { runtime } : {}),
+            ...(deprecationNotice ? { deprecationNotice } : {}),
+        };
+    }
+    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.
+    async executeCode(code) {
+        return this.bridge.call("execute_code", { code });
+    }
+    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;AA6VH;;;;;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"}

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

@@ -0,0 +1,374 @@
+/**
+ * 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.
+ */
+const PREAMBLE = String.raw `
+function _writeJson(path, obj) {
+  var f = new File(path);
+  f.encoding = "UTF-8";
+  f.open("w");
+  f.write(JSON.stringify(obj));
+  f.close();
+}
+
+function _seq() {
+  if (!app.project) throw new Error("No project open in Premiere.");
+  var s = app.project.activeSequence;
+  if (!s) throw new Error("No active sequence in Premiere.");
+  return s;
+}
+
+function _fps(seq) {
+  // videoFrameRate is a Time; .seconds = frame duration in seconds.
+  var fd = seq.getSettings().videoFrameRate.seconds;
+  return fd > 0 ? 1 / fd : 30;
+}
+
+function _frames(time, seq) {
+  // seq.timebase: ticks per frame (TickValue). time.ticks: ticks since 0.
+  var tb = parseInt(seq.timebase, 10);
+  if (!tb || isNaN(tb)) tb = 1;
+  return Math.round(parseInt(time.ticks, 10) / tb);
+}
+
+function _markerColor(name) {
+  // Premiere marker colorIndex: 0..7 maps to Green, Red, Purple, Orange,
+  // Yellow, White, Blue, Cyan (varies by version; this is the common map).
+  var m = { green:0, red:1, purple:2, orange:3, yellow:4, white:5, blue:6, cyan:7 };
+  var k = (name || "blue").toLowerCase();
+  return m[k] !== undefined ? m[k] : 6;
+}
+
+function _findClipBin(name) {
+  // Walk root bin recursively for a ProjectItem matching imported file name.
+  var stack = [app.project.rootItem];
+  while (stack.length) {
+    var item = stack.pop();
+    for (var i = 0; i < item.children.numItems; i++) {
+      var child = item.children[i];
+      if (child.name === name) return child;
+      if (child.type === 2 /* BIN */) stack.push(child);
+    }
+  }
+  return null;
+}
+`;
+// ── Per-method bodies ───────────────────────────────────────
+const METHODS = {
+    ping: String.raw `
+    return { product: "Premiere Pro", version: app.version || "?" };
+  `,
+    get_timeline: String.raw `
+    var seq = _seq();
+    var fps = _fps(seq);
+    var clips = [];
+    function collect(tracks, kind) {
+      for (var ti = 0; ti < tracks.numTracks; ti++) {
+        var tr = tracks[ti];
+        for (var ci = 0; ci < tr.clips.numItems; ci++) {
+          var c = tr.clips[ci];
+          try {
+            clips.push({
+              id: String(c.nodeId || c.name + ":" + ci),
+              track: ti + 1,
+              trackKind: kind,
+              startFrame: _frames(c.start, seq),
+              endFrame: _frames(c.end, seq),
+              name: c.name
+            });
+          } catch (e) { /* skip uninspectable */ }
+        }
+      }
+    }
+    collect(seq.videoTracks, "video");
+    collect(seq.audioTracks, "audio");
+
+    var markers = [];
+    var mc = seq.markers;
+    var m = mc.getFirstMarker();
+    while (m) {
+      markers.push({
+        frame: _frames(m.start, seq),
+        note: (m.comments || m.name || ""),
+        color: m.colorIndex,
+        durationFrames: _frames(m.end, seq) - _frames(m.start, seq)
+      });
+      m = mc.getNextMarker(m);
+    }
+
+    var dur = (seq.end ? _frames({ ticks: seq.end }, seq) : 0);
+    return {
+      name: seq.name,
+      frameRate: fps,
+      durationFrames: dur,
+      clips: clips,
+      markers: markers
+    };
+  `,
+    add_marker: String.raw `
+    var seq = _seq();
+    var fps = _fps(seq);
+    var m = seq.markers.createMarker(P.frame / fps);
+    m.name = (P.note || "").substring(0, 60);
+    m.comments = P.note || "";
+    if (P.durationFrames && P.durationFrames > 1) {
+      m.end = m.start + (P.durationFrames / fps);
+    }
+    try { m.setColorByIndex(_markerColor(P.color)); } catch (e) {}
+    return null;
+  `,
+    append_clip: String.raw `
+    var seq = _seq();
+    var ok = app.project.importFiles([P.mediaPath], true, app.project.rootItem, false);
+    if (!ok) throw new Error("importFiles returned false for " + P.mediaPath);
+    // Find the imported item by basename.
+    var base = P.mediaPath.replace(/\\/g, "/").split("/").pop();
+    var pi = _findClipBin(base);
+    if (!pi) throw new Error("Imported item not found in project bin: " + base);
+    var track = seq.videoTracks[(P.track || 1) - 1];
+    if (!track) throw new Error("Track " + P.track + " does not exist on active sequence.");
+    // Insert at sequence end.
+    var endSec = seq.end ? (parseInt(seq.end, 10) / 254016000000) : 0;
+    track.insertClip(pi, endSec);
+    // Find the inserted clip — it's the last one on the track.
+    var inserted = track.clips[track.clips.numItems - 1];
+    return {
+      id: String(inserted.nodeId || inserted.name),
+      track: P.track || 1,
+      trackKind: "video",
+      startFrame: _frames(inserted.start, seq),
+      endFrame: _frames(inserted.end, seq),
+      name: inserted.name
+    };
+  `,
+    import_timeline: String.raw `
+    // Premiere's importFiles handles FCPXML/EDL — they create new sequences.
+    var ok = app.project.importFiles([P.filePath], true, app.project.rootItem, false);
+    if (!ok) throw new Error("importFiles returned false for " + P.filePath);
+    return null;
+  `,
+    get_markers: String.raw `
+    var seq = _seq();
+    var markers = [];
+    var mc = seq.markers;
+    var m = mc.getFirstMarker();
+    while (m) {
+      markers.push({
+        frame: _frames(m.start, seq),
+        note: (m.comments || m.name || ""),
+        color: m.colorIndex,
+        durationFrames: _frames(m.end, seq) - _frames(m.start, seq)
+      });
+      m = mc.getNextMarker(m);
+    }
+    return markers;
+  `,
+    create_timeline: String.raw `
+    if (!app.project) throw new Error("No project open in Premiere.");
+    var name = String(P.name || "GG Sequence");
+    var preset = P.presetPath || "";
+    var newSeq = null;
+    if (preset) {
+      try { newSeq = app.project.createNewSequence(name, preset); } catch (e) { newSeq = null; }
+    }
+    if (!newSeq) {
+      // Fallback: clone the active sequence so we get a usable preset.
+      var src = app.project.activeSequence;
+      if (!src) {
+        throw new Error("create_timeline needs either a sqpreset path (P.presetPath) or an active sequence to clone.");
+      }
+      try {
+        newSeq = src.clone();
+        if (newSeq && newSeq.name !== undefined) newSeq.name = name;
+      } catch (e2) {
+        throw new Error("create_timeline fallback failed: " + (e2 && e2.message ? e2.message : e2));
+      }
+    }
+    return { name: newSeq.name || name };
+  `,
+    import_to_media_pool: String.raw `
+    if (!app.project) throw new Error("No project open in Premiere.");
+    var paths = P.paths || [];
+    if (!paths.length) throw new Error("import_to_media_pool: paths array is empty.");
+    var parent = app.project.rootItem;
+    if (P.bin) {
+      var existing = null;
+      for (var i = 0; i < parent.children.numItems; i++) {
+        var child = parent.children[i];
+        if (child.name === P.bin && child.type === 2 /* BIN */) { existing = child; break; }
+      }
+      parent = existing || parent.createBin(P.bin);
+    }
+    var ok = app.project.importFiles(paths, true, parent, false);
+    if (!ok) throw new Error("importFiles returned false.");
+    return { imported: paths.length };
+  `,
+    clone_timeline: String.raw `
+    var src = _seq();
+    var newName = String(P.newName || (src.name + " copy"));
+    var cloned = null;
+    try { cloned = src.clone(); } catch (e) { cloned = null; }
+    if (!cloned) throw new Error("sequence clone failed (older Premiere versions don't expose Sequence.clone)");
+    if (cloned.name !== undefined) {
+      try { cloned.name = newName; } catch (e2) {}
+    }
+    return { name: cloned.name || newName };
+  `,
+    save_project: String.raw `
+    if (!app.project) throw new Error("No project open in Premiere.");
+    if (typeof app.project.save !== "function") throw new Error("app.project.save is not callable in this Premiere version");
+    app.project.save();
+    return null;
+  `,
+    insert_clip_on_track: String.raw `
+    var seq = _seq();
+    var fps = _fps(seq);
+    // Import media first.
+    var ok = app.project.importFiles([P.mediaPath], true, app.project.rootItem, false);
+    if (!ok) throw new Error("importFiles returned false for " + P.mediaPath);
+    var base = P.mediaPath.replace(/\\/g, "/").split("/").pop();
+    var pi = _findClipBin(base);
+    if (!pi) throw new Error("imported item not found: " + base);
+    var trackIdx = (P.track || 2) - 1;
+    // mediaKind selects audio vs video track family. Default video for back-compat.
+    var kind = String(P.mediaKind || "video").toLowerCase();
+    var trackList = (kind === "audio") ? seq.audioTracks : seq.videoTracks;
+    var track = trackList[trackIdx];
+    if (!track) throw new Error(kind + " track " + P.track + " does not exist on active sequence.");
+    var recordSec = P.recordFrame / fps;
+    track.insertClip(pi, recordSec);
+    var inserted = null;
+    for (var i = 0; i < track.clips.numItems; i++) {
+      var c = track.clips[i];
+      if (Math.abs(_frames(c.start, seq) - P.recordFrame) < 2) { inserted = c; break; }
+    }
+    if (!inserted) inserted = track.clips[track.clips.numItems - 1];
+    return {
+      id: String(inserted.nodeId || inserted.name),
+      track: P.track || 2,
+      trackKind: kind,
+      startFrame: _frames(inserted.start, seq),
+      endFrame: _frames(inserted.end, seq),
+      name: inserted.name
+    };
+  `,
+    replace_clip: String.raw `
+    var seq = _seq();
+    var target = null;
+    function scan(tracks) {
+      for (var ti = 0; ti < tracks.numTracks; ti++) {
+        var tr = tracks[ti];
+        for (var ci = 0; ci < tr.clips.numItems; ci++) {
+          var c = tr.clips[ci];
+          var iid = String(c.nodeId || c.name + ":" + ci);
+          if (iid === P.clipId) { target = c; return; }
+        }
+      }
+    }
+    scan(seq.videoTracks);
+    if (!target) scan(seq.audioTracks);
+    if (!target) throw new Error("clip not found on active sequence: " + P.clipId);
+    // Import the new media if not already in the project.
+    var ok = app.project.importFiles([P.mediaPath], true, app.project.rootItem, false);
+    if (!ok) throw new Error("importFiles returned false for " + P.mediaPath);
+    var base = P.mediaPath.replace(/\\/g, "/").split("/").pop();
+    var pi = _findClipBin(base);
+    if (!pi) throw new Error("imported item not found: " + base);
+    // Premiere's TrackItem exposes changeMediaPath in some versions.
+    if (typeof target.changeMediaPath === "function") {
+      target.changeMediaPath(P.mediaPath);
+      return { clipId: P.clipId, mediaPath: P.mediaPath };
+    }
+    throw new Error("replace_clip not supported by this Premiere version. fix: rebuild via FCPXML with the new media reference.");
+  `,
+    import_subtitles: String.raw `
+    if (!app.project) throw new Error("No project open in Premiere.");
+    var ok = app.project.importFiles([P.srtPath], true, app.project.rootItem, false);
+    if (!ok) throw new Error("importFiles returned false for " + P.srtPath);
+    return { imported: true, attached: false, note: "SRT imported to project; drag onto a captions track on the active sequence." };
+  `,
+    // Escape hatch: eval arbitrary ExtendScript with the Premiere DOM in scope.
+    // Pre-bound: app, project, sequence (active sequence or null), qe (Quality
+    // Engineering DOM, undocumented but available after enableQE()).
+    // Result resolution: caller may either assign to `result` or call setResult(value).
+    // print(...) is captured to a buffer and returned as `stdout`.
+    execute_code: String.raw `
+    if (typeof P.code !== "string" || !P.code.length) {
+      throw new Error("execute_code requires a non-empty 'code' string.");
+    }
+    var project = app.project || null;
+    var sequence = (project && project.activeSequence) ? project.activeSequence : null;
+    try { if (typeof app.enableQE === "function") app.enableQE(); } catch (eqe) {}
+    var qe = (typeof window !== "undefined" && window.qe) ? window.qe : (typeof $.global.qe !== "undefined" ? $.global.qe : null);
+    var __stdout = [];
+    var print = function () {
+      var parts = [];
+      for (var i = 0; i < arguments.length; i++) {
+        try { parts.push(typeof arguments[i] === "string" ? arguments[i] : JSON.stringify(arguments[i])); }
+        catch (e) { parts.push(String(arguments[i])); }
+      }
+      __stdout.push(parts.join(" "));
+    };
+    var __holder = { value: null, set: false };
+    var setResult = function (v) { __holder.value = v; __holder.set = true; };
+    var result = null;
+    try {
+      // ExtendScript eval inherits the current scope, so app/project/sequence/
+      // qe/print/setResult/result are all visible inside the snippet.
+      eval(P.code);
+    } catch (eEval) {
+      var stdout = __stdout.join("\n");
+      var tail = stdout ? ("\nstdout: " + stdout.substring(Math.max(0, stdout.length - 1500))) : "";
+      throw new Error((eEval && eEval.message ? eEval.message : String(eEval)) + tail);
+    }
+    var safe = function (v) {
+      try { JSON.stringify(v); return v; } catch (e) { return String(v); }
+    };
+    var out = { result: __holder.set ? safe(__holder.value) : (typeof result === "undefined" ? null : safe(result)) };
+    if (__stdout.length) {
+      var s = __stdout.join("\n");
+      if (s.length > 4000) s = s.substring(0, 2000) + "\n…[truncated]…\n" + s.substring(s.length - 1500);
+      out.stdout = s;
+    }
+    return out;
+  `,
+};
+/**
+ * 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 function buildJsxScript(method, params, outPath) {
+    const body = METHODS[method];
+    if (!body)
+        throw new Error(`unknown premiere method: ${method}`);
+    // Escape outPath for safe JSX string literal.
+    const safeOut = outPath.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    const safeParams = JSON.stringify(params).replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    return `${PREAMBLE}
+var P = JSON.parse("${safeParams}");
+var __out = "${safeOut}";
+try {
+  var __result = (function () { ${body} })();
+  _writeJson(__out, { ok: true, result: __result === undefined ? null : __result });
+} catch (__e) {
+  _writeJson(__out, { ok: false, error: (__e && __e.message) ? __e.message : String(__e) });
+}
+`;
+}
+export const PREMIERE_METHODS = Object.keys(METHODS);
+//# sourceMappingURL=bridge-source.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-source.js","sourceRoot":"","sources":["../../../../src/core/hosts/premiere/bridge-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkD1B,CAAC;AAEF,+DAA+D;AAE/D,MAAM,OAAO,GAA2B;IACtC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAA;;GAEf;IAED,YAAY,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CvB;IAED,UAAU,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;GAWrB;IAED,WAAW,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBtB;IAED,eAAe,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;GAK1B;IAED,WAAW,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;GAetB;IAED,eAAe,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;GAsB1B;IAED,oBAAoB,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;GAgB/B;IAED,cAAc,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;GAUzB;IAED,YAAY,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;GAKvB;IAED,oBAAoB,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+B/B;IAED,YAAY,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BvB;IAED,gBAAgB,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;GAK3B;IAED,4EAA4E;IAC5E,2EAA2E;IAC3E,iEAAiE;IACjE,oFAAoF;IACpF,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCvB;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,MAA+B,EAC/B,OAAe;IAEf,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC;IACjE,8CAA8C;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtF,OAAO,GAAG,QAAQ;sBACE,UAAU;eACjB,OAAO;;kCAEY,IAAI;;;;;CAKrC,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC"}

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

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

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

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