@writepanda/mcp 1.217.0 → 1.219.0

package/bin/server.mjs

@@ -1231,7 +1231,7 @@ const TOOLS = [
 	{
 		name: "export_publish_youtube",
 		description:
-			"Publish an export entry to YouTube. Slow. Check the entry's youtubeVideoId before republishing. channelId optional (uploads go to the account's own channel; omit when channels can't be listed). Error code youtube_permission_missing: relay message, follow howToFix. Returns { videoUrl, channelId }.",
+			"Publish an export entry to YouTube. Slow. Check the entry's youtubeVideoId before republishing. channelId optional (uploads go to the account's own channel; omit when channels can't be listed). Error code youtube_permission_missing: relay message, follow howToFix. Error code daily_limit or youtube_quota_exceeded (with resetsAt): tell the user when it resets; never retry before resetsAt. Returns { videoUrl, channelId }.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1296,7 +1296,7 @@ const TOOLS = [
 	{
 		name: "export_publish_social",
 		description:
-			"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 }.",
+			"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 }. A job failing with errorDetails.code daily_limit (posts per workspace per 24h) has errorDetails.resetsAt: tell the user; never retry before it.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1347,7 +1347,8 @@ const TOOLS = [
 	},
 	{
 		name: "export_update_youtube",
-		description: "Update a published YouTube video's metadata (only fields to change).",
+		description:
+			"Update a published YouTube video's metadata (only fields to change). Error code daily_limit or youtube_quota_exceeded (with resetsAt): never retry before resetsAt.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -1365,7 +1366,8 @@ const TOOLS = [
 	},
 	{
 		name: "export_update_youtube_thumbnail",
-		description: "Replace a published YouTube video's thumbnail (local 1280x720 image).",
+		description:
+			"Replace a published YouTube video's thumbnail (local 1280x720 image). Error code daily_limit or youtube_quota_exceeded (with resetsAt): never retry before resetsAt.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4318,7 +4320,7 @@ const TOOLS = [
 	{
 		name: "audio_enhance",
 		description:
-			"Enhance voice: THE audio cleanup step (one call). Runs the studio chain on speech, per source (a podcast's host and each guest separately): noise removal, coughs/bumps out of pauses, mouth-click repair, broadcast tone, boom control, level riding (lifts very quiet speech too), de-esser, quieter pauses, -16 LUFS / -1 dBTP. strength: natural (default), light (gentle tidy), strong (assertive broadcast). keepBackground true for vlogs / ambience where the room is part of the video (no noise removal, event remover or pause expander; level, EQ and loudness still run). echo true only when the user mentions echo / reverb or the room is bare. restore true = Restore voice quality (TF-Restormer) for thin, muffled or call-quality mics only (Apple silicon; slow; never on a good mic). reference = a clip id or file whose voice tone to match. off true restores the original audio. The noise-removal engine is automatic. Every run processes the original media, so running again replaces the result (never stacks). ASYNC: { jobId }, job_wait; the result reports before/after loudness (LUFS, LRA, true peak, speech over pauses, tone deviation) and the engine per source: tell the user.",
+			"Enhance voice: THE audio cleanup step (one call). Runs the studio chain on speech, per source (a podcast's host and each guest separately): noise removal, coughs/bumps out of pauses, mouth-click repair, broadcast tone, boom control, level riding (lifts very quiet speech too), de-esser, quieter pauses, -16 LUFS / -1 dBTP. strength: natural (default), light (gentle tidy), strong (assertive broadcast). keepBackground true for vlogs / ambience where the room is part of the video (no noise removal, event remover or pause expander; level, EQ and loudness still run). Enhance voice already removes room echo with the Studio AI model; only use echo when the result reports the model did not run (fallback) (denoiser deepfilternet3, or keepBackground); when the model runs, echo is skipped and the result says echoSkipped: ai-model-removes-echo (relay echoSkippedReason, do not retry). restore true = Studio mic sound (the app's name) for thin, muffled or call-quality mics only (never on a good mic): TF-Restormer on Apple silicon, AP-BWE on Windows and Intel Macs (CPU, faster than real time); restoreEngine in the result says which ran. reference = a clip id or file whose voice tone to match. off true restores the original audio. The noise-removal engine is automatic. Every run processes the original media, so running again replaces the result (never stacks). ASYNC: { jobId }, job_wait; the result reports before/after loudness (LUFS, LRA, true peak, speech over pauses, tone deviation) and the engine per source: tell the user.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4339,11 +4341,17 @@ const TOOLS = [
 					default: false,
 					description: "Keep the room sound (vlogs, ambience).",
 				},
-				echo: { type: "boolean", default: false, description: "Reduce room echo." },
+				echo: {
+					type: "boolean",
+					default: false,
+					description:
+						"Reduce room echo. Enhance voice already removes room echo with the Studio AI model; only use echo when the result reports the model did not run (fallback). Skipped (echoSkipped) whenever the model runs.",
+				},
 				restore: {
 					type: "boolean",
 					default: false,
-					description: "Restore voice quality for a thin / low-bandwidth mic (TF-Restormer).",
+					description:
+						"Studio mic sound for a thin / low-bandwidth mic (TF-Restormer on Apple silicon, AP-BWE elsewhere).",
 				},
 				reference: { type: "string", description: "Clip id or audio/video file to sound like." },
 				off: { type: "boolean", description: "Remove the enhancement (original audio)." },
@@ -4359,14 +4367,18 @@ const TOOLS = [
 	{
 		name: "audio_clean",
 		description:
-			"Deprecated alias of audio_enhance strength light (noise removal, gentle level and tone, -16 LUFS), echo true adds Reduce echo; clips already enhanced are skipped unless clipId is given. Prefer audio_enhance. ASYNC: { jobId }, job_wait.",
+			"Deprecated alias of audio_enhance strength light (noise removal, gentle level and tone, -16 LUFS), echo true adds Reduce echo only when the Studio AI model does not run (it already removes room echo; the result then says echoSkipped); clips already enhanced are skipped unless clipId is given. Prefer audio_enhance. ASYNC: { jobId }, job_wait.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				id: { type: "string" },
 				path: { type: "string" },
 				clipId: { type: "string" },
-				echo: { type: "boolean", description: "Only when the user mentions echo / reverb." },
+				echo: {
+					type: "boolean",
+					description:
+						"Enhance voice already removes room echo with the Studio AI model; only use echo when the result reports the model did not run (fallback).",
+				},
 				normalize: { type: "boolean", description: "Ignored (quiet speech is always lifted)." },
 			},
 		},
@@ -5717,7 +5729,8 @@ const TOOLS = [
 	},
 	{
 		name: "llm_generate_timestamps",
-		description: "Generate YouTube chapter timestamps from the transcript.",
+		description:
+			"Generate YouTube chapter timestamps for the edited video: edited-timeline times from the words that survive the cuts (first 0:00, each >= 10 s, all before the end); the local LLM only writes labels.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -6233,7 +6246,7 @@ Before an editing pass, read the skill's "Which tool for which moment" section (
 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_enhance (Enhance voice) on clips not yet enhanced: strength natural; keepBackground true for vlogs / ambience; echo only when the room is echoey.
+6. audio_enhance (Enhance voice) on clips not yet enhanced: strength natural; keepBackground true for vlogs / ambience; no echo (Enhance voice already removes room echo with the Studio AI model; only use echo when the result reports the model did not run (fallback)).
 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 the style (captions, pacing, kinds of moves, music, transitions). Graphics inside it are designed by you: a named template is the reference look; author your own (motion_render_html, same palette and type) when a beat needs something the template can't show. (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.
@@ -6242,6 +6255,8 @@ A single named operation ("just add captions", "remove the silences") is exactly
 
 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.
 
+Publishing has daily limits (YouTube uploads and updates per license, social posts per workspace, and PandaStudio's shared YouTube quota). A failure with code daily_limit or youtube_quota_exceeded carries resetsAt: tell the user when it resets and do not retry, loop or switch accounts to get around it before then. It is not a bug to report.
+
 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.217.0",
+	"version": "1.219.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",