@writepanda/mcp 1.81.0 → 1.87.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:
@@ -1418,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" },
 			},
 		},
@@ -2038,12 +2188,37 @@ const TOOLS = [
 		},
 		command: "media.generate-narration",
 	},
+	{
+		name: "media_generate_music",
+		description:
+			"Generate an original instrumental background-music track via Replicate (Google Lyria-2). Project-agnostic; writes audio to <userData>/generated-music/ and returns { audioPath, durationMs, model, predictionId }. Canonical workflow: media_generate_music → project_add_audio (place at startMs, pass the returned durationMs so the overlay is sized). The bundled library (asset_list_music) is the faster default for common moods — reach for generation when the user wants something specific/custom the library doesn't cover. Describe the music in `prompt` (genre, mood, instruments, tempo, use-case). Lyria-2 is instrumental only (~30s clips, 48kHz stereo) — loop for longer videos. Requires the user's Replicate API key (Settings → Integrations).",
+		inputSchema: {
+			type: "object",
+			properties: {
+				prompt: {
+					type: "string",
+					description:
+						"What the music should sound like — genre, mood, instruments, tempo, use-case. e.g. 'upbeat lo-fi hip hop with mellow piano, relaxed, for a coding montage'.",
+				},
+				negativePrompt: {
+					type: "string",
+					description: "Optional — qualities to steer AWAY from, e.g. 'vocals, drums, harsh'.",
+				},
+				seed: {
+					type: "number",
+					description: "Optional integer seed for reproducible output.",
+				},
+			},
+			required: ["prompt"],
+		},
+		command: "media.generate-music",
+	},
 	// `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.81.0",
+	"version": "1.87.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",