@writepanda/mcp 1.211.0 → 1.214.0

package/bin/server.mjs

@@ -636,6 +636,84 @@ const MOTION_ELEMENT_PROPS = {
 	anchor: { type: "string", enum: ["auto", "free"] },
 };
 const TOOLS = [
+	{
+		name: "folder_list",
+		description:
+			"Manage flat folders in the active workspace. Delete keeps projects unless deleteProjects is true.",
+		inputSchema: {
+			type: "object",
+			properties: {},
+			required: [],
+		},
+		command: "folder.list",
+	},
+	{
+		name: "folder_create",
+		description:
+			"Manage flat folders in the active workspace. Delete keeps projects unless deleteProjects is true.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				name: {
+					type: "string",
+				},
+			},
+			required: ["name"],
+		},
+		command: "folder.create",
+	},
+	{
+		name: "folder_rename",
+		description:
+			"Manage flat folders in the active workspace. Delete keeps projects unless deleteProjects is true.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: {
+					type: "string",
+				},
+				name: {
+					type: "string",
+				},
+			},
+			required: ["id", "name"],
+		},
+		command: "folder.rename",
+	},
+	{
+		name: "folder_delete",
+		description:
+			"Manage flat folders in the active workspace. Delete keeps projects unless deleteProjects is true.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: {
+					type: "string",
+				},
+				deleteProjects: {
+					type: "boolean",
+					default: false,
+				},
+			},
+			required: ["id"],
+		},
+		command: "folder.delete",
+	},
+	{
+		name: "folder_contents",
+		description:
+			"Manage flat folders in the active workspace. Delete keeps projects unless deleteProjects is true.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: {
+					type: "string",
+				},
+			},
+			required: ["id"],
+		},
+		command: "folder.contents",
+	},
 	// ── system + discovery ──────────────────────────────────────────
 	{
 		name: "system_status",
@@ -1273,6 +1351,8 @@ const TOOLS = [
 		inputSchema: {
 			type: "object",
 			properties: {
+				folderId: { type: ["string", "null"], description: "Folder UUID" },
+				topLevel: { type: "boolean" },
 				allWorkspaces: { type: "boolean" },
 				sortBy: { type: "string", enum: ["modifiedAt", "createdAt", "name"] },
 				order: { type: "string", enum: ["desc", "asc"] },
@@ -1288,6 +1368,7 @@ const TOOLS = [
 		inputSchema: {
 			type: "object",
 			properties: {
+				folderId: { type: ["string", "null"], description: "Folder UUID" },
 				id: { type: "string" },
 				path: { type: "string" },
 				folder: { type: "string" },
@@ -1315,6 +1396,7 @@ const TOOLS = [
 		inputSchema: {
 			type: "object",
 			properties: {
+				folderId: { type: ["string", "null"], description: "Folder UUID" },
 				id: { type: "string" },
 				path: { type: "string" },
 			},
@@ -1377,6 +1459,9 @@ const TOOLS = [
 		inputSchema: {
 			type: "object",
 			properties: {
+				folderId: { type: ["string", "null"], description: "Folder UUID" },
+				parentProjectId: { type: "string" },
+				originKind: { type: "string", enum: ["agent", "recipe"] },
 				name: { type: "string" },
 				withMedia: { type: "array", items: { type: "string" } },
 			},
@@ -1391,6 +1476,7 @@ const TOOLS = [
 		inputSchema: {
 			type: "object",
 			properties: {
+				folderId: { type: ["string", "null"], description: "Folder UUID" },
 				exportId: { type: "string" },
 				shotId: { type: "string" },
 				aspectRatio: { type: "string", description: "Default 9:16." },
@@ -1434,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" },
 			},
@@ -1782,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: {
@@ -1796,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",
@@ -3700,16 +3788,52 @@ const TOOLS = [
 	},
 
 	// ── transcript-based editing ────────────────────────────────────
+	{
+		name: "transcript_detect_language",
+		description:
+			"Guess a clip's language locally from up to 30 seconds. Returns guess or null when unavailable. Confirm with the user before cloud transcription.",
+		inputSchema: {
+			type: "object",
+			properties: { id: { type: "string" }, path: { type: "string" }, clipId: { type: "string" } },
+		},
+		command: "transcript.detect-language",
+	},
+
+	{
+		name: "system_set_transcription_preferences",
+		description:
+			"Save workspace language and provider atomically. Confirm consent to upload audio for cloud. Cloud cannot use auto.",
+		inputSchema: {
+			type: "object",
+			required: ["language", "provider"],
+			properties: {
+				language: { type: "string" },
+				provider: { type: "string", enum: ["local", "deepgram", "elevenlabs"] },
+			},
+		},
+		command: "system.set-transcription-preferences",
+	},
+
 	{
 		name: "transcript_transcribe",
 		description:
-			"Transcribe clips with word timestamps (default: only clips without words). To REDO a transcript (wrong language, bad run) fix the language first, then force: true (all clips) or clipId. Word fixes are re-applied; tell the user about result droppedWordEdits[] (fixes that may need redoing). Each clip is transcribed only over the part it plays (head trim to out-point, e.g. one half of a split; result transcribedRanges[]). ASYNC: { jobId }, job_wait. Concurrent saves are merged and retried (three attempts). Exhausted conflicts report code revision_conflict / status 409 (job.errorDetails for async jobs).",
+			"Transcribe clips with word timestamps (default: only clips without words). To REDO a transcript (wrong language, bad run) confirm language, pass per-run language and provider overrides, then force: true (all clips) or clipId. Word fixes are re-applied; tell the user about result droppedWordEdits[] (fixes that may need redoing). Each clip is transcribed only over the part it plays (head trim to out-point, e.g. one half of a split; result transcribedRanges[]). ASYNC: { jobId }, job_wait. 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: {
 				id: { type: "string" },
 				path: { type: "string" },
 				clipId: { type: "string", description: "Only this clip, even if already transcribed." },
+				language: {
+					type: "string",
+					description:
+						"Per-run spoken language name (english, tamil, etc.). Cloud cannot use auto.",
+				},
+				provider: {
+					type: "string",
+					enum: ["local", "deepgram", "elevenlabs"],
+					description: "Per-run provider. Audio is sent to the selected cloud provider.",
+				},
 				force: { type: "boolean", description: "Re-transcribe clips that already have words." },
 			},
 		},
@@ -5501,14 +5625,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.211.0",
+	"version": "1.214.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",