@writepanda/mcp 1.205.0 → 1.207.0

package/bin/server.mjs

@@ -577,7 +577,7 @@ const MOTION_ELEMENT_PROPS = {
 	content: {
 		type: ["object", "string", "array"],
 		description:
-			'keyword/chip/stamp/slam/behind/highlight { text } (or a bare string); count { value, to?, prefix?, suffix?, label?, decimals? } (value "20-30" = range); steps { items[], cues? (ms offsets from start) }; lowerThird { title, subtitle? (<=320 chars, wraps), look?: plate|plain|typewriter }; endCard { lines: [a, b] }; progress { label?, fromMs?, toMs? }; iconPop { emoji } | { icon }; frame { look: viewfinder | selection | corners, label? }; sticker { image: transparent PNG path, label? }; ticker { text (one story per line, <=2000 chars), label?, speed? (40-600 px/s) }; credits { title?, entries: [{ role?, name }] | "Role: Name" strings (<=200) }; crawl { title?, text (<=6000 chars), tilt? (0-80), turn? (-60..60) }. Any script, symbols and emoji draw.',
+			'keyword/chip/stamp/slam/behind/highlight { text } (or a bare string); count { value, to?, prefix?, suffix?, label?, decimals? } (value "20-30" = range); steps { items[], cues? (ms offsets from start) }; lowerThird { title, subtitle? (<=320 chars, wraps), look?: plate|plain|typewriter, typeSpeed? (typewriter pace, 5-80 chars/s, default ~22) }; endCard { lines: [a, b] }; progress { label?, fromMs?, toMs? }; iconPop { emoji } | { icon }; frame { look: viewfinder | selection | corners, label? }; sticker { image: transparent PNG path, label? }; ticker { text (one story per line, <=2000 chars), label?, speed? (40-600 px/s) }; credits { title?, entries: [{ role?, name }] | "Role: Name" strings (<=200) }; crawl { title?, text (<=6000 chars), tilt? (0-80), turn? (-60..60) }. Any script, symbols and emoji draw.',
 	},
 	atMs: { type: "number", description: "Start, edited ms. Or wordId." },
 	wordId: {
@@ -635,7 +635,7 @@ const TOOLS = [
 	{
 		name: "system_status",
 		description:
-			"App version and license; automationGated true = trial expired, every other tool fails; license.socialPublishing.allowed false = the plan has no Instagram/TikTok/social publishing (Creator, Team, Pro only). Call first.",
+			"App version and license; automationGated true = trial expired, or the Solo plan (license.agentEditing.allowed false: no agent editing, relay license.agentEditing.message to the user), and every other tool fails; license.socialPublishing.allowed false = the plan has no Instagram/TikTok/social publishing (Creator, Team, Pro only). Call first.",
 		inputSchema: { type: "object", properties: {} },
 		command: "system.status",
 	},
@@ -1300,7 +1300,8 @@ const TOOLS = [
 	},
 	{
 		name: "project_current",
-		description: "The project open in the editor, or null.",
+		description:
+			"The project open in the editor, or null, plus the editor's LIVE playhead read at call time: playhead { ms, timeBase: 'edited', durationMs, inCut, playing } (null + playheadNote when unavailable). playhead.ms is EDITED (output) ms, what add-* atMs takes. Call it when the user says 'here' / 'at the playhead' / 'now': the chat context's playhead is from when the message was sent.",
 		inputSchema: { type: "object", properties: {} },
 		command: "project.current",
 	},
@@ -1560,7 +1561,7 @@ const TOOLS = [
 	{
 		name: "project_add_designed_segment",
 		description:
-			"Designed segment: host live on one half, a graphic panel on the other, in one call. The panel is a full-frame transparent render with the camera's half left empty (skill 'Designed segments').",
+			"Designed segment: host live on one half, a graphic panel on the other, in one call. The panel is a full-frame transparent render with the camera's half left empty (skill_read file='motion-templates' section='designed segments').",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4520,6 +4521,24 @@ const TOOLS = [
 		},
 		command: "recipe.list",
 	},
+	{
+		name: "recipe_prepare_reference",
+		description:
+			"Prepare evidence for learning a reference video's editing style, without editing any project. Async job: whole-video contact sheets, dense motion samples, transition candidates and mixed-audio excerpts. Inspect the evidence and save a portable reference-specific recipe; do not assume generic effects or exact source sound files.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				file: {
+					type: "string",
+					description: "Absolute local video path (download links with media_download_url first).",
+				},
+				title: { type: "string" },
+				sourceUrl: { type: "string" },
+			},
+			required: ["file"],
+		},
+		command: "recipe.prepare-reference",
+	},
 	{
 		name: "recipe_pick",
 		description:
@@ -4732,7 +4751,8 @@ const TOOLS = [
 	},
 	{
 		name: "motion_craft",
-		description: "Launch / promo motion craft library: no id lists topics; id returns the doc.",
+		description:
+			"Launch / promo film craft library (story arcs, blueprints, GSAP rules, design presets): no id lists topics; id returns the doc. An unknown id fails with the closest ids and every valid id. Not the custom motion-graphic HTML contract: that is skill_read section='custom motion graphics'.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4782,7 +4802,7 @@ const TOOLS = [
 	{
 		name: "motion_render_html",
 		description:
-			"Render custom HTML to video when no template fits. Contract (skill 'Custom motion graphics'): a paused GSAP timeline at window.__timelines[<data-composition-id>] and a root with data-composition-id / width / height / duration. Lint and STATIC_RENDER failures must be fixed, never placed. ASYNC: { jobId }.",
+			"Render custom HTML to video when no template fits. Contract (skill_read section='custom motion graphics'; render details in skill_read file='custom-html'): a paused GSAP timeline at window.__timelines[<data-composition-id>] and a root with data-composition-id / width / height / duration. Lint and STATIC_RENDER failures must be fixed, never placed. ASYNC: { jobId }.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4862,6 +4882,44 @@ const TOOLS = [
 	},
 
 	// ── assets ──────────────────────────────────────────────────────
+	{
+		name: "asset_list_sound_patterns",
+		description:
+			"List shared motion sound recipes: counted entrances, scroll ratchets, slides, swipes and presses. Use asset_plan_sound_pattern with actual animation timings.",
+		inputSchema: { type: "object", properties: { query: { type: "string" } } },
+		command: "asset.list-sound-patterns",
+	},
+	{
+		name: "asset_plan_sound_pattern",
+		description:
+			"Plan motion-synced sounds without writing a project. Returns cues for project_add_sound_cues; use a unique group per animation. One cue per actual event, variant rotation, quiet starting gain, tails bounded by settle. Preview below narration.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				pattern: { type: "string", description: "Id from asset_list_sound_patterns." },
+				atMs: { type: "integer", minimum: 0, description: "Edited-timeline motion start." },
+				endMs: { type: "integer", description: "Edited-timeline motion end/settle." },
+				eventOffsetsMs: {
+					type: "array",
+					items: { type: "integer", minimum: 0 },
+					minItems: 1,
+					maxItems: 500,
+					description:
+						"Actual entrance/crossing/gesture offsets relative to atMs; strictly increasing. Follow easing, not an assumed uniform stagger.",
+				},
+				volume: { type: "number", minimum: 0, maximum: 2 },
+				sounds: {
+					type: "array",
+					items: { type: "string" },
+					minItems: 1,
+					maxItems: 500,
+					description: "Optional alternate ids/paths, rotated.",
+				},
+			},
+			required: ["pattern", "atMs", "endMs", "eventOffsetsMs"],
+		},
+		command: "asset.plan-sound-pattern",
+	},
 	{
 		name: "asset_list_emoji",
 		description: "List animated emoji for project_add_emoji.",

package/package.json

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