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

package/dist/tools/project.js

@@ -6,11 +6,11 @@ export function getProjectTools(bridgeOptions) {
             description: "Save the current Premiere Pro project",
             parameters: {},
             handler: async () => {
-                const script = buildToolScript(`
-          var project = app.project;
-          if (!project) return __error("No project is open");
-          project.save();
-          return __result({ saved: true, name: project.name, path: project.path });
+                const script = buildToolScript(`
+          var project = app.project;
+          if (!project) return __error("No project is open");
+          project.save();
+          return __result({ saved: true, name: project.name, path: project.path });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -28,11 +28,11 @@ export function getProjectTools(bridgeOptions) {
                 required: ["path"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var project = app.project;
-          if (!project) return __error("No project is open");
-          project.saveAs("${escapeForExtendScript(args.path)}");
-          return __result({ saved: true, path: "${escapeForExtendScript(args.path)}" });
+                const script = buildToolScript(`
+          var project = app.project;
+          if (!project) return __error("No project is open");
+          project.saveAs("${escapeForExtendScript(args.path)}");
+          return __result({ saved: true, path: "${escapeForExtendScript(args.path)}" });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -50,10 +50,10 @@ export function getProjectTools(bridgeOptions) {
                 required: ["path"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          app.openDocument("${escapeForExtendScript(args.path)}");
-          var project = app.project;
-          return __result({ opened: true, name: project.name, path: project.path });
+                const script = buildToolScript(`
+          app.openDocument("${escapeForExtendScript(args.path)}");
+          var project = app.project;
+          return __result({ opened: true, name: project.name, path: project.path });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -71,11 +71,11 @@ export function getProjectTools(bridgeOptions) {
                 required: ["sequence_id"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var seq = __findSequence("${escapeForExtendScript(args.sequence_id)}");
-          if (!seq) return __error("Sequence not found: ${escapeForExtendScript(args.sequence_id)}");
-          app.project.activeSequence = seq;
-          return __result({ active: true, name: seq.name, id: seq.sequenceID });
+                const script = buildToolScript(`
+          var seq = __findSequence("${escapeForExtendScript(args.sequence_id)}");
+          if (!seq) return __error("Sequence not found: ${escapeForExtendScript(args.sequence_id)}");
+          app.project.activeSequence = seq;
+          return __result({ active: true, name: seq.name, id: seq.sequenceID });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -93,14 +93,14 @@ export function getProjectTools(bridgeOptions) {
             },
             handler: async (args) => {
                 const count = args.count || 1;
-                const script = buildToolScript(`
-          // undo is a QE-DOM operation, not on the Project DOM in most PP builds.
-          app.enableQE();
-          for (var i = 0; i < ${count}; i++) {
-            if (qe && qe.project && qe.project.undo) { qe.project.undo(); }
-            else if (app.project.undo) { app.project.undo(); }
-          }
-          return __result({ undone: ${count} });
+                const script = buildToolScript(`
+          // undo is a QE-DOM operation, not on the Project DOM in most PP builds.
+          app.enableQE();
+          for (var i = 0; i < ${count}; i++) {
+            if (qe && qe.project && qe.project.undo) { qe.project.undo(); }
+            else if (app.project.undo) { app.project.undo(); }
+          }
+          return __result({ undone: ${count} });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -109,9 +109,9 @@ export function getProjectTools(bridgeOptions) {
             description: "Consolidate duplicate project items",
             parameters: {},
             handler: async () => {
-                const script = buildToolScript(`
-          app.project.consolidateDuplicates();
-          return __result({ consolidated: true });
+                const script = buildToolScript(`
+          app.project.consolidateDuplicates();
+          return __result({ consolidated: true });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -129,11 +129,11 @@ export function getProjectTools(bridgeOptions) {
                 required: ["path"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          app.newProject("${escapeForExtendScript(args.path)}");
-          var project = app.project;
-          if (!project) return __error("Failed to create project");
-          return __result({ created: true, name: project.name, path: project.path });
+                const script = buildToolScript(`
+          app.newProject("${escapeForExtendScript(args.path)}");
+          var project = app.project;
+          if (!project) return __error("Failed to create project");
+          return __result({ created: true, name: project.name, path: project.path });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -154,17 +154,17 @@ export function getProjectTools(bridgeOptions) {
                 // We always suppress the interactive prompt (promptUser = 0) since this runs
                 // headless via the bridge; the saveFirst flag is what actually controls intent.
                 const save = args.save_first !== false;
-                const script = buildToolScript(`
-          var project = app.project;
-          if (!project) return __error("No project is open");
-          var name = project.name;
-          try {
-            // saveFirst: ${save ? "1 (save)" : "0 (do not save)"}, promptUserIfDirty: 0 (suppressed)
-            project.closeDocument(${save ? "1" : "0"}, 0);
-          } catch (e) {
-            return __error("Failed to close project: " + e.toString());
-          }
-          return __result({ closed: true, name: name, saved: ${save} });
+                const script = buildToolScript(`
+          var project = app.project;
+          if (!project) return __error("No project is open");
+          var name = project.name;
+          try {
+            // saveFirst: ${save ? "1 (save)" : "0 (do not save)"}, promptUserIfDirty: 0 (suppressed)
+            project.closeDocument(${save ? "1" : "0"}, 0);
+          } catch (e) {
+            return __error("Failed to close project: " + e.toString());
+          }
+          return __result({ closed: true, name: name, saved: ${save} });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -195,18 +195,18 @@ export function getProjectTools(bridgeOptions) {
                     : `var targetBin = app.project.rootItem;`;
                 if (args.comp_names && args.comp_names.length > 0) {
                     const comps = args.comp_names.map(c => `"${escapeForExtendScript(c)}"`).join(", ");
-                    const script = buildToolScript(`
-            ${binLookup}
-            app.project.importAEComps("${escapeForExtendScript(args.ae_project_path)}", [${comps}], targetBin);
-            return __result({ imported: true, comps: [${comps}] });
+                    const script = buildToolScript(`
+            ${binLookup}
+            app.project.importAEComps("${escapeForExtendScript(args.ae_project_path)}", [${comps}], targetBin);
+            return __result({ imported: true, comps: [${comps}] });
           `);
                     return sendCommand(script, bridgeOptions);
                 }
                 else {
-                    const script = buildToolScript(`
-            ${binLookup}
-            app.project.importAllAEComps("${escapeForExtendScript(args.ae_project_path)}", targetBin);
-            return __result({ imported: true, allComps: true });
+                    const script = buildToolScript(`
+            ${binLookup}
+            app.project.importAllAEComps("${escapeForExtendScript(args.ae_project_path)}", targetBin);
+            return __result({ imported: true, allComps: true });
           `);
                     return sendCommand(script, bridgeOptions);
                 }
@@ -225,13 +225,13 @@ export function getProjectTools(bridgeOptions) {
                 required: ["bin_id"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var bin = __findProjectItem("${escapeForExtendScript(args.bin_id)}");
-          if (!bin) return __error("Bin not found: ${escapeForExtendScript(args.bin_id)}");
-          if (bin.type !== 2) return __error("Item is not a bin");
-          var name = bin.name;
-          bin.deleteBin();
-          return __result({ deleted: true, name: name });
+                const script = buildToolScript(`
+          var bin = __findProjectItem("${escapeForExtendScript(args.bin_id)}");
+          if (!bin) return __error("Bin not found: ${escapeForExtendScript(args.bin_id)}");
+          if (bin.type !== 2) return __error("Item is not a bin");
+          var name = bin.name;
+          bin.deleteBin();
+          return __result({ deleted: true, name: name });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -253,13 +253,13 @@ export function getProjectTools(bridgeOptions) {
                 required: ["bin_id", "new_name"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var bin = __findProjectItem("${escapeForExtendScript(args.bin_id)}");
-          if (!bin) return __error("Bin not found: ${escapeForExtendScript(args.bin_id)}");
-          if (bin.type !== 2) return __error("Item is not a bin");
-          var oldName = bin.name;
-          bin.renameBin("${escapeForExtendScript(args.new_name)}");
-          return __result({ renamed: true, oldName: oldName, newName: "${escapeForExtendScript(args.new_name)}" });
+                const script = buildToolScript(`
+          var bin = __findProjectItem("${escapeForExtendScript(args.bin_id)}");
+          if (!bin) return __error("Bin not found: ${escapeForExtendScript(args.bin_id)}");
+          if (bin.type !== 2) return __error("Item is not a bin");
+          var oldName = bin.name;
+          bin.renameBin("${escapeForExtendScript(args.new_name)}");
+          return __result({ renamed: true, oldName: oldName, newName: "${escapeForExtendScript(args.new_name)}" });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -281,9 +281,9 @@ export function getProjectTools(bridgeOptions) {
                 required: ["name", "query"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          app.project.rootItem.createSmartBin("${escapeForExtendScript(args.name)}", "${escapeForExtendScript(args.query)}");
-          return __result({ created: true, name: "${escapeForExtendScript(args.name)}", query: "${escapeForExtendScript(args.query)}" });
+                const script = buildToolScript(`
+          app.project.rootItem.createSmartBin("${escapeForExtendScript(args.name)}", "${escapeForExtendScript(args.query)}");
+          return __result({ created: true, name: "${escapeForExtendScript(args.name)}", query: "${escapeForExtendScript(args.query)}" });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -301,20 +301,20 @@ export function getProjectTools(bridgeOptions) {
                 required: ["path_search"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var root = app.project.rootItem;
-          var matches = root.findItemsMatchingMediaPath("${escapeForExtendScript(args.path_search)}");
-          var items = [];
-          if (matches) {
-            for (var i = 0; i < matches.length; i++) {
-              items.push({
-                nodeId: matches[i].nodeId,
-                name: matches[i].name,
-                type: matches[i].type === 1 ? "clip" : matches[i].type === 2 ? "bin" : "sequence"
-              });
-            }
-          }
-          return __result({ count: items.length, items: items });
+                const script = buildToolScript(`
+          var root = app.project.rootItem;
+          var matches = root.findItemsMatchingMediaPath("${escapeForExtendScript(args.path_search)}");
+          var items = [];
+          if (matches) {
+            for (var i = 0; i < matches.length; i++) {
+              items.push({
+                nodeId: matches[i].nodeId,
+                name: matches[i].name,
+                type: matches[i].type === 1 ? "clip" : matches[i].type === 2 ? "bin" : "sequence"
+              });
+            }
+          }
+          return __result({ count: items.length, items: items });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -323,9 +323,9 @@ export function getProjectTools(bridgeOptions) {
             description: "Start encoding all items in the Adobe Media Encoder render queue",
             parameters: {},
             handler: async () => {
-                const script = buildToolScript(`
-          app.encoder.startBatch();
-          return __result({ started: true });
+                const script = buildToolScript(`
+          app.encoder.startBatch();
+          return __result({ started: true });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -351,9 +351,9 @@ export function getProjectTools(bridgeOptions) {
                 required: ["field_name", "field_label", "field_type"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          app.project.addPropertyToProjectMetadataSchema("${escapeForExtendScript(args.field_name)}", "${escapeForExtendScript(args.field_label)}", ${args.field_type});
-          return __result({ added: true, name: "${escapeForExtendScript(args.field_name)}", label: "${escapeForExtendScript(args.field_label)}" });
+                const script = buildToolScript(`
+          app.project.addPropertyToProjectMetadataSchema("${escapeForExtendScript(args.field_name)}", "${escapeForExtendScript(args.field_label)}", ${args.field_type});
+          return __result({ added: true, name: "${escapeForExtendScript(args.field_name)}", label: "${escapeForExtendScript(args.field_label)}" });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -377,16 +377,16 @@ export function getProjectTools(bridgeOptions) {
             handler: async (args) => {
                 if (args.sequence_ids && args.sequence_ids.length > 0) {
                     const ids = args.sequence_ids.map(id => `"${escapeForExtendScript(id)}"`).join(", ");
-                    const script = buildToolScript(`
-            app.project.importSequences("${escapeForExtendScript(args.project_path)}", [${ids}]);
-            return __result({ imported: true, sequenceIds: [${ids}] });
+                    const script = buildToolScript(`
+            app.project.importSequences("${escapeForExtendScript(args.project_path)}", [${ids}]);
+            return __result({ imported: true, sequenceIds: [${ids}] });
           `);
                     return sendCommand(script, bridgeOptions);
                 }
                 else {
-                    const script = buildToolScript(`
-            app.project.importSequences("${escapeForExtendScript(args.project_path)}");
-            return __result({ imported: true, allSequences: true });
+                    const script = buildToolScript(`
+            app.project.importSequences("${escapeForExtendScript(args.project_path)}");
+            return __result({ imported: true, allSequences: true });
           `);
                     return sendCommand(script, bridgeOptions);
                 }
@@ -422,32 +422,32 @@ export function getProjectTools(bridgeOptions) {
                 const explicitTimebase = args.timebase
                     ? `"${escapeForExtendScript(args.timebase)}"`
                     : "null";
-                const script = buildToolScript(`
-          try {
-            var explicitTimebase = ${explicitTimebase};
-            var timebase = explicitTimebase;
-            if (timebase === null) {
-              // Derive timebase from the active sequence, then any existing sequence,
-              // falling back to the standard TICKS_PER_SECOND default only if nothing
-              // else is available.
-              var seq = app.project.activeSequence;
-              if (seq && seq.timebase) {
-                timebase = String(seq.timebase);
-              } else if (app.project.sequences && app.project.sequences.numSequences > 0) {
-                var firstSeq = app.project.sequences[0];
-                if (firstSeq && firstSeq.timebase) {
-                  timebase = String(firstSeq.timebase);
-                }
-              }
-              if (timebase === null) {
-                timebase = String(TICKS_PER_SECOND);
-              }
-            }
-            app.project.newBarsAndTone(${w}, ${h}, timebase, "${escapeForExtendScript(name)}");
-            return __result({ created: true, name: "${escapeForExtendScript(name)}", width: ${w}, height: ${h}, timebase: timebase });
-          } catch (e) {
-            return __error("Failed to create bars and tone: " + e.toString());
-          }
+                const script = buildToolScript(`
+          try {
+            var explicitTimebase = ${explicitTimebase};
+            var timebase = explicitTimebase;
+            if (timebase === null) {
+              // Derive timebase from the active sequence, then any existing sequence,
+              // falling back to the standard TICKS_PER_SECOND default only if nothing
+              // else is available.
+              var seq = app.project.activeSequence;
+              if (seq && seq.timebase) {
+                timebase = String(seq.timebase);
+              } else if (app.project.sequences && app.project.sequences.numSequences > 0) {
+                var firstSeq = app.project.sequences[0];
+                if (firstSeq && firstSeq.timebase) {
+                  timebase = String(firstSeq.timebase);
+                }
+              }
+              if (timebase === null) {
+                timebase = String(TICKS_PER_SECOND);
+              }
+            }
+            app.project.newBarsAndTone(${w}, ${h}, timebase, "${escapeForExtendScript(name)}");
+            return __result({ created: true, name: "${escapeForExtendScript(name)}", width: ${w}, height: ${h}, timebase: timebase });
+          } catch (e) {
+            return __error("Failed to create bars and tone: " + e.toString());
+          }
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -465,9 +465,9 @@ export function getProjectTools(bridgeOptions) {
                 required: ["path"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          app.openFCPXML("${escapeForExtendScript(args.path)}");
-          return __result({ imported: true, path: "${escapeForExtendScript(args.path)}" });
+                const script = buildToolScript(`
+          app.openFCPXML("${escapeForExtendScript(args.path)}");
+          return __result({ imported: true, path: "${escapeForExtendScript(args.path)}" });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -485,9 +485,9 @@ export function getProjectTools(bridgeOptions) {
                 required: ["enabled"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          app.project.setEnableTranscodeOnIngest(${args.enabled ? 1 : 0});
-          return __result({ set: true, transcodeOnIngest: ${args.enabled} });
+                const script = buildToolScript(`
+          app.project.setEnableTranscodeOnIngest(${args.enabled ? 1 : 0});
+          return __result({ set: true, transcodeOnIngest: ${args.enabled} });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -496,10 +496,10 @@ export function getProjectTools(bridgeOptions) {
             description: "Get the current target bin for new imports (the bin that is currently focused in the Project panel)",
             parameters: {},
             handler: async () => {
-                const script = buildToolScript(`
-          var bin = app.project.getInsertionBin();
-          if (!bin) return __error("No insertion bin found");
-          return __result({ name: bin.name, nodeId: bin.nodeId, treePath: bin.treePath });
+                const script = buildToolScript(`
+          var bin = app.project.getInsertionBin();
+          if (!bin) return __error("No insertion bin found");
+          return __result({ name: bin.name, nodeId: bin.nodeId, treePath: bin.treePath });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -508,10 +508,10 @@ export function getProjectTools(bridgeOptions) {
             description: "Get the current project panel metadata/column configuration as XML",
             parameters: {},
             handler: async () => {
-                const script = buildToolScript(`
-          var meta = app.project.getProjectPanelMetadata();
-          if (!meta) return __error("Could not retrieve project panel metadata");
-          return __result({ metadata: meta });
+                const script = buildToolScript(`
+          var meta = app.project.getProjectPanelMetadata();
+          if (!meta) return __error("Could not retrieve project panel metadata");
+          return __result({ metadata: meta });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -529,9 +529,9 @@ export function getProjectTools(bridgeOptions) {
                 required: ["metadata_xml"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          app.project.setProjectPanelMetadata("${escapeForExtendScript(args.metadata_xml)}");
-          return __result({ set: true });
+                const script = buildToolScript(`
+          app.project.setProjectPanelMetadata("${escapeForExtendScript(args.metadata_xml)}");
+          return __result({ set: true });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -540,9 +540,9 @@ export function getProjectTools(bridgeOptions) {
             description: "Get the graphics white luminance value (HDR setting) for the project",
             parameters: {},
             handler: async () => {
-                const script = buildToolScript(`
-          var val = app.project.getGraphicsWhiteLuminance();
-          return __result({ graphicsWhiteLuminance: val });
+                const script = buildToolScript(`
+          var val = app.project.getGraphicsWhiteLuminance();
+          return __result({ graphicsWhiteLuminance: val });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -560,9 +560,9 @@ export function getProjectTools(bridgeOptions) {
                 required: ["luminance"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          app.project.setGraphicsWhiteLuminance(${args.luminance});
-          return __result({ set: true, graphicsWhiteLuminance: ${args.luminance} });
+                const script = buildToolScript(`
+          app.project.setGraphicsWhiteLuminance(${args.luminance});
+          return __result({ set: true, graphicsWhiteLuminance: ${args.luminance} });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -584,9 +584,9 @@ export function getProjectTools(bridgeOptions) {
                 required: ["scratch_disk_type", "path"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          app.setScratchDiskPath("${escapeForExtendScript(args.path)}", "${escapeForExtendScript(args.scratch_disk_type)}");
-          return __result({ set: true, type: "${escapeForExtendScript(args.scratch_disk_type)}", path: "${escapeForExtendScript(args.path)}" });
+                const script = buildToolScript(`
+          app.setScratchDiskPath("${escapeForExtendScript(args.path)}", "${escapeForExtendScript(args.scratch_disk_type)}");
+          return __result({ set: true, type: "${escapeForExtendScript(args.scratch_disk_type)}", path: "${escapeForExtendScript(args.path)}" });
         `);
                 return sendCommand(script, bridgeOptions);
             },