@writepanda/mcp 1.191.0 → 1.198.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",
@@ -1973,6 +2043,153 @@ const TOOLS = [
 		},
 		command: "project.remove-mute-region",
 	},
+	{
+		name: "project_add_bleep",
+		description:
+			"Bleep words instead of cutting them: audio silenced, a tone of exactly their length plays, captions mask them (d***). wordIds from transcript.get (adjacent words = one bleep; stays on those words through later cuts) or startMs/endMs edited ms. Overlaps merge. Returns bleepIds.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				wordIds: { type: "array", items: { type: "string" } },
+				startMs: { type: "number" },
+				endMs: { type: "number" },
+				sound: {
+					type: "string",
+					enum: ["tv", "low", "high", "retro", "silence"],
+					description: "Default tv (1 kHz).",
+				},
+				volume: { type: "number", description: "0-1, default 0.5." },
+				mask: {
+					type: "string",
+					enum: ["stars", "none"],
+					description: "Caption masking, default stars.",
+				},
+				padMs: { type: "number", description: "Padding each side, default 30." },
+				padStartMs: { type: "number" },
+				padEndMs: { type: "number" },
+				expectedRevision: { type: "number" },
+			},
+		},
+		command: "project.add-bleep",
+	},
+	{
+		name: "project_update_bleep",
+		description:
+			"Change a bleep's sound, volume or caption mask, or its edges: nudgeStartMs (+ = earlier start), nudgeEndMs (+ = later end), or padStartMs/padEndMs.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				bleepId: { type: "string" },
+				sound: { type: "string", enum: ["tv", "low", "high", "retro", "silence"] },
+				volume: { type: "number" },
+				mask: { type: "string", enum: ["stars", "none"] },
+				padStartMs: { type: "number" },
+				padEndMs: { type: "number" },
+				nudgeStartMs: { type: "number" },
+				nudgeEndMs: { type: "number" },
+				expectedRevision: { type: "number" },
+			},
+			required: ["bleepId"],
+		},
+		command: "project.update-bleep",
+	},
+	{
+		name: "project_remove_bleep",
+		description: "Remove a bleep (bleepId) or un-bleep specific words (wordIds).",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				bleepId: { type: "string" },
+				wordIds: { type: "array", items: { type: "string" } },
+				expectedRevision: { type: "number" },
+			},
+		},
+		command: "project.remove-bleep",
+	},
+	{
+		name: "project_check_broll",
+		description:
+			"B-roll, the LAST step of an edit. YOU pick the moments from what's said (transcript_get; any language, any topic; ~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" },
+				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.check-broll",
+	},
+	{
+		name: "project_add_broll",
+		description:
+			"Place a B-roll beat on a word: the picture (user's own, or generated after they agreed) for ~2 s with a slow push, shutter click and a transition on both edges; moves / deletes / follows cuts as one (brollId).",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				imagePath: { type: "string" },
+				wordId: { type: "string" },
+				atMs: { type: "number" },
+				durationMs: { type: "number", description: "1400-4000, default 2000." },
+				endWordId: { type: "string" },
+				layout: { type: "string", enum: ["full", "inset"] },
+				transition: {
+					type: "string",
+					enum: ["flash", "light-sweep", "film-burn", "fade-white", "glitch", "none"],
+				},
+				sound: { type: "string", enum: ["shutter", "click", "none"] },
+				push: { type: "string", enum: ["in", "out", "none"] },
+				expectedRevision: { type: "number" },
+			},
+			required: ["imagePath"],
+		},
+		command: "project.add-broll",
+	},
+	{
+		name: "project_list_broll",
+		description: "The project's B-roll beats (brollId, picture, span, overlay ids).",
+		inputSchema: {
+			type: "object",
+			properties: { id: { type: "string" }, path: { type: "string" } },
+		},
+		command: "project.list-broll",
+	},
+	{
+		name: "project_remove_broll",
+		description: "Remove a B-roll beat (picture + transitions) by brollId.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				brollId: { type: "string" },
+				expectedRevision: { type: "number" },
+			},
+			required: ["brollId"],
+		},
+		command: "project.remove-broll",
+	},
 	{
 		name: "project_add_spotlight",
 		description:
@@ -3560,7 +3777,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." },
@@ -3641,7 +3862,7 @@ const TOOLS = [
 	{
 		name: "media_generate_image",
 		description:
-			"Generate one image on the user's own image connector (auto: Replicate, else Higgsfield; their credits). 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: {
@@ -4394,6 +4615,10 @@ const TOOLS = [
 					description: "Omit for the template's natural mode.",
 				},
 				outputName: { type: "string" },
+				durationMs: {
+					type: "number",
+					description: "Length for templates with a durationRangeMs (clamped); ignored otherwise.",
+				},
 			},
 			required: ["templateId", "slots"],
 		},
@@ -4630,6 +4855,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 ──────────────────────────────────────────
 	{
@@ -5041,7 +5278,8 @@ Before an editing pass, read the skill's "Which tool for which moment" section (
 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. llm_generate_title / description / timestamps, then preview_show and ask before export_start. Never export before the user has seen the preview.
+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.
 
 Style defaults when the user names no style, recipe or creator (their choice or a saved memory wins):
@@ -5049,7 +5287,9 @@ Style defaults when the user names no style, recipe or creator (their choice or
 - 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, 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.
+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.
+
+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.191.0",
+	"version": "1.198.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",