@writepanda/mcp 1.210.0 → 1.211.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)}`);
 	}
@@ -1479,7 +1480,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 +1492,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 +1587,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 +1611,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 +1817,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 +1854,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 +2601,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 +3001,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 +3018,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 +3239,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: {
@@ -3689,7 +3703,7 @@ const TOOLS = [
 	{
 		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) 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).",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -3854,7 +3868,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 +3876,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 +4618,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.211.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",