@synthetic-ai/premiere-mcp 2.0.0

package/dist/tools/tracks.d.ts

@@ -0,0 +1,90 @@
+import { BridgeOptions } from "../bridge/file-bridge.js";
+export declare function getTrackTools(bridgeOptions: BridgeOptions): {
+    add_track: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                track_type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                count: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            track_type: string;
+            count?: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    delete_track: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                track_type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                track_index: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            track_type: string;
+            track_index: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    lock_track: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                track_index: {
+                    type: string;
+                    description: string;
+                };
+                locked: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            track_index: number;
+            locked: boolean;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    toggle_track_visibility: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                track_index: {
+                    type: string;
+                    description: string;
+                };
+                visible: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            track_index: number;
+            visible: boolean;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+};
+//# sourceMappingURL=tracks.d.ts.map

package/dist/tools/tracks.js

@@ -0,0 +1,183 @@
+import { buildToolScript } from "../bridge/script-builder.js";
+import { sendCommand } from "../bridge/file-bridge.js";
+export function getTrackTools(bridgeOptions) {
+    return {
+        add_track: {
+            description: "Add a new video or audio track to the active sequence",
+            parameters: {
+                type: "object",
+                properties: {
+                    track_type: {
+                        type: "string",
+                        enum: ["video", "audio"],
+                        description: "Type of track to add",
+                    },
+                    count: {
+                        type: "number",
+                        description: "Number of tracks to add (default: 1)",
+                    },
+                },
+                required: ["track_type"],
+            },
+            handler: async (args) => {
+                const count = args.count ?? 1;
+                const isVideo = args.track_type === "video";
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+
+          // PP 2026: neither seq.addTrack(), seq.insertVideoTrackAt(), nor
+          // qe.getActiveSequence().addVideoTrack() are available via ExtendScript.
+          // The only way to add tracks in PP 2026 is via the UI or by creating a
+          // new sequence with the desired track count.
+          // We attempt both known approaches and report the result.
+          app.enableQE();
+          var beforeCount = ${isVideo ? "seq.videoTracks.numTracks" : "seq.audioTracks.numTracks"};
+          var added = false;
+
+          // Attempt 1: seq.addTrack() (pre-PP2026 API)
+          try { if (seq.addTrack) { for (var i = 0; i < ${count}; i++) seq.addTrack("${args.track_type}"${!isVideo ? ", 1" : ""}); added = true; } } catch(e) {}
+
+          // Attempt 2: QE DOM addVideoTrack/addAudioTrack
+          if (!added) {
+            try {
+              var qs = qe.project.getActiveSequence();
+              if (qs) {
+                for (var j = 0; j < ${count}; j++) {
+                  ${isVideo ? "qs.addVideoTrack();" : "qs.addAudioTrack(0);"}
+                }
+                added = true;
+              }
+            } catch(e2) {}
+          }
+
+          var afterCount = ${isVideo ? "seq.videoTracks.numTracks" : "seq.audioTracks.numTracks"};
+          var actualAdded = afterCount - beforeCount;
+          if (actualAdded === 0) {
+            return __error("Adding ${args.track_type} tracks is not supported via ExtendScript in PP 2026. Use Sequence > Add Tracks in the UI, or create a new sequence with the needed track count.");
+          }
+          return __result({ added: actualAdded, trackType: "${args.track_type}", totalTracks: afterCount });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        delete_track: {
+            description: "Delete a video or audio track from the active sequence",
+            parameters: {
+                type: "object",
+                properties: {
+                    track_type: {
+                        type: "string",
+                        enum: ["video", "audio"],
+                        description: "Type of track to delete",
+                    },
+                    track_index: {
+                        type: "number",
+                        description: "Index of the track to delete (0-based)",
+                    },
+                },
+                required: ["track_type", "track_index"],
+            },
+            handler: async (args) => {
+                const isVideo = args.track_type === "video";
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+
+          var numTracks = ${isVideo ? "seq.videoTracks.numTracks" : "seq.audioTracks.numTracks"};
+          if (${args.track_index} >= numTracks) return __error("Track index out of range: " + ${args.track_index} + " >= " + numTracks);
+
+          // PP 2026: seq.deleteVideoTrackAt/deleteAudioTrackAt do NOT exist.
+          // Use QE DOM: qe.project.getActiveSequence().removeVideoTrack() / removeAudioTrack()
+          // QE DOM may be unavailable/unstable across PP versions, so guard everything.
+          try {
+            app.enableQE();
+          } catch (eEnable) {
+            return __error("Track deletion is not supported via ExtendScript in this Premiere Pro version (QE DOM unavailable: " + eEnable.toString() + "). Please delete the track manually in the Premiere Pro UI.");
+          }
+
+          var qs = null;
+          try {
+            qs = qe.project.getActiveSequence();
+          } catch (eGet) {
+            qs = null;
+          }
+          if (!qs) return __error("Track deletion is not supported via ExtendScript in this Premiere Pro version (QE sequence not found). Please delete the track manually in the Premiere Pro UI.");
+
+          try {
+            ${isVideo ? `qs.removeVideoTrack(${args.track_index});` : `qs.removeAudioTrack(${args.track_index});`}
+          } catch (eRemove) {
+            return __error("Track deletion failed via ExtendScript in this Premiere Pro version (QE remove" + ("${args.track_type}" === "video" ? "Video" : "Audio") + "Track threw: " + eRemove.toString() + "). Tracks cannot be reliably deleted via ExtendScript here — please delete the track manually in the Premiere Pro UI.");
+          }
+
+          var newCount = ${isVideo ? "seq.videoTracks.numTracks" : "seq.audioTracks.numTracks"};
+          return __result({ deleted: true, trackType: "${args.track_type}", trackIndex: ${args.track_index}, trackCount: newCount });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        lock_track: {
+            description: "Lock or unlock a video track",
+            parameters: {
+                type: "object",
+                properties: {
+                    track_index: {
+                        type: "number",
+                        description: "Video track index (0-based)",
+                    },
+                    locked: {
+                        type: "boolean",
+                        description: "True to lock, false to unlock",
+                    },
+                },
+                required: ["track_index", "locked"],
+            },
+            handler: async (args) => {
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
+          if (${args.track_index} >= seq.videoTracks.numTracks) return __error("Track index out of range");
+          
+          var track = seq.videoTracks[${args.track_index}];
+          track.setLocked(${args.locked ? 1 : 0});
+          
+          return __result({ trackIndex: ${args.track_index}, locked: ${args.locked}, trackName: track.name });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        toggle_track_visibility: {
+            description: "Toggle a video track's visibility (eye icon)",
+            parameters: {
+                type: "object",
+                properties: {
+                    track_index: {
+                        type: "number",
+                        description: "Video track index (0-based)",
+                    },
+                    visible: {
+                        type: "boolean",
+                        description: "True to show, false to hide",
+                    },
+                },
+                required: ["track_index", "visible"],
+            },
+            handler: async (args) => {
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
+          if (${args.track_index} >= seq.videoTracks.numTracks) return __error("Track index out of range");
+          
+          var track = seq.videoTracks[${args.track_index}];
+          track.setMute(${args.visible ? 0 : 1});
+          
+          return __result({ trackIndex: ${args.track_index}, visible: ${args.visible}, trackName: track.name });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+    };
+}
+//# sourceMappingURL=tracks.js.map