@writepanda/mcp 1.265.0 → 1.269.0

package/bin/server.mjs

@@ -1739,7 +1739,7 @@ const TOOLS = [
 	{
 		name: "project_edit_summary",
 		description:
-			"What the edit contains now: lengths (editedDurationMs, sourceDurationMs, removedMs cut or sped up), counts (cuts, zooms, motionElements, graphics, transitions, brollBeats, mediaOverlays, captions { on, template }, audio { narration, music, soundEffects }, ...) and highlights[] (plain lines). Cheap; use it to report an editing pass instead of project_read.",
+			"What the edit contains now: lengths (editedDurationMs, sourceDurationMs, removedMs cut or sped up), counts (cuts, zooms, motionElements, graphics, transitions, brollBeats, mediaOverlays, captions { on, template }, audio { narration, music, soundEffects }, voiceEnhancedClips vs loudnessNormalizedClips, ...) and highlights[] (plain lines). Each recording counts once, so splits change neither source length nor cuts. Cheap; use it to report an editing pass instead of project_read.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -3576,6 +3576,35 @@ const TOOLS = [
 		},
 		command: "project.add-spotlight",
 	},
+	{
+		name: "project_set_speaker_background",
+		description:
+			"The speaker's background for the WHOLE video as one look: blur, remove (wallpaper shows; outline on by default), image (studio plate) or none. Replaces the previous whole-video background instead of stacking; partial background-effect regions stay. Camera footage. For one stretch use project_add_background_effect.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				mode: { type: "string", enum: ["none", "blur", "remove", "image"] },
+				strength: { type: "number", description: "blur: 1-120, default 18." },
+				backgroundImage: {
+					type: "string",
+					description:
+						"image: warm-creator, tech-rgb, neutral-grey, podcast-warm, daylight-airy, gradient-gel, cinematic-dark, or an image path.",
+				},
+				outline: {
+					type: "boolean",
+					description: "Keyline around the cutout (on by default for remove).",
+				},
+				outlineWidth: { type: "number" },
+				outlineColor: { type: "string" },
+				outlineShadow: { type: "boolean" },
+				expectedRevision: { type: "number" },
+			},
+			required: ["mode"],
+		},
+		command: "project.set-speaker-background",
+	},
 	{
 		name: "project_add_background_effect",
 		description:
@@ -4475,7 +4504,7 @@ const TOOLS = [
 	{
 		name: "project_center_camera_on_face",
 		description:
-			"Keep the presenter's face centred in the camera card by tracking it (can take a minute). On a podcast clip it tracks every participant's camera so their tiles (pair, grid, screen-share strip) centre on each face (the editor also does this in the background when a podcast opens; a set-podcast-source-crop framing wins). clear: true turns it off. Concurrent saves are merged and retried (three attempts). Exhausted conflicts report code revision_conflict / status 409 (job.errorDetails for async jobs).",
+			"Keep the presenter's face centred in a SEPARATE camera card by tracking it (can take a minute). Not for the main video: face-tracked zooms on the main video are project_auto_reframe. On a podcast clip it tracks every participant's camera so their tiles (pair, grid, screen-share strip) centre on each face (the editor also does this in the background when a podcast opens; a set-podcast-source-crop framing wins). clear: true turns it off. Concurrent saves are merged and retried (three attempts). Exhausted conflicts report code revision_conflict / status 409 (job.errorDetails for async jobs).",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4714,7 +4743,7 @@ const TOOLS = [
 	{
 		name: "project_auto_reframe",
 		description:
-			"Active-speaker auto-reframe of landscape multi-person footage for vertical / square: frames whoever talks, shot by shot. split=true stacks two people (podcast / interview wide) one above the other on a 9:16 canvas. Slow (minutes). clear reverts. Concurrent saves are merged and retried (three attempts). Exhausted conflicts report code revision_conflict / status 409 (job.errorDetails for async jobs).",
+			"Active-speaker auto-reframe: frames whoever talks, shot by shot (face tracking, no speaker IDs needed). Landscape footage on a vertical / square canvas gets a crop that follows the speaker; footage that already has the canvas shape (a 16:9 wide of two hosts in a 16:9 video) gets a punch-in on the speaker inside the frame, which is also how to get face-tracked zooms on the main video. zoom = fixed punch-in. split=true stacks two people (podcast / interview wide) one above the other on a 9:16 canvas. Slow (minutes). clear reverts. Concurrent saves are merged and retried (three attempts). Exhausted conflicts report code revision_conflict / status 409 (job.errorDetails for async jobs).",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -5964,6 +5993,30 @@ const TOOLS = [
 		},
 		command: "caption.set-style",
 	},
+	{
+		name: "caption_set_look",
+		description:
+			"Set a COMPLETE caption look in one call, replacing the current one: on/off, template, words per line, position and every override (in style). What the look leaves out goes back to the template's own, never what an earlier style left. How a recipe's captions are applied; use it to copy a look exactly. For one tweak use caption_set_style.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				enabled: { type: "boolean" },
+				templateId: { type: "string", description: "A caption_set_template id." },
+				wordsPerLine: { type: "number", description: "1-10. Default the template's own." },
+				positionY: { type: "number", description: "% from the top. Default the project's." },
+				style: {
+					type: "object",
+					description:
+						"caption_set_style's look fields: fontFamily, fontSize, color, backgroundColor, highlightColor, highlightBackgroundColor, strokeColor, strokeWidth, uppercase, highlightMode, emphasisColor, emphasisBackgroundColor, emphasisScale, emphasisItalic, emphasisFontFamily, boxRotation.",
+				},
+				expectedRevision: { type: "number" },
+			},
+			required: ["enabled"],
+		},
+		command: "caption.set-look",
+	},
 	{
 		name: "caption_mark_emphasis",
 		description:
@@ -6157,17 +6210,20 @@ const TOOLS = [
 			properties: {
 				script: {
 					type: "string",
-					description: "What the user will read, plain text (no markdown or stage directions), up to 20,000 characters.",
+					description:
+						"What the user will read, plain text (no markdown or stage directions), up to 20,000 characters.",
 				},
 				mode: {
 					type: "string",
 					enum: ["camera", "screen", "both"],
-					description: "camera (solo; default with a script), screen (screen only), or both (screen + camera bubble; default without a script).",
+					description:
+						"camera (solo; default with a script), screen (screen only), or both (screen + camera bubble; default without a script).",
 				},
 				orientation: {
 					type: "string",
 					enum: ["landscape", "portrait"],
-					description: "landscape 16:9 (YouTube) or portrait 9:16 (Shorts, Reels, TikTok): the camera shape for a camera take; a screen take's final shape is set while editing.",
+					description:
+						"landscape 16:9 (YouTube) or portrait 9:16 (Shorts, Reels, TikTok): the camera shape for a camera take; a screen take's final shape is set while editing.",
 				},
 				speed: { type: "number", description: "Teleprompter scroll speed 0.25-3." },
 				fontSize: { type: "number", description: "Teleprompter text size in px, 16-72." },
@@ -7439,7 +7495,7 @@ const TOOLS = [
 	{
 		name: "recipe_apply_style",
 		description:
-			"Apply a recipe's fixed style to a project, before recipe_render's content work. Returns { applied, failed, pending, notes }: applied / failed are read back from the project, notes = parts left to you. Fails, changing nothing, when the recipe needs footage the project lacks (a camera recipe on an audio-only project).",
+			"Apply a recipe's fixed style to a project, before recipe_render's content work: aspect, the full caption look, speaker background, vertical framing, grade, camera layout. It REPLACES an earlier recipe's look. Returns { applied, failed, pending, notes }: applied / failed are read back from the project, notes = parts left to you. Fails, changing nothing, when the recipe needs footage the project lacks (a camera recipe on an audio-only project).",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -7452,6 +7508,17 @@ const TOOLS = [
 		},
 		command: "recipe.apply-style",
 	},
+	{
+		name: "recipe_look_frames",
+		description:
+			"The recipe's target look as images (attached): stills of its finished edit at key moments, each with what it shows. Look before editing with a recipe; compare project_render_frame at the matching beats before saying done. Match the look, never the content.",
+		inputSchema: {
+			type: "object",
+			properties: { id: { type: "string", description: "Recipe id." } },
+			required: ["id"],
+		},
+		command: "recipe.look-frames",
+	},
 	{
 		name: "recipe_save",
 		description:
@@ -7462,7 +7529,7 @@ const TOOLS = [
 				recipe: {
 					type: "object",
 					description:
-						"{ id?, title, description, category, footage?, aspectRatio?, fields: [{ key, label, type: text|longtext|select|color|images, default?, options?, required?, help?, minCount?, maxCount?, optional? }], prompt, style?: { aspectRatio?, colorCorrection?, lut?: { preset, intensity? }, background?: { mode, image? }, cameraLayout?, captions?: { enabled, templateId? }, wallpaper? }, checklist: string[] }",
+						"{ id?, title, description, category, footage?, aspectRatio?, fields: [{ key, label, type: text|longtext|select|color|images, default?, options?, required?, help?, minCount?, maxCount?, optional? }], prompt, lookFrames?: [{ src: absolute image path, shows: what it shows (position, size, colours), atMs? }] (up to 8 stills of the target look; copied into the recipe), style?: { aspectRatio?, colorCorrection?, lut?: { preset, intensity? }, speakerBackground?: { mode: none|blur|remove|image, image?, strength?, outline?: { enabled, width?, color?, shadow? } }, framing?: { shortsLayout: full|camera-corner }, cameraLayout?, captions?: { enabled, templateId?, wordsPerLine?, positionY?, style?: caption_set_look's style }, broll?: { use: none|ask|generate|user-images, layout?: full|split|card, notes? }, graphics?: { family?, titleFont?, bodyFont?, accentColor?, textColor?, surfaceColor?, notes? }, wallpaper? }, checklist: string[] }. Put the WHOLE look in style (every caption value, the background, framing, B-roll rule, title fonts and colours): it is applied exactly, the prompt only covers what depends on the footage.",
 				},
 			},
 			required: ["recipe"],
@@ -9049,10 +9116,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
 			for (const previewPath of previews) {
 				const fs = await import("node:fs/promises");
 				const buf = await fs.readFile(previewPath);
+				const ext = previewPath.toLowerCase().split(".").pop();
 				content.push({
 					type: "image",
 					data: buf.toString("base64"),
-					mimeType: "image/png",
+					mimeType:
+						ext === "jpg" || ext === "jpeg"
+							? "image/jpeg"
+							: ext === "webp"
+								? "image/webp"
+								: "image/png",
 				});
 			}
 		} catch (imgErr) {
@@ -9113,6 +9186,12 @@ function collectInlinePreviewPaths(command, data) {
 	if (command === "motion.screenshot") {
 		return typeof data.previewPath === "string" ? [data.previewPath] : [];
 	}
+	if (command === "recipe.look-frames") {
+		const frames = Array.isArray(data.frames) ? data.frames : [];
+		return frames
+			.map((f) => (f && typeof f.path === "string" ? f.path : null))
+			.filter((p) => p !== null);
+	}
 	if (command === "motion.verify-frames") {
 		const frames = Array.isArray(data.frames) ? data.frames : [];
 		return frames

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@writepanda/mcp",
-	"version": "1.265.0",
+	"version": "1.269.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",