@synthetic-ai/premiere-mcp 2.2.0 → 2.3.0-dev.0

package/dist/tools/export.js

@@ -6,24 +6,24 @@ import { tmpdir } from "node:os";
 export function getExportTools(bridgeOptions) {
     return {
         export_sequence: {
-            description: `Export the active sequence to a file using Adobe Media Encoder (AME).
-
-Preconditions: An active sequence must exist. Adobe Media Encoder must be installed. The output directory must exist and be writable.
-
-Export runs asynchronously via AME — this tool queues and starts the export, but completion may take minutes. The tool returns after the export job is queued (not after it finishes).
-
-Common preset paths:
-- macOS H.264 1080p: /Applications/Adobe Media Encoder [year]/MediaIO/systempresets/4028/HDTV 1080p 29.97 High Quality.epr
-- Windows H.264: C:\\Program Files\\Adobe\\Adobe Media Encoder [year]\\MediaIO\\systempresets\\4028\\HDTV 1080p 29.97 High Quality.epr
-
-If preset_path is omitted, uses default H.264 1080p settings.
-
-Parameters:
-- output_path: Absolute path for the output file including extension (e.g., .mp4, .mov, .mxf).
-- preset_path: Path to an AME .epr preset file. Determines codec, bitrate, and format.
-- work_area_only: If true, exports only the range between work area in/out points instead of the full sequence.
-
-Example: export_sequence({ output_path: "C:\\\\Exports\\\\final.mp4" })
+            description: `Export the active sequence to a file using Adobe Media Encoder (AME).
+
+Preconditions: An active sequence must exist. Adobe Media Encoder must be installed. The output directory must exist and be writable.
+
+Export runs asynchronously via AME — this tool queues and starts the export, but completion may take minutes. The tool returns after the export job is queued (not after it finishes).
+
+Common preset paths:
+- macOS H.264 1080p: /Applications/Adobe Media Encoder [year]/MediaIO/systempresets/4028/HDTV 1080p 29.97 High Quality.epr
+- Windows H.264: C:\\Program Files\\Adobe\\Adobe Media Encoder [year]\\MediaIO\\systempresets\\4028\\HDTV 1080p 29.97 High Quality.epr
+
+If preset_path is omitted, uses default H.264 1080p settings.
+
+Parameters:
+- output_path: Absolute path for the output file including extension (e.g., .mp4, .mov, .mxf).
+- preset_path: Path to an AME .epr preset file. Determines codec, bitrate, and format.
+- work_area_only: If true, exports only the range between work area in/out points instead of the full sequence.
+
+Example: export_sequence({ output_path: "C:\\\\Exports\\\\final.mp4" })
 Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_path: "/path/to/ProRes422.epr", work_area_only: false })`,
             parameters: {
                 type: "object",
@@ -44,41 +44,41 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
                 required: ["output_path"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var seq = app.project.activeSequence;
-          if (!seq) return __error("No active sequence");
-          
-          var outputPath = "${escapeForExtendScript(args.output_path)}";
-          
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
+          var outputPath = "${escapeForExtendScript(args.output_path)}";
+          
           ${args.preset_path
                     ? `var presetPath = "${escapeForExtendScript(args.preset_path)}";`
-                    : `// No preset_path provided — build a default by probing common locations.
-               var presetPath = "";
-               var presetCandidates = [
-                 // Windows — Adobe Media Encoder 2026 / 2025 / 2024 / generic
-                 "C:\\\\Program Files\\\\Adobe\\\\Adobe Media Encoder 2026\\\\MediaIO\\\\systempresets\\\\4028\\\\HDTV 1080p 29.97 High Quality.epr",
-                 "C:\\\\Program Files\\\\Adobe\\\\Adobe Media Encoder 2025\\\\MediaIO\\\\systempresets\\\\4028\\\\HDTV 1080p 29.97 High Quality.epr",
-                 "C:\\\\Program Files\\\\Adobe\\\\Adobe Media Encoder 2024\\\\MediaIO\\\\systempresets\\\\4028\\\\HDTV 1080p 29.97 High Quality.epr",
-                 // macOS — Adobe Media Encoder 2026 / 2025 / 2024
-                 "/Applications/Adobe Media Encoder 2026/MediaIO/systempresets/4028/HDTV 1080p 29.97 High Quality.epr",
-                 "/Applications/Adobe Media Encoder 2025/MediaIO/systempresets/4028/HDTV 1080p 29.97 High Quality.epr",
-                 "/Applications/Adobe Media Encoder 2024/MediaIO/systempresets/4028/HDTV 1080p 29.97 High Quality.epr"
-               ];
-               for (var i = 0; i < presetCandidates.length; i++) {
-                 var presetFile = new File(presetCandidates[i]);
-                 if (presetFile.exists) { presetPath = presetFile.fsName; break; }
-               }
-               if (presetPath === "") {
-                 return __error("No default export preset (.epr) could be found on this system. Pass preset_path with an absolute path to an AME .epr preset file.");
-               }`}
-
-          var exportResult = seq.exportAsMediaDirect(
-            outputPath,
-            presetPath,
-            ${args.work_area_only ? "app.encoder.ENCODE_WORKAREA" : "app.encoder.ENCODE_ENTIRE"}
-          );
-          
-          return __result({ exported: true, outputPath: outputPath });
+                    : `// No preset_path provided — build a default by probing common locations.
+               var presetPath = "";
+               var presetCandidates = [
+                 // Windows — Adobe Media Encoder 2026 / 2025 / 2024 / generic
+                 "C:\\\\Program Files\\\\Adobe\\\\Adobe Media Encoder 2026\\\\MediaIO\\\\systempresets\\\\4028\\\\HDTV 1080p 29.97 High Quality.epr",
+                 "C:\\\\Program Files\\\\Adobe\\\\Adobe Media Encoder 2025\\\\MediaIO\\\\systempresets\\\\4028\\\\HDTV 1080p 29.97 High Quality.epr",
+                 "C:\\\\Program Files\\\\Adobe\\\\Adobe Media Encoder 2024\\\\MediaIO\\\\systempresets\\\\4028\\\\HDTV 1080p 29.97 High Quality.epr",
+                 // macOS — Adobe Media Encoder 2026 / 2025 / 2024
+                 "/Applications/Adobe Media Encoder 2026/MediaIO/systempresets/4028/HDTV 1080p 29.97 High Quality.epr",
+                 "/Applications/Adobe Media Encoder 2025/MediaIO/systempresets/4028/HDTV 1080p 29.97 High Quality.epr",
+                 "/Applications/Adobe Media Encoder 2024/MediaIO/systempresets/4028/HDTV 1080p 29.97 High Quality.epr"
+               ];
+               for (var i = 0; i < presetCandidates.length; i++) {
+                 var presetFile = new File(presetCandidates[i]);
+                 if (presetFile.exists) { presetPath = presetFile.fsName; break; }
+               }
+               if (presetPath === "") {
+                 return __error("No default export preset (.epr) could be found on this system. Pass preset_path with an absolute path to an AME .epr preset file.");
+               }`}
+
+          var exportResult = seq.exportAsMediaDirect(
+            outputPath,
+            presetPath,
+            ${args.work_area_only ? "app.encoder.ENCODE_WORKAREA" : "app.encoder.ENCODE_ENTIRE"}
+          );
+          
+          return __result({ exported: true, outputPath: outputPath });
         `);
                 return sendCommand(script, { ...bridgeOptions, timeoutMs: 120000 }); // 2 min timeout for exports
             },
@@ -100,18 +100,18 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
                 required: ["output_path"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var seq = app.project.activeSequence;
-          if (!seq) return __error("No active sequence");
-          
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
           ${args.time_seconds !== undefined
                     ? `seq.setPlayerPosition(__secondsToTicks(${args.time_seconds}).toString());`
-                    : ""}
-          
-          var outputPath = "${escapeForExtendScript(args.output_path)}";
-          seq.exportFramePNG(seq.getPlayerPosition().ticks, outputPath);
-          
-          return __result({ exported: true, outputPath: outputPath });
+                    : ""}
+          
+          var outputPath = "${escapeForExtendScript(args.output_path)}";
+          seq.exportFramePNG(seq.getPlayerPosition().ticks, outputPath);
+          
+          return __result({ exported: true, outputPath: outputPath });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -129,12 +129,12 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
                 required: ["output_path"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var seq = app.project.activeSequence;
-          if (!seq) return __error("No active sequence");
-          
-          seq.exportAsFinalCutProXML("${escapeForExtendScript(args.output_path)}");
-          return __result({ exported: true, outputPath: "${escapeForExtendScript(args.output_path)}", format: "FCP XML" });
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
+          seq.exportAsFinalCutProXML("${escapeForExtendScript(args.output_path)}");
+          return __result({ exported: true, outputPath: "${escapeForExtendScript(args.output_path)}", format: "FCP XML" });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -168,19 +168,19 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
                 required: ["output_path"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var seq = app.project.activeSequence;
-          if (!seq) return __error("No active sequence");
-          
-          seq.exportAsAAF(
-            "${escapeForExtendScript(args.output_path)}",
-            ${args.mix_down_video !== false ? 1 : 0},
-            ${args.explode_to_mono ? 1 : 0},
-            ${args.sample_rate ?? 48000},
-            ${args.bits_per_sample ?? 16}
-          );
-          
-          return __result({ exported: true, outputPath: "${escapeForExtendScript(args.output_path)}", format: "AAF" });
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
+          seq.exportAsAAF(
+            "${escapeForExtendScript(args.output_path)}",
+            ${args.mix_down_video !== false ? 1 : 0},
+            ${args.explode_to_mono ? 1 : 0},
+            ${args.sample_rate ?? 48000},
+            ${args.bits_per_sample ?? 16}
+          );
+          
+          return __result({ exported: true, outputPath: "${escapeForExtendScript(args.output_path)}", format: "AAF" });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -202,29 +202,29 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
                 required: ["output_path"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var seq = app.project.activeSequence;
-          if (!seq) return __error("No active sequence");
-          
-          var encoder = app.encoder;
-          if (!encoder) return __error("Adobe Media Encoder not available");
-          
-          encoder.launchEncoder();
-          
-          var outputPath = "${escapeForExtendScript(args.output_path)}";
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
+          var encoder = app.encoder;
+          if (!encoder) return __error("Adobe Media Encoder not available");
+          
+          encoder.launchEncoder();
+          
+          var outputPath = "${escapeForExtendScript(args.output_path)}";
           ${args.preset_path
                     ? `var presetPath = "${escapeForExtendScript(args.preset_path)}";`
-                    : `var presetPath = encoder.ENCODE_MATCH_SEQUENCE;`}
-          
-          encoder.encodeSequence(
-            seq,
-            outputPath,
-            presetPath,
-            0, // workAreaType
-            1  // removeOnCompletion
-          );
-          
-          return __result({ queued: true, outputPath: outputPath });
+                    : `var presetPath = encoder.ENCODE_MATCH_SEQUENCE;`}
+          
+          encoder.encodeSequence(
+            seq,
+            outputPath,
+            presetPath,
+            0, // workAreaType
+            1  // removeOnCompletion
+          );
+          
+          return __result({ queued: true, outputPath: outputPath });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -233,14 +233,14 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
             description: "Get the current status of the Adobe Media Encoder render queue",
             parameters: {},
             handler: async () => {
-                const script = buildToolScript(`
-          var encoder = app.encoder;
-          if (!encoder) return __error("Adobe Media Encoder not available");
-          
-          return __result({
-            isRunning: encoder.isRunning ? encoder.isRunning() : "unknown",
-            info: "Check Adobe Media Encoder application for detailed queue status"
-          });
+                const script = buildToolScript(`
+          var encoder = app.encoder;
+          if (!encoder) return __error("Adobe Media Encoder not available");
+          
+          return __result({
+            isRunning: encoder.isRunning ? encoder.isRunning() : "unknown",
+            info: "Check Adobe Media Encoder application for detailed queue status"
+          });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -270,24 +270,24 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
                 required: ["item_id", "name", "in_seconds", "out_seconds"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var item = __findProjectItem("${escapeForExtendScript(args.item_id)}");
-          if (!item) return __error("Item not found");
-          
-          var inTicks = __secondsToTicks(${args.in_seconds}).toString();
-          var outTicks = __secondsToTicks(${args.out_seconds}).toString();
-          
-          var subclip = item.createSubClip(
-            "${escapeForExtendScript(args.name)}",
-            inTicks,
-            outTicks,
-            0, // hasHardBoundaries
-            1, // takeVideo
-            1  // takeAudio
-          );
-          
-          if (!subclip) return __error("Failed to create subclip");
-          return __result({ created: true, name: "${escapeForExtendScript(args.name)}", source: item.name });
+                const script = buildToolScript(`
+          var item = __findProjectItem("${escapeForExtendScript(args.item_id)}");
+          if (!item) return __error("Item not found");
+          
+          var inTicks = __secondsToTicks(${args.in_seconds}).toString();
+          var outTicks = __secondsToTicks(${args.out_seconds}).toString();
+          
+          var subclip = item.createSubClip(
+            "${escapeForExtendScript(args.name)}",
+            inTicks,
+            outTicks,
+            0, // hasHardBoundaries
+            1, // takeVideo
+            1  // takeAudio
+          );
+          
+          if (!subclip) return __error("Failed to create subclip");
+          return __result({ created: true, name: "${escapeForExtendScript(args.name)}", source: item.name });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -306,51 +306,51 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
             handler: async (args) => {
                 const tempPath = join(tmpdir(), `mcp_frame_capture_${Date.now()}.png`);
                 const escapedPath = escapeForExtendScript(tempPath);
-                const script = buildToolScript(`
-          var seq = app.project.activeSequence;
-          if (!seq) return __error("No active sequence");
-          
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
           ${args.time_seconds !== undefined
                     ? `seq.setPlayerPosition(__secondsToTicks(${args.time_seconds}).toString());`
-                    : ""}
-          
-          var outputPath = "${escapedPath}";
-          // seq.exportFramePNG does not exist in PP 2026. Use the QE DOM approach:
-          // app.enableQE(); qe.project.getActiveSequence().exportFrameJPG(ticks, path)
-          // falls back to source monitor PNG if that also fails.
-          // PP 2026 host bug verified at runtime: seq.exportFramePNG / exportFrameJPEG
-          // do NOT exist on the DOM Sequence object, and qe.project.getActiveSequence()
-          // exposes exportFramePNG as a "function" but the call returns successfully
-          // WITHOUT writing the file (waited 5s, file never appears).
-          // The only working frame-export path in PP 2026 is via Adobe Media Encoder
-          // with a single-frame preset, which is heavy and asynchronous.
-          // Return an honest error with a recommended workaround.
-          app.enableQE();
-          var pos = seq.getPlayerPosition();
-          var posTicks = pos ? pos.ticks : "0";
-          var attempted = [];
-          var hadAnyFunction = false;
-          try {
-            var qeSeq2 = qe.project.getActiveSequence();
-            if (qeSeq2 && typeof qeSeq2.exportFramePNG === "function") {
-              hadAnyFunction = true;
-              attempted.push("qeSeq.exportFramePNG(path, ticks)");
-              qeSeq2.exportFramePNG(outputPath, posTicks);
-              // Wait a moment in case PP is fast enough
-              $.sleep(800);
-              var f = new File(outputPath);
-              if (f.exists && f.length > 0) {
-                return __result({ exported: true, outputPath: outputPath, atTicks: posTicks });
-              }
-            }
-          } catch (eQE) { attempted.push("qe error: " + eQE.toString()); }
-
-          return __error("capture_frame is not supported in Premiere Pro 2026 via ExtendScript. " +
-            "Verified at runtime: seq.exportFramePNG/exportFrameJPEG do not exist on the DOM Sequence, " +
-            "and qe.project.getActiveSequence().exportFramePNG reports success but never writes the file. " +
-            "Workaround: use 'File > Export > Media > Single Frame' in the Premiere Pro UI, " +
-            "or use export_sequence with a single-frame preset via AME (heavy/async). " +
-            "Attempted: [" + attempted.join("; ") + "]. hadFunction=" + hadAnyFunction);
+                    : ""}
+          
+          var outputPath = "${escapedPath}";
+          // seq.exportFramePNG does not exist in PP 2026. Use the QE DOM approach:
+          // app.enableQE(); qe.project.getActiveSequence().exportFrameJPG(ticks, path)
+          // falls back to source monitor PNG if that also fails.
+          // PP 2026 host bug verified at runtime: seq.exportFramePNG / exportFrameJPEG
+          // do NOT exist on the DOM Sequence object, and qe.project.getActiveSequence()
+          // exposes exportFramePNG as a "function" but the call returns successfully
+          // WITHOUT writing the file (waited 5s, file never appears).
+          // The only working frame-export path in PP 2026 is via Adobe Media Encoder
+          // with a single-frame preset, which is heavy and asynchronous.
+          // Return an honest error with a recommended workaround.
+          app.enableQE();
+          var pos = seq.getPlayerPosition();
+          var posTicks = pos ? pos.ticks : "0";
+          var attempted = [];
+          var hadAnyFunction = false;
+          try {
+            var qeSeq2 = qe.project.getActiveSequence();
+            if (qeSeq2 && typeof qeSeq2.exportFramePNG === "function") {
+              hadAnyFunction = true;
+              attempted.push("qeSeq.exportFramePNG(path, ticks)");
+              qeSeq2.exportFramePNG(outputPath, posTicks);
+              // Wait a moment in case PP is fast enough
+              $.sleep(800);
+              var f = new File(outputPath);
+              if (f.exists && f.length > 0) {
+                return __result({ exported: true, outputPath: outputPath, atTicks: posTicks });
+              }
+            }
+          } catch (eQE) { attempted.push("qe error: " + eQE.toString()); }
+
+          return __error("capture_frame is not supported in Premiere Pro 2026 via ExtendScript. " +
+            "Verified at runtime: seq.exportFramePNG/exportFrameJPEG do not exist on the DOM Sequence, " +
+            "and qe.project.getActiveSequence().exportFramePNG reports success but never writes the file. " +
+            "Workaround: use 'File > Export > Media > Single Frame' in the Premiere Pro UI, " +
+            "or use export_sequence with a single-frame preset via AME (heavy/async). " +
+            "Attempted: [" + attempted.join("; ") + "]. hadFunction=" + hadAnyFunction);
         `);
                 const result = await sendCommand(script, bridgeOptions);
                 if (!result.success)
@@ -424,23 +424,23 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
                 required: ["output_path"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var seq = app.project.activeSequence;
-          if (!seq) return __error("No active sequence");
-          
-          app.project.exportOMF(
-            seq,
-            "${escapeForExtendScript(args.output_path)}",
-            "OMFTitle",
-            ${args.sample_rate ?? 48000},
-            ${args.bits_per_sample ?? 16},
-            ${args.audio_encapsulated !== false ? 1 : 0},
-            ${args.audio_file_format ?? 1},
-            ${args.trim_audio_files !== false ? 1 : 0},
-            ${args.handle_frames ?? 1000}
-          );
-          
-          return __result({ exported: true, outputPath: "${escapeForExtendScript(args.output_path)}", format: "OMF" });
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
+          app.project.exportOMF(
+            seq,
+            "${escapeForExtendScript(args.output_path)}",
+            "OMFTitle",
+            ${args.sample_rate ?? 48000},
+            ${args.bits_per_sample ?? 16},
+            ${args.audio_encapsulated !== false ? 1 : 0},
+            ${args.audio_file_format ?? 1},
+            ${args.trim_audio_files !== false ? 1 : 0},
+            ${args.handle_frames ?? 1000}
+          );
+          
+          return __result({ exported: true, outputPath: "${escapeForExtendScript(args.output_path)}", format: "OMF" });
         `);
                 return sendCommand(script, { ...bridgeOptions, timeoutMs: 120000 });
             },
@@ -470,25 +470,25 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
                 required: ["item_id", "output_path", "preset_path"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var item = __findProjectItem("${escapeForExtendScript(args.item_id)}");
-          if (!item) return __error("Project item not found: ${escapeForExtendScript(args.item_id)}");
-          
-          app.encoder.launchEncoder();
-          app.encoder.encodeProjectItem(
-            item,
-            "${escapeForExtendScript(args.output_path)}",
-            "${escapeForExtendScript(args.preset_path)}",
-            app.encoder.ENCODE_IN_TO_OUT,
-            ${args.remove_on_completion !== false ? 1 : 0}
-          );
-          app.encoder.startBatch();
-          
-          return __result({
-            queued: true,
-            item: item.name,
-            outputPath: "${escapeForExtendScript(args.output_path)}"
-          });
+                const script = buildToolScript(`
+          var item = __findProjectItem("${escapeForExtendScript(args.item_id)}");
+          if (!item) return __error("Project item not found: ${escapeForExtendScript(args.item_id)}");
+          
+          app.encoder.launchEncoder();
+          app.encoder.encodeProjectItem(
+            item,
+            "${escapeForExtendScript(args.output_path)}",
+            "${escapeForExtendScript(args.preset_path)}",
+            app.encoder.ENCODE_IN_TO_OUT,
+            ${args.remove_on_completion !== false ? 1 : 0}
+          );
+          app.encoder.startBatch();
+          
+          return __result({
+            queued: true,
+            item: item.name,
+            outputPath: "${escapeForExtendScript(args.output_path)}"
+          });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -532,31 +532,31 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
                 const outPointCode = args.out_seconds !== undefined
                     ? `var srcOut = new Time(); srcOut.seconds = ${args.out_seconds};`
                     : `var srcOut = undefined;`;
-                const script = buildToolScript(`
-          app.encoder.launchEncoder();
-          
-          ${inPointCode}
-          ${outPointCode}
-          
-          // Signature: encodeFile(inputPath, outputPath, presetPath, workArea,
-          // removeUponCompletion, inPoint, outPoint). workArea 1 = in-to-out, 0 = entire.
-          var workArea = (typeof srcIn !== "undefined" || typeof srcOut !== "undefined") ? 1 : 0;
-          app.encoder.encodeFile(
-            "${escapeForExtendScript(args.input_path)}",
-            "${escapeForExtendScript(args.output_path)}",
-            "${escapeForExtendScript(args.preset_path)}",
-            workArea,
-            ${args.remove_on_completion !== false ? 1 : 0},
-            srcIn,
-            srcOut
-          );
-          app.encoder.startBatch();
-          
-          return __result({
-            queued: true,
-            inputPath: "${escapeForExtendScript(args.input_path)}",
-            outputPath: "${escapeForExtendScript(args.output_path)}"
-          });
+                const script = buildToolScript(`
+          app.encoder.launchEncoder();
+          
+          ${inPointCode}
+          ${outPointCode}
+          
+          // Signature: encodeFile(inputPath, outputPath, presetPath, workArea,
+          // removeUponCompletion, inPoint, outPoint). workArea 1 = in-to-out, 0 = entire.
+          var workArea = (typeof srcIn !== "undefined" || typeof srcOut !== "undefined") ? 1 : 0;
+          app.encoder.encodeFile(
+            "${escapeForExtendScript(args.input_path)}",
+            "${escapeForExtendScript(args.output_path)}",
+            "${escapeForExtendScript(args.preset_path)}",
+            workArea,
+            ${args.remove_on_completion !== false ? 1 : 0},
+            srcIn,
+            srcOut
+          );
+          app.encoder.startBatch();
+          
+          return __result({
+            queued: true,
+            inputPath: "${escapeForExtendScript(args.input_path)}",
+            outputPath: "${escapeForExtendScript(args.output_path)}"
+          });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -583,32 +583,32 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
                 required: ["item_id", "action"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var item = __findProjectItem("${escapeForExtendScript(args.item_id)}");
-          if (!item) return __error("Item not found");
-          
-          var action = "${args.action}";
-          
-          if (action === "create") {
-            item.createProxy("", 0);
-            return __result({ action: "create", item: item.name, status: "Proxy creation started" });
-          } else if (action === "attach") {
+                const script = buildToolScript(`
+          var item = __findProjectItem("${escapeForExtendScript(args.item_id)}");
+          if (!item) return __error("Item not found");
+          
+          var action = "${args.action}";
+          
+          if (action === "create") {
+            item.createProxy("", 0);
+            return __result({ action: "create", item: item.name, status: "Proxy creation started" });
+          } else if (action === "attach") {
             ${args.proxy_path
-                    ? `item.attachProxy("${escapeForExtendScript(args.proxy_path)}", 0);
+                    ? `item.attachProxy("${escapeForExtendScript(args.proxy_path)}", 0);
                  return __result({ action: "attach", item: item.name, proxyPath: "${escapeForExtendScript(args.proxy_path)}" });`
-                    : `return __error("proxy_path is required for attach action");`}
-          } else if (action === "toggle") {
-            var hasP = false;
-            try { hasP = item.hasProxy(); } catch(e) {}
-            if (hasP) {
-              try { item.detachProxy(); } catch(e) {}
-              return __result({ action: "toggle", item: item.name, result: "proxy detached" });
-            } else {
-              return __result({ action: "toggle", item: item.name, result: "no proxy attached — use action='attach' with a proxy_path to add one" });
-            }
-          }
-          
-          return __error("Unknown proxy action: " + action);
+                    : `return __error("proxy_path is required for attach action");`}
+          } else if (action === "toggle") {
+            var hasP = false;
+            try { hasP = item.hasProxy(); } catch(e) {}
+            if (hasP) {
+              try { item.detachProxy(); } catch(e) {}
+              return __result({ action: "toggle", item: item.name, result: "proxy detached" });
+            } else {
+              return __result({ action: "toggle", item: item.name, result: "no proxy attached — use action='attach' with a proxy_path to add one" });
+            }
+          }
+          
+          return __error("Unknown proxy action: " + action);
         `);
                 return sendCommand(script, bridgeOptions);
             },

package/dist/tools/health.js

@@ -6,16 +6,16 @@ export function getHealthTools(bridgeOptions) {
             description: "Health check — verify the CEP plugin is running and connected to Premiere Pro. Call this before other tools to confirm connectivity.",
             parameters: {},
             handler: async () => {
-                const script = buildToolScript(`
-          var version = app.version;
-          var projectName = app.project && app.project.name ? app.project.name : "No project open";
-          var activeSeq = app.project && app.project.activeSequence ? app.project.activeSequence.name : "None";
-          return __result({
-            connected: true,
-            premiereVersion: version,
-            projectName: projectName,
-            activeSequence: activeSeq
-          });
+                const script = buildToolScript(`
+          var version = app.version;
+          var projectName = app.project && app.project.name ? app.project.name : "No project open";
+          var activeSeq = app.project && app.project.activeSequence ? app.project.activeSequence.name : "None";
+          return __result({
+            connected: true,
+            premiereVersion: version,
+            projectName: projectName,
+            activeSequence: activeSeq
+          });
         `);
                 return sendCommand(script, { ...bridgeOptions, timeoutMs: 5000 });
             },