@writepanda/mcp 1.22.2 → 1.23.0

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",
@@ -710,6 +715,49 @@ const TOOLS = [
 		},
 		command: "project.add-annotation",
 	},
+	{
+		name: "project_add_clip_transform_region",
+		description:
+			"Time-bounded transform on the main video clip — between startMs and endMs the clip renders inside a sub-rect of the canvas (per the chosen preset), freeing the rest for motion graphics. Outside the region, the clip renders full-frame. Renderer interpolates over `transitionMs` (default 320ms) at each boundary so the camera smoothly slides + scales. **Use ONLY on camera-only / user-uploaded recordings — for screen recordings, use cursor-telemetry zooms instead.** Typical pattern: agent finds an emphasis moment in the transcript, places a `cam-bottom-half` (9:16) or `cam-right-portrait` (16:9) transform region, and adds a motion graphic in the freed space. When the region ends, the camera returns to full-frame.",
+		inputSchema: {
+			type: "object",
+			required: ["startMs", "endMs", "preset"],
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				startMs: { type: "number" },
+				endMs: { type: "number" },
+				preset: {
+					type: "string",
+					enum: [
+						"cam-bottom-half",
+						"cam-top-half",
+						"cam-right-portrait",
+						"cam-left-portrait",
+						"cam-bottom-right-quarter",
+						"cam-bottom-left-quarter",
+					],
+					description:
+						"cam-bottom-half / cam-top-half — for 9:16 (camera fills half, other half open for motion graphics). cam-right-portrait / cam-left-portrait — for 16:9 (camera ~35% of canvas in a portrait card on the chosen side, other ~65% open). cam-bottom-right-quarter / cam-bottom-left-quarter — small corner card; rest of canvas open.",
+				},
+				transitionMs: {
+					type: "number",
+					description: "Transition window at each edge in ms. Default 320.",
+				},
+				anchorSourceMs: {
+					type: "number",
+					description:
+						"Anchor to a SOURCE-time moment (transcript word startMs). Pass when startMs was derived from a transcript word — the region re-anchors automatically on subsequent transcript edits.",
+				},
+				anchorSourceEndMs: {
+					type: "number",
+					description: "Optional anchor end (source ms) for ranged anchoring.",
+				},
+				expectedRevision: { type: "number" },
+			},
+		},
+		command: "project.add-clip-transform-region",
+	},
 
 	// ── project lifecycle (extended) ───────────────────────────────
 	{

package/package.json

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