@writepanda/mcp 1.269.0 → 1.272.0

package/bin/server.mjs

@@ -623,6 +623,11 @@ const MOTION_ELEMENT_PROPS = {
 			accent: { type: "string" },
 			highlight: { type: "string" },
 			text: { type: "string" },
+			surface: {
+				type: "string",
+				description:
+					"The element's own plate / pill / band colour (lowerThird plate, chip, endCard, ticker band). Default: the family's (clean = light card). Text left unset picks a readable ink.",
+			},
 			font: { type: "string" },
 			size: { type: "string", enum: ["xs", "s", "m", "l", "xl"] },
 			outline: { type: "boolean" },
@@ -783,6 +788,10 @@ const TOOLS = [
 					type: "string",
 					description: "What happened and your diagnosis (no user content).",
 				},
+				description: {
+					type: "string",
+					description: "Same as details; pass either.",
+				},
 				kind: {
 					type: "string",
 					enum: ["capability-gap", "command-failed", "wrong-output", "crash", "confusing", "other"],
@@ -800,7 +809,7 @@ const TOOLS = [
 				userContent: { type: "string" },
 				userConsented: { type: "boolean" },
 			},
-			required: ["title", "details"],
+			required: ["title"],
 		},
 		command: "system.report-issue",
 	},
@@ -2020,11 +2029,11 @@ const TOOLS = [
 	...[
 		[
 			"status",
-			"Read the live podcast session code, guest link, recording and sharing state, the host's micMuted / cameraOff / devices, and each guest's name, role, state, micMuted, cameraOff and sharing.",
+			"Read the live podcast session code, mode (hosting / producing), links (guest, call-in, host, producer), recording and sharing state, the desktop's micMuted / cameraOff / devices, each guest's name, role, state, micMuted, cameraOff and sharing, and people: everyone's role, stage (on / back), upNext, talkingPrivately and (while recording) whether they're recorded. While recording, takeStage is who was on stage when.",
 		],
 		[
 			"start-recording",
-			"Start recording the host and signal connected guests to record. Returns once recording has really started; fails with the reason otherwise.",
+			"Start the take: everyone on stage records now, everyone else from their first time on stage (a producer backstage is never recorded). Returns once recording has really started; fails with the reason otherwise.",
 		],
 		[
 			"stop-recording",
@@ -2149,19 +2158,67 @@ const TOOLS = [
 	{
 		name: "podcast_set_stage",
 		description:
-			"Put a participant (host | guest | guest-2 | guest-3) on air or backstage (onAir), or mute them in the stream only (muted). The recording is never affected.",
+			"Put someone on stage or backstage (stage on|back, live or recording or before the show), queue them up next (upNext: they hear the show and get a cue), or mute them in the stream only (muted). Only on-stage people are in the stream, the recording and the edit; backstage they're recorded as silence. Ids: host (the show's host), producer (the desktop when a producer runs the show), cohost, guest, guest-2, guest-3, caller-N, producer-web-N (browser producers can't go on stage). See podcast_status.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				waitSec: PODCAST_WAIT,
 				participant: { type: "string" },
-				onAir: { type: "boolean" },
+				stage: { type: "string", enum: ["on", "back"] },
+				onAir: { type: "boolean", description: "Same as stage on (true) / back (false)." },
+				upNext: { type: "boolean" },
 				muted: { type: "boolean" },
 			},
 			required: ["participant"],
 		},
 		command: "podcast.set-stage",
 	},
+	{
+		name: "podcast_talkback",
+		description:
+			'Talk privately from the studio desktop (a producer running the show): its mic reaches only `to` (participant ids, or "stage" for everyone on stage), never the stream or the recording, until you call it with active false.',
+		inputSchema: {
+			type: "object",
+			properties: {
+				to: { type: "array", items: { type: "string" } },
+				active: { type: "boolean", description: "false stops (default true)." },
+			},
+		},
+		command: "podcast.talkback",
+	},
+	{
+		name: "podcast_set_mode",
+		description:
+			"Who runs the show from this desktop: hosting (its operator hosts, on camera; default) or producing (a producer runs the studio backstage, never recorded unless they step on stage; the host joins by the host link from podcast_invite as host). Not while recording.",
+		inputSchema: {
+			type: "object",
+			properties: { mode: { type: "string", enum: ["hosting", "producing"] } },
+			required: ["mode"],
+		},
+		command: "podcast.set-mode",
+	},
+	{
+		name: "podcast_host_control",
+		description:
+			"Give the host (host link) control on their page, or take it back: Record, bring people on or backstage, next segment. Graphics and going live stay with the producer. Off by default.",
+		inputSchema: {
+			type: "object",
+			properties: { on: { type: "boolean" } },
+			required: ["on"],
+		},
+		command: "podcast.host-control",
+	},
+	{
+		name: "podcast_cue_host",
+		description:
+			'Show the host a cue card on their page ("Wrap up in 2", "Ask about pricing"). Never on air. Needs the host connected by the host link.',
+		inputSchema: {
+			type: "object",
+			properties: { text: { type: "string", description: "Up to 280 characters." } },
+			required: ["text"],
+		},
+		command: "podcast.cue-host",
+	},
 	{
 		name: "podcast_show_overlay",
 		description:
@@ -2290,10 +2347,214 @@ const TOOLS = [
 						"YouTube title when it should differ from the episode title; empty = follow it.",
 				},
 				draftRundown: { type: "boolean" },
+				mode: {
+					type: "string",
+					enum: ["hosting", "producing"],
+					description:
+						"producing: a producer runs the studio, the host joins by the host link (podcast_invite as host).",
+				},
+				host: {
+					type: "object",
+					description: "Producing: the show's host (their lower third).",
+					properties: {
+						name: { type: "string" },
+						email: { type: "string" },
+						role: { type: "string" },
+					},
+					required: ["name"],
+				},
+				crew: {
+					type: "array",
+					description: "The production side: producers, editor, client.",
+					items: {
+						type: "object",
+						properties: {
+							name: { type: "string" },
+							email: { type: "string" },
+							role: { type: "string" },
+						},
+						required: ["name"],
+					},
+				},
+				hostControl: {
+					type: "boolean",
+					description: "Producing: the host gets Record, stage and next segment on their page.",
+				},
+				showId: { type: "string", description: "The show (series) it belongs to." },
 			},
 		},
 		command: "podcast.schedule",
 	},
+	{
+		name: "show_list",
+		description:
+			"Podcast shows (series) in the current workspace. A workspace is the client; a show is one of its series, with defaults for new episodes and a delivery after each recording.",
+		inputSchema: { type: "object", properties: {} },
+		command: "show.list",
+	},
+	{
+		name: "show_create",
+		description:
+			"Create a podcast show in the current workspace. Episodes scheduled with its showId (podcast_schedule) start from its mode (hosting / producing), host, crew, host control, run-of-show template, recipe and destinations. A delivery with edit / MP3 / Shorts / upload proposes a delivery routine the user turns on.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				name: { type: "string" },
+				description: { type: "string" },
+				mode: { type: "string", enum: ["hosting", "producing"] },
+				host: {
+					type: "object",
+					properties: {
+						name: { type: "string" },
+						email: { type: "string" },
+						role: { type: "string" },
+					},
+					required: ["name"],
+				},
+				crew: {
+					type: "array",
+					items: {
+						type: "object",
+						properties: {
+							name: { type: "string" },
+							email: { type: "string" },
+							role: { type: "string" },
+						},
+						required: ["name"],
+					},
+				},
+				hostControl: { type: "boolean" },
+				recipeId: { type: "string", description: "The edit's recipe (recipe_list); empty clears." },
+				rundownTemplate: { type: "object", description: "Run of show new episodes start from." },
+				destinationIds: { type: "array", items: { type: "string" } },
+				delivery: {
+					type: "object",
+					description:
+						"After each recorded episode: folder (absolute) gets rawFiles (each person's own recording + the live program); edit, audioMaster (MP3), shorts (0-10) and youtube {accountId, privacy} run as a delivery routine the user turns on. null clears.",
+					properties: {
+						folder: { type: "string" },
+						rawFiles: { type: "boolean" },
+						edit: { type: "boolean" },
+						audioMaster: { type: "boolean" },
+						shorts: { type: "number" },
+						youtube: {
+							type: "object",
+							properties: {
+								accountId: { type: "string" },
+								privacy: { type: "string", enum: ["private", "unlisted", "public"] },
+							},
+							required: ["accountId"],
+						},
+						notes: { type: "string" },
+					},
+				},
+			},
+			required: ["name"],
+		},
+		command: "show.create",
+	},
+	{
+		name: "show_update",
+		description: "Change a show's name, defaults or delivery (only the fields given).",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				name: { type: "string" },
+				description: { type: "string" },
+				mode: { type: "string", enum: ["hosting", "producing"] },
+				host: {
+					type: "object",
+					properties: {
+						name: { type: "string" },
+						email: { type: "string" },
+						role: { type: "string" },
+					},
+					required: ["name"],
+				},
+				crew: {
+					type: "array",
+					items: {
+						type: "object",
+						properties: {
+							name: { type: "string" },
+							email: { type: "string" },
+							role: { type: "string" },
+						},
+						required: ["name"],
+					},
+				},
+				hostControl: { type: "boolean" },
+				recipeId: { type: "string", description: "The edit's recipe (recipe_list); empty clears." },
+				rundownTemplate: { type: "object", description: "Run of show new episodes start from." },
+				destinationIds: { type: "array", items: { type: "string" } },
+				delivery: {
+					type: "object",
+					description:
+						"After each recorded episode: folder (absolute) gets rawFiles (each person's own recording + the live program); edit, audioMaster (MP3), shorts (0-10) and youtube {accountId, privacy} run as a delivery routine the user turns on. null clears.",
+					properties: {
+						folder: { type: "string" },
+						rawFiles: { type: "boolean" },
+						edit: { type: "boolean" },
+						audioMaster: { type: "boolean" },
+						shorts: { type: "number" },
+						youtube: {
+							type: "object",
+							properties: {
+								accountId: { type: "string" },
+								privacy: { type: "string", enum: ["private", "unlisted", "public"] },
+							},
+							required: ["accountId"],
+						},
+						notes: { type: "string" },
+					},
+				},
+			},
+			required: ["id"],
+		},
+		command: "show.update",
+	},
+	{
+		name: "show_set_delivery",
+		description:
+			"What to hand over after each recorded episode of a show: raw files to a folder (copied right after recording), plus the edit, MP3, Shorts and YouTube upload as a delivery routine the user turns on.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				delivery: {
+					type: "object",
+					description:
+						"After each recorded episode: folder (absolute) gets rawFiles (each person's own recording + the live program); edit, audioMaster (MP3), shorts (0-10) and youtube {accountId, privacy} run as a delivery routine the user turns on. null clears.",
+					properties: {
+						folder: { type: "string" },
+						rawFiles: { type: "boolean" },
+						edit: { type: "boolean" },
+						audioMaster: { type: "boolean" },
+						shorts: { type: "number" },
+						youtube: {
+							type: "object",
+							properties: {
+								accountId: { type: "string" },
+								privacy: { type: "string", enum: ["private", "unlisted", "public"] },
+							},
+							required: ["accountId"],
+						},
+						notes: { type: "string" },
+					},
+				},
+			},
+			required: ["id", "delivery"],
+		},
+		command: "show.set-delivery",
+	},
+	{
+		name: "show_delete",
+		description:
+			"Delete a show (ask the user first). Its episodes and files stay; its delivery routine is removed.",
+		inputSchema: { type: "object", properties: { id: { type: "string" } }, required: ["id"] },
+		command: "show.delete",
+	},
 	{
 		name: "podcast_list_upcoming",
 		description:
@@ -2324,13 +2585,14 @@ const TOOLS = [
 	{
 		name: "podcast_invite",
 		description:
-			"An episode's guest invite: join link, invite text and a calendar invite (.ics, needs a date). out writes the .ics there. Don't send it yourself unless the user asks.",
+			"An episode's invite: the link, invite text and a calendar invite (.ics, needs a date). as: guest (default), host (the host link, when a producer runs the studio) or producer (a browser producer link: watch, talk privately, approve the AI producer). out writes the .ics there. Don't send it yourself unless the user asks.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				path: { type: "string" },
 				id: { type: "string" },
 				sessionCode: { type: "string" },
+				as: { type: "string", enum: ["guest", "host", "producer"] },
 				out: { type: "string", description: "Absolute path ending in .ics." },
 				hostName: { type: "string" },
 			},
@@ -3472,7 +3734,7 @@ const TOOLS = [
 	{
 		name: "project_check_broll",
 		description:
-			"B-roll, the LAST step of an edit. YOU pick the moments from what's said (transcript_get; any language, any topic; in a Short ~1 per 6-8 s with the first right after the opening line, in long-form ~1 per 10-15 s) and what each picture shows; this checks them: span, clashes with the steps list / end card / other pictures, spacing, a nearby suggestion when blocked, insetSide (card away from the face). No moments: free stretches. Returns imageConnector. Never makes images: show the user your moments and ASK: their own images, generate on their connector (uses credits), or none. No one to ask: skip it and say so.",
+			"B-roll, the LAST step of an edit. YOU pick the moments from what's said (transcript_get; any language, any topic; in a Short ~1 per 6-8 s with the first right after the opening line, in long-form ~1 per 10-15 s) and what each picture shows; this checks them: span, clashes with the steps list / end card / pictures it would hide / graphics covering most of it (by position and stacking: a thin header or logo strip over it is fine), spacing, a nearby suggestion when blocked, insetSide (card away from the face). No moments: free stretches. Returns imageConnector. Never makes images: show the user your moments and ASK: their own images, generate on their connector (uses credits), or none. No one to ask: skip it and say so.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -3488,6 +3750,11 @@ const TOOLS = [
 							endWordId: { type: "string" },
 							durationMs: { type: "number" },
 							picture: { type: "string", description: "What the picture shows." },
+							layout: {
+								type: "string",
+								enum: ["full", "inset"],
+								description: "The add-broll layout you plan (default full).",
+							},
 						},
 					},
 				},
@@ -5140,6 +5407,24 @@ const TOOLS = [
 		},
 		command: "project.set-clip-chroma-key",
 	},
+	{
+		name: "project_set_clip_flip",
+		description:
+			"Flip a main-track clip's picture: fixes a recording that came out upside down (horizontal + vertical = turned 180 degrees, e.g. a monitor mounted upside down) or mirrored (horizontal). Corrects the source: crops, cursor and zoom focus read the flipped picture. Omitted axes keep their value; both false removes it. Check with project_render_frame.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				clipId: { type: "string" },
+				horizontal: { type: "boolean", description: "Mirror left to right." },
+				vertical: { type: "boolean", description: "Mirror top to bottom." },
+				expectedRevision: { type: "number" },
+			},
+			required: ["clipId"],
+		},
+		command: "project.set-clip-flip",
+	},
 	{
 		name: "project_set_clip_kind",
 		description:
@@ -5459,7 +5744,7 @@ const TOOLS = [
 	{
 		name: "transcript_transcribe",
 		description:
-			"Transcribe clips with word timestamps (default: only clips without words). Engine: language auto/english = Parakeet; any other named language = local Whisper LOCKED to it (engine override). Returns { jobId, plan } (plan = engine + reason, ranges, totalAudioMs: the audio that will be processed, estimate/estimatedMs: how long on this computer, advice: faster options for a long Whisper run; tell the user for long jobs). Long Whisper runs are saved chunk by chunk: stalls restart from the last chunk automatically; after job_cancel, a crash or an app restart, transcribing again resumes there. Progress is real (audio decoded); time left in progress.message and progress.data.etaMs. 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 tail trim, e.g. one half of a split; only the kept parts when cuts hide most of a long recording; 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). Engine: language auto/english = Parakeet; any other named language = local Whisper LOCKED to it (engine override). Returns { jobId, plan } (plan = engine + reason, ranges, totalAudioMs: the audio that will be processed, estimate/estimatedMs: how long on this computer, advice: faster options for a long Whisper run; tell the user for long jobs). Long Whisper runs are saved chunk by chunk: stalls restart from the last chunk automatically; after job_cancel, a crash or an app restart, transcribing again resumes there. Progress is real (audio decoded); time left in progress.message and progress.data.etaMs. 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 tail trim, e.g. one half of a split; only the kept parts when cuts hide most of a long recording; result transcribedRanges[]). Clips with no audio track are skipped (result noAudioClips), not failed. Result warnings[] flags words that can't cover the audio (sound with no words, too few words: music, noise, another language) and a re-run with the same words as before: surface it, and get a second reading with engine whisper or a cloud provider (Parakeet isn't locked by language english, so retrying the same way repeats it). 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: {
@@ -7531,6 +7816,13 @@ const TOOLS = [
 					description:
 						"{ id?, title, description, category, footage?, aspectRatio?, fields: [{ key, label, type: text|longtext|select|color|images, default?, options?, required?, help?, minCount?, maxCount?, optional? }], prompt, lookFrames?: [{ src: absolute image path, shows: what it shows (position, size, colours), atMs? }] (up to 8 stills of the target look; copied into the recipe), style?: { aspectRatio?, colorCorrection?, lut?: { preset, intensity? }, speakerBackground?: { mode: none|blur|remove|image, image?, strength?, outline?: { enabled, width?, color?, shadow? } }, framing?: { shortsLayout: full|camera-corner }, cameraLayout?, captions?: { enabled, templateId?, wordsPerLine?, positionY?, style?: caption_set_look's style }, broll?: { use: none|ask|generate|user-images, layout?: full|split|card, notes? }, graphics?: { family?, titleFont?, bodyFont?, accentColor?, textColor?, surfaceColor?, notes? }, wallpaper? }, checklist: string[] }. Put the WHOLE look in style (every caption value, the background, framing, B-roll rule, title fonts and colours): it is applied exactly, the prompt only covers what depends on the footage.",
 				},
+				id: {
+					type: "string",
+					description:
+						"Project the edit was made in (default: the one open in the editor). Without lookFrames, three stills of it become the recipe's cover on Home and the look the next run matches.",
+				},
+				path: { type: "string", description: "Same as id, by project file path." },
+				stills: { type: "boolean", description: "false = save without stills of the edit." },
 			},
 			required: ["recipe"],
 		},

package/package.json

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