@synthetic-ai/premiere-mcp 2.0.0

package/dist/tools/markers.d.ts

@@ -0,0 +1,117 @@
+import { BridgeOptions } from "../bridge/file-bridge.js";
+export declare function getMarkerTools(bridgeOptions: BridgeOptions): {
+    add_marker: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                time_seconds: {
+                    type: string;
+                    description: string;
+                };
+                name: {
+                    type: string;
+                    description: string;
+                };
+                comments: {
+                    type: string;
+                    description: string;
+                };
+                color: {
+                    type: string;
+                    description: string;
+                };
+                duration_seconds: {
+                    type: string;
+                    description: string;
+                };
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            time_seconds: number;
+            name?: string;
+            comments?: string;
+            color?: number;
+            duration_seconds?: number;
+            node_id?: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    delete_marker: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                time_seconds: {
+                    type: string;
+                    description: string;
+                };
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            time_seconds: number;
+            node_id?: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    update_marker: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                time_seconds: {
+                    type: string;
+                    description: string;
+                };
+                name: {
+                    type: string;
+                    description: string;
+                };
+                comments: {
+                    type: string;
+                    description: string;
+                };
+                color: {
+                    type: string;
+                    description: string;
+                };
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            time_seconds: number;
+            name?: string;
+            comments?: string;
+            color?: number;
+            node_id?: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    list_markers: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                node_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+        handler: (args: {
+            node_id?: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+};
+//# sourceMappingURL=markers.d.ts.map

package/dist/tools/markers.js

@@ -0,0 +1,206 @@
+import { buildToolScript, escapeForExtendScript } from "../bridge/script-builder.js";
+import { sendCommand } from "../bridge/file-bridge.js";
+export function getMarkerTools(bridgeOptions) {
+    return {
+        add_marker: {
+            description: "Add a marker to the active sequence or a clip",
+            parameters: {
+                type: "object",
+                properties: {
+                    time_seconds: {
+                        type: "number",
+                        description: "Time position in seconds for the marker",
+                    },
+                    name: {
+                        type: "string",
+                        description: "Name/label for the marker",
+                    },
+                    comments: {
+                        type: "string",
+                        description: "Comments for the marker",
+                    },
+                    color: {
+                        type: "number",
+                        description: "Marker color index (0=Green, 1=Red, 2=Purple, 3=Orange, 4=Yellow, 5=White, 6=Blue, 7=Cyan)",
+                    },
+                    duration_seconds: {
+                        type: "number",
+                        description: "Duration of the marker in seconds (0 for point marker)",
+                    },
+                    node_id: {
+                        type: "string",
+                        description: "Optional clip node ID to add marker to clip instead of sequence",
+                    },
+                },
+                required: ["time_seconds"],
+            },
+            handler: async (args) => {
+                const markerTarget = args.node_id
+                    ? `var clipResult = __findClip("${escapeForExtendScript(args.node_id)}");
+             if (!clipResult) return __error("Clip not found");
+             var markers = clipResult.clip.markers;`
+                    : `var seq = app.project.activeSequence;
+             if (!seq) return __error("No active sequence");
+             var markers = seq.markers;`;
+                const script = buildToolScript(`
+          ${markerTarget}
+          
+          var marker = markers.createMarker(${args.time_seconds});
+          
+          ${args.name ? `marker.name = "${escapeForExtendScript(args.name)}";` : ""}
+          ${args.comments ? `marker.comments = "${escapeForExtendScript(args.comments)}";` : ""}
+          ${args.color !== undefined ? `marker.setColorByIndex(${args.color});` : ""}
+          ${args.duration_seconds ? `marker.end.ticks = __secondsToTicks(${args.time_seconds + args.duration_seconds}).toString();` : ""}
+          
+          return __result({
+            added: true,
+            timeSeconds: ${args.time_seconds},
+            name: marker.name,
+            comments: marker.comments
+          });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        delete_marker: {
+            description: "Delete a marker at a specific time position",
+            parameters: {
+                type: "object",
+                properties: {
+                    time_seconds: {
+                        type: "number",
+                        description: "Time position of the marker to delete",
+                    },
+                    node_id: {
+                        type: "string",
+                        description: "Optional clip node ID (deletes from sequence if omitted)",
+                    },
+                },
+                required: ["time_seconds"],
+            },
+            handler: async (args) => {
+                const markerTarget = args.node_id
+                    ? `var clipResult = __findClip("${escapeForExtendScript(args.node_id)}");
+             if (!clipResult) return __error("Clip not found");
+             var markers = clipResult.clip.markers;`
+                    : `var seq = app.project.activeSequence;
+             if (!seq) return __error("No active sequence");
+             var markers = seq.markers;`;
+                const script = buildToolScript(`
+          ${markerTarget}
+          
+          var targetTicks = __secondsToTicks(${args.time_seconds});
+          var marker = markers.getFirstMarker();
+          var deleted = false;
+          
+          while (marker) {
+            var markerTicks = parseFloat(marker.start.ticks);
+            if (Math.abs(markerTicks - targetTicks) < TICKS_PER_SECOND * 0.01) {
+              markers.deleteMarker(marker);
+              deleted = true;
+              break;
+            }
+            marker = markers.getNextMarker(marker);
+          }
+          
+          if (!deleted) return __error("No marker found at " + ${args.time_seconds} + "s");
+          return __result({ deleted: true, timeSeconds: ${args.time_seconds} });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        update_marker: {
+            description: "Update an existing marker's properties",
+            parameters: {
+                type: "object",
+                properties: {
+                    time_seconds: {
+                        type: "number",
+                        description: "Time position of the marker to update",
+                    },
+                    name: { type: "string", description: "New name" },
+                    comments: { type: "string", description: "New comments" },
+                    color: { type: "number", description: "New color index" },
+                    node_id: {
+                        type: "string",
+                        description: "Optional clip node ID (updates sequence marker if omitted)",
+                    },
+                },
+                required: ["time_seconds"],
+            },
+            handler: async (args) => {
+                const markerTarget = args.node_id
+                    ? `var clipResult = __findClip("${escapeForExtendScript(args.node_id)}");
+             if (!clipResult) return __error("Clip not found");
+             var markers = clipResult.clip.getMarkers();`
+                    : `var seq = app.project.activeSequence;
+             if (!seq) return __error("No active sequence");
+             var markers = seq.markers;`;
+                const script = buildToolScript(`
+          ${markerTarget}
+
+          var targetTicks = __secondsToTicks(${args.time_seconds});
+          var marker = markers.getFirstMarker();
+          var found = false;
+
+          while (marker) {
+            var markerTicks = parseFloat(marker.start.ticks);
+            if (Math.abs(markerTicks - targetTicks) < TICKS_PER_SECOND * 0.01) {
+              ${args.name ? `marker.name = "${escapeForExtendScript(args.name)}";` : ""}
+              ${args.comments ? `marker.comments = "${escapeForExtendScript(args.comments)}";` : ""}
+              ${args.color !== undefined ? `marker.setColorByIndex(${args.color});` : ""}
+              found = true;
+              break;
+            }
+            marker = markers.getNextMarker(marker);
+          }
+
+          if (!found) return __error("No marker found at " + ${args.time_seconds} + "s");
+          return __result({ updated: true, timeSeconds: ${args.time_seconds} });
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+        list_markers: {
+            description: "List all markers on the active sequence or a specific clip",
+            parameters: {
+                type: "object",
+                properties: {
+                    node_id: {
+                        type: "string",
+                        description: "Optional clip node ID to list clip markers instead of sequence markers",
+                    },
+                },
+            },
+            handler: async (args) => {
+                const markerTarget = args.node_id
+                    ? `var clipResult = __findClip("${escapeForExtendScript(args.node_id)}");
+             if (!clipResult) return __error("Clip not found");
+             var markers = clipResult.clip.markers;`
+                    : `var seq = app.project.activeSequence;
+             if (!seq) return __error("No active sequence");
+             var markers = seq.markers;`;
+                const script = buildToolScript(`
+          ${markerTarget}
+          
+          var list = [];
+          var marker = markers.getFirstMarker();
+          while (marker) {
+            list.push({
+              name: marker.name,
+              comments: marker.comments,
+              startSeconds: __ticksToSeconds(marker.start.ticks),
+              endSeconds: __ticksToSeconds(marker.end.ticks),
+              type: marker.type
+            });
+            marker = markers.getNextMarker(marker);
+          }
+          
+          return __result(list);
+        `);
+                return sendCommand(script, bridgeOptions);
+            },
+        },
+    };
+}
+//# sourceMappingURL=markers.js.map

package/dist/tools/media.d.ts

@@ -0,0 +1,297 @@
+import { BridgeOptions } from "../bridge/file-bridge.js";
+export declare function getMediaTools(bridgeOptions: BridgeOptions): {
+    import_media: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                file_paths: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                target_bin: {
+                    type: string;
+                    description: string;
+                };
+                suppress_ui: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            file_paths: string[];
+            target_bin?: string;
+            suppress_ui?: boolean;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    import_folder: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                folder_path: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            folder_path: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    create_bin: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                parent_bin: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            name: string;
+            parent_bin?: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    move_item_to_bin: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+                target_bin: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+            target_bin: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    relink_media: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+                new_path: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+            new_path: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    refresh_media: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    check_offline_media: {
+        description: string;
+        parameters: {};
+        handler: () => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    set_offline: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    has_proxy: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    detach_proxy: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    set_override_frame_rate: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+                frame_rate: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+            frame_rate: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    set_override_pixel_aspect_ratio: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+                numerator: {
+                    type: string;
+                    description: string;
+                };
+                denominator: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+            numerator: number;
+            denominator: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    set_scale_to_frame_size: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    get_item_info: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    select_item: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+    set_start_time: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                item_id: {
+                    type: string;
+                    description: string;
+                };
+                start_seconds: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            item_id: string;
+            start_seconds: number;
+        }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
+    };
+};
+//# sourceMappingURL=media.d.ts.map