@writepanda/mcp 1.200.0 → 1.205.0

package/bin/portableSchema.mjs

@@ -0,0 +1,91 @@
+// Tool input schemas in the subset every model provider accepts.
+//
+// Our schemas are written in plain JSON Schema, and some fields allow more
+// than one type (`type: ["object", "null"]`, `["object", "string", "array"]`).
+// Anthropic and OpenAI take that, but Google Gemini rejects the whole tool
+// list when a multi-type field carries `properties` or an array branch has no
+// `items` ("properties: only allowed for OBJECT type", "items: missing
+// field"), so every Gemini session failed before its first reply.
+//
+// portableSchema rewrites each such field, keeping its meaning:
+// - a type plus null becomes that single type; null stays accepted by the
+//   handlers and is noted in the description.
+// - several non-null types become anyOf branches, each with only the
+//   keywords that belong to its type (properties on the object branch,
+//   items on the array branch, enum values of matching type).
+// - every array schema gets an items schema.
+
+const OBJECT_KEYS = ["properties", "required", "additionalProperties"];
+const ARRAY_KEYS = ["items", "minItems", "maxItems"];
+const NUMBER_KEYS = ["minimum", "maximum"];
+const STRING_KEYS = ["minLength", "maxLength", "pattern", "format"];
+
+function keysFor(type) {
+	if (type === "object") return OBJECT_KEYS;
+	if (type === "array") return ARRAY_KEYS;
+	if (type === "number" || type === "integer") return NUMBER_KEYS;
+	if (type === "string") return STRING_KEYS;
+	return [];
+}
+
+const TYPE_SPECIFIC = new Set([...OBJECT_KEYS, ...ARRAY_KEYS, ...NUMBER_KEYS, ...STRING_KEYS]);
+
+function enumFor(values, type) {
+	const match = (v) =>
+		type === "integer"
+			? Number.isInteger(v)
+			: type === "array"
+				? Array.isArray(v)
+				: type === "object"
+					? v !== null && typeof v === "object" && !Array.isArray(v)
+					: typeof v === type;
+	return values.filter(match);
+}
+
+/** One branch of a multi-type field: the type and only its own keywords. */
+function branch(schema, type) {
+	const out = { type };
+	for (const k of keysFor(type)) if (k in schema) out[k] = schema[k];
+	if (Array.isArray(schema.enum)) {
+		const values = enumFor(schema.enum, type);
+		if (values.length) out.enum = values;
+	}
+	return portableSchema(out);
+}
+
+export function portableSchema(schema) {
+	if (Array.isArray(schema)) return schema.map(portableSchema);
+	if (!schema || typeof schema !== "object") return schema;
+	let s = { ...schema };
+
+	if (Array.isArray(s.type)) {
+		const nullable = s.type.includes("null");
+		const types = s.type.filter((t) => t !== "null");
+		if (nullable && s.description && !/\bnull\b/.test(s.description))
+			s.description = `${s.description} (null clears it.)`;
+		if (Array.isArray(s.enum)) s.enum = s.enum.filter((v) => v !== null);
+		if (types.length <= 1) {
+			s.type = types[0] ?? "string";
+		} else {
+			const common = {};
+			for (const [k, v] of Object.entries(s))
+				if (k !== "type" && k !== "enum" && !TYPE_SPECIFIC.has(k)) common[k] = v;
+			return { ...common, anyOf: types.map((t) => branch(s, t)) };
+		}
+	}
+
+	if (s.type === "array" && !s.items) s.items = { type: "string" };
+	if (s.properties && !s.type && !s.anyOf) s.type = "object";
+
+	if (s.properties) {
+		const props = {};
+		for (const [k, v] of Object.entries(s.properties)) props[k] = portableSchema(v);
+		s.properties = props;
+	}
+	if (s.items) s.items = portableSchema(s.items);
+	for (const k of ["anyOf", "oneOf", "allOf"])
+		if (Array.isArray(s[k])) s[k] = s[k].map(portableSchema);
+	if (s.additionalProperties && typeof s.additionalProperties === "object")
+		s.additionalProperties = portableSchema(s.additionalProperties);
+	return s;
+}

package/bin/server.mjs

@@ -47,6 +47,7 @@ import {
 	probeHealth,
 	waitForHealth,
 } from "./appConnection.mjs";
+import { portableSchema } from "./portableSchema.mjs";
 
 // ── Credentials + transport ───────────────────────────────────────────
 //
@@ -567,13 +568,16 @@ const MOTION_ELEMENT_TYPES = [
 	"iconPop",
 	"frame",
 	"sticker",
+	"ticker",
+	"credits",
+	"crawl",
 ];
 const MOTION_ELEMENT_PROPS = {
 	type: { type: "string", enum: MOTION_ELEMENT_TYPES },
 	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? }; endCard { lines: [a, b] }; progress { label?, fromMs?, toMs? }; iconPop { emoji } | { icon }; frame { look: viewfinder | selection | corners, label? }; sticker { image: transparent PNG path, label? }. Latin script only.',
+			'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.',
 	},
 	atMs: { type: "number", description: "Start, edited ms. Or wordId." },
 	wordId: {
@@ -596,8 +600,19 @@ const MOTION_ELEMENT_PROPS = {
 			highlight: { type: "string" },
 			text: { type: "string" },
 			font: { type: "string" },
-			size: { type: "string", enum: ["s", "m", "l", "xl"] },
+			size: { type: "string", enum: ["xs", "s", "m", "l", "xl"] },
 			outline: { type: "boolean" },
+			opacity: { type: "number", minimum: 0, maximum: 1, description: "Main text opacity." },
+			secondary: {
+				type: "object",
+				description:
+					"The smaller line (count label, lower-third subtitle, ticker label box, credits roles).",
+				properties: {
+					size: { type: "number", minimum: 0.4, maximum: 2.5, description: "1 = default." },
+					opacity: { type: "number", minimum: 0, maximum: 1 },
+					color: { type: "string" },
+				},
+			},
 		},
 		description: "Default: the brand kit.",
 	},
@@ -3101,7 +3116,7 @@ const TOOLS = [
 	{
 		name: "project_auto_reframe",
 		description:
-			"Active-speaker auto-reframe of landscape multi-person footage for vertical / square: frames whoever talks, shot by shot. Slow (minutes). clear reverts.",
+			"Active-speaker auto-reframe of landscape multi-person footage for vertical / square: frames whoever talks, shot by shot. split=true stacks two people (podcast / interview wide) one above the other on a 9:16 canvas. Slow (minutes). clear reverts.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -3112,6 +3127,11 @@ const TOOLS = [
 				minShotMs: { type: "number", description: "Default 500." },
 				samplesPerShot: { type: "number", description: "Default 3." },
 				zoom: { type: "number", description: "Fixed punch-in >= 1; omit = adaptive." },
+				split: {
+					type: "boolean",
+					description:
+						"Stack two people: a shot with two people too far apart for one vertical crop becomes two tiles (left person on top), each tracked on its face. Result reframed[].splitShots counts them.",
+				},
 				clear: { type: "boolean" },
 				expectedRevision: { type: "number" },
 			},
@@ -5035,6 +5055,104 @@ const TOOLS = [
 		},
 		command: "export.set-details",
 	},
+	{
+		name: "clips_make",
+		description:
+			"Long video (podcast, webinar, talk) in, scored vertical clips out, no agent needed: imports, transcribes, finds the best sentence-aligned moments across the whole video (local AI + transcript score), and forks each into its own 9:16 project with captions and face-following framing. Async: returns { clipSetId, jobId }; poll clips_get. Then clips_export, or edit a clip's projectPath with any project tool.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				file: { type: "string", description: "Absolute path of the long video." },
+				length: {
+					type: "string",
+					enum: ["short", "medium", "long"],
+					description: "short 15-30 s (default) | medium 30-60 s | long 60-90 s.",
+				},
+				format: {
+					type: "string",
+					enum: ["9:16", "1:1", "16:9"],
+					description: "Shape of every clip (default 9:16).",
+				},
+				footage: {
+					type: "string",
+					enum: ["camera", "screen"],
+					description: "camera (people talking, default) | screen (screen recording, slides).",
+				},
+				captionTemplate: {
+					type: "string",
+					description: "Caption template id (default glowStack), or none.",
+				},
+			},
+			required: ["file"],
+		},
+		command: "clips.make",
+	},
+	{
+		name: "clips_list",
+		description: "List clip sets from clips_make, newest first, with status and clip counts.",
+		inputSchema: { type: "object", properties: {} },
+		command: "clips.list",
+	},
+	{
+		name: "clips_get",
+		description:
+			"One clip set: status (importing, transcribing, finding, building, ready, error), usedModel, sourceProjectPath and clips[] best-first ({ id, title, hook, score 0-100, startMs, endMs, status, projectPath, thumbPath, exportedPath }).",
+		inputSchema: {
+			type: "object",
+			properties: { id: { type: "string", description: "Clip set id." } },
+			required: ["id"],
+		},
+		command: "clips.get",
+	},
+	{
+		name: "clips_export",
+		description:
+			"Export a clip set's finished clips to MP4 (all, or clipIds) into Movies/PandaStudio Clips/<video>/. Async: returns { jobId, outputDir }; job_wait for { exported[] }.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Clip set id." },
+				clipIds: { type: "array", items: { type: "string" }, description: "Only these clips." },
+			},
+			required: ["id"],
+		},
+		command: "clips.export",
+	},
+	{
+		name: "clips_retry",
+		description:
+			"Run a failed or stopped clip set again, reusing its import and transcript and keeping finished clips. clips_get shows why it failed (errorCode).",
+		inputSchema: {
+			type: "object",
+			properties: { id: { type: "string", description: "Clip set id." } },
+			required: ["id"],
+		},
+		command: "clips.retry",
+	},
+	{
+		name: "clips_set_caption",
+		description:
+			"Change every clip's caption style in a set (clips not built yet use it; finished clips are restyled and re-rendered in the background). captionTemplate: template id or none.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Clip set id." },
+				captionTemplate: { type: "string", description: "Caption template id, or none." },
+			},
+			required: ["id", "captionTemplate"],
+		},
+		command: "clips.set-caption",
+	},
+	{
+		name: "clips_delete",
+		description: "Forget a clip set (its clip projects and exports are kept).",
+		inputSchema: {
+			type: "object",
+			properties: { id: { type: "string", description: "Clip set id." } },
+			required: ["id"],
+		},
+		command: "clips.delete",
+	},
 	{
 		name: "export_generate_shots",
 		description:
@@ -5348,7 +5466,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 		tools: TOOLS.map((t) => ({
 			name: t.name,
 			description: t.description,
-			inputSchema: t.inputSchema,
+			// Gemini rejects multi-type fields that JSON Schema allows.
+			inputSchema: portableSchema(t.inputSchema),
 		})),
 	};
 });

package/package.json

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