@writepanda/mcp 1.38.0 → 1.44.0

package/bin/server.mjs

@@ -431,6 +431,21 @@ const TOOLS = [
 		},
 		command: "project.setFolder",
 	},
+	{
+		name: "project_rename",
+		description:
+			"Rename a project (the display name shown in the editor title bar and the Home grid). Identify the project by `id` (preferred) or `path`. Pass the new `name` (trimmed; must be non-empty). The on-disk filename is NOT changed (files are keyed by project id), so this is safe to call while the project is open. Returns { id, path, name }. Use when the user asks to rename, retitle, or relabel a project.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Project UUID (preferred)." },
+				path: { type: "string", description: "Absolute project file path." },
+				name: { type: "string", description: "New display name. Trimmed; must be non-empty." },
+			},
+			required: ["name"],
+		},
+		command: "project.rename",
+	},
 	{
 		name: "project_locate",
 		description:
@@ -1082,6 +1097,25 @@ const TOOLS = [
 		},
 		command: "project.remove-region",
 	},
+	{
+		name: "project_clear_edits",
+		description:
+			"Reset the project to a clean editing slate in ONE atomic call. Removes every time-based region (trim, speed, zoom, motion graphic, lower third, FX, annotation, clip-transform), removes all audio overlays, and turns captions off (keeping the user's chosen caption template + style overrides so re-enabling later restores their look). Clips, transcripts, cleaned audio, and the project aspect ratio are NOT touched. Use this when the user says 'start over', 'clear all edits', or 'reset the timeline' — instead of looping project_remove_region (which N-tuples revisions and failure points). Pass full=true to also clear per-clip LUTs + crops + webcam layout + wallpaper for a true blank canvas. Returns a `cleared` summary listing how many of each kind were removed.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				full: {
+					type: "boolean",
+					description:
+						"Also reset project-level visual config (per-clip LUT presets, LUT intensity, screen crop, webcam crop, webcam layout, wallpaper). Default false — only time-based edits + captions.enabled are cleared. Aspect ratio is NEVER reset.",
+				},
+				expectedRevision: { type: "number" },
+			},
+		},
+		command: "project.clear-edits",
+	},
 	{
 		name: "project_update_region",
 		description:
@@ -1360,6 +1394,23 @@ const TOOLS = [
 		},
 		command: "project.set-clip-lut",
 	},
+	{
+		name: "project_set_clip_kind",
+		description:
+			"Stamp a clip's capture origin authoritatively: kind = camera | screen | upload. project.read returns each clip's kind (your visual-strategy signal: camera → designed segments + emphasis zooms; screen → cursor zooms). On pre-v1.28 projects kind wasn't recorded, so project.read INFERS it (flagged kindInferred:true) — and inference can be wrong. Use this to correct/lock it. `camera` = talking-head; `screen` = screen recording (maybe with webcam PiP); `upload` = imported file.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				clipId: { type: "string", description: "Clip id from project_read mainTrack.clips[n].id" },
+				kind: { type: "string", enum: ["camera", "screen", "upload"] },
+				expectedRevision: { type: "number" },
+			},
+			required: ["clipId", "kind"],
+		},
+		command: "project.set-clip-kind",
+	},
 
 	// ── transcript-based editing ────────────────────────────────────
 	{
@@ -1439,6 +1490,25 @@ const TOOLS = [
 		},
 		command: "transcript.search",
 	},
+	{
+		name: "transcript_find_issues",
+		description:
+			"Scan the transcript for editorial problems the speaker created and recovered from: **duplicate-take** (a line re-recorded later — keep the cleaner second take, cut the first), **false-start** (an abandoned fragment before a restart), and **adjacent-repeat** (a stutter like 'the the'). Returns candidate `issues`, each with `type`, `severity`, the `wordIds` of the DISCARDED attempt (pass straight to transcript.delete-words), the edited-time span, the offending `text`, and a `note` explaining what's kept. CONSERVATIVE and read-only — it never edits; review each candidate against context before deleting, since some repeats are intentional. Run this after transcribe + remove-fillers as the content-cleanup pass. Filter with `types` (comma-separated) and cap with `limit`.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				types: {
+					type: "string",
+					description:
+						"Optional comma-separated filter: any of `duplicate-take`, `false-start`, `adjacent-repeat`. Omit for all.",
+				},
+				limit: { type: "number", description: "Optional max number of issues to return." },
+			},
+		},
+		command: "transcript.find-issues",
+	},
 	{
 		name: "transcript_find_replace",
 		description:
@@ -1467,7 +1537,8 @@ const TOOLS = [
 				path: { type: "string" },
 				thresholdMs: {
 					type: "number",
-					description: "Gaps longer than this are trimmed. Default 700ms.",
+					description:
+						"Gaps longer than this are trimmed. Default 500ms — same threshold as the UI Remove Silences button, so the agent removes the same silences a manual click would.",
 				},
 				expectedRevision: { type: "number" },
 			},
@@ -1510,7 +1581,7 @@ const TOOLS = [
 	{
 		name: "caption_set_template",
 		description:
-			"Pick a caption template: classic, modern, minimal, bold, spotlight, boxed, neon, colored, or texture. `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).",
+			"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.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1528,6 +1599,7 @@ const TOOLS = [
 						"neon",
 						"colored",
 						"texture",
+						"editorial",
 					],
 				},
 				expectedRevision: { type: "number" },
@@ -1623,7 +1695,49 @@ const TOOLS = [
 		command: "media.generate-image",
 	},
 	// `motion_generate` removed in v1.31.0 — see comment above the
-	// motion-graphics section. Authoring path is `motion_render_html`.
+	// motion-graphics section.
+	{
+		name: "motion_list",
+		description:
+			"List the bundled motion-graphic templates an agent can drop onto the timeline. Returns each template's id, name, description, style, tags, aspectRatios, durationMs, `overlay` (true → renders with alpha; sits over the video), and `slots` — the editable fields (key, type: string|color|list, label, default). Call this to discover what's available and exactly which text/colors you can set, then render one with motion_generate. The SKILL.md 'Motion graphics' catalog documents when to use each.",
+		inputSchema: { type: "object", properties: {} },
+		command: "motion.list",
+	},
+	{
+		name: "motion_generate",
+		description:
+			"Render a bundled template by id with your own slot values (text, colors, list items) and a background mode, then add the result to the timeline with project_add_motion_graphic (or project_add_designed_segment for split-panel). Async — returns { jobId, outputPath }; call job_wait, then pass that jobId as `fromJob` to the add tool. Discover templates + slots with motion_list. Prefer this over motion_render_html whenever a bundled template fits the brief — it's faster and already designed.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				templateId: {
+					type: "string",
+					description: "Template id from motion_list (e.g. creator-card, stat-reveal, split-panel).",
+				},
+				slots: {
+					type: "object",
+					description:
+						"Editable values keyed by slot key (see motion_list / the SKILL catalog): text strings, color hex strings, or list arrays. Omitted slots fall back to the template default.",
+				},
+				aspectRatio: {
+					type: "string",
+					enum: ["16:9", "9:16", "1:1"],
+					description: "Defaults to the template's first listed aspect.",
+				},
+				background: {
+					type: "string",
+					enum: ["solid", "transparent", "glass"],
+					description:
+						"'solid' = hard full-frame card. 'transparent' = alpha; camera shows through un-painted pixels. 'glass' = alpha + frosted blur of the camera behind the content (then set backdropBlurStrength on project_add_motion_graphic). Omit to use the template's natural mode — overlay templates (split-panel, lower thirds, grain/3D/shatter/parallax titles) default to transparent, opaque cards to solid. Don't force 'solid' on an overlay template — its see-through half turns black.",
+				},
+				outputName: { type: "string", description: "Optional filename stem (no extension)." },
+			},
+			required: ["templateId", "slots"],
+		},
+		command: "motion.generate",
+	},
+	// Custom HTML authoring path is `motion_render_html` (for briefs no
+	// bundled template fits).
 	{
 		name: "motion_render_html",
 		description:

package/package.json

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