@synthetic-ai/premiere-mcp 2.0.0

package/dist/tools/source-monitor.js

@@ -0,0 +1,180 @@
+import { buildToolScript, escapeForExtendScript } from "../bridge/script-builder.js";
+import { sendCommand } from "../bridge/file-bridge.js";
+export function getSourceMonitorTools(bridgeOptions) {
+    return {
+        open_in_source: {
+            description: "Open a project item in the Source Monitor for preview and trimming.",
+            parameters: {
+                type: "object",
+                properties: {
+                    item_id: {
+                        type: "string",
+                        description: "Node ID or name of the project item to open",
+                    },
+                },
+                required: ["item_id"],
+            },
+            handler: async (args) => {
+                const script = buildToolScript(`
+          var item = __findProjectItem("${escapeForExtendScript(args.item_id)}");
+          if (!item) return __error("Project item not found");
+          app.sourceMonitor.openProjectItem(item);
+          return __result({ opened: true, item: item.name });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        close_source_monitor: {
+            description: "Close the clip currently open in the Source Monitor.",
+            parameters: {},
+            handler: async () => {
+                const script = buildToolScript(`
+          app.sourceMonitor.closeClip();
+          return __result({ closed: true });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        close_all_source_clips: {
+            description: "Close all clips in the Source Monitor.",
+            parameters: {},
+            handler: async () => {
+                const script = buildToolScript(`
+          app.sourceMonitor.closeAllClips();
+          return __result({ closed: true });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        set_source_in_out: {
+            description: "Set in and/or out points on the clip currently open in the Source Monitor.",
+            parameters: {
+                type: "object",
+                properties: {
+                    in_seconds: {
+                        type: "number",
+                        description: "In point in seconds (optional)",
+                    },
+                    out_seconds: {
+                        type: "number",
+                        description: "Out point in seconds (optional)",
+                    },
+                },
+            },
+            handler: async (args) => {
+                const script = buildToolScript(`
+          var item = app.sourceMonitor.getProjectItem();
+          if (!item) return __error("No clip open in Source Monitor");
+
+          ${args.in_seconds !== undefined ? `
+          var inTime = new Time();
+          inTime.seconds = ${args.in_seconds};
+          item.setInPoint(inTime.ticks, 4);
+          ` : ""}
+
+          ${args.out_seconds !== undefined ? `
+          var outTime = new Time();
+          outTime.seconds = ${args.out_seconds};
+          item.setOutPoint(outTime.ticks, 4);
+          ` : ""}
+
+          return __result({
+            item: item.name,
+            inSet: ${args.in_seconds !== undefined},
+            outSet: ${args.out_seconds !== undefined}
+          });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        insert_from_source: {
+            description: "Insert the clip from the Source Monitor at the playhead position (insert edit — shifts existing clips).",
+            parameters: {
+                type: "object",
+                properties: {
+                    video_track_index: {
+                        type: "number",
+                        description: "Target video track index (default: 0)",
+                    },
+                    audio_track_index: {
+                        type: "number",
+                        description: "Target audio track index (default: 0)",
+                    },
+                },
+            },
+            handler: async (args) => {
+                const vTrack = args.video_track_index ?? 0;
+                const aTrack = args.audio_track_index ?? 0;
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+
+          var item = app.sourceMonitor.getProjectItem();
+          if (!item) return __error("No clip open in Source Monitor");
+
+          var pos = seq.getPlayerPosition().ticks;
+          seq.insertClip(item, pos, ${vTrack}, ${aTrack});
+
+          return __result({ inserted: true, item: item.name, atSeconds: __ticksToSeconds(pos) });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        overwrite_from_source: {
+            description: "Overwrite the clip from the Source Monitor at the playhead position (overwrite edit — replaces existing clips).",
+            parameters: {
+                type: "object",
+                properties: {
+                    video_track_index: {
+                        type: "number",
+                        description: "Target video track index (default: 0)",
+                    },
+                    audio_track_index: {
+                        type: "number",
+                        description: "Target audio track index (default: 0)",
+                    },
+                },
+            },
+            handler: async (args) => {
+                const vTrack = args.video_track_index ?? 0;
+                const aTrack = args.audio_track_index ?? 0;
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+
+          var item = app.sourceMonitor.getProjectItem();
+          if (!item) return __error("No clip open in Source Monitor");
+
+          var pos = seq.getPlayerPosition().ticks;
+          seq.overwriteClip(item, pos, ${vTrack}, ${aTrack});
+
+          return __result({ overwritten: true, item: item.name, atSeconds: __ticksToSeconds(pos) });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        get_source_monitor_info: {
+            description: "Get information about the clip currently loaded in the Source Monitor.",
+            parameters: {},
+            handler: async () => {
+                const script = buildToolScript(`
+          var item = app.sourceMonitor.getProjectItem();
+          if (!item) return __result({ loaded: false });
+
+          var info = {
+            loaded: true,
+            nodeId: item.nodeId,
+            name: item.name
+          };
+          try { info.mediaPath = item.getMediaPath(); } catch(e) {}
+          try { info.inPoint = __ticksToSeconds(item.getInPoint().ticks); } catch(e) {}
+          try { info.outPoint = __ticksToSeconds(item.getOutPoint().ticks); } catch(e) {}
+
+          return __result(info);
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+    };
+}
+//# sourceMappingURL=source-monitor.js.map

package/dist/tools/text.d.ts

@@ -0,0 +1,97 @@
+import { BridgeOptions } from "../bridge/file-bridge.js";
+export declare function getTextTools(bridgeOptions: BridgeOptions): {
+    add_text_overlay: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                text: {
+                    type: string;
+                    description: string;
+                };
+                track_index: {
+                    type: string;
+                    description: string;
+                };
+                start_seconds: {
+                    type: string;
+                    description: string;
+                };
+                duration_seconds: {
+                    type: string;
+                    description: string;
+                };
+                font_size: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            text: string;
+            track_index?: number;
+            start_seconds?: number;
+            duration_seconds?: number;
+            font_size?: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    import_mogrt: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                mogrt_path: {
+                    type: string;
+                    description: string;
+                };
+                track_index: {
+                    type: string;
+                    description: string;
+                };
+                start_seconds: {
+                    type: string;
+                    description: string;
+                };
+                duration_seconds: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            mogrt_path: string;
+            track_index?: number;
+            start_seconds?: number;
+            duration_seconds?: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    import_mogrt_from_library: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                mogrt_name: {
+                    type: string;
+                    description: string;
+                };
+                track_index: {
+                    type: string;
+                    description: string;
+                };
+                start_seconds: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            mogrt_name: string;
+            track_index?: number;
+            start_seconds?: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+};
+//# sourceMappingURL=text.d.ts.map

package/dist/tools/text.js

@@ -0,0 +1,159 @@
+import { buildToolScript, escapeForExtendScript } from "../bridge/script-builder.js";
+import { sendCommand } from "../bridge/file-bridge.js";
+export function getTextTools(bridgeOptions) {
+    return {
+        add_text_overlay: {
+            description: "Add a text overlay (title) to the active sequence",
+            parameters: {
+                type: "object",
+                properties: {
+                    text: {
+                        type: "string",
+                        description: "Text content to display",
+                    },
+                    track_index: {
+                        type: "number",
+                        description: "Video track index to place the text on (default: topmost track)",
+                    },
+                    start_seconds: {
+                        type: "number",
+                        description: "Start time in seconds (default: 0)",
+                    },
+                    duration_seconds: {
+                        type: "number",
+                        description: "Duration in seconds (default: 5)",
+                    },
+                    font_size: {
+                        type: "number",
+                        description: "Font size (default: 60)",
+                    },
+                },
+                required: ["text"],
+            },
+            handler: async (args) => {
+                const startSeconds = args.start_seconds ?? 0;
+                const durationSeconds = args.duration_seconds ?? 5;
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
+          var trackIndex = ${args.track_index !== undefined ? args.track_index : "seq.videoTracks.numTracks - 1"};
+          
+          // Create a graphics clip using the captions API approach
+          var project = app.project;
+          
+          // Use QE DOM to insert text
+          app.enableQE();
+          var qeSeq = qe.project.getActiveSequence();
+          
+          // Add a caption track if needed, then add text
+          // Note: Direct text creation requires MOGRT or Graphics workspace
+          // For basic text, we use the Graphics approach
+          var startTicks = __secondsToTicks(${startSeconds}).toString();
+          var endTicks = __secondsToTicks(${startSeconds + durationSeconds}).toString();
+          
+          var textContent = "${escapeForExtendScript(args.text)}";
+          // Add caption track via QE DOM
+          try {
+            qeSeq.addCaptionTrack("Subtitle", 0);
+          } catch(e) {}
+          // Get caption track count
+          var captionTrackCount = seq.captionTracks ? seq.captionTracks.numTracks : 0;
+          return __result({ added: true, text: textContent, note: "Caption track added. Use create_caption_track with an SRT file for full subtitle workflow.", captionTracks: captionTrackCount });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        import_mogrt: {
+            description: "Import a Motion Graphics Template (.mogrt) file and add it to the timeline",
+            parameters: {
+                type: "object",
+                properties: {
+                    mogrt_path: {
+                        type: "string",
+                        description: "Full path to the .mogrt file",
+                    },
+                    track_index: {
+                        type: "number",
+                        description: "Video track index (default: 0)",
+                    },
+                    start_seconds: {
+                        type: "number",
+                        description: "Start time in seconds (default: 0)",
+                    },
+                    duration_seconds: {
+                        type: "number",
+                        description: "Duration in seconds (default: 5)",
+                    },
+                },
+                required: ["mogrt_path"],
+            },
+            handler: async (args) => {
+                const trackIndex = args.track_index ?? 0;
+                const startSeconds = args.start_seconds ?? 0;
+                const durationSeconds = args.duration_seconds ?? 5;
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
+          var mogrtPath = "${escapeForExtendScript(args.mogrt_path)}";
+          var startTicks = __secondsToTicks(${startSeconds}).toString();
+          var durationTicks = __secondsToTicks(${durationSeconds}).toString();
+          
+          var success = seq.importMGT(
+            mogrtPath,
+            startTicks,
+            ${trackIndex},
+            ${trackIndex}  // audio track index
+          );
+          
+          if (!success) return __error("Failed to import MOGRT");
+          
+          return __result({
+            imported: true,
+            mogrtPath: mogrtPath,
+            trackIndex: ${trackIndex},
+            startSeconds: ${startSeconds},
+            durationSeconds: ${durationSeconds}
+          });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        import_mogrt_from_library: {
+            description: "Import a MOGRT from an Adobe Library by name",
+            parameters: {
+                type: "object",
+                properties: {
+                    mogrt_name: {
+                        type: "string",
+                        description: "Name of the MOGRT in the library",
+                    },
+                    track_index: {
+                        type: "number",
+                        description: "Video track index (default: 0)",
+                    },
+                    start_seconds: {
+                        type: "number",
+                        description: "Start time in seconds (default: 0)",
+                    },
+                },
+                required: ["mogrt_name"],
+            },
+            handler: async (args) => {
+                const trackIndex = args.track_index ?? 0;
+                const startSeconds = args.start_seconds ?? 0;
+                const script = buildToolScript(`
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          
+          var seq = app.project.activeSequence;
+          if (!seq) return __error("No active sequence");
+          return __error("import_mogrt_from_library is not supported via ExtendScript. Adobe Libraries cannot be accessed programmatically. Use import_mogrt with a local file path instead: download the MOGRT from your library first, then use import_mogrt({ mogrt_path: '/path/to/template.mogrt' }).");
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+    };
+}
+//# sourceMappingURL=text.js.map

package/dist/tools/timeline.d.ts

@@ -0,0 +1,265 @@
+import { BridgeOptions } from "../bridge/file-bridge.js";
+export declare function getTimelineTools(bridgeOptions: BridgeOptions): {
+    add_to_timeline: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+                track_index: {
+                    type: string;
+                    description: string;
+                };
+                start_seconds: {
+                    type: string;
+                    description: string;
+                };
+                audio_track_index: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+            track_index?: number;
+            start_seconds?: number;
+            audio_track_index?: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    remove_from_timeline: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+                ripple: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            node_id: string;
+            ripple?: boolean;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    move_clip: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+                new_start_seconds: {
+                    type: string;
+                    description: string;
+                };
+                new_track_index: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            node_id: string;
+            new_start_seconds: number;
+            new_track_index?: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    trim_clip: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+                new_in_seconds: {
+                    type: string;
+                    description: string;
+                };
+                new_out_seconds: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            node_id: string;
+            new_in_seconds?: number;
+            new_out_seconds?: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    split_clip: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                time_seconds: {
+                    type: string;
+                    description: string;
+                };
+                track_index: {
+                    type: string;
+                    description: string;
+                };
+                track_type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            time_seconds: number;
+            track_index?: number;
+            track_type?: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    duplicate_clip: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            node_id: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    enable_disable_clip: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+                enabled: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            node_id: string;
+            enabled: boolean;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    set_clip_properties: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+                opacity: {
+                    type: string;
+                    description: string;
+                };
+                speed: {
+                    type: string;
+                    description: string;
+                };
+                scale: {
+                    type: string;
+                    description: string;
+                };
+                position_x: {
+                    type: string;
+                    description: string;
+                };
+                position_y: {
+                    type: string;
+                    description: string;
+                };
+                rotation: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            node_id: string;
+            opacity?: number;
+            speed?: number;
+            scale?: number;
+            position_x?: number;
+            position_y?: number;
+            rotation?: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    replace_clip: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+                new_item_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            node_id: string;
+            new_item_id: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    speed_change: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+                speed_percent: {
+                    type: string;
+                    description: string;
+                };
+                reverse: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            node_id: string;
+            speed_percent: number;
+            reverse?: boolean;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+};
+//# sourceMappingURL=timeline.d.ts.map