@writepanda/mcp 1.213.0 → 1.215.0

package/bin/server.mjs

@@ -1520,7 +1520,8 @@ const TOOLS = [
 				},
 				replaceToMs: {
 					type: "number",
-					description: "With atMs: cut [atMs, replaceToMs) (a trim) and put the clip there.",
+					description:
+						"With atMs: replace [atMs, replaceToMs), merge overlapping or adjacent cuts, and remove fully trimmed clips.",
 				},
 				expectedRevision: { type: "number" },
 			},
@@ -1868,7 +1869,7 @@ const TOOLS = [
 	{
 		name: "project_add_transition",
 		description:
-			"Place a transition centred on a cut (a clip boundary or a jump cut). kind overlay (fade-black, flash, glitch, torn-paper…) draws a WebM over the cut; kind native (zoom-blur, whip-left, whip-right, whip-up, spin) moves the footage itself (captions/graphics stay put), 350 ms default. Snaps atMs to a cut within snapMs (default 500) and places the transition's default sound.",
+			"Place a transition centred on a cut (a clip boundary or a jump cut). Cross-dissolve blends the outgoing and incoming shots with linear alpha, without dipping to black. kind overlay (fade-black, flash, glitch, torn-paper…) draws a WebM over the cut; kind native (cross-dissolve, zoom-blur, whip-left, whip-right, whip-up, spin) moves the footage itself (captions/graphics stay put), 1000 ms for cross-dissolve, 350 ms for motion transitions. Snaps atMs to a cut within snapMs (default 500) and places the transition's default sound.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1882,7 +1883,8 @@ const TOOLS = [
 				atMs: { type: "number", description: "The cut (edited ms)." },
 				durationMs: {
 					type: "number",
-					description: "Default: the catalog's (1000 overlays, 900 torn-paper, 350 native).",
+					description:
+						"Default: the catalog's (1000 overlays, 900 torn-paper, 1000 cross-dissolve, 350 motion).",
 				},
 				snapMs: {
 					type: "number",
@@ -3152,7 +3154,7 @@ const TOOLS = [
 	{
 		name: "project_set_webcam_layout",
 		description:
-			"Project-level webcam layout, position, scale and crop. side-by-side: cx < 0.5 = camera left. Per-clip: project_set_clip_layout; vertical screen recordings: project_set_vertical_screen_layout.",
+			"Project-level webcam layout, position, scale and crop. cutout: presenter over the full screen with camera background removed, no box; scale=1 gives 55% frame height, cy=1 allows the lower half offscreen. side-by-side: cx < 0.5 = camera left. Per-clip: project_set_clip_layout; vertical screen recordings: project_set_vertical_screen_layout.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -3161,6 +3163,7 @@ const TOOLS = [
 				preset: {
 					type: "string",
 					enum: [
+						"cutout",
 						"picture-in-picture",
 						"vertical-stack",
 						"side-by-side",
@@ -3754,6 +3757,7 @@ const TOOLS = [
 						"podcast",
 						"podcast-host-full",
 						"podcast-guest-full",
+						"cutout",
 						"picture-in-picture",
 						"side-by-side",
 						"vertical-stack",
@@ -3855,10 +3859,16 @@ const TOOLS = [
 	},
 	{
 		name: "transcript_delete_words",
-		description: "Delete words (their spans become trims).",
+		description:
+			"Delete words with measured quiet cut edges; cuts without pauses warn. snapToAudio=false uses legacy timing.",
 		inputSchema: {
 			type: "object",
 			properties: {
+				snapToAudio: {
+					type: "boolean",
+					description:
+						"Default true: measured quiet cuts; false uses legacy timing. Results include snapped/skipped/warnings.",
+				},
 				id: { type: "string" },
 				path: { type: "string" },
 				wordIds: { type: "array", items: { type: "string" } },
@@ -3903,10 +3913,16 @@ const TOOLS = [
 	},
 	{
 		name: "transcript_remove_fillers",
-		description: "Trim filler words (um, uh, hmm) and immediate repeats.",
+		description:
+			"Trim fillers and repeats only when measured pauses surround them; skipped fillers intentionally remain. Returns snapped/skipped/warnings; snapToAudio=false opts out.",
 		inputSchema: {
 			type: "object",
 			properties: {
+				snapToAudio: {
+					type: "boolean",
+					description:
+						"Default true: measured quiet cuts; false uses legacy timing. Results include snapped/skipped/warnings.",
+				},
 				id: { type: "string" },
 				path: { type: "string" },
 				aggressive: {
@@ -3972,14 +3988,22 @@ const TOOLS = [
 	{
 		name: "transcript_remove_silences",
 		description:
-			"Trim silences (transcript gaps plus audio dead air). Returns { removedCount, totalTrimmedMs }.",
+			"Remove measured quiet runs with a 50ms decay hold. Returns snapped/skipped/warnings; snapToAudio=false uses legacy timing.",
 		inputSchema: {
 			type: "object",
 			properties: {
+				snapToAudio: {
+					type: "boolean",
+					description:
+						"Default true: measured quiet cuts; false uses legacy timing. Results include snapped/skipped/warnings.",
+				},
 				id: { type: "string" },
 				path: { type: "string" },
 				thresholdMs: { type: "number", description: "Default 600." },
-				paddingMs: { type: "number", description: "Kept around words, default 100." },
+				paddingMs: {
+					type: "number",
+					description: "Legacy/fallback word guard, default 100. Measured audio uses a 50ms hold.",
+				},
 				expectedRevision: { type: "number" },
 			},
 		},
@@ -5623,14 +5647,15 @@ const TOOLS = [
 	// ── preview overlay ─────────────────────────────────────────────
 	{
 		name: "preview_show",
-		description: "Open a floating live preview window to show the user your work.",
+		description:
+			"Show and focus the editor, wait for media, seek to atMs within one frame and optionally start playback. Returns playheadMs and playing; errors report actual state.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				id: { type: "string" },
 				path: { type: "string" },
 				atMs: { type: "number" },
-				autoplay: { type: "boolean", description: "Default true." },
+				autoplay: { type: "boolean", description: "Default false. Start playback after seeking." },
 			},
 		},
 		command: "preview.show",

package/package.json

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