@writepanda/mcp 1.62.0 → 1.69.0

package/bin/server.mjs

@@ -561,6 +561,37 @@ const TOOLS = [
 		},
 		command: "project.new",
 	},
+	{
+		name: "project_fork_from_shot",
+		description:
+			"Fork an exported video's AI-generated shot into a new 9:16 project. Carries forward the source project's timing surgery (trim regions, transcript edits, speed regions, per-clip transcribed/audioCleaned status) but STRIPS every overlay row — zooms, FX, motion graphics, captions, transitions, lower thirds, annotations, clip-transforms, background music — because those were sized for 16:9 and don't fit a vertical short. The new project is cropped to the shot's [startMs, endMs] range, switched to 9:16, and ready to receive Shorts-native graphics/captions on top. Pass exportId + shotId from export.list (the shot lives under `entry.generatedShots[]`); the verb looks up the source project path, runs the fork, writes the new file, and returns its id + path. If the source project has been edited since export (revision drift) the verb returns `revision_mismatch` with the live revision; confirm with the user and retry with `force: true`. Returns { id, path, name, aspectRatio, sourceProjectPath, sourceProjectRevision, liveRevision, project }.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				exportId: {
+					type: "string",
+					description: "Export library entry id (from export.list).",
+				},
+				shotId: {
+					type: "string",
+					description:
+						"Shot id (from the export entry's `generatedShots` array; produced by generate-shorts).",
+				},
+				aspectRatio: {
+					type: "string",
+					description:
+						"Target aspect. Defaults to '9:16' (the right answer for almost every shot generator output).",
+				},
+				force: {
+					type: "boolean",
+					description:
+						"Set true to fork even when the source project has drifted since export. Without it, drift returns revision_mismatch and the caller must confirm with the user first.",
+				},
+			},
+			required: ["exportId", "shotId"],
+		},
+		command: "project.fork-from-shot",
+	},
 	{
 		name: "project_open",
 		description:
@@ -575,7 +606,7 @@ const TOOLS = [
 		command: "project.open",
 	},
 
-	// ── compose: clips, motion graphics, FX, lower-thirds ──────────
+	// ── compose: clips, motion graphics, FX ────────────────────────
 	{
 		name: "project_add_clip",
 		description:
@@ -786,54 +817,71 @@ const TOOLS = [
 				src: { type: "string", description: "Direct path/URL (alternative to fxId)" },
 				atMs: { type: "number" },
 				durationMs: { type: "number", description: "Default 2500ms for bundled FX" },
+				speed: {
+					type: "number",
+					description:
+						"Playback-speed multiplier for the looping FX (0.25-4, default 1). 2 = twice as fast, 0.5 = half. Speeds up / slows down a film burn, light leak, etc. without re-rendering.",
+				},
 				expectedRevision: { type: "number" },
 			},
 			required: ["atMs"],
 		},
 		command: "project.add-fx",
 	},
+	{
+		name: "project_add_transition",
+		description:
+			"Place a transition at a cut between two clips. Drops a bundled transition overlay (a full-frame transparent WebM that goes opaque at its midpoint) CENTERED on atMs, so the opaque peak masks the cut and reads as a scene change. No render step. Pass atMs = the cut time (a clip boundary from project_read). Ids (asset_list_transitions): fade-black, fade-white, flash, light-sweep, film-burn, glitch.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				transitionId: { type: "string", description: "Bundled id, e.g. fade-black. From asset_list_transitions." },
+				file: { type: "string", description: "Custom transition video (path / file:// URL). Use instead of transitionId." },
+				atMs: { type: "number", description: "Edited-timeline CUT time to center the transition on." },
+				durationMs: { type: "number", description: "Total length. Default 1000 (native length of the bundled set)." },
+				expectedRevision: { type: "number" },
+			},
+			required: ["atMs"],
+		},
+		command: "project.add-transition",
+	},
 	{
 		name: "project_add_lower_third",
-		description: "Drop a lower-third name plate onto the timeline.",
+		description:
+			"One-call lower third: renders an lt-* nameplate motion template (hyperframes) with your name/title and places it on the timeline as a transparent overlay at atMs. ASYNC — returns { jobId, outputPath }; call job_wait — it resolves once the region is PLACED (result: { path, revision, outputPath, durationMs }), no separate project_add_motion_graphic call needed. Designs (see motion_list, category lower-third): lt-vox-marker (default, highlighter swipe), lt-broadcast-bar (news chyron), lt-glass-card (frosted), lt-kinetic-stack (bold word-by-word), lt-minimal-line (editorial), lt-corner-plate (documentary bracket + kicker slot), lt-accent-slab (knockout name), lt-avatar-pill (creator pill), lt-typewriter-tag (mono typing), lt-gradient-sweep (gradient glow).",
 		inputSchema: {
 			type: "object",
 			properties: {
 				id: { type: "string" },
 				path: { type: "string" },
-				content: { type: "string", description: "Primary text (name)" },
-				subtitle: { type: "string", description: "Secondary text (title)" },
-				atMs: { type: "number" },
-				durationMs: { type: "number", description: "Default 5000ms" },
-				designType: {
+				name: { type: "string", description: "Primary text (person/brand name)" },
+				title: { type: "string", description: "Secondary line (role / handle / tagline)" },
+				templateId: {
 					type: "string",
-					description:
-						"slash-reveal | center-stack | split-horizontal | name-bar | border-frame | minimal-underline | box-reveal | corner-brackets. Default: slash-reveal.",
+					description: "lt-* design id. Default lt-vox-marker.",
 				},
-				accentColor: { type: "string", description: "Hex accent/background color" },
-				textColor: { type: "string", description: "Hex text color. Default #ffffff" },
-				backgroundColor: {
+				atMs: { type: "number", description: "Edited timeline time" },
+				aspectRatio: {
 					type: "string",
-					description: "Hex background fill. Default matches accentColor",
+					description: "16:9 | 9:16 | 1:1. Default 16:9 — match the project's aspect.",
 				},
-				backgroundRadius: {
-					type: "number",
-					description: "Corner radius in pixels. Default 8",
+				slots: {
+					type: "object",
+					description:
+						"Optional extra slot overrides (colors like accentColor/inkColor, or kicker for lt-corner-plate). Keys from motion_list. name/title args win over same-key entries.",
 				},
-				fontSize: { type: "number", description: "Primary text font size in px. Default 28" },
-				fontFamily: { type: "string", description: "CSS font family name. Default Inter" },
 				soundUrl: {
 					type: "string",
 					description:
-						'SFX played when the lower third enters. Bundled id (bundled:sound/<id>). Default bundled:sound/mouse-click. Pass "none" for silent.',
-				},
-				soundVolume: {
-					type: "number",
-					description: "Sound volume 0–1. Default 0.8.",
+						'SFX on enter. Bundled id (bundled:sound/<id>). Default bundled:sound/mouse-click. Pass "none" for silent.',
 				},
+				soundVolume: { type: "number", description: "Sound volume 0–1. Default 1." },
 				anchorSourceMs: {
 					type: "number",
 					description:
-						"Anchor the lower third to a SOURCE-time moment. Pass when atMs was derived from a transcript word's startMs — the lower third re-anchors automatically on subsequent transcript edits. Without it, the lower third drifts after any trim. Omit for free-floating placement.",
+						"Anchor to a SOURCE-time moment. Pass when atMs comes from a transcript word's startMs so the region survives later trims.",
 				},
 				anchorSourceEndMs: {
 					type: "number",
@@ -841,7 +889,7 @@ const TOOLS = [
 				},
 				expectedRevision: { type: "number" },
 			},
-			required: ["content", "atMs"],
+			required: ["name", "atMs"],
 		},
 		command: "project.add-lower-third",
 	},
@@ -893,7 +941,7 @@ const TOOLS = [
 	{
 		name: "project_set_region_sound",
 		description:
-			'Set or clear the sound effect on an existing region (zoom / motionGraphic / lowerThird / fx). Use to swap the default zoom swoosh, add a ding to a motion graphic, or mute a lower-third click. Pass soundUrl="none" to clear.',
+			'Set or clear the sound effect on an existing region (zoom / motionGraphic / fx). Use to swap the default zoom swoosh, add a ding to a motion graphic, or mute an effect sound. Pass soundUrl="none" to clear.',
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -902,7 +950,7 @@ const TOOLS = [
 				regionId: { type: "string", description: "Target region id" },
 				regionType: {
 					type: "string",
-					enum: ["zoom", "motionGraphic", "lowerThird", "fx"],
+					enum: ["zoom", "motionGraphic", "fx"],
 					description: "Region kind that owns the id",
 				},
 				soundUrl: {
@@ -1117,7 +1165,7 @@ const TOOLS = [
 	{
 		name: "project_move_clip",
 		description:
-			"Reorder a clip on the main track. `clipId` identifies the clip; `toIndex` is its new 0-based position after the move. Project-level regions (zooms, trims, speeds, annotations, FX, lower-thirds, media overlays, clip transforms) automatically migrate to follow their original clips so the user-perceived edits stay attached to the same content — a zoom that was 'into the explanation in clip 2' is still pointing at the same explanation after clip 2 moves to position 0. Per-clip transcripts ride on the clips themselves and don't need separate migration.",
+			"Reorder a clip on the main track. `clipId` identifies the clip; `toIndex` is its new 0-based position after the move. Project-level regions (zooms, trims, speeds, annotations, FX, media overlays, clip transforms) automatically migrate to follow their original clips so the user-perceived edits stay attached to the same content — a zoom that was 'into the explanation in clip 2' is still pointing at the same explanation after clip 2 moves to position 0. Per-clip transcripts ride on the clips themselves and don't need separate migration.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1140,7 +1188,7 @@ const TOOLS = [
 	{
 		name: "project_remove_region",
 		description:
-			"Delete an existing region (zoom, trim, speed, annotation, fx, lower-third, overlay, clip-transform, audio-overlay) by its id. Use project_read to find region ids — visual regions live under editor.*Regions; audio overlays live under audioOverlays[]. If the region belongs to a link group (designed-segment pair: a clip-transform parking the camera into one half + the panel motion-graphic on the other half), deleting either half also removes its peer so the pair stays coherent. Returns the updated project.",
+			"Delete an existing region (zoom, trim, speed, annotation, fx, overlay, clip-transform, audio-overlay) by its id. Use project_read to find region ids — visual regions live under editor.*Regions; audio overlays live under audioOverlays[]. If the region belongs to a link group (designed-segment pair: a clip-transform parking the camera into one half + the panel motion-graphic on the other half), deleting either half also removes its peer so the pair stays coherent. Returns the updated project.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1149,7 +1197,7 @@ const TOOLS = [
 				regionType: {
 					type: "string",
 					description:
-						"zoom | trim | speed | annotation | fx | lower-third | overlay | clip-transform | audio-overlay",
+						"zoom | trim | speed | annotation | fx | overlay | clip-transform | audio-overlay",
 				},
 				regionId: { type: "string", description: "id of the region to delete" },
 				expectedRevision: { type: "number" },
@@ -1180,7 +1228,7 @@ const TOOLS = [
 	{
 		name: "project_update_region",
 		description:
-			"Patch fields on an existing region without replacing it. Accepts any subset of the region's own properties — only the supplied fields are changed, everything else is preserved. Works on zoom (depth, focusX, focusY), trim (startMs, endMs), speed (startMs, endMs, speed), lower-third (content, subtitle, atMs, durationMs, designType, accentColor, textColor, backgroundColor, backgroundRadius, fontSize, fontFamily), fx (atMs, durationMs), annotation, overlay, clip-transform (startMs, endMs, preset, transitionMs), and audio-overlay (startMs, endMs, sourceStartMs, volume — lets you drag-trim an audio overlay without removing it). Time shifts on a link-grouped region (e.g. one half of a designed segment) propagate to every peer in the group so the pair stays coherent.",
+			"Patch fields on an existing region without replacing it. Accepts any subset of the region's own properties — only the supplied fields are changed, everything else is preserved. Works on zoom (depth, focusX, focusY), trim (startMs, endMs), speed (startMs, endMs, speed), fx (atMs, durationMs, opacity, blendMode, speed), annotation, overlay, clip-transform (startMs, endMs, preset, transitionMs), and audio-overlay (startMs, endMs, sourceStartMs, volume — lets you drag-trim an audio overlay without removing it). Time shifts on a link-grouped region (e.g. one half of a designed segment) propagate to every peer in the group so the pair stays coherent.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1189,13 +1237,13 @@ const TOOLS = [
 				regionType: {
 					type: "string",
 					description:
-						"zoom | trim | speed | annotation | fx | lower-third | overlay | clip-transform | audio-overlay",
+						"zoom | trim | speed | annotation | fx | overlay | clip-transform | audio-overlay",
 				},
 				regionId: { type: "string", description: "id of the region to update" },
 				patch: {
 					type: "object",
 					description:
-						"Fields to update (partial). E.g. { depth: 4 } to change zoom depth, { content: 'New Name' } on a lower-third, or { startMs: 2000, endMs: 15000, sourceStartMs: 4000 } to shift + trim an audio overlay (play seconds 4–17 of the source from the 2s mark on the timeline).",
+						"Fields to update (partial). E.g. { depth: 4 } to change zoom depth, or { startMs: 2000, endMs: 15000, sourceStartMs: 4000 } to shift + trim an audio overlay (play seconds 4–17 of the source from the 2s mark on the timeline).",
 				},
 				expectedRevision: { type: "number" },
 			},
@@ -1713,7 +1761,7 @@ const TOOLS = [
 	{
 		name: "caption_set_template",
 		description:
-			"Pick a caption template: classic, modern, minimal, bold, spotlight, boxed, neon, colored, texture, or editorial. `texture` fills large uppercase words with a flowing texture mask (lava/marble/metal/wood/concrete/rock) — pick the texture via caption_set_style `texture` (defaults to lava). `editorial` is a magazine-emphasis style: the word being spoken right now renders large (and takes an accent color) while the rest of the line shrinks, so one big word sweeps across the line in time with the speech.",
+			"Pick a caption template: classic, modern, minimal, bold, spotlight, boxed, neon, colored, or editorial. `editorial` is a magazine-emphasis style: the word being spoken right now renders large (and takes an accent color) while the rest of the line shrinks, so one big word sweeps across the line in time with the speech.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1730,7 +1778,6 @@ const TOOLS = [
 						"boxed",
 						"neon",
 						"colored",
-						"texture",
 						"editorial",
 					],
 				},
@@ -1744,7 +1791,7 @@ const TOOLS = [
 	{
 		name: "caption_set_style",
 		description:
-			"Override specific style properties of the caption overlay without changing the template. All fields are optional — pass only what you want to change. positionY controls vertical placement (0=top, 100=bottom, default 85). fontSize accepts CSS values like '28px' or '1.5em'.",
+			"Override specific style properties of the caption overlay without changing the template. All fields are optional — pass only what you want to change. positionY controls vertical placement (0=top, 100=bottom, default 85). fontSize is in REM (e.g. '2.6rem'), matching the editor's Font size slider; it is clamped to 1.0–5.0rem (a px value is converted to rem), so you can't exceed the editor's max.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1767,11 +1814,9 @@ const TOOLS = [
 				},
 				strokeColor: { type: "string", description: "Text stroke/outline color" },
 				strokeWidth: { type: "number", description: "Text stroke width in px" },
-				fontSize: { type: "string", description: "CSS font-size value, e.g. '28px'" },
-				texture: {
+				fontSize: {
 					type: "string",
-					enum: ["lava", "marble", "metal", "wood", "concrete", "rock"],
-					description: "Texture for the 'texture' caption template. Ignored by other templates.",
+					description: "Font size in REM, e.g. '2.6rem'. Clamped to 1.0–5.0rem (the editor's slider range).",
 				},
 				expectedRevision: { type: "number" },
 			},
@@ -2060,6 +2105,13 @@ const TOOLS = [
 		inputSchema: { type: "object", properties: {} },
 		command: "asset.list-fx",
 	},
+	{
+		name: "asset_list_transitions",
+		description:
+			"List every bundled transition (id, title, category, durationSeconds). Use the id with project_add_transition, centered on a cut.",
+		inputSchema: { type: "object", properties: {} },
+		command: "asset.list-transitions",
+	},
 	{
 		name: "asset_list_music",
 		description:
@@ -2121,7 +2173,7 @@ const TOOLS = [
 	{
 		name: "export_start",
 		description:
-			"Render the project to MP4 via the same Tier-3 PixiJS pipeline the editor's Export Video button uses (v1.24+ — convergence release). When an editor window is already open on the target project, the agent reuses it. Otherwise the agent spawns a hidden editor window for the duration of the render and closes it after. ASYNC — returns { jobId, outputPath }; call job_wait. Honours every region/style/caption/FX/lower-third/motion-graphic in the project. Video overlays (motion graphics added via project_add_motion_graphic) — opaque MP4 and transparent WebM/VP9+alpha — composite inline in the export pipeline; no extra call needed.",
+			"Render the project to MP4 via the same Tier-3 PixiJS pipeline the editor's Export Video button uses (v1.24+ — convergence release). When an editor window is already open on the target project, the agent reuses it. Otherwise the agent spawns a hidden editor window for the duration of the render and closes it after. ASYNC — returns { jobId, outputPath }; call job_wait. Honours every region/style/caption/FX/motion-graphic in the project. Video overlays (motion graphics added via project_add_motion_graphic) — opaque MP4 and transparent WebM/VP9+alpha — composite inline in the export pipeline; no extra call needed.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -2348,7 +2400,7 @@ const TOOLS = [
 const server = new Server(
 	{
 		name: "pandastudio",
-		version: "1.58.0",
+		version: "1.69.0",
 	},
 	{
 		capabilities: {

package/package.json

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