@writepanda/mcp 1.210.0 → 1.213.0

package/bin/server.mjs

@@ -212,6 +212,7 @@ async function callPandastudio(command, args = {}) {
 	} catch {
 		body = { raw: text };
 	}
+	if (res.status === 409 && body?.details?.code === "revision_conflict") return body;
 	if (res.status >= 400) {
 		throw new Error(`HTTP ${res.status}: ${body?.error ?? text.slice(0, 200)}`);
 	}
@@ -635,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",
@@ -1272,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"] },
@@ -1287,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" },
@@ -1314,6 +1396,7 @@ const TOOLS = [
 		inputSchema: {
 			type: "object",
 			properties: {
+				folderId: { type: ["string", "null"], description: "Folder UUID" },
 				id: { type: "string" },
 				path: { type: "string" },
 			},
@@ -1376,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" } },
 			},
@@ -1390,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." },
@@ -1479,7 +1566,8 @@ const TOOLS = [
 	},
 	{
 		name: "podcast_open_host",
-		description: "Open or focus the live podcast host window. Call podcast_status for the session code and guest link once it loads.",
+		description:
+			"Open or focus the live podcast host window. Call podcast_status for the session code and guest link once it loads.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1490,10 +1578,22 @@ const TOOLS = [
 		command: "podcast.open-host",
 	},
 	...[
-		["status", "Read the live podcast session code, guest link, participants, recording, and sharing state."],
-		["start-recording", "Start recording the host and signal connected guests to record. Returns once recording has really started; fails with the reason otherwise."],
-		["stop-recording", "Stop recording and finalize podcast media. Check podcast_status for finalization and guest uploads."],
-		["start-screen-share", "Open the desktop picker to share and record the host screen during a podcast. Waits for the host to choose; fails if the picker is cancelled or capture fails."],
+		[
+			"status",
+			"Read the live podcast session code, guest link, participants, recording, and sharing state.",
+		],
+		[
+			"start-recording",
+			"Start recording the host and signal connected guests to record. Returns once recording has really started; fails with the reason otherwise.",
+		],
+		[
+			"stop-recording",
+			"Stop recording and finalize podcast media. Check podcast_status for finalization and guest uploads.",
+		],
+		[
+			"start-screen-share",
+			"Open the desktop picker to share and record the host screen during a podcast. Waits for the host to choose; fails if the picker is cancelled or capture fails.",
+		],
 		["stop-screen-share", "Stop and finalize the host's podcast screen share."],
 		["open-in-editor", "Open the finished podcast in the editor when guest media has arrived."],
 	].map(([noun, description]) => ({
@@ -1573,7 +1673,7 @@ const TOOLS = [
 	{
 		name: "project_update_motion_graphic",
 		description:
-			"Edit a generated graphic (overlay with generatedFrom) and re-render it in place, keeping timing and position. ASYNC: { jobId }.",
+			"Edit a generated graphic (overlay with generatedFrom) and re-render it in place, keeping timing and position. ASYNC: { jobId }. 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: {
@@ -1597,7 +1697,7 @@ const TOOLS = [
 	{
 		name: "project_add_emoji",
 		description:
-			"Place an animated emoji overlay. ASYNC: { jobId }; job_wait gives result.overlayId.",
+			"Place an animated emoji overlay. ASYNC: { jobId }; job_wait gives result.overlayId. 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: {
@@ -1803,7 +1903,7 @@ const TOOLS = [
 	{
 		name: "project_add_lower_third",
 		description:
-			"Render a nameplate and place it at atMs in one call, laid out for the project's aspect. ASYNC: { jobId }; job_wait gives result.overlayId once placed.",
+			"Render a nameplate and place it at atMs in one call, laid out for the project's aspect. ASYNC: { jobId }; job_wait gives result.overlayId once placed. 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: {
@@ -1840,7 +1940,7 @@ const TOOLS = [
 	{
 		name: "project_add_title_behind",
 		description:
-			"1-3 huge words at head height BEHIND the presenter. ASYNC: job_wait gives regionId, face.",
+			"1-3 huge words at head height BEHIND the presenter. ASYNC: job_wait gives regionId, face. 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: {
@@ -2587,7 +2687,7 @@ const TOOLS = [
 	{
 		name: "audio_probe",
 		description:
-			"Per-clip audio stats: hasAudio, mean/max dB, silence spans (source time), plus audio overlays. A few seconds per clip.",
+			"Per-clip audio stats: hasAudio, integratedLufs (null if unavailable/silent), tooQuiet (< -30 LUFS), mean/max dB, silence spans (source time), plus audio overlays. A few seconds per clip.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -2987,7 +3087,7 @@ const TOOLS = [
 	{
 		name: "project_center_camera_on_face",
 		description:
-			"Keep the presenter's face centred in the camera card by tracking it (can take a minute). clear: true turns it off.",
+			"Keep the presenter's face centred in the camera card by tracking it (can take a minute). clear: true turns it off. 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: {
@@ -3004,7 +3104,7 @@ const TOOLS = [
 	{
 		name: "project_batch",
 		description:
-			"Run up to 200 verb.noun commands on one project in order (id / path filled in; not atomic; stops at the first failure by default). Returns { ran, failed, results[] }.",
+			"Run up to 200 verb.noun commands on one project in order (id / path filled in; not atomic; stops at the first failure by default). Returns { ran, failed, results[] }. 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: {
@@ -3225,7 +3325,7 @@ const TOOLS = [
 	{
 		name: "project_auto_reframe",
 		description:
-			"Active-speaker auto-reframe of landscape multi-person footage for vertical / square: frames whoever talks, shot by shot. split=true stacks two people (podcast / interview wide) one above the other on a 9:16 canvas. Slow (minutes). clear reverts.",
+			"Active-speaker auto-reframe of landscape multi-person footage for vertical / square: frames whoever talks, shot by shot. split=true stacks two people (podcast / interview wide) one above the other on a 9:16 canvas. Slow (minutes). clear reverts. 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: {
@@ -3686,16 +3786,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.",
+			"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." },
 			},
 		},
@@ -3854,7 +3990,7 @@ const TOOLS = [
 	{
 		name: "audio_clean",
 		description:
-			"Denoise each clip's audio, optionally reducing room echo (original kept). ASYNC: { jobId }, job_wait.",
+			"Denoise each clip’s audio, optionally reducing room echo. Speech below -30 LUFS is boosted to -16 LUFS / -1.5 dBTP by default; warnings explain boosts. Original kept; audio_reset_clean restores it. ASYNC: { jobId }, job_wait. Concurrent saves are merged and retried (three attempts); exhausted conflicts report code revision_conflict / status 409.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -3862,11 +3998,42 @@ const TOOLS = [
 				path: { type: "string" },
 				clipId: { type: "string" },
 				echo: { type: "boolean", description: "Only when the user mentions echo / reverb." },
+				normalize: {
+					type: "boolean",
+					description: "Default true: boost very quiet speech. Set false to opt out.",
+				},
 			},
 		},
 		command: "audio.clean",
 	},
 
+	{
+		name: "audio_normalize",
+		description:
+			"Normalize a clip’s active audio without denoising. Default -16 LUFS, -1.5 dBTP ceiling. Silent audio skipped with warnings. Original kept. ASYNC: job_wait.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				clipId: { type: "string" },
+				targetLufs: { type: "number", minimum: -70, maximum: -5, default: -16 },
+			},
+			required: ["clipId"],
+		},
+		command: "audio.normalize",
+	},
+	{
+		name: "audio_reset_clean",
+		description:
+			"Restore original clip audio by clearing cleaned/normalized audio and echo metadata. Optional clipId; otherwise all clips. Keeps generated files. Synchronous.",
+		inputSchema: {
+			type: "object",
+			properties: { id: { type: "string" }, path: { type: "string" }, clipId: { type: "string" } },
+		},
+		command: "audio.reset-clean",
+	},
+
 	// ── captions ────────────────────────────────────────────────────
 	{
 		name: "caption_toggle",
@@ -4573,7 +4740,7 @@ const TOOLS = [
 	{
 		name: "media_download_url",
 		description:
-			"Download a video or its audio from a page link (YouTube, Vimeo...). Only content the user has rights to. ASYNC: job_wait gives { path, title, durationMs }.",
+			"Download a video or its audio from a page link (YouTube, Vimeo...). Only content the user has rights to. ASYNC: job_wait gives { path, title, durationMs }. Project placement retries concurrent-save conflicts (three attempts); exhaustion is job.errorDetails with revision_conflict / status 409.",
 		inputSchema: {
 			type: "object",
 			properties: {

package/package.json

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