@writepanda/mcp 1.66.0 → 1.72.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 with a centered cover-crop so the landscape source FILLS the vertical frame (not letterboxed), 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:
@@ -661,7 +692,7 @@ const TOOLS = [
 	{
 		name: "project_add_designed_segment",
 		description:
-			"Create a 'designed segment' — the YouTube split where the host stays LIVE on one half and a motion-graphic panel fills the other (host right / panel left, like a Vox or MKBHD explainer beat). ONE atomic call places both pieces over the same time range with the same transition and source anchor, so they can't drift or mismatch: the camera is repositioned + cover-cropped into its half (a full-bleed split clip-transform) and a full-frame transparent panel graphic is composited on top. Stays in the live compositor — camera is full-quality and scrubbable, nothing baked. IMPORTANT: author the panel graphic as a FULL-FRAME (1920×1080) TRANSPARENT render via motion_render_html --transparent — paint the opaque panel + content on the panel side, leave the camera's half fully transparent (it reveals the repositioned host). See SKILL.md 'Designed segments'.",
+			"Create a 'designed segment' — the split where the host stays LIVE on one half and a motion-graphic panel fills the other. 16:9: host right / panel left, like a Vox or MKBHD explainer beat. 9:16 SHORTS: host in a top/bottom band, panel in the other band (cameraSide top|bottom). ONE atomic call places both pieces over the same time range with the same transition and source anchor, so they can't drift or mismatch: the camera is repositioned + cover-cropped into its half (a full-bleed split clip-transform) and a full-frame transparent panel graphic is composited on top. Stays in the live compositor — camera is full-quality and scrubbable, nothing baked. IMPORTANT: author the panel graphic as a FULL-FRAME TRANSPARENT render at the project aspect via motion_render_html --transparent (1920x1080 for 16:9, 1080x1920 for 9:16; the premium `paper-panel` and `vox-side-panel` templates are aspect-aware — render either at 9:16 and it reflows into a top/bottom band) — paint the opaque panel + content on the panel side, leave the camera's half fully transparent (it reveals the repositioned host). See SKILL.md 'Designed segments' and 'Editing a Short'.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -681,15 +712,15 @@ const TOOLS = [
 				atMs: { type: "number", description: "Default: end of timeline" },
 				cameraSide: {
 					type: "string",
-					enum: ["left", "right"],
+					enum: ["left", "right", "top", "bottom"],
 					description:
-						"Which half the CAMERA fills; the panel graphic fills the opposite half. 'right' is the canonical reference (host right, panel left).",
+						"Which half the CAMERA fills; the panel graphic fills the opposite half. 16:9: 'left'/'right' ('right' is the canonical reference — host right, panel left). 9:16 SHORTS: 'top'/'bottom' — the camera fills a horizontal band and the panel covers the other band (render a premium panel like `paper-panel` or `vox-side-panel` at 9:16; both reflow into a top/bottom band).",
 				},
 				cameraRatio: {
 					type: "number",
 					enum: [50, 55],
 					description:
-						"Camera's share of the frame width: 55 (default, the reference split) or 50 (balanced). Panel gets the remaining 45 or 50. Author the panel's opaque width to match (e.g. left 45% for cameraSide=right, cameraRatio=55).",
+						"Camera's share of the split axis (width for left/right, height for top/bottom): 55 (default for 16:9) or 50 (balanced — pair the 9:16 shorts template with 50). Panel gets the rest. Author the panel's opaque band to match (e.g. left 45% for cameraSide=right ratio=55; bottom 50% for cameraSide=top ratio=50).",
 				},
 				transitionMs: {
 					type: "number",
@@ -1279,6 +1310,27 @@ const TOOLS = [
 		},
 		command: "project.set-crop",
 	},
+	{
+		name: "project_set_focal_point",
+		description:
+			"Set or clear a clip's FACE FOCAL POINT (source-normalised 0-1, origin top-left). When set, cover-cropped layouts — a 9:16 fill or a top/bottom designed-segment band — bias toward this point instead of centering geometrically, so the face stays in frame. Omit clipId to apply to ALL clips (single-clip shorts). Pass clear=true (or omit x/y) to reset to centered. NOTE: the editor AUTO-DETECTS this for vertical talking-head clips when they open, so you rarely need this — use it to override the auto framing or when building a short fully headless.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				clipId: {
+					type: "string",
+					description: "Target clip id (from project.read clipStates). Omit to apply to all clips.",
+				},
+				x: { type: "number", description: "Face center X, 0-1. Omit (with y) to clear." },
+				y: { type: "number", description: "Face center Y, 0-1. Omit (with x) to clear." },
+				clear: { type: "boolean", description: "Reset the focal point to geometric centering." },
+				expectedRevision: { type: "number" },
+			},
+		},
+		command: "project.set-focal-point",
+	},
 	{
 		name: "project_set_export_settings",
 		description:
@@ -1730,7 +1782,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: {
@@ -1747,7 +1799,6 @@ const TOOLS = [
 						"boxed",
 						"neon",
 						"colored",
-						"texture",
 						"editorial",
 					],
 				},
@@ -1761,7 +1812,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: {
@@ -1784,11 +1835,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" },
 			},
@@ -2372,7 +2421,7 @@ const TOOLS = [
 const server = new Server(
 	{
 		name: "pandastudio",
-		version: "1.66.0",
+		version: "1.70.0",
 	},
 	{
 		capabilities: {

package/package.json

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