@writepanda/mcp 1.198.0 → 1.201.0

package/bin/server.mjs

@@ -567,13 +567,16 @@ const MOTION_ELEMENT_TYPES = [
 	"iconPop",
 	"frame",
 	"sticker",
+	"ticker",
+	"credits",
+	"crawl",
 ];
 const MOTION_ELEMENT_PROPS = {
 	type: { type: "string", enum: MOTION_ELEMENT_TYPES },
 	content: {
 		type: ["object", "string", "array"],
 		description:
-			'keyword/chip/stamp/slam/behind/highlight { text } (or a bare string); count { value, to?, prefix?, suffix?, label?, decimals? } (value "20-30" = range); steps { items[], cues? (ms offsets from start) }; lowerThird { title, subtitle? }; endCard { lines: [a, b] }; progress { label?, fromMs?, toMs? }; iconPop { emoji } | { icon }; frame { look: viewfinder | selection | corners, label? }; sticker { image: transparent PNG path, label? }. Latin script only.',
+			'keyword/chip/stamp/slam/behind/highlight { text } (or a bare string); count { value, to?, prefix?, suffix?, label?, decimals? } (value "20-30" = range); steps { items[], cues? (ms offsets from start) }; lowerThird { title, subtitle? (<=320 chars, wraps), look?: plate|plain|typewriter }; endCard { lines: [a, b] }; progress { label?, fromMs?, toMs? }; iconPop { emoji } | { icon }; frame { look: viewfinder | selection | corners, label? }; sticker { image: transparent PNG path, label? }; ticker { text (one story per line, <=2000 chars), label?, speed? (40-600 px/s) }; credits { title?, entries: [{ role?, name }] | "Role: Name" strings (<=200) }; crawl { title?, text (<=6000 chars), tilt? (0-80), turn? (-60..60) }. Any script, symbols and emoji draw.',
 	},
 	atMs: { type: "number", description: "Start, edited ms. Or wordId." },
 	wordId: {
@@ -596,8 +599,19 @@ const MOTION_ELEMENT_PROPS = {
 			highlight: { type: "string" },
 			text: { type: "string" },
 			font: { type: "string" },
-			size: { type: "string", enum: ["s", "m", "l", "xl"] },
+			size: { type: "string", enum: ["xs", "s", "m", "l", "xl"] },
 			outline: { type: "boolean" },
+			opacity: { type: "number", minimum: 0, maximum: 1, description: "Main text opacity." },
+			secondary: {
+				type: "object",
+				description:
+					"The smaller line (count label, lower-third subtitle, ticker label box, credits roles).",
+				properties: {
+					size: { type: "number", minimum: 0.4, maximum: 2.5, description: "1 = default." },
+					opacity: { type: "number", minimum: 0, maximum: 1 },
+					color: { type: "string" },
+				},
+			},
 		},
 		description: "Default: the brand kit.",
 	},
@@ -2112,10 +2126,34 @@ const TOOLS = [
 		},
 		command: "project.remove-bleep",
 	},
+	{
+		name: "project_follow_speaker",
+		description:
+			"Podcast recordings (each person on their own camera): cut the frame to whoever is talking from the transcript's speaker tags. podcast-solo per turn, podcast-pair (both) in quick back-and-forth, no cut for short interjections. Anchored, re-runnable; run after the cuts. One wide shot of several people: project_auto_reframe instead.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				minTurnMs: { type: "number", description: "Shorter turns don't cut away (default 1200)." },
+				pair: {
+					type: "boolean",
+					description: "Both people during quick exchanges (default true).",
+				},
+				exchangeTurnMs: {
+					type: "number",
+					description: "Turn length that counts as quick (default 2600).",
+				},
+				dryRun: { type: "boolean" },
+				expectedRevision: { type: "number" },
+			},
+		},
+		command: "project.follow-speaker",
+	},
 	{
 		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; ~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 / 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.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4476,6 +4514,21 @@ const TOOLS = [
 		},
 		command: "recipe.list",
 	},
+	{
+		name: "recipe_pick",
+		description:
+			"No style named ('edit my video', 'make this a Short')? The recipes that fit this project's format and footage, each with pickWhen, plus defaultId. Choose by what's said, then recipe_apply_style + recipe_render.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Project id (default: the open project)." },
+				path: { type: "string" },
+				format: { type: "string", enum: ["short", "long"] },
+				footage: { type: "string", enum: ["camera", "screen", "podcast", "none"] },
+			},
+		},
+		command: "recipe.pick",
+	},
 	{
 		name: "recipe_get",
 		description: "Read one recipe in full.",
@@ -5270,22 +5323,18 @@ Start with system_status. Unknown arguments are rejected. Verbs without a tool o
 
 Before an editing pass, read the skill's "Which tool for which moment" section (skill_read section="Which tool for which moment").
 
-"Edit my video" with no specifics = this pipeline, in order. Confirm scope once ("full polish, or just part of it?"), then run it all:
+"Edit my video" / "make this a Short" with no specifics = this pipeline, in order. Confirm scope once ("full polish, or just part of it?"), then run it all:
 1. transcript_transcribe clips not yet transcribed (project_read clipStates).
 2. transcript_remove_fillers.
 3. Fix misheard names / brands with transcript_find_replace (transcript_insert_words for dropped words).
 4. transcript_find_issues, then transcript_delete_words on each duplicate take / false start (keep the LAST take; keep severity "low" ones).
 5. transcript_remove_silences.
 6. audio_clean clips not yet cleaned.
-7. Captions (caption_toggle; template glowStack unless a recipe says otherwise), motion graphics, emphasis zooms: only after steps 2-5, which shift the timeline.
+7. The style, after steps 2-5 (they shift the timeline). The user's named style, recipe, creator or a saved memory wins. Otherwise call recipe_pick: it returns the recipes that fit this project's format and footage, each with pickWhen, plus defaultId. Read the transcript, choose the ONE candidate whose pickWhen matches what is said (defaultId when none clearly fits), do its "before" step if any, then recipe_apply_style + recipe_render and follow the prompt: the recipe decides captions, graphics, zooms, music and transitions. (An app without recipe_pick, 2.0.5 and older: recipe_list with format short or long, and choose by description and footage.) Tell the user which recipe and why in one line and name one or two alternatives. Only when no candidate exists or the user asked for a plain clean-up: captions (caption_toggle, template glowStack), a few motion graphics, emphasis zooms.
 8. B-roll, last: pick the moments yourself from what's said (any language), check them with project_check_broll, show the user your moments and ASK: their own images, generated on their image connector (only if one is connected; it uses their credits), or no B-roll. Never generate or invent images without their answer. Place what they give with project_add_broll. Nobody to ask: skip it and say so.
 9. llm_generate_title / description / timestamps, then preview_show and ask before export_start. Never export before the user has seen the preview.
-Report the real count each step returned. Never add music, intro/outro cards or FX overlays unless asked.
-
-Style defaults when the user names no style, recipe or creator (their choice or a saved memory wins):
-- Long-form 16:9 with the speaker on camera: the Ali style recipe, id educator-talking-head-chapters (recipe_apply_style, then recipe_render and follow its prompt). It keeps burned-in captions OFF (keyword pops instead). Not for camera-less screen recordings or Loom-style internal videos.
-- Shorts / Reels / TikTok (9:16): the Shorts recipe that fits: hard-truth-one-liner-short (one blunt claim), rules-listicle-cutaways-short (numbered tips), rapid-fire-list-short (many one-line items), storytime-turn-short (story with a twist), framework-explainer-short (one concept), split-screen-short-broll (showable things), social-ad-hook-variants (selling an offer), faceless-short (no footage), else warm-educator-short.
-A Short from a SCREEN RECORDING first gets project_set_vertical_screen_layout, then the recipe. Say which recipe you used and why, and offer others (recipe_list).
+Report the real count each step returned. No music, intro/outro cards or FX overlays unless the recipe or the user asks for them.
+A single named operation ("just add captions", "remove the silences") is exactly that: no recipe.
 
 Destructive actions need the user's own confirmation: project_delete, workspace_delete, recipe_delete, memory_forget, export_delete, export_clear_thumbnail, youtube_disconnect, social_disconnect. Ask plainly in chat first ("Delete project 'Demo'? This can't be undone.") and call only after they agree. PandaStudio then confirms with them itself: in its own chat the call returns confirmation_required and changes nothing while a Delete / Cancel card waits (tell them to press it; don't call again; the outcome arrives as their next message); from other apps a dialog asks, and the call is refused when nobody is at the app. Nothing you send can approve it.
 

package/package.json

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