@writepanda/mcp 1.194.0 → 1.200.0

package/bin/server.mjs

@@ -620,10 +620,43 @@ const TOOLS = [
 	{
 		name: "system_status",
 		description:
-			"App version and license; automationGated true = trial expired, every other tool fails. Call first.",
+			"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.",
 		inputSchema: { type: "object", properties: {} },
 		command: "system.status",
 	},
+	{
+		name: "system_report_issue",
+		description:
+			"Report a PandaStudio problem to the team (emailed; repeats group into one issue). Call it yourself, without asking, on a capability gap, an unexpected command failure, or output that doesn't match the project; then say in chat that you reported it. Not for user mistakes, missing keys, network or taste. Technical facts only: never put transcript/captions in title or details (userContent + userConsented only after the user agrees). sent=false with a reason: don't retry.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				title: { type: "string", description: "One line: what's broken." },
+				details: {
+					type: "string",
+					description: "What happened and your diagnosis (no user content).",
+				},
+				kind: {
+					type: "string",
+					enum: ["capability-gap", "command-failed", "wrong-output", "crash", "confusing", "other"],
+				},
+				key: {
+					type: "string",
+					description: "Kebab-case problem name, e.g. custom-font-not-in-export.",
+				},
+				userGoal: { type: "string" },
+				command: { type: "string", description: "e.g. caption.set-style" },
+				workaround: { type: "string" },
+				agent: { type: "string", description: "Your runtime / model." },
+				id: { type: "string", description: "Project id (default: open project)." },
+				path: { type: "string" },
+				userContent: { type: "string" },
+				userConsented: { type: "boolean" },
+			},
+			required: ["title", "details"],
+		},
+		command: "system.report-issue",
+	},
 	{
 		name: "skill_read",
 		description:
@@ -1052,51 +1085,88 @@ const TOOLS = [
 		},
 		command: "export.publish-youtube",
 	},
+	// ── Social publishing (2.0.3): Instagram, TikTok, Facebook, LinkedIn, X ──
+	// Through PandaQueue; every verb acts on the ACTIVE workspace's own
+	// accounts. The older instagram.* verbs remain callable via pandastudio_call.
 	{
-		name: "instagram_connect",
+		name: "social_channels",
 		description:
-			"Start connecting Instagram (Business / Creator only); the user finishes in the browser, then poll instagram_status.",
+			"Social accounts connected in the active workspace (Instagram, TikTok, Facebook, LinkedIn, X) with ids, limits and per-post settings, plus each network's count.",
 		inputSchema: { type: "object", properties: {} },
-		command: "instagram.connect",
+		command: "social.channels",
 	},
 	{
-		name: "instagram_status",
-		description: "Instagram connection { status, active }. Poll after instagram_connect.",
+		name: "social_connect",
+		description:
+			"Connect a network to the active workspace: opens its sign-in in the user's browser, returns { sessionId } at once; poll social_connect_status. Instagram: Business/Creator only.",
 		inputSchema: {
 			type: "object",
 			properties: {
-				connectionId: { type: "string" },
+				network: { type: "string", enum: ["instagram", "tiktok", "facebook", "linkedin", "x"] },
 			},
+			required: ["network"],
 		},
-		command: "instagram.status",
+		command: "social.connect",
 	},
 	{
-		name: "instagram_account",
-		description: "Connected Instagram account and whether it can publish.",
-		inputSchema: { type: "object", properties: {} },
-		command: "instagram.account",
+		name: "social_connect_status",
+		description: "{ state: pending | connected | failed, channels } for a social_connect session.",
+		inputSchema: {
+			type: "object",
+			properties: { sessionId: { type: "string" } },
+			required: ["sessionId"],
+		},
+		command: "social.connect-status",
 	},
 	{
-		name: "instagram_disconnect",
+		name: "social_disconnect",
 		description:
-			"Disconnect Instagram. Published Reels stay. Destructive: user confirms (see instructions).",
-		inputSchema: { type: "object", properties: {} },
-		command: "instagram.disconnect",
+			"Disconnect one social account (id from social_channels). Destructive: user confirms (see instructions).",
+		inputSchema: {
+			type: "object",
+			properties: { channelId: { type: "string" } },
+			required: ["channelId"],
+		},
+		command: "social.disconnect",
 	},
 	{
-		name: "export_publish_instagram",
+		name: "export_publish_social",
 		description:
-			"Publish an export entry (9:16, up to ~90 s) as an Instagram Reel. Slow. Returns { permalink }.",
+			"Post an export entry to connected social accounts, now or scheduled. Public: confirm accounts + caption first. Returns { jobId }; job_wait gives { state, channels[{ permalink, error }], summary }.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				id: { type: "string", description: "Export entry id." },
-				caption: { type: "string", description: "Max 2200 chars." },
-				shareToFeed: { type: "boolean", description: "Default true." },
+				channelIds: {
+					type: "array",
+					items: { type: "string" },
+					description: "Account ids from social_channels.",
+				},
+				networks: {
+					type: "array",
+					items: { type: "string" },
+					description: "Every connected account of these networks.",
+				},
+				caption: { type: "string" },
+				captions: { type: "object", description: "{ channelId: caption } overrides." },
+				settings: { type: "object", description: "{ channelId: { ...network settings } }." },
+				when: { type: "string", enum: ["now", "schedule"] },
+				scheduledAt: { type: "string", description: "ISO 8601 with offset; for schedule." },
 			},
 			required: ["id"],
 		},
-		command: "export.publish-instagram",
+		command: "export.publish-social",
+	},
+	{
+		name: "social_post_status",
+		description:
+			"Status and links of a post from export_publish_social (pass exportId to update the export's record).",
+		inputSchema: {
+			type: "object",
+			properties: { postId: { type: "string" }, exportId: { type: "string" } },
+			required: ["postId"],
+		},
+		command: "social.post-status",
 	},
 	{
 		name: "export_list_youtube",
@@ -2043,19 +2113,55 @@ const TOOLS = [
 		command: "project.remove-bleep",
 	},
 	{
-		name: "project_plan_broll",
+		name: "project_follow_speaker",
+		description:
+			"Podcast recordings (each person on their own camera): cut the frame to whoever is talking from the transcript's speaker tags. podcast-solo per turn, podcast-pair (both) in quick back-and-forth, no cut for short interjections. Anchored, re-runnable; run after the cuts. One wide shot of several people: project_auto_reframe instead.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				minTurnMs: { type: "number", description: "Shorter turns don't cut away (default 1200)." },
+				pair: {
+					type: "boolean",
+					description: "Both people during quick exchanges (default true).",
+				},
+				exchangeTurnMs: {
+					type: "number",
+					description: "Turn length that counts as quick (default 2600).",
+				},
+				dryRun: { type: "boolean" },
+				expectedRevision: { type: "number" },
+			},
+		},
+		command: "project.follow-speaker",
+	},
+	{
+		name: "project_check_broll",
 		description:
-			"B-roll, the LAST step of an edit: the moments where a picture of what's said would help, plus imageConnector (connected generator or null). Never makes images: show the user the moments and ASK: their own images, generate on their connector (uses their credits), or no B-roll. No one to ask: skip it and say so.",
+			"B-roll, the LAST step of an edit. YOU pick the moments from what's said (transcript_get; any language, any topic; in a Short ~1 per 6-8 s with the first right after the opening line, in long-form ~1 per 10-15 s) and what each picture shows; this checks them: span, clashes with the steps list / end card / other pictures, spacing, a nearby suggestion when blocked, insetSide (card away from the face). No moments: free stretches. Returns imageConnector. Never makes images: show the user your moments and ASK: their own images, generate on their connector (uses credits), or none. No one to ask: skip it and say so.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				id: { type: "string" },
 				path: { type: "string" },
-				maxBeats: { type: "number" },
+				moments: {
+					type: "array",
+					items: {
+						type: "object",
+						properties: {
+							wordId: { type: "string" },
+							atMs: { type: "number" },
+							endWordId: { type: "string" },
+							durationMs: { type: "number" },
+							picture: { type: "string", description: "What the picture shows." },
+						},
+					},
+				},
 				minGapMs: { type: "number" },
 			},
 		},
-		command: "project.plan-broll",
+		command: "project.check-broll",
 	},
 	{
 		name: "project_add_broll",
@@ -3695,7 +3801,11 @@ const TOOLS = [
 				path: { type: "string" },
 				wordsPerLine: { type: "number" },
 				positionY: { type: "number", description: "% from the top, default 85." },
-				fontFamily: { type: "string" },
+				fontFamily: {
+					type: "string",
+					description:
+						"A family from asset_list_fonts (bundled, custom or system). Unknown names render in Inter and come back as a warning.",
+				},
 				color: { type: "string" },
 				backgroundColor: { type: "string" },
 				highlightColor: { type: "string", description: "Spoken word." },
@@ -3776,7 +3886,7 @@ const TOOLS = [
 	{
 		name: "media_generate_image",
 		description:
-			"Generate one image on the user's own image connector (auto: Replicate, else Higgsfield; their credits). Only after the user agreed to generating (ask first; B-roll: project_plan_broll, then ask). Returns { imagePath, provider, model, transparent }. transparent=true: trimmed PNG sticker. No connector: code NO_IMAGE_CONNECTOR, so ask the user for their own images. Each call is a paid generation.",
+			"Generate one image on the user's own image connector (auto: Replicate, else Higgsfield; their credits). Only after the user agreed to generating (ask first; B-roll: pick moments, project_check_broll, then ask). Returns { imagePath, provider, model, transparent }. transparent=true: trimmed PNG sticker. No connector: code NO_IMAGE_CONNECTOR, so ask the user for their own images. Each call is a paid generation.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4390,6 +4500,21 @@ const TOOLS = [
 		},
 		command: "recipe.list",
 	},
+	{
+		name: "recipe_pick",
+		description:
+			"No style named ('edit my video', 'make this a Short')? The recipes that fit this project's format and footage, each with pickWhen, plus defaultId. Choose by what's said, then recipe_apply_style + recipe_render.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Project id (default: the open project)." },
+				path: { type: "string" },
+				format: { type: "string", enum: ["short", "long"] },
+				footage: { type: "string", enum: ["camera", "screen", "podcast", "none"] },
+			},
+		},
+		command: "recipe.pick",
+	},
 	{
 		name: "recipe_get",
 		description: "Read one recipe in full.",
@@ -4769,6 +4894,18 @@ const TOOLS = [
 		inputSchema: { type: "object", properties: {} },
 		command: "asset.list-luts",
 	},
+	{
+		name: "asset_list_fonts",
+		description:
+			"Font families text can use: bundled, scriptFallbacks (Noto, used per character for Indic/Arabic/Hebrew/Thai text), custom (the user's imported fonts; prefer one covering the video's language), system with includeSystem. Pass one to caption_set_style fontFamily.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				includeSystem: { type: "boolean", description: "Also list installed families (long)." },
+			},
+		},
+		command: "asset.list-fonts",
+	},
 
 	// ── project-aware LLM ──────────────────────────────────────────
 	{
@@ -5172,24 +5309,22 @@ Start with system_status. Unknown arguments are rejected. Verbs without a tool o
 
 Before an editing pass, read the skill's "Which tool for which moment" section (skill_read section="Which tool for which moment").
 
-"Edit my video" with no specifics = this pipeline, in order. Confirm scope once ("full polish, or just part of it?"), then run it all:
+"Edit my video" / "make this a Short" with no specifics = this pipeline, in order. Confirm scope once ("full polish, or just part of it?"), then run it all:
 1. transcript_transcribe clips not yet transcribed (project_read clipStates).
 2. transcript_remove_fillers.
 3. Fix misheard names / brands with transcript_find_replace (transcript_insert_words for dropped words).
 4. transcript_find_issues, then transcript_delete_words on each duplicate take / false start (keep the LAST take; keep severity "low" ones).
 5. transcript_remove_silences.
 6. audio_clean clips not yet cleaned.
-7. Captions (caption_toggle; template glowStack unless a recipe says otherwise), motion graphics, emphasis zooms: only after steps 2-5, which shift the timeline.
-8. B-roll, last: project_plan_broll, show the user the moments and ASK: their own images, generated on their image connector (only if one is connected; it uses their credits), or no B-roll. Never generate or invent images without their answer. Place what they give with project_add_broll. Nobody to ask: skip it and say so.
+7. The style, after steps 2-5 (they shift the timeline). The user's named style, recipe, creator or a saved memory wins. Otherwise call recipe_pick: it returns the recipes that fit this project's format and footage, each with pickWhen, plus defaultId. Read the transcript, choose the ONE candidate whose pickWhen matches what is said (defaultId when none clearly fits), do its "before" step if any, then recipe_apply_style + recipe_render and follow the prompt: the recipe decides captions, graphics, zooms, music and transitions. (An app without recipe_pick, 2.0.5 and older: recipe_list with format short or long, and choose by description and footage.) Tell the user which recipe and why in one line and name one or two alternatives. Only when no candidate exists or the user asked for a plain clean-up: captions (caption_toggle, template glowStack), a few motion graphics, emphasis zooms.
+8. B-roll, last: pick the moments yourself from what's said (any language), check them with project_check_broll, show the user your moments and ASK: their own images, generated on their image connector (only if one is connected; it uses their credits), or no B-roll. Never generate or invent images without their answer. Place what they give with project_add_broll. Nobody to ask: skip it and say so.
 9. llm_generate_title / description / timestamps, then preview_show and ask before export_start. Never export before the user has seen the preview.
-Report the real count each step returned. Never add music, intro/outro cards or FX overlays unless asked.
+Report the real count each step returned. No music, intro/outro cards or FX overlays unless the recipe or the user asks for them.
+A single named operation ("just add captions", "remove the silences") is exactly that: no recipe.
 
-Style defaults when the user names no style, recipe or creator (their choice or a saved memory wins):
-- Long-form 16:9 with the speaker on camera: the Ali style recipe, id educator-talking-head-chapters (recipe_apply_style, then recipe_render and follow its prompt). It keeps burned-in captions OFF (keyword pops instead). Not for camera-less screen recordings or Loom-style internal videos.
-- Shorts / Reels / TikTok (9:16): the Shorts recipe that fits: hard-truth-one-liner-short (one blunt claim), rules-listicle-cutaways-short (numbered tips), rapid-fire-list-short (many one-line items), storytime-turn-short (story with a twist), framework-explainer-short (one concept), split-screen-short-broll (showable things), social-ad-hook-variants (selling an offer), faceless-short (no footage), else warm-educator-short.
-A Short from a SCREEN RECORDING first gets project_set_vertical_screen_layout, then the recipe. Say which recipe you used and why, and offer others (recipe_list).
+Destructive actions need the user's own confirmation: project_delete, workspace_delete, recipe_delete, memory_forget, export_delete, export_clear_thumbnail, youtube_disconnect, social_disconnect. Ask plainly in chat first ("Delete project 'Demo'? This can't be undone.") and call only after they agree. PandaStudio then confirms with them itself: in its own chat the call returns confirmation_required and changes nothing while a Delete / Cancel card waits (tell them to press it; don't call again; the outcome arrives as their next message); from other apps a dialog asks, and the call is refused when nobody is at the app. Nothing you send can approve it.
 
-Destructive actions need the user's own confirmation: project_delete, workspace_delete, recipe_delete, memory_forget, export_delete, export_clear_thumbnail, youtube_disconnect, instagram_disconnect. Ask plainly in chat first ("Delete project 'Demo'? This can't be undone.") and call only after they agree. PandaStudio then confirms with them itself: in its own chat the call returns confirmation_required and changes nothing while a Delete / Cancel card waits (tell them to press it; don't call again; the outcome arrives as their next message); from other apps a dialog asks, and the call is refused when nobody is at the app. Nothing you send can approve it.
+PandaStudio problems (a capability gap like an imported font the export can't draw, a command failing unexpectedly, a render not matching the project): call system_report_issue yourself, then tell the user you reported it. Not for user mistakes, missing keys or taste.
 
 Destination decides everything: infer it (Shorts/TikTok/vertical/<=90s: shorts; YouTube/tutorial/>8 min: youtube-long; LinkedIn; Loom/internal), else ask once.
 

package/package.json

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