@writepanda/mcp 1.116.0 → 1.119.0

package/bin/server.mjs

@@ -668,6 +668,20 @@ const TOOLS = [
 		},
 		command: "project.rename",
 	},
+	{
+		name: "project_duplicate",
+		description:
+			"Duplicate a project — exact copy with all edits (trims, zooms, overlays, captions, transcript, everything), new id + '(copy)' name. Identify the source by `id` (preferred) or `path`. The source is untouched (non-destructive); media files are shared, not copied. Returns { id, path, name } of the new project. Use when the user asks to duplicate, copy, or clone a project.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Source project UUID (preferred)." },
+				path: { type: "string", description: "Absolute source project file path." },
+			},
+			required: ["id"],
+		},
+		command: "project.duplicate",
+	},
 	{
 		name: "project_locate",
 		description:
@@ -2703,7 +2717,7 @@ const TOOLS = [
 	{
 		name: "media_generate_image",
 		description:
-			'Generate a single image via Replicate gpt-image-2 — for B-roll, concept stills, reference frames. Project-agnostic; writes to <userData>/generated-images/ and returns { imagePath, prompt, aspectRatio, predictionId }. The canonical B-roll workflow is: media_generate_image → motion_render_html (Ken-Burns + vignette wrap to a WebM) → project_add_motion_graphic — see SKILL.md "B-roll generation". Aspect ratios are gpt-image-2 native (1:1 / 3:2 / 2:3). For 16:9 video B-roll, generate 3:2 and crop in the wrap; for 9:16, generate 2:3. Requires the user\'s Replicate API key (Settings → Integrations).',
+			'Generate a single image via Replicate gpt-image-2 — for B-roll, concept stills, reference frames. Project-agnostic; writes to <userData>/generated-images/ and returns { imagePath, prompt, aspectRatio, predictionId }. For a FACELESS / image-driven video, pair with media_image_to_video (one-call Ken-Burns clip → project_add_clip). For B-roll layered over footage, the motion_render_html wrap (Ken-Burns + vignette → project_add_motion_graphic) still applies — see SKILL.md "Faceless videos" / "B-roll generation". Aspect ratios are gpt-image-2 native (1:1 / 3:2 / 2:3). For 16:9 generate 3:2; for 9:16 generate 2:3. Requires the user\'s Replicate API key (Settings → Integrations).',
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -2734,6 +2748,50 @@ const TOOLS = [
 		},
 		command: "media.generate-image",
 	},
+	{
+		name: "media_image_to_video",
+		description:
+			"Turn a STILL image into a Ken-Burns video clip (slow pan/zoom) via FFmpeg — the native, one-call way to build faceless / image-driven videos. Takes an imagePath + durationMs, writes an H.264 MP4 to <userData>/ken-burns/, and returns { videoPath, durationMs, width, height }. Feed videoPath straight into project_add_clip. Fast, deterministic alternative to the motion_render_html Ken-Burns wrap (no headless browser). Canonical faceless-short loop: media_generate_image (2:3 for 9:16) → media_image_to_video (per beat, alternate zoom in/out) → project_add_clip, then media_generate_narration → project_add_audio at each clip's cumulative start.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				imagePath: {
+					type: "string",
+					description: "Absolute path (or file:// URL) to the source still image.",
+				},
+				durationMs: {
+					type: "number",
+					description:
+						"Clip length in ms. Match to the beat's narration length + a small tail (300-500ms) so the visual holds until the VO finishes.",
+				},
+				aspectRatio: {
+					type: "string",
+					description:
+						"Output frame: '16:9' (default) | '9:16' (shorts) | '1:1' | '4:5' | '2:3' | '3:2'. The still is scaled to COVER these dims then panned.",
+				},
+				zoom: {
+					type: "string",
+					description:
+						"Motion: 'in' (default, push in) | 'out' (pull out) | 'none' (static). Alternate in/out across beats for a lively cut.",
+				},
+				zoomAmount: {
+					type: "number",
+					description:
+						"Peak zoom delta 0.05-0.4 (default 0.12 → ends at 1.12×). Keep ≤0.2 for a subtle documentary feel.",
+				},
+				fps: {
+					type: "number",
+					description: "Output frame rate (default 30).",
+				},
+				outputName: {
+					type: "string",
+					description: "Optional file-stem hint. Slugified; timestamp appended automatically.",
+				},
+			},
+			required: ["imagePath", "durationMs"],
+		},
+		command: "media.image-to-video",
+	},
 	{
 		name: "media_generate_narration",
 		description:
@@ -2800,6 +2858,112 @@ const TOOLS = [
 		},
 		command: "media.generate-music",
 	},
+	{
+		name: "media_list_avatars",
+		description:
+			"List the HeyGen avatars on the user's account (studio avatars + talking photos) for talking-head video generation. Returns { avatars: [{ avatarId, name, kind, gender, previewImageUrl }], count }. Use an avatarId with media_generate_avatar_video (pass avatarKind='talking_photo' for a photo avatar). Requires the user's HeyGen API key (Settings → Integrations); the HeyGen API is a paid capability, not on every plan.",
+		inputSchema: { type: "object", properties: {} },
+		command: "media.list-avatars",
+	},
+	{
+		name: "media_list_avatar_voices",
+		description:
+			"List the HeyGen voices on the user's account for talking-head video generation. Returns { voices: [{ voiceId, name, language, gender, previewAudioUrl }], count }. Use a voiceId with media_generate_avatar_video. Requires the user's HeyGen API key (Settings → Integrations).",
+		inputSchema: { type: "object", properties: {} },
+		command: "media.list-avatar-voices",
+	},
+	{
+		name: "media_generate_avatar_video",
+		description:
+			"Generate a HeyGen talking-head video from the user's own avatar + a script. ASYNC: returns { jobId }; poll job_wait for { videoPath, durationSec, width, height }, then add it to the timeline with project_add_clip. Discover avatarId with media_list_avatars and voiceId with media_list_avatar_voices. Requires the user's HeyGen API key + credits (Settings → Integrations); renders server-side over minutes (poll with a generous timeout). Billed against the user's own HeyGen credits, not by PandaStudio.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				avatarId: {
+					type: "string",
+					description: "HeyGen avatar id (from media_list_avatars).",
+				},
+				voiceId: {
+					type: "string",
+					description: "HeyGen voice id (from media_list_avatar_voices).",
+				},
+				script: {
+					type: "string",
+					description: "The text the avatar speaks. Plain text; HeyGen handles TTS.",
+				},
+				avatarKind: {
+					type: "string",
+					enum: ["avatar", "talking_photo"],
+					description: "'avatar' (studio avatar, default) | 'talking_photo' (photo avatar).",
+				},
+				aspectRatio: {
+					type: "string",
+					enum: ["16:9", "9:16", "1:1"],
+					description: "'16:9' (default, YouTube) | '9:16' (Shorts/Reels) | '1:1'.",
+				},
+				resolution: {
+					type: "string",
+					enum: ["720p", "1080p"],
+					description: "'720p' (default, cheaper on credits) | '1080p'.",
+				},
+				speed: {
+					type: "number",
+					description: "Voice speed multiplier 0.5–1.5 (default 1).",
+				},
+				backgroundColor: {
+					type: "string",
+					description: "Optional solid background hex, e.g. '#000000'.",
+				},
+				outputName: {
+					type: "string",
+					description: "Optional file-stem hint; timestamp is appended. Defaults to the script head.",
+				},
+			},
+			required: ["avatarId", "voiceId", "script"],
+		},
+		command: "media.generate-avatar-video",
+	},
+	{
+		name: "memory_save",
+		description:
+			"Remember a durable fact or preference about this user/workspace, carried across ALL future chats (injected into every session). Use for STANDING context — brand, default caption/zoom styles, channel name + tone, recurring instructions ('always 9:16 for this client'). Do NOT use for one-off requests about the current edit. Idempotent on identical text. Returns { id, text }.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				note: {
+					type: "string",
+					description:
+						"One concise fact/preference, e.g. 'Channel is WritePanda; energetic tone, fast cuts' or 'Default caption template: editorial'.",
+				},
+			},
+			required: ["note"],
+		},
+		command: "memory.save",
+	},
+	{
+		name: "memory_forget",
+		description:
+			"Remove durable memory entries by id (from memory_list) or by a case-insensitive text substring. Use when a saved preference is outdated or wrong. Returns { removed, remaining }.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				query: {
+					type: "string",
+					description:
+						"An entry id (e.g. 'a1b2c3') for an exact remove, or a text fragment to remove every matching note.",
+				},
+			},
+			required: ["query"],
+		},
+		command: "memory.forget",
+	},
+	{
+		name: "memory_list",
+		description:
+			"List the durable memory for this workspace — the same notes injected into every chat. Returns { entries: [{ id, text }], count }. Rarely needed (memory is already in context); use to get ids for memory_forget or to audit what's stored.",
+		inputSchema: { type: "object", properties: {} },
+		command: "memory.list",
+	},
 	// `motion_generate` removed in v1.31.0 — see comment above the
 	// motion-graphics section.
 	{

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@writepanda/mcp",
-	"version": "1.116.0",
+	"version": "1.119.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",
@@ -36,7 +36,7 @@
 		"LICENSE"
 	],
 	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.0.4"
+		"@modelcontextprotocol/sdk": "~1.29.0"
 	},
 	"publishConfig": {
 		"access": "public"