@writepanda/mcp 1.191.0 → 1.194.0

package/bin/server.mjs

@@ -1973,6 +1973,141 @@ const TOOLS = [
 		},
 		command: "project.remove-mute-region",
 	},
+	{
+		name: "project_add_bleep",
+		description:
+			"Bleep words instead of cutting them: audio silenced, a tone of exactly their length plays, captions mask them (d***). wordIds from transcript.get (adjacent words = one bleep; stays on those words through later cuts) or startMs/endMs edited ms. Overlaps merge. Returns bleepIds.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				wordIds: { type: "array", items: { type: "string" } },
+				startMs: { type: "number" },
+				endMs: { type: "number" },
+				sound: {
+					type: "string",
+					enum: ["tv", "low", "high", "retro", "silence"],
+					description: "Default tv (1 kHz).",
+				},
+				volume: { type: "number", description: "0-1, default 0.5." },
+				mask: {
+					type: "string",
+					enum: ["stars", "none"],
+					description: "Caption masking, default stars.",
+				},
+				padMs: { type: "number", description: "Padding each side, default 30." },
+				padStartMs: { type: "number" },
+				padEndMs: { type: "number" },
+				expectedRevision: { type: "number" },
+			},
+		},
+		command: "project.add-bleep",
+	},
+	{
+		name: "project_update_bleep",
+		description:
+			"Change a bleep's sound, volume or caption mask, or its edges: nudgeStartMs (+ = earlier start), nudgeEndMs (+ = later end), or padStartMs/padEndMs.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				bleepId: { type: "string" },
+				sound: { type: "string", enum: ["tv", "low", "high", "retro", "silence"] },
+				volume: { type: "number" },
+				mask: { type: "string", enum: ["stars", "none"] },
+				padStartMs: { type: "number" },
+				padEndMs: { type: "number" },
+				nudgeStartMs: { type: "number" },
+				nudgeEndMs: { type: "number" },
+				expectedRevision: { type: "number" },
+			},
+			required: ["bleepId"],
+		},
+		command: "project.update-bleep",
+	},
+	{
+		name: "project_remove_bleep",
+		description: "Remove a bleep (bleepId) or un-bleep specific words (wordIds).",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				bleepId: { type: "string" },
+				wordIds: { type: "array", items: { type: "string" } },
+				expectedRevision: { type: "number" },
+			},
+		},
+		command: "project.remove-bleep",
+	},
+	{
+		name: "project_plan_broll",
+		description:
+			"B-roll, the LAST step of an edit: the moments where a picture of what's said would help, plus imageConnector (connected generator or null). Never makes images: show the user the moments and ASK: their own images, generate on their connector (uses their credits), or no B-roll. No one to ask: skip it and say so.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				maxBeats: { type: "number" },
+				minGapMs: { type: "number" },
+			},
+		},
+		command: "project.plan-broll",
+	},
+	{
+		name: "project_add_broll",
+		description:
+			"Place a B-roll beat on a word: the picture (user's own, or generated after they agreed) for ~2 s with a slow push, shutter click and a transition on both edges; moves / deletes / follows cuts as one (brollId).",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				imagePath: { type: "string" },
+				wordId: { type: "string" },
+				atMs: { type: "number" },
+				durationMs: { type: "number", description: "1400-4000, default 2000." },
+				endWordId: { type: "string" },
+				layout: { type: "string", enum: ["full", "inset"] },
+				transition: {
+					type: "string",
+					enum: ["flash", "light-sweep", "film-burn", "fade-white", "glitch", "none"],
+				},
+				sound: { type: "string", enum: ["shutter", "click", "none"] },
+				push: { type: "string", enum: ["in", "out", "none"] },
+				expectedRevision: { type: "number" },
+			},
+			required: ["imagePath"],
+		},
+		command: "project.add-broll",
+	},
+	{
+		name: "project_list_broll",
+		description: "The project's B-roll beats (brollId, picture, span, overlay ids).",
+		inputSchema: {
+			type: "object",
+			properties: { id: { type: "string" }, path: { type: "string" } },
+		},
+		command: "project.list-broll",
+	},
+	{
+		name: "project_remove_broll",
+		description: "Remove a B-roll beat (picture + transitions) by brollId.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				brollId: { type: "string" },
+				expectedRevision: { type: "number" },
+			},
+			required: ["brollId"],
+		},
+		command: "project.remove-broll",
+	},
 	{
 		name: "project_add_spotlight",
 		description:
@@ -3641,7 +3776,7 @@ const TOOLS = [
 	{
 		name: "media_generate_image",
 		description:
-			"Generate one image on the user's own image connector (auto: Replicate, else Higgsfield; their credits). Returns { imagePath, provider, model, transparent }. transparent=true: trimmed PNG sticker. No connector: code NO_IMAGE_CONNECTOR, so ask the user for their own images. Each call is a paid generation.",
+			"Generate one image on the user's own image connector (auto: Replicate, else Higgsfield; their credits). Only after the user agreed to generating (ask first; B-roll: project_plan_broll, then ask). Returns { imagePath, provider, model, transparent }. transparent=true: trimmed PNG sticker. No connector: code NO_IMAGE_CONNECTOR, so ask the user for their own images. Each call is a paid generation.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4394,6 +4529,10 @@ const TOOLS = [
 					description: "Omit for the template's natural mode.",
 				},
 				outputName: { type: "string" },
+				durationMs: {
+					type: "number",
+					description: "Length for templates with a durationRangeMs (clamped); ignored otherwise.",
+				},
 			},
 			required: ["templateId", "slots"],
 		},
@@ -5041,7 +5180,8 @@ Before an editing pass, read the skill's "Which tool for which moment" section (
 5. transcript_remove_silences.
 6. audio_clean clips not yet cleaned.
 7. Captions (caption_toggle; template glowStack unless a recipe says otherwise), motion graphics, emphasis zooms: only after steps 2-5, which shift the timeline.
-8. llm_generate_title / description / timestamps, then preview_show and ask before export_start. Never export before the user has seen the preview.
+8. B-roll, last: project_plan_broll, show the user the moments and ASK: their own images, generated on their image connector (only if one is connected; it uses their credits), or no B-roll. Never generate or invent images without their answer. Place what they give with project_add_broll. Nobody to ask: skip it and say so.
+9. llm_generate_title / description / timestamps, then preview_show and ask before export_start. Never export before the user has seen the preview.
 Report the real count each step returned. Never add music, intro/outro cards or FX overlays unless asked.
 
 Style defaults when the user names no style, recipe or creator (their choice or a saved memory wins):

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@writepanda/mcp",
-	"version": "1.191.0",
+	"version": "1.194.0",
 	"description": "Model Context Protocol server for PandaStudio. Exposes the desktop video editor's automation surface to Cursor, Continue, Cline, Claude Desktop, and any MCP-compliant client.",
 	"keywords": [
 		"pandastudio",