@writepanda/mcp 1.79.0 → 1.86.0

package/bin/server.mjs

@@ -321,6 +321,50 @@ const TOOLS = [
 		},
 		command: "workspace.set-brand",
 	},
+	{
+		name: "workspace_get_project_defaults",
+		description:
+			"Return the active workspace's project-look defaults (wallpaper/background, captionSettings, editorDefaults) that new projects and fresh recordings start from. Returns { defaults: null } when none are set.",
+		inputSchema: { type: "object", properties: {} },
+		command: "workspace.get-project-defaults",
+	},
+	{
+		name: "workspace_set_project_defaults",
+		description:
+			"Set the active workspace's project-look defaults so every NEW project + recording starts from them (so the user does not re-set the same look each time). Pass any subset under `defaults`. Unknown/badly-typed fields are dropped. Pass defaults=null (or omit) to clear. Use when the user says e.g. 'use this look for all my projects' or 'always start with this background/captions'.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				defaults: {
+					type: ["object", "null"],
+					properties: {
+						wallpaper: { type: "string" },
+						captionSettings: {
+							type: "object",
+							properties: {
+								enabled: { type: "boolean" },
+								templateId: { type: "string" },
+								wordsPerLine: { type: "integer" },
+								positionY: { type: "number" },
+								styleOverrides: { type: "object" },
+							},
+						},
+						editorDefaults: {
+							type: "object",
+							properties: {
+								padding: { type: "number" },
+								shadowIntensity: { type: "number" },
+								borderRadius: { type: "number" },
+								showBlur: { type: "boolean" },
+								motionBlurAmount: { type: "number" },
+							},
+						},
+					},
+				},
+			},
+		},
+		command: "workspace.set-project-defaults",
+	},
 
 	// ── YouTube publishing (v1.19) ──────────────────────────────────
 	// Connect Google accounts per workspace, publish exports, edit
@@ -977,6 +1021,120 @@ const TOOLS = [
 		},
 		command: "project.add-zoom",
 	},
+	{
+		name: "project_add_spotlight",
+		description:
+			"Add a focus region over the video. kind 'spotlight' DIMS everything OUTSIDE a rounded rectangle to draw the eye to one spot (Focusee-style); kind 'blur' BLURS everything INSIDE the rectangle to hide an email, username, or other sensitive detail. The rect is 0..1 fractions of the video and tracks content through zooms. Defaults give a centred half-size box; pass x/y/width/height to place it.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				atMs: { type: "number" },
+				durationMs: { type: "number" },
+				kind: {
+					type: "string",
+					enum: ["spotlight", "blur"],
+					description: '"spotlight" (default — dims outside) or "blur" (blurs inside).',
+				},
+				x: { type: "number", description: "Rect left edge, 0..1 of video width. Default 0.25." },
+				y: { type: "number", description: "Rect top edge, 0..1 of video height. Default 0.25." },
+				width: { type: "number", description: "Rect width, 0..1. Default 0.5." },
+				height: { type: "number", description: "Rect height, 0..1. Default 0.5." },
+				roundness: { type: "number", description: "Corner radius px, 0..120. Default 16." },
+				maskOpacity: {
+					type: "number",
+					description: "SPOTLIGHT only: surround darkness 0..1. Default 0.6.",
+				},
+				blurAmount: {
+					type: "number",
+					description: "BLUR only: blur strength px, 0..120. Default 12.",
+				},
+				feathering: { type: "number", description: "Soft edge px, 0..120. Default 12." },
+				expectedRevision: { type: "number" },
+			},
+			required: ["atMs", "durationMs"],
+		},
+		command: "project.add-spotlight",
+	},
+	{
+		name: "project_update_spotlight",
+		description:
+			"Patch an existing focus region in-place: move/resize the rect, retime it, restyle it (roundness/feathering/darkness/blur), or switch spotlight<->blur. Only the fields you pass change. Find ids via project_read under editor.spotlightRegions[].id.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				regionId: {
+					type: "string",
+					description: "The id of the focus region (editor.spotlightRegions[].id).",
+				},
+				startMs: { type: "number", description: "New edited-time start (ms)." },
+				endMs: { type: "number", description: "New edited-time end (ms)." },
+				kind: {
+					type: "string",
+					enum: ["spotlight", "blur"],
+					description: 'Switch kind: "spotlight" (dims outside) or "blur" (blurs inside).',
+				},
+				x: { type: "number", description: "Rect left edge, 0..1 of video width." },
+				y: { type: "number", description: "Rect top edge, 0..1 of video height." },
+				width: { type: "number", description: "Rect width, 0..1." },
+				height: { type: "number", description: "Rect height, 0..1." },
+				roundness: { type: "number", description: "Corner radius px, 0..120." },
+				maskOpacity: {
+					type: "number",
+					description: "SPOTLIGHT only: surround darkness 0..1.",
+				},
+				blurAmount: {
+					type: "number",
+					description: "BLUR only: blur strength px, 0..120.",
+				},
+				feathering: { type: "number", description: "Soft edge px, 0..120." },
+				expectedRevision: { type: "number" },
+			},
+			required: ["regionId"],
+		},
+		command: "project.update-spotlight",
+	},
+	{
+		name: "project_remove_spotlight",
+		description:
+			"Remove a focus region (spotlight or blur) by id. Find ids via project_read under editor.spotlightRegions[].id.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				regionId: {
+					type: "string",
+					description: "The id of the focus region to remove (editor.spotlightRegions[].id).",
+				},
+				expectedRevision: { type: "number" },
+			},
+			required: ["regionId"],
+		},
+		command: "project.remove-spotlight",
+	},
+	{
+		name: "project_render_frame",
+		description:
+			"Render the composited preview frame at a given edited-time to a PNG and return its path so a VISION agent can `read` the image. Use this to SEE what's on screen — e.g. to locate an email/username/face to cover before calling project_add_spotlight (kind=blur). Returns { path, width, height, timeMs, maskRect }. `maskRect` is the video content rect as 0..1 fractions of the image — the SAME coordinate space spotlight/blur x/y/width/height use. To cover something you see at image-fractions (ix,iy,iw,ih): x=(ix-maskRect.x)/maskRect.width, y=(iy-maskRect.y)/maskRect.height, width=iw/maskRect.width, height=ih/maskRect.height. Caveats: existing focus regions are NOT drawn (so you see content clearly), and the frame reflects any active zoom at that time — place focus regions referencing an un-zoomed moment, then re-render to verify.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				atMs: { type: "number", description: "Edited-timeline time to render (ms)." },
+				outPath: {
+					type: "string",
+					description: "Optional PNG output path. Defaults to a temp file you can read.",
+				},
+			},
+			required: ["atMs"],
+		},
+		command: "project.render-frame",
+	},
 	{
 		name: "project_set_region_sound",
 		description:
@@ -1162,12 +1320,17 @@ const TOOLS = [
 	{
 		name: "project_delete",
 		description:
-			"Permanently delete a project file from disk. There is no trash — this is irreversible. Use project_list to confirm the id before deleting.",
+			"Permanently delete a project file from disk. There is no trash — this is irreversible. By default the original source recording is KEPT (only the project is removed). Pass deleteRecording=true to ALSO permanently delete the project's original recording file(s) from disk. Use project_list to confirm the id before deleting.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				id: { type: "string" },
 				path: { type: "string" },
+				deleteRecording: {
+					type: "boolean",
+					description:
+						"Also permanently delete the project's original source recording file(s). Default false. IRREVERSIBLE.",
+				},
 			},
 		},
 		command: "project.delete",
@@ -1413,20 +1576,12 @@ const TOOLS = [
 				},
 				format: {
 					type: "string",
-					description: "mp4 | webm | gif. Default mp4.",
+					description: "mp4 | webm. Default mp4. (PandaStudio is video-only.)",
 				},
 				resolution: {
 					type: "string",
 					description: "Output resolution: 4k | 1080p | 720p | 480p | source. Default source.",
 				},
-				gifFrameRate: {
-					type: "number",
-					description: "GIF frame rate (fps). Only used when format is gif. Default 15.",
-				},
-				gifSize: {
-					type: "string",
-					description: "GIF size preset: small | medium | large. Only used when format is gif.",
-				},
 				expectedRevision: { type: "number" },
 			},
 		},
@@ -1994,12 +2149,51 @@ const TOOLS = [
 		},
 		command: "media.generate-image",
 	},
+	{
+		name: "media_generate_narration",
+		description:
+			"Generate a voiceover / narration audio clip via Replicate TTS, for promo videos and explainers. Project-agnostic; writes audio to <userData>/narration/ and returns { audioPath, durationMs, model, voice, predictionId }. Canonical workflow: media_generate_narration → project_add_audio (place at startMs, pass the returned durationMs so the overlay is sized to the speech). Models: 'elevenlabs-v3' (default, most expressive — embed inline delivery tags in the text like [excited] or [whispers]) | 'gemini-flash-tts' (30 voices, strong multilingual; 'style' sets tone) | 'minimax-turbo' (fast; 'style' maps to an emotion, 'speed' 0.5-2). Voices — gemini e.g. Kore/Puck/Charon; minimax e.g. Friendly_Person/Wise_Woman/Casual_Guy; omit voice for the model default. Requires the user's Replicate API key (Settings → Integrations).",
+		inputSchema: {
+			type: "object",
+			properties: {
+				text: {
+					type: "string",
+					description:
+						"The script to speak. For elevenlabs-v3 you can embed delivery tags inline, e.g. 'Welcome [excited] to the future of editing.'",
+				},
+				model: {
+					type: "string",
+					description: "'elevenlabs-v3' (default) | 'gemini-flash-tts' | 'minimax-turbo'.",
+				},
+				voice: {
+					type: "string",
+					description:
+						"Voice id/name for the chosen model (gemini: Kore/Puck/...; minimax: Friendly_Person/...). Omit for the model default.",
+				},
+				language: {
+					type: "string",
+					description: "Optional BCP-47 language hint, e.g. 'en-US', 'es-ES'.",
+				},
+				style: {
+					type: "string",
+					description:
+						"Optional tone/emotion hint (e.g. 'warm and upbeat'). Maps to Gemini's style prompt and MiniMax's emotion enum.",
+				},
+				speed: {
+					type: "number",
+					description: "Optional playback speed for MiniMax (0.5-2, 1 = normal).",
+				},
+			},
+			required: ["text"],
+		},
+		command: "media.generate-narration",
+	},
 	// `motion_generate` removed in v1.31.0 — see comment above the
 	// motion-graphics section.
 	{
 		name: "motion_list",
 		description:
-			"List the bundled motion-graphic templates an agent can drop onto the timeline. Returns each template's id, name, description, style, tags, aspectRatios, durationMs, `overlay` (true → renders with alpha; sits over the video), and `slots` — the editable fields (key, type: string|color|list, label, default). Call this to discover what's available and exactly which text/colors you can set, then render one with motion_generate. The SKILL.md 'Motion graphics' catalog documents when to use each.",
+			"List motion-graphic building blocks. Returns two arrays. `templates`: the slot-parameterized bundled templates — each has id, name, description, style, tags, aspectRatios, durationMs, `overlay`, and `slots` (key, type: string|color|list, label, default); render with motion_generate. `registryBlocks`: standalone Hyperframes compositions (animated captions, shader transitions, data-viz, social cards, code themes, VFX) — each has name, kind, title, description, tags, durationMs, dimensions, and `htmlPath`; these have NO slots, so render the htmlPath directly with motion_render_html and edit the HTML if you need different text. Prefer a `template` when one fits (it's parameterized); reach into `registryBlocks` for captions/transitions/data-viz the templates don't cover.",
 		inputSchema: { type: "object", properties: {} },
 		command: "motion.list",
 	},

package/package.json

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