@writepanda/mcp 1.15.0 → 1.18.0

package/bin/server.mjs

@@ -171,6 +171,13 @@ const TOOLS = [
 		inputSchema: { type: "object", properties: {} },
 		command: "project.list",
 	},
+	{
+		name: "project_current",
+		description:
+			"Return the project currently loaded in the editor window: { project: {id, path, name, revision, clipCount} | null }. Use this when the user says 'edit what I'm working on' / 'the project that's open' — no need to ask them for an id. Returns { project: null } when no editor window is open.",
+		inputSchema: { type: "object", properties: {} },
+		command: "project.current",
+	},
 	{
 		name: "project_show",
 		description:
@@ -242,8 +249,7 @@ const TOOLS = [
 				media: { type: "string", description: "Absolute path to video file" },
 				atIndex: {
 					type: "number",
-					description:
-						"Insert before this zero-based clip index. Omit to append at the end.",
+					description: "Insert before this zero-based clip index. Omit to append at the end.",
 				},
 				expectedRevision: { type: "number" },
 			},
@@ -254,7 +260,7 @@ const TOOLS = [
 	{
 		name: "project_add_motion_graphic",
 		description:
-			"Drop a motion-graphic MP4 (typically the output of motion_generate) onto the timeline.",
+			"Drop a motion-graphic MP4 (typically the output of motion_generate) onto the timeline. Optional SFX plays when it appears.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -263,6 +269,15 @@ const TOOLS = [
 				file: { type: "string", description: "Absolute path to MP4" },
 				durationMs: { type: "number" },
 				atMs: { type: "number", description: "Default: end of timeline" },
+				soundUrl: {
+					type: "string",
+					description:
+						"Optional SFX played when the motion graphic appears. Bundled id (bundled:sound/<id>) like bundled:sound/message-pop, bundled:sound/swoosh-fast, etc. — use asset_list_sounds to discover. No default.",
+				},
+				soundVolume: {
+					type: "number",
+					description: "Sound volume 0–1. Default 1 when soundUrl is set.",
+				},
 				expectedRevision: { type: "number" },
 			},
 			required: ["file", "durationMs"],
@@ -305,7 +320,7 @@ const TOOLS = [
 				designType: {
 					type: "string",
 					description:
-						"name-bar | slash-reveal | center-stack | minimal-underline | box-reveal | corner-brackets | border-frame | split-horizontal",
+						"slash-reveal | center-stack | split-horizontal | name-bar | border-frame | minimal-underline | box-reveal | corner-brackets. Default: slash-reveal.",
 				},
 				accentColor: { type: "string", description: "Hex accent/background color" },
 				textColor: { type: "string", description: "Hex text color. Default #ffffff" },
@@ -319,6 +334,15 @@ const TOOLS = [
 				},
 				fontSize: { type: "number", description: "Primary text font size in px. Default 28" },
 				fontFamily: { type: "string", description: "CSS font family name. Default Inter" },
+				soundUrl: {
+					type: "string",
+					description:
+						'SFX played when the lower third enters. Bundled id (bundled:sound/<id>). Default bundled:sound/mouse-click. Pass "none" for silent.',
+				},
+				soundVolume: {
+					type: "number",
+					description: "Sound volume 0–1. Default 0.8.",
+				},
 				expectedRevision: { type: "number" },
 			},
 			required: ["content", "atMs"],
@@ -330,7 +354,7 @@ const TOOLS = [
 	{
 		name: "project_add_zoom",
 		description:
-			"Add a zoom region — highlight a UI moment. Typical pattern: find 'click X' in transcript, drop zoom there.",
+			"Add a zoom region — highlight a UI moment. Typical pattern: find 'click X' in transcript, drop zoom there. Ships with a short swoosh SFX by default; pass soundUrl=\"none\" for silent.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -341,12 +365,51 @@ const TOOLS = [
 				depth: { type: "number", description: "1 (mild) - 6 (extreme). Default 3" },
 				focusX: { type: "number", description: "Normalised 0-1 horizontal center. Default 0.5" },
 				focusY: { type: "number", description: "Normalised 0-1 vertical center. Default 0.5" },
+				soundUrl: {
+					type: "string",
+					description:
+						'SFX played at the zoom\'s leading edge. Bundled id (bundled:sound/<id>). Default bundled:sound/swoosh-fast. Pass "none" for silent.',
+				},
+				soundVolume: {
+					type: "number",
+					description: "Sound volume 0–1. Default 1.",
+				},
 				expectedRevision: { type: "number" },
 			},
 			required: ["atMs", "durationMs"],
 		},
 		command: "project.add-zoom",
 	},
+	{
+		name: "project_set_region_sound",
+		description:
+			'Set or clear the sound effect on an existing region (zoom / motionGraphic / lowerThird / fx). Use to swap the default zoom swoosh, add a ding to a motion graphic, or mute a lower-third click. Pass soundUrl="none" to clear.',
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				regionId: { type: "string", description: "Target region id" },
+				regionType: {
+					type: "string",
+					enum: ["zoom", "motionGraphic", "lowerThird", "fx"],
+					description: "Region kind that owns the id",
+				},
+				soundUrl: {
+					type: "string",
+					description:
+						'Bundled id (bundled:sound/<id>), absolute path, or file:// URL. Pass "none" to clear.',
+				},
+				soundVolume: {
+					type: "number",
+					description: 'Sound volume 0–1. Ignored when soundUrl is "none". Default 1.',
+				},
+				expectedRevision: { type: "number" },
+			},
+			required: ["regionId", "regionType", "soundUrl"],
+		},
+		command: "project.set-region-sound",
+	},
 	{
 		name: "project_add_trim",
 		description: "Mark a span the exporter SKIPS. Use directly for manual cuts.",
@@ -605,8 +668,7 @@ const TOOLS = [
 				},
 				resolution: {
 					type: "string",
-					description:
-						"Output resolution: 4k | 1080p | 720p | 480p | source. Default source.",
+					description: "Output resolution: 4k | 1080p | 720p | 480p | source. Default source.",
 				},
 				gifFrameRate: {
 					type: "number",
@@ -614,8 +676,7 @@ const TOOLS = [
 				},
 				gifSize: {
 					type: "string",
-					description:
-						"GIF size preset: small | medium | large. Only used when format is gif.",
+					description: "GIF size preset: small | medium | large. Only used when format is gif.",
 				},
 				expectedRevision: { type: "number" },
 			},
@@ -957,7 +1018,7 @@ const TOOLS = [
 	{
 		name: "motion_list",
 		description:
-			"List every motion-graphic template (id, name, slots, defaults, aspectRatios). 19 templates ship today.",
+			"List every motion-graphic template (id, name, slots, defaults, aspectRatios). 20 templates ship today, including youtube-lower-third for YouTube-style name plates.",
 		inputSchema: { type: "object", properties: {} },
 		command: "motion.list",
 	},
@@ -971,7 +1032,7 @@ const TOOLS = [
 	{
 		name: "motion_generate",
 		description:
-			"Render a motion graphic asynchronously. Returns { jobId, outputPath }; call job_wait. Output is an MP4 you can pass to project_add_motion_graphic.",
+			"Render a motion graphic asynchronously. Returns { jobId, outputPath }; call job_wait. Output is an MP4 you can pass to project_add_motion_graphic. Use templateId=youtube-lower-third (slots: channelName, handle, accentColor) for YouTube-style name plates with avatar + Subscribe button.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -987,7 +1048,7 @@ const TOOLS = [
 	{
 		name: "motion_render_html",
 		description:
-			"Render arbitrary HTML/CSS/JS to an MP4. Use this when the bundled motion-graphic templates don't fit the brief. Pass either inline `html` or a `htmlPath`. Animations should auto-start on DOMContentLoaded. IMPORTANT: renders are sequential — call job_wait to completion before starting another render, or you'll get a RENDER_BUSY error. Async — returns { jobId, outputPath }; poll job_wait for the final MP4.",
+			"Render arbitrary HTML/CSS/JS to video. Use this when the bundled motion-graphic templates don't fit the brief — you write the HTML, the Chromium → capturePage → FFmpeg pipeline does the rest. Pass either inline `html` or a `htmlPath`. Animations should auto-start on DOMContentLoaded. Set `transparent: true` to get a WebM with alpha channel for overlays (lower thirds, watermarks, name plates) that composite over existing video. IMPORTANT: renders are sequential — call job_wait to completion before starting another render, or you'll get a RENDER_BUSY error. Async — returns { jobId, outputPath }; poll job_wait for the final file.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1011,7 +1072,7 @@ const TOOLS = [
 				audioPath: {
 					type: "string",
 					description:
-						"Absolute path to an audio file (mp3, wav, aac, m4a) to mux into the MP4. Without this the output is silent.",
+						"Absolute path to an audio file (mp3, wav, aac, m4a) to mux into the MP4. Without this the output is silent. Ignored when transparent: true.",
 				},
 				audioVolume: {
 					type: "number",
@@ -1021,7 +1082,12 @@ const TOOLS = [
 					type: "array",
 					items: { type: "string" },
 					description:
-						"Absolute paths to local files to stage alongside inline HTML. Reference them by basename: pass [\"/path/logo.png\"] and use <img src=\"logo.png\"> in the HTML. Avoids base64-encoding large images.",
+						'Absolute paths to local files to stage alongside inline HTML. Reference them by basename: pass ["/path/logo.png"] and use <img src="logo.png"> in the HTML. Avoids base64-encoding large images.',
+				},
+				transparent: {
+					type: "boolean",
+					description:
+						"Render with a transparent background (VP9/yuva420p WebM instead of H.264 MP4). Use for overlays — lower thirds, watermarks, bug logos, name plates — anything that composites on top of existing video without a white/black fill. The returned outputPath will have a .webm extension. Note: audioPath is ignored in transparent mode.",
 				},
 			},
 		},
@@ -1159,7 +1225,7 @@ const TOOLS = [
 	{
 		name: "export_start",
 		description:
-			"Render the project to MP4 via the same Skia native render-helper the editor's Export button uses. ASYNC — returns { jobId, outputPath }; call job_wait. Honours every region/style/caption/FX/lower-third/motion-graphic.",
+			"Render the project to MP4 via the same Skia native render-helper the editor's Export button uses. ASYNC — returns { jobId, outputPath }; call job_wait. Honours every region/style/caption/FX/lower-third/motion-graphic. Video overlays (motion graphics added via project_add_motion_graphic) are automatically composited in a post-process FFmpeg pass — both opaque MP4 and transparent WebM/VP9+alpha overlays are supported; no extra call needed.",
 		inputSchema: {
 			type: "object",
 			properties: {

package/package.json

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