@writepanda/mcp 1.22.0 → 1.22.2

package/bin/server.mjs

@@ -480,6 +480,16 @@ const TOOLS = [
 					type: "number",
 					description: "Sound volume 0–1. Default 1 when soundUrl is set.",
 				},
+				anchorSourceMs: {
+					type: "number",
+					description:
+						"Anchor the motion graphic to a SOURCE-time moment (raw recording time). Pass this whenever atMs was derived from a transcript word's startMs — the region will then re-anchor automatically when subsequent transcript edits (remove-fillers, remove-silences, delete-words) shift the edited-time map. Without it, the motion graphic drifts silently. Omit for free-floating placement.",
+				},
+				anchorSourceEndMs: {
+					type: "number",
+					description:
+						"Optional anchor end (source ms) for ranged anchoring — the region's duration tracks the source-time span instead of preserving its visible duration.",
+				},
 				expectedRevision: { type: "number" },
 			},
 			required: ["file", "durationMs"],
@@ -545,6 +555,15 @@ const TOOLS = [
 					type: "number",
 					description: "Sound volume 0–1. Default 0.8.",
 				},
+				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.",
+				},
+				anchorSourceEndMs: {
+					type: "number",
+					description: "Optional anchor end (source ms) for ranged anchoring.",
+				},
 				expectedRevision: { type: "number" },
 			},
 			required: ["content", "atMs"],
@@ -676,6 +695,15 @@ const TOOLS = [
 				y: { type: "number", description: "Vertical center, percent 0-100. Default 50." },
 				width: { type: "number", description: "Width, percent 0-100. Default 30." },
 				height: { type: "number", description: "Height, percent 0-100. Default 20." },
+				anchorSourceMs: {
+					type: "number",
+					description:
+						"Anchor the annotation to a SOURCE-time moment (raw recording time). Pass when startMs was derived from a transcript word's startMs — the annotation re-anchors automatically on subsequent transcript edits. Without it, the annotation drifts after any trim. Omit for free-floating placement.",
+				},
+				anchorSourceEndMs: {
+					type: "number",
+					description: "Optional anchor end (source ms) for ranged anchoring.",
+				},
 				expectedRevision: { type: "number" },
 			},
 			required: ["startMs", "endMs", "type"],
@@ -996,6 +1024,16 @@ const TOOLS = [
 					description:
 						"[Legacy] Sets endMs = startMs + maxDurationMs when endMs is absent. Prefer endMs.",
 				},
+				anchorSourceMs: {
+					type: "number",
+					description:
+						"Anchor an SFX overlay to a SOURCE-time moment (e.g. a punchline word). Pass when startMs was derived from a transcript word's source-time — the overlay re-anchors automatically on subsequent transcript edits. DO NOT pass for background music tracks; those should stay free-floating (they cover a fixed slot of the edited timeline regardless of content edits).",
+				},
+				anchorSourceEndMs: {
+					type: "number",
+					description:
+						"Optional anchor end (source ms). When set, the overlay's edited duration tracks the source-time span between anchorSourceMs and anchorSourceEndMs.",
+				},
 				expectedRevision: { type: "number" },
 			},
 			required: ["audioPath"],
@@ -1378,6 +1416,39 @@ const TOOLS = [
 		},
 		command: "motion.concat",
 	},
+	{
+		name: "motion_verify_frames",
+		description:
+			"Extract PNG frames at given timestamps from a rendered video so the agent can VISUALLY verify the motion graphics landed. This operationalises the 'lint passing ≠ design working — VIEW THE FRAMES' rule in reference/motion-philosophy.md §4. Call this after motion_render_html or export.start and BEFORE declaring a motion-graphics deliverable done. Pass either entryId (export-library entry) or videoPath (arbitrary MP4). Timestamps are in seconds, typically 8-15 spread across hero moments. Returns { frames: [{timestampSeconds, path}...] } — the agent must then Read each path as an image (multimodal) and confirm no cropped faces / text overflow / blank frames / forbidden-zone occlusion / flat-white headlines.",
+		inputSchema: {
+			type: "object",
+			required: ["timestamps"],
+			properties: {
+				entryId: {
+					type: "string",
+					description:
+						"Export library entry id. Mutually exclusive with videoPath — one must be provided.",
+				},
+				videoPath: {
+					type: "string",
+					description:
+						"Absolute path to an MP4 (e.g. a motion.render-html intermediate output). Mutually exclusive with entryId.",
+				},
+				timestamps: {
+					type: "array",
+					items: { type: "number" },
+					description:
+						"Timestamps in seconds to extract frames at (e.g. [0.5, 1.5, 3.0, 5.0, 7.5, 10.0, 12.5, 15.0]). Max 30 per call.",
+				},
+				outputName: {
+					type: "string",
+					description:
+						"Optional subdir stem for the output PNGs. Defaults to verify-<rand>. Frames land in RECORDINGS_DIR/<stem>/frame-<ms>.png.",
+				},
+			},
+		},
+		command: "motion.verify-frames",
+	},
 
 	// ── assets ──────────────────────────────────────────────────────
 	{

package/package.json

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