@writepanda/mcp 1.22.1 → 1.22.3

package/bin/server.mjs

@@ -396,12 +396,17 @@ const TOOLS = [
 	{
 		name: "project_read",
 		description:
-			"Read a project's full JSON. Returns { path, project, clipStates }. `clipStates` is a per-clip summary: { clipId, mediaPath, durationMs, transcribed, wordCount, audioCleaned, cleanedAudioPath? } — use it to decide whether to call transcript_transcribe or audio_clean before editing. Pass `project.revision` back as `expectedRevision` on subsequent writes for conflict-safe edits.",
+			"Read a project's full JSON. Returns { path, project, clipStates }. `clipStates` is a per-clip summary: { clipId, mediaPath, durationMs, transcribed, wordCount, audioCleaned, cleanedAudioPath? } — use it to decide whether to call transcript_transcribe or audio_clean before editing. Pass `project.revision` back as `expectedRevision` on subsequent writes for conflict-safe edits. **Performance tip:** pass `includeTranscript: false` after your first read to drop the per-clip transcript words from the response — they're typically 600+ KB on a 5-minute recording and most agent flows don't need them after pacing is done. clipStates always tells you the transcribed/wordCount status either way.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				id: { type: "string" },
 				path: { type: "string" },
+				includeTranscript: {
+					type: "boolean",
+					description:
+						"When false, per-clip transcripts are stripped from the returned project object. Saves 600+ KB on typical recordings, 2-4s of JSON parse on subsequent reads. Default true.",
+				},
 			},
 		},
 		command: "project.read",
@@ -480,6 +485,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 +560,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 +700,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 +1029,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"],

package/package.json

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