@synthetic-ai/premiere-mcp 2.0.0

package/dist/tools/transitions.d.ts

@@ -0,0 +1,124 @@
+import { BridgeOptions } from "../bridge/file-bridge.js";
+export declare function getTransitionsTools(bridgeOptions: BridgeOptions): {
+    add_transition: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                transition_name: {
+                    type: string;
+                    description: string;
+                };
+                track_index: {
+                    type: string;
+                    description: string;
+                };
+                cut_point_seconds: {
+                    type: string;
+                    description: string;
+                };
+                duration_seconds: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            transition_name: string;
+            track_index: number;
+            cut_point_seconds: number;
+            duration_seconds?: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    add_transition_to_clip: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+                transition_name: {
+                    type: string;
+                    description: string;
+                };
+                position: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                duration_seconds: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            node_id: string;
+            transition_name: string;
+            position?: string;
+            duration_seconds?: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    batch_add_transitions: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                transition_name: {
+                    type: string;
+                    description: string;
+                };
+                track_index: {
+                    type: string;
+                    description: string;
+                };
+                duration_seconds: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            transition_name: string;
+            track_index?: number;
+            duration_seconds?: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    list_available_transitions: {
+        description: string;
+        parameters: {};
+        handler: () => Promise<{
+            success: boolean;
+            data: {
+                transitions: {
+                    name: string;
+                    category: string;
+                }[];
+                count: number;
+                note: string;
+            };
+        }>;
+    };
+    list_available_audio_transitions: {
+        description: string;
+        parameters: {};
+        handler: () => Promise<{
+            success: boolean;
+            data: {
+                transitions: {
+                    name: string;
+                    category: string;
+                    description: string;
+                }[];
+                count: number;
+                note: string;
+            };
+        }>;
+    };
+};
+//# sourceMappingURL=transitions.d.ts.map

package/dist/tools/transitions.js

@@ -0,0 +1,267 @@
+import { buildToolScript, escapeForExtendScript } from "../bridge/script-builder.js";
+import { sendCommand } from "../bridge/file-bridge.js";
+export function getTransitionsTools(bridgeOptions) {
+    return {
+        add_transition: {
+            description: "Add a video transition between two clips at a cut point. Uses QE DOM.",
+            parameters: {
+                type: "object",
+                properties: {
+                    transition_name: {
+                        type: "string",
+                        description: "Name of the transition (e.g., 'Cross Dissolve', 'Dip to Black')",
+                    },
+                    track_index: {
+                        type: "number",
+                        description: "Video track index (0-based)",
+                    },
+                    cut_point_seconds: {
+                        type: "number",
+                        description: "Time position in seconds of the cut point where the transition should be placed",
+                    },
+                    duration_seconds: {
+                        type: "number",
+                        description: "Duration of the transition in seconds (default: 1.0)",
+                    },
+                },
+                required: ["transition_name", "track_index", "cut_point_seconds"],
+            },
+            handler: async (args) => {
+                const duration = args.duration_seconds ?? 1.0;
+                const script = buildToolScript(`
+          app.enableQE();
+          var qeSeq = qe.project.getActiveSequence();
+          if (!qeSeq) return __error("No active sequence (QE)");
+          
+          var qeTrack = qeSeq.getVideoTrackAt(${args.track_index});
+          if (!qeTrack) return __error("Track not found");
+
+          var transitionName = "${escapeForExtendScript(args.transition_name)}";
+          var transitionQE = __findTransition(transitionName, "video");
+          if (!transitionQE) return __error("Transition not found: " + transitionName + " (tried English name and localized aliases)");
+
+          // Resolve the cut point to a clip index on the DOM track. addTransition is a
+          // method of the QE CLIP (getItemAt), NOT the QE track. The clip determines the
+          // position, so there is no cut-position argument; duration is a SECONDS string.
+          var domSeq = app.project.activeSequence;
+          if (!domSeq) return __error("No active sequence");
+          var domTrack = domSeq.videoTracks[${args.track_index}];
+          if (!domTrack) return __error("DOM video track not found at index ${args.track_index}");
+          var cutSec = ${args.cut_point_seconds};
+          var clipIdx = -1;
+          var bestDiff = null;
+          for (var c = 0; c < domTrack.clips.numItems; c++) {
+            var endSec = __ticksToSeconds(domTrack.clips[c].end.ticks);
+            var startSec = __ticksToSeconds(domTrack.clips[c].start.ticks);
+            var d = Math.min(Math.abs(endSec - cutSec), Math.abs(startSec - cutSec));
+            if (bestDiff === null || d < bestDiff) { bestDiff = d; clipIdx = c; }
+          }
+          if (clipIdx < 0) return __error("No clip found near cut point " + cutSec + "s");
+
+          var qeClip = qeTrack.getItemAt(clipIdx);
+          if (!qeClip) return __error("QE clip not found at index " + clipIdx);
+          qeClip.addTransition(transitionQE, true, String(${duration}));
+
+          return __result({
+            added: true,
+            transition: transitionName,
+            trackIndex: ${args.track_index},
+            clipIndex: clipIdx,
+            atSeconds: ${args.cut_point_seconds},
+            durationSeconds: ${duration}
+          });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        add_transition_to_clip: {
+            description: "Add a transition to a specific clip's start or end",
+            parameters: {
+                type: "object",
+                properties: {
+                    node_id: {
+                        type: "string",
+                        description: "Node ID of the clip",
+                    },
+                    transition_name: {
+                        type: "string",
+                        description: "Name of the transition",
+                    },
+                    position: {
+                        type: "string",
+                        enum: ["start", "end", "both"],
+                        description: "Where to apply the transition (default: end)",
+                    },
+                    duration_seconds: {
+                        type: "number",
+                        description: "Duration of the transition in seconds (default: 1.0)",
+                    },
+                },
+                required: ["node_id", "transition_name"],
+            },
+            handler: async (args) => {
+                const position = args.position || "end";
+                const duration = args.duration_seconds ?? 1.0;
+                const script = buildToolScript(`
+          app.enableQE();
+          var qeSeq = qe.project.getActiveSequence();
+          if (!qeSeq) return __error("No active sequence (QE)");
+          
+          var result = __findClip("${escapeForExtendScript(args.node_id)}");
+          if (!result) return __error("Clip not found");
+
+          var transitionName = "${escapeForExtendScript(args.transition_name)}";
+          var transitionQE = __findTransition(transitionName, "video");
+          if (!transitionQE) return __error("Transition not found: " + transitionName + " (tried English name and localized aliases)");
+
+          var qeTrack = qeSeq.getVideoTrackAt(result.trackIndex);
+          var clip = result.clip;
+          var transitionPosition = "${position}";
+
+          // addTransition is a QE CLIP method. forceSingle/applyToEnd boolean selects
+          // head (false) vs tail (true); duration is a SECONDS string. No position arg.
+          var qeClip = qeTrack.getItemAt(result.clipIndex);
+          if (!qeClip) return __error("QE clip not found at index " + result.clipIndex);
+
+          if (transitionPosition === "start" || transitionPosition === "both") {
+            qeClip.addTransition(transitionQE, false, String(${duration}));
+          }
+          if (transitionPosition === "end" || transitionPosition === "both") {
+            qeClip.addTransition(transitionQE, true, String(${duration}));
+          }
+
+          return __result({
+            added: true,
+            transition: transitionName,
+            clipName: clip.name,
+            position: transitionPosition,
+            durationSeconds: ${duration}
+          });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        batch_add_transitions: {
+            description: "Add the same transition to all cut points on a track",
+            parameters: {
+                type: "object",
+                properties: {
+                    transition_name: {
+                        type: "string",
+                        description: "Name of the transition (e.g., 'Cross Dissolve')",
+                    },
+                    track_index: {
+                        type: "number",
+                        description: "Video track index (0-based, default: 0)",
+                    },
+                    duration_seconds: {
+                        type: "number",
+                        description: "Duration of each transition in seconds (default: 1.0)",
+                    },
+                },
+                required: ["transition_name"],
+            },
+            handler: async (args) => {
+                const trackIndex = args.track_index ?? 0;
+                const duration = args.duration_seconds ?? 1.0;
+                const script = buildToolScript(`
+          app.enableQE();
+          var qeSeq = qe.project.getActiveSequence();
+          if (!qeSeq) return __error("No active sequence (QE)");
+          
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
+          var transitionName = "${escapeForExtendScript(args.transition_name)}";
+          var transitionQE = __findTransition(transitionName, "video");
+          if (!transitionQE) return __error("Transition not found: " + transitionName + " (tried English name and localized aliases)");
+
+          var track = seq.videoTracks[${trackIndex}];
+          var qeTrack = qeSeq.getVideoTrackAt(${trackIndex});
+          var count = 0;
+
+          // addTransition is a QE CLIP method (getItemAt), not a track method. Apply to
+          // the tail of each clip except the last; duration is a SECONDS string.
+          for (var c = 0; c < track.clips.numItems - 1; c++) {
+            try {
+              var qeClip = qeTrack.getItemAt(c);
+              if (qeClip) {
+                qeClip.addTransition(transitionQE, true, String(${duration}));
+                count++;
+              }
+            } catch(e) {}
+          }
+          
+          return __result({
+            added: count,
+            transition: transitionName,
+            trackIndex: ${trackIndex},
+            durationSeconds: ${duration}
+          });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        list_available_transitions: {
+            description: "List all available video transitions in Premiere Pro.",
+            parameters: {},
+            handler: async () => {
+                const transitions = [
+                    // Dissolve
+                    { name: "Cross Dissolve", category: "Dissolve" },
+                    { name: "Dip to Black", category: "Dissolve" },
+                    { name: "Dip to White", category: "Dissolve" },
+                    { name: "Film Dissolve", category: "Dissolve" },
+                    { name: "Additive Dissolve", category: "Dissolve" },
+                    { name: "Non-Additive Dissolve", category: "Dissolve" },
+                    { name: "Morph Cut", category: "Dissolve" },
+                    // Wipe
+                    { name: "Clock Wipe", category: "Wipe" },
+                    { name: "Inset", category: "Wipe" },
+                    { name: "Paint Splatter", category: "Wipe" },
+                    { name: "Pinwheel", category: "Wipe" },
+                    { name: "Radial Wipe", category: "Wipe" },
+                    { name: "Spiral Boxes", category: "Wipe" },
+                    { name: "Venetian Blinds", category: "Wipe" },
+                    { name: "Wedge Wipe", category: "Wipe" },
+                    { name: "Wipe", category: "Wipe" },
+                    { name: "Zig-Zag Blocks", category: "Wipe" },
+                    // Slide
+                    { name: "Center Split", category: "Slide" },
+                    { name: "Multi-Spin", category: "Slide" },
+                    { name: "Push", category: "Slide" },
+                    { name: "Slide", category: "Slide" },
+                    { name: "Split", category: "Slide" },
+                    { name: "Swap", category: "Slide" },
+                    // Zoom
+                    { name: "Cross Zoom", category: "Zoom" },
+                    // 3D Motion
+                    { name: "Cube Spin", category: "3D Motion" },
+                    { name: "Curtain", category: "3D Motion" },
+                    { name: "Doors", category: "3D Motion" },
+                    { name: "Flip Over", category: "3D Motion" },
+                    { name: "Fold Up", category: "3D Motion" },
+                    { name: "Spin", category: "3D Motion" },
+                    { name: "Spin Away", category: "3D Motion" },
+                    { name: "Swing In", category: "3D Motion" },
+                    { name: "Swing Out", category: "3D Motion" },
+                    { name: "Tumble Away", category: "3D Motion" },
+                ];
+                return { success: true, data: { transitions, count: transitions.length, note: "Static list of common Premiere Pro video transitions. Use add_transition with these exact names." } };
+            },
+        },
+        list_available_audio_transitions: {
+            description: "List all available audio transitions in Premiere Pro.",
+            parameters: {},
+            handler: async () => {
+                const transitions = [
+                    { name: "Constant Gain", category: "Crossfade", description: "Crossfade using constant gain curve" },
+                    { name: "Constant Power", category: "Crossfade", description: "Crossfade using constant power (equal loudness) - default" },
+                    { name: "Exponential Fade", category: "Crossfade", description: "Exponential fade curve" },
+                ];
+                return { success: true, data: { transitions, count: transitions.length, note: "Premiere Pro has 3 audio transitions. 'Constant Power' is the recommended default for music crossfades." } };
+            },
+        },
+    };
+}
+//# sourceMappingURL=transitions.js.map