@writepanda/mcp 1.249.0 → 1.259.0

package/bin/server.mjs

@@ -1274,6 +1274,29 @@ const TOOLS = [
 								borderRadius: { type: "number" },
 								showBlur: { type: "boolean" },
 								motionBlurAmount: { type: "number" },
+								wallpaperMotion: { type: "number", description: "mesh: background speed 0-2." },
+								screenFrame: {
+									type: "object",
+									description: "Device frame for screen recordings.",
+									properties: {
+										kind: {
+											type: "string",
+											enum: ["browser", "window", "laptop", "phone", "tablet"],
+										},
+										theme: { type: "string", enum: ["light", "dark"] },
+										url: { type: "string" },
+									},
+								},
+								screenTilt: {
+									type: "object",
+									description: "3D tilt of screen recordings.",
+									properties: {
+										angle: { type: "string", enum: ["flat", "left", "right", "above"] },
+										followCursor: { type: "boolean" },
+										clickBounce: { type: "boolean" },
+										strength: { type: "number", description: "0-1." },
+									},
+								},
 							},
 						},
 						graphicSound: {
@@ -2412,12 +2435,18 @@ const TOOLS = [
 	{
 		name: "podcast_draft_rundown",
 		description:
-			"Have the studio's producer draft the run of show from a short brief: segments with questions, guest lower thirds, and a YouTube title, description and thumbnail idea, on the model the user picked for the assistant. Replaces the current run of show unless apply=false.",
+			"Have the studio's producer draft the run of show from a short brief: segments with questions, guest lower thirds, and a YouTube title, description and thumbnail idea, on the model the user picked for the assistant. Pass the host's own questions as questions: each goes in word for word (on the prompter card) with a lower third. Replaces the current run of show unless apply=false.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				brief: { type: "string" },
 				minutes: { type: "number", description: "Total show length (default 45)." },
+				questions: {
+					type: "array",
+					items: { type: "string" },
+					description:
+						"The host's own questions, in order: kept word for word, each with a lower third.",
+				},
 				guests: {
 					type: "array",
 					items: {
@@ -3770,7 +3799,7 @@ const TOOLS = [
 	{
 		name: "audio_describe",
 		description:
-			"Numeric audio evidence for a local audio/video path OR project id/range: loudness, true peak, clipping, silence, speech/music estimate, tempo/beats, attacks, spectral brightness and summary. No song/sound identification. Async: job.wait; first 10 minutes maximum.",
+			"Numeric audio evidence for a local audio/video path OR project id/range: loudness, true peak, clipping, silence, speech/music estimate, tempo/beats, attacks, spectral brightness and summary. A file with no audio track returns hasAudio:false (silent), not an error. No song/sound identification. Async: job.wait; first 10 minutes maximum.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4022,6 +4051,43 @@ const TOOLS = [
 		},
 		command: "project.close-gap",
 	},
+	{
+		name: "project_set_overlay_lane",
+		description:
+			'Pin media overlays (B-roll, graphics, transitions) or audio tracks to a row of their timeline lane so each keeps its own row, like one track per asset. Without a pin the timeline packs items that do not overlap into the fewest rows. Rows are zero based, top first. Shapes: overlayId + lane; ids + lane (one row for all, or "separate": ids[i] -> row i, in order); or assignments [{id, lane}]. lane null or "auto" unpins. Layout only: nothing moves in time, picture stacking stays zIndex / layer, main-track clips are one sequential track (not lanes). A pin onto a row another PINNED item holds at the same time is rejected; unpinned items make room. Returns timelineLanes {media, audio}: ids per row, the numbering project_close_gap uses ("media:1"); project_read reports the same. One undo step.',
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Project id (or pass path)." },
+				path: { type: "string", description: "Project file path (or pass id)." },
+				overlayId: { type: "string", description: "One media overlay or audio track id." },
+				ids: {
+					type: "array",
+					items: { type: "string" },
+					description: "Several media overlay / audio track ids, with lane.",
+				},
+				lane: {
+					type: ["number", "string", "null"],
+					description:
+						'Row 0-31 (top first); null or "auto" unpins; "separate" with ids puts ids[i] on row i.',
+				},
+				assignments: {
+					type: "array",
+					items: {
+						type: "object",
+						properties: {
+							id: { type: "string" },
+							lane: { type: ["number", "string", "null"] },
+						},
+						required: ["id", "lane"],
+					},
+					description: 'Per-item rows, e.g. [{"id": "a", "lane": 0}, {"id": "b", "lane": "auto"}].',
+				},
+				expectedRevision: { type: "number" },
+			},
+		},
+		command: "project.set-overlay-lane",
+	},
 
 	{
 		name: "project_remove_pause",
@@ -4671,7 +4737,7 @@ const TOOLS = [
 	{
 		name: "project_set_wallpaper",
 		description:
-			"Set the background: a wallpaper value, or source=desktop (a kept still of the user's desktop wallpaper) / source=edges (Match video edges: a soft gradient from the video's border colours, slowly following the content; same in preview and export).",
+			"Set the background: a wallpaper value, or source=desktop (a kept still of the user's desktop wallpaper) / source=edges (Match video edges: a soft gradient from the video's border colours, slowly following the content; same in preview and export). Animated: 'mesh:<id>' = a living mesh gradient (blobs drift in a seamless 24 s loop); motion = drift speed.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4680,9 +4746,13 @@ const TOOLS = [
 				wallpaper: {
 					type: "string",
 					description:
-						"Bundled id (e.g. gradient-blue), color, CSS gradient or 'none'. Omit with source.",
+						"Bundled id (e.g. gradient-blue), color, CSS gradient, 'none', or an animated mesh:aurora | mesh:sunset | mesh:ocean | mesh:candy | mesh:forest | mesh:midnight | mesh:peach | mesh:graphite. Omit with source.",
 				},
 				source: { type: "string", enum: ["desktop", "edges"] },
+				motion: {
+					type: "number",
+					description: "Animated (mesh:) drift speed 0-2: 0 still, 1 default. Kept when omitted.",
+				},
 				expectedRevision: { type: "number" },
 			},
 		},
@@ -4742,7 +4812,7 @@ const TOOLS = [
 	{
 		name: "project_set_style",
 		description:
-			"Framing style, main-video frame (shape, border ring; drawn when the video is a card) and drawn-cursor behaviour. Only passed fields change. Camera tile of screen+camera: project_set_webcam_style.",
+			"Framing style, main-video frame (shape, border ring; drawn when the video is a card), drawn-cursor behaviour, and the screen's device frame + 3D tilt (screen recordings / images only). Only passed fields change. Camera tile of screen+camera: project_set_webcam_style.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4766,6 +4836,27 @@ const TOOLS = [
 				borderWidth: { type: "number", description: "px 0-40." },
 				borderColor: { type: "string" },
 				resetFrame: { type: "boolean", description: "Clear shape + border first." },
+				deviceFrame: {
+					type: "string",
+					enum: ["browser", "window", "laptop", "phone", "tablet", "none"],
+					description: "Frame around the screen; the video shrinks to fit inside it.",
+				},
+				deviceFrameTheme: { type: "string", enum: ["light", "dark"] },
+				deviceFrameUrl: {
+					type: "string",
+					description: "Browser address / window title; '' clears.",
+				},
+				tilt: {
+					type: "string",
+					enum: ["flat", "left", "right", "above"],
+					description: "3D angle (left / right: that edge goes back; above: seen from above).",
+				},
+				tiltFollowCursor: {
+					type: "boolean",
+					description: "Lean toward the cursor (needs cursor data).",
+				},
+				tiltClickBounce: { type: "boolean", description: "Rock slightly on each click." },
+				tiltStrength: { type: "number", description: "0-100, default 100." },
 				expectedRevision: { type: "number" },
 			},
 		},
@@ -4916,7 +5007,7 @@ const TOOLS = [
 	{
 		name: "project_align_cursor",
 		description:
-			"Fix a screen recording whose drawn cursor / cursor auto-zooms land in the wrong place (old recordings saved the pointer with the wrong mapping) without re-recording. Pins: at atMs the REAL pointer (or what was clicked) is at x,y, fractions 0-1 of the recorded frame. 1 pin = offset; 2+ pins far apart also fix scale per axis. Stored on the clip (non-destructive), used by preview, export and auto-zoom; cursor auto-zooms follow unless moveZooms false. reset removes it. Check with project_render_frame.",
+			"Fix a screen recording whose drawn cursor / cursor auto-zooms land in the wrong place (old recordings saved the pointer with the wrong mapping) without re-recording. Pins: at atMs the REAL pointer (or what was clicked) is at x,y, fractions 0-1 of the recorded frame. 1 pin = offset; 2+ pins far apart also fix scale per axis; the LAST pin is matched exactly (earlier ones steer the scale). Stored on the clip (non-destructive), used by preview, export and auto-zoom; cursor auto-zooms follow unless moveZooms false. reset removes it. Check with project_render_frame.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4929,7 +5020,7 @@ const TOOLS = [
 				points: {
 					type: "array",
 					description:
-						"[{atMs (edited timeline ms) or sourceMs (clip's own ms), x 0-1, y 0-1}] where the real pointer is.",
+						"[{atMs (edited timeline ms) or sourceMs (clip's own ms), x 0-1, y 0-1}] where the real pointer is. Last pin is exact.",
 					items: {
 						type: "object",
 						properties: {
@@ -5601,7 +5692,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). 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.",
+			"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: light (default, the best-sounding setup with Studio mic sound), natural (fuller processing), strong (assertive broadcast; only when the user asks, never by your own choice). keepBackground true for vlogs / ambience / gameplay where the room is part of the video (no noise removal, event remover or pause expander; level, EQ and loudness still run). A stereo source keeps its stereo (result channels: 2; else channels: 1 with monoReason one-channel / dual-mono / silent / studio-mic), and Studio mic sound stays off unless restore is true (it rebuilds the voice without the room). 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 = Studio mic sound (the app's name): leave it unset and it is ON on Apple silicon with macOS 14+ (TF-Restormer; Light + Studio mic sound is the default there) and off on Windows and Intel Macs (AP-BWE; pass true there only for thin, muffled or call-quality mics); false only when the user asks. restored / restoreEngine in the result say what 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: {
@@ -5615,7 +5706,7 @@ const TOOLS = [
 				strength: {
 					type: "string",
 					enum: ["light", "natural", "strong"],
-					default: "natural",
+					default: "light",
 				},
 				keepBackground: {
 					type: "boolean",
@@ -5630,9 +5721,8 @@ const TOOLS = [
 				},
 				restore: {
 					type: "boolean",
-					default: false,
 					description:
-						"Studio mic sound for a thin / low-bandwidth mic (TF-Restormer on Apple silicon, AP-BWE elsewhere).",
+						"Studio mic sound. Leave unset: ON on Apple silicon with macOS 14+ (TF-Restormer), off on Windows and Intel Macs (AP-BWE). false only when the user asks.",
 				},
 				reference: { type: "string", description: "Clip id or audio/video file to sound like." },
 				off: { type: "boolean", description: "Remove the enhancement (original audio)." },
@@ -5711,7 +5801,7 @@ const TOOLS = [
 	{
 		name: "caption_set_template",
 		description:
-			"Pick a caption template (default glowStack); clears style overrides. Emphasis templates (hormoziEmphasis, tiltedBox, serifItalic, condensedCaps, scriptKeyword) style the IMPORTANT word of each phrase, not the spoken one; emphasis is detected on apply when missing (result.emphasis).",
+			"Pick a caption template (new projects start with hormoziEmphasis when vertical, classic otherwise; use those when the user names no style, never glowStack unless asked); clears style overrides. Emphasis templates (hormoziEmphasis, tiltedBox, serifItalic, condensedCaps, scriptKeyword) style the IMPORTANT word of each phrase, not the spoken one; emphasis is detected on apply when missing (result.emphasis).",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -6044,10 +6134,55 @@ const TOOLS = [
 					description:
 						"Hide desktop icons for a whole-display recording (restored on stop/crash/quit). Default: the user's setting. Result tip = ask the user to turn on Do Not Disturb.",
 				},
+				windowSize: {
+					type: "string",
+					enum: ["16:9", "16:10", "4:3", "1:1", "9:16", "21:9", "720p", "1080p", "1440p", "4K"],
+					description:
+						"Window sources only: resize the window first. Ratio = same area, new shape; resolution = exact recorded pixels (fails if the display is too small). macOS needs Accessibility access.",
+				},
+				centerWindow: {
+					type: "boolean",
+					description:
+						"Window sources only: move the window to the middle of its display for the recording, back on stop/failure/crash/quit. Default: the user's setting.",
+				},
 			},
 		},
 		command: "recording.start",
 	},
+	{
+		name: "recording_resize_window",
+		description:
+			"Resize a window before recording it (the picker's size chips): a ratio keeps its area in the new shape, a resolution makes the recording exactly that size (1080p on a 2x display = a 960 x 540 point window). macOS needs Accessibility access (the error says how). Returns { frame, pixels }.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				source: { type: "string", description: "'window:N:0' from recording_list_sources." },
+				size: {
+					type: "string",
+					enum: ["16:9", "16:10", "4:3", "1:1", "9:16", "21:9", "720p", "1080p", "1440p", "4K"],
+				},
+			},
+			required: ["source", "size"],
+		},
+		command: "recording.resize-window",
+	},
+	{
+		name: "recording_get_window_options",
+		description: "Window-recording options: { centerWindow, supported }.",
+		inputSchema: { type: "object", properties: {} },
+		command: "recording.get-window-options",
+	},
+	{
+		name: "recording_set_center_window",
+		description:
+			"Turn Center on screen on/off for window recordings (window moves to the middle of its display during the recording, back after). Off by default. Returns { centerWindow }.",
+		inputSchema: {
+			type: "object",
+			properties: { enabled: { type: "boolean" } },
+			required: ["enabled"],
+		},
+		command: "recording.set-center-window",
+	},
 	{
 		name: "recording_get_clean_desktop",
 		description: "Clean-desktop recording setting. Returns { cleanDesktop, supported }.",
@@ -6602,16 +6737,409 @@ const TOOLS = [
 	{
 		name: "memory_save",
 		description:
-			"Save a durable workspace fact or preference for all future chats (not one-off requests).",
+			"Save a durable fact or preference the user STATED, for all future chats (not one-off requests). kind profile = who they are. Over budget it's refused with the current entries: merge (memory_replace) or forget first. Noticed but not stated: memory_suggest.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				note: { type: "string", description: "One concise fact." },
+				kind: {
+					type: "string",
+					enum: ["notes", "profile"],
+					description: "notes (default): preferences. profile: who the creator is.",
+				},
 			},
 			required: ["note"],
 		},
 		command: "memory.save",
 	},
+	{
+		name: "memory_replace",
+		description: "Rewrite one memory entry by id: correct it, or merge two to stay under budget.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				entryId: { type: "string", description: "Entry id from memory_list." },
+				note: { type: "string", description: "The new text." },
+				kind: {
+					type: "string",
+					enum: ["notes", "profile"],
+					description: "notes (default): preferences. profile: who the creator is.",
+				},
+			},
+			required: ["entryId", "note"],
+		},
+		command: "memory.replace",
+	},
+	{
+		name: "memory_suggest",
+		description:
+			"PandaStudio's own chat only: a 'Remember this?' card for a preference you noticed but the user didn't state. Their Save writes it; don't save it yourself.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				note: { type: "string", description: "The preference, worded as it would be saved." },
+				reason: { type: "string", description: "One line on why you think so." },
+				kind: {
+					type: "string",
+					enum: ["notes", "profile"],
+					description: "notes (default): preferences. profile: who the creator is.",
+				},
+			},
+			required: ["note"],
+		},
+		command: "memory.suggest",
+	},
+	{
+		name: "chat_ask",
+		description:
+			"PandaStudio's own chat only: ask the user a multiple-choice question as a card with 2-5 buttons. Doesn't wait; END YOUR TURN after calling it and the choice arrives as the user's next message. For real decisions (light or heavy edit, which opening), not things you can decide yourself. Other agents get not_supported: ask in your own chat.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				question: { type: "string", description: "One short sentence." },
+				options: {
+					type: "array",
+					description: "2-5 choices: strings, or { label, detail } with detail one short line.",
+					items: {
+						anyOf: [
+							{ type: "string" },
+							{
+								type: "object",
+								properties: { label: { type: "string" }, detail: { type: "string" } },
+								required: ["label"],
+							},
+						],
+					},
+				},
+				recommended: { type: "string", description: "Label of the choice you'd pick." },
+				allowOther: { type: "boolean", description: "Also allow a typed answer." },
+			},
+			required: ["question", "options"],
+		},
+		command: "chat.ask",
+	},
+	{
+		name: "motion_propose",
+		description:
+			"PandaStudio's own chat: show a rendered graphic playing in the chat with Add to timeline / Try another before placing it. Render first (motion_generate or motion_render_html, job_wait), then pass the jobId and where it goes. For graphic ideas and judgment calls; a graphic the user asked for goes straight in with project_add_motion_graphic.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Project id" },
+				path: { type: "string" },
+				fromJob: { type: "string", description: "Finished render job (preferred)." },
+				file: { type: "string", description: "Rendered MP4/WebM when there's no job." },
+				atMs: { type: "number", description: "Edited timeline start." },
+				durationMs: { type: "number", description: "Default: the render's length." },
+				title: { type: "string", description: "What it shows, a few words." },
+				reason: { type: "string", description: "Why at this moment." },
+			},
+			required: ["atMs", "title"],
+		},
+		command: "motion.propose",
+	},
+	{
+		name: "post_plan",
+		description:
+			"PandaStudio's own chat: suggest where and when to post finished exports, a caption each, as an editable schedule card. Nothing posts until the user approves; then each row is queued via export_publish_social and you get the job ids. Export ids from export_list, accounts from social_channels.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				summary: { type: "string", description: "One line on the plan." },
+				rows: {
+					type: "array",
+					items: {
+						type: "object",
+						properties: {
+							exportId: { type: "string" },
+							channelIds: { type: "array", items: { type: "string" } },
+							networks: {
+								type: "array",
+								items: {
+									type: "string",
+									enum: ["instagram", "tiktok", "facebook", "linkedin", "x"],
+								},
+							},
+							caption: { type: "string" },
+							when: {
+								type: "string",
+								description: "now, or ISO with offset (e.g. 2026-11-03T18:30:00+00:00).",
+							},
+						},
+						required: ["exportId", "caption"],
+					},
+				},
+			},
+			required: ["rows"],
+		},
+		command: "post.plan",
+	},
+	{
+		name: "plan_propose",
+		description:
+			"Write an editing plan for the user to approve BEFORE editing (summary, up to 3 questions, up to 20 steps). Shown as a plan card with Start editing; nothing changes yet. End your turn after proposing; when they press Start you get the planId and answers, then do the steps with plan_update_step after each. Mark needsApproval on steps that spend money, publish or reach outside the app.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Project id" },
+				path: { type: "string", description: "Absolute .pandastudio path (alternative to id)" },
+				summary: { type: "string", description: "One line: what the footage is and the angle." },
+				steps: {
+					type: "array",
+					description: "Steps in order.",
+					items: {
+						type: "object",
+						properties: {
+							title: { type: "string" },
+							stage: { type: "string", enum: ["prep", "edit", "clip", "post"] },
+							detail: { type: "string" },
+							needsApproval: { type: "boolean" },
+						},
+						required: ["title"],
+					},
+				},
+				questions: {
+					type: "array",
+					description: "Decisions only the user can make (max 3).",
+					items: {
+						type: "object",
+						properties: {
+							text: { type: "string" },
+							options: { type: "array", items: { type: "string" } },
+							recommended: { type: "string" },
+						},
+						required: ["text", "options"],
+					},
+				},
+				recipeId: { type: "string", description: "Recipe the plan follows (recipe_pick)." },
+				source: { type: "string", enum: ["chat", "recording-finished", "routine"] },
+			},
+			required: ["summary", "steps"],
+		},
+		command: "plan.propose",
+	},
+	{
+		name: "plan_get",
+		description:
+			"The project's open plan (proposed or running) with step statuses and the next step; plan: null when none.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				includeHistory: {
+					type: "boolean",
+					description: "Also return finished and dismissed plans.",
+				},
+			},
+		},
+		command: "plan.get",
+	},
+	{
+		name: "plan_answer",
+		description:
+			"Record the user's answer to a plan question (option id or label). Only before the plan starts.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				planId: { type: "string" },
+				questionId: { type: "string" },
+				optionId: { type: "string" },
+			},
+			required: ["questionId", "optionId"],
+		},
+		command: "plan.answer",
+	},
+	{
+		name: "plan_start",
+		description:
+			"Start a proposed plan (unanswered questions take the recommended choice). The card's Start editing does this; call it only when the user told you to go ahead.",
+		inputSchema: {
+			type: "object",
+			properties: { id: { type: "string" }, path: { type: "string" }, planId: { type: "string" } },
+		},
+		command: "plan.start",
+	},
+	{
+		name: "plan_update_step",
+		description:
+			"Mark a step of the running plan: running, then done (result with the real counts), skipped or failed (say why).",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				planId: { type: "string" },
+				stepId: { type: "string" },
+				status: { type: "string", enum: ["running", "done", "skipped", "failed"] },
+				result: { type: "string" },
+			},
+			required: ["stepId", "status"],
+		},
+		command: "plan.update-step",
+	},
+	{
+		name: "plan_finish",
+		description: "Close a plan: done (unreached steps become skipped) or dismissed.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				planId: { type: "string" },
+				status: { type: "string", enum: ["done", "dismissed"] },
+			},
+			required: ["status"],
+		},
+		command: "plan.finish",
+	},
+	{
+		name: "routine_templates",
+		description: "Ready-made routines with the exact settings for routine_propose.",
+		inputSchema: { type: "object", properties: {} },
+		command: "routine.templates",
+	},
+	{
+		name: "routine_list",
+		description:
+			"This workspace's routines (proposed / on / paused), triggers in plain words, next run and recent runs with reports.",
+		inputSchema: { type: "object", properties: {} },
+		command: "routine.list",
+	},
+	{
+		name: "routine_propose",
+		description:
+			"Propose a routine: recurring or event-triggered work done on its own. Created OFF; the user turns it on from a routine card. Say what it does, how often, and that it runs on their AI account.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				name: { type: "string", description: "A few words, e.g. 'Monday competitor scan'." },
+				prompt: {
+					type: "string",
+					description: "What the agent does each run (unattended: no questions, read-only shell).",
+				},
+				schedule: {
+					type: "string",
+					description:
+						"'every 2h', 'daily 09:00', 'weekdays 09:00', 'mon,thu 18:30', 'monthly 1 09:00' or an ISO time. Schedule OR event; min every 15 min.",
+				},
+				timezone: { type: "string", description: "IANA zone; default this Mac's." },
+				event: {
+					type: "string",
+					enum: ["recording.finished", "import.finished", "podcast.ended", "export.finished"],
+					description: "Run when this happens instead of on a schedule.",
+				},
+				precheck: {
+					type: "object",
+					description:
+						"Free check before the AI turn; nothing found = run skipped. {kind:'ideas-breakouts',minMultiplier} | {kind:'new-exports'} | {kind:'connector-connected',connector}.",
+				},
+				autonomy: {
+					type: "string",
+					enum: ["suggest", "act"],
+					description: "suggest (default): no edits. act: edits that need no approval.",
+				},
+				notify: { type: "string", enum: ["desktop", "none"] },
+				template: { type: "string", description: "Start from a routine_templates id." },
+			},
+			required: ["name", "prompt"],
+		},
+		command: "routine.propose",
+	},
+	{
+		name: "routine_update",
+		description:
+			"Change a routine. name/notify apply now; prompt, schedule/event, precheck or autonomy become a pending change the user approves on the card.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				routineId: { type: "string" },
+				name: { type: "string", description: "A few words, e.g. 'Monday competitor scan'." },
+				prompt: {
+					type: "string",
+					description: "What the agent does each run (unattended: no questions, read-only shell).",
+				},
+				schedule: {
+					type: "string",
+					description:
+						"'every 2h', 'daily 09:00', 'weekdays 09:00', 'mon,thu 18:30', 'monthly 1 09:00' or an ISO time. Schedule OR event; min every 15 min.",
+				},
+				timezone: { type: "string", description: "IANA zone; default this Mac's." },
+				event: {
+					type: "string",
+					enum: ["recording.finished", "import.finished", "podcast.ended", "export.finished"],
+					description: "Run when this happens instead of on a schedule.",
+				},
+				precheck: {
+					type: "object",
+					description:
+						"Free check before the AI turn; nothing found = run skipped. {kind:'ideas-breakouts',minMultiplier} | {kind:'new-exports'} | {kind:'connector-connected',connector}.",
+				},
+				autonomy: {
+					type: "string",
+					enum: ["suggest", "act"],
+					description: "suggest (default): no edits. act: edits that need no approval.",
+				},
+				notify: { type: "string", enum: ["desktop", "none"] },
+			},
+			required: ["routineId"],
+		},
+		command: "routine.update",
+	},
+	{
+		name: "routine_pause",
+		description: "Pause a routine.",
+		inputSchema: {
+			type: "object",
+			properties: { routineId: { type: "string" } },
+			required: ["routineId"],
+		},
+		command: "routine.pause",
+	},
+	{
+		name: "routine_resume",
+		description: "Resume a paused routine (not a proposal).",
+		inputSchema: {
+			type: "object",
+			properties: { routineId: { type: "string" } },
+			required: ["routineId"],
+		},
+		command: "routine.resume",
+	},
+	{
+		name: "routine_run",
+		description:
+			"Run a routine now in the background; the report lands in the Routines thread and routine_runs.",
+		inputSchema: {
+			type: "object",
+			properties: { routineId: { type: "string" } },
+			required: ["routineId"],
+		},
+		command: "routine.run",
+	},
+	{
+		name: "routine_runs",
+		description:
+			"A routine's runs, newest first: done, silent, skipped, failed, missed, interrupted; with reports.",
+		inputSchema: {
+			type: "object",
+			properties: { routineId: { type: "string" }, limit: { type: "number" } },
+			required: ["routineId"],
+		},
+		command: "routine.runs",
+	},
+	{
+		name: "routine_delete",
+		description: "Delete a routine and its history (asks the user on a confirm card).",
+		inputSchema: {
+			type: "object",
+			properties: { routineId: { type: "string" } },
+			required: ["routineId"],
+		},
+		command: "routine.delete",
+	},
 	{
 		name: "recipe_list",
 		description: "List edit recipes (proven styles): the user's saved ones first, then starters.",
@@ -6754,6 +7282,11 @@ const TOOLS = [
 			type: "object",
 			properties: {
 				query: { type: "string", description: "Entry id, or text removing every match." },
+				kind: {
+					type: "string",
+					enum: ["notes", "profile"],
+					description: "notes (default): preferences. profile: who the creator is.",
+				},
 			},
 			required: ["query"],
 		},
@@ -6761,8 +7294,17 @@ const TOOLS = [
 	},
 	{
 		name: "memory_list",
-		description: "List durable memory entries (ids for memory_forget).",
-		inputSchema: { type: "object", properties: {} },
+		description: "Both memory lists (notes, profile) with ids and budget use; kind for one list.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				kind: {
+					type: "string",
+					enum: ["notes", "profile"],
+					description: "notes (default): preferences. profile: who the creator is.",
+				},
+			},
+		},
 		command: "memory.list",
 	},
 	{
@@ -7386,7 +7928,7 @@ const TOOLS = [
 				},
 				captionTemplate: {
 					type: "string",
-					description: "Caption template id (default glowStack), or none.",
+					description: "Caption template id (default hormoziEmphasis), or none.",
 				},
 			},
 			required: ["file"],
@@ -7459,6 +8001,247 @@ const TOOLS = [
 		},
 		command: "clips.delete",
 	},
+	{
+		name: "ideas_research",
+		description:
+			"Find outliers (videos beating their own channel's median views) across a niche: searches YouTube for the topic (comma-separate several angles) and/or expands from a seed channel the target audience watches, reads every channel found and ranks their recent uploads by multiplier. For what's trending, pass period month and maxAgeDays 30. Async: returns { researchId, jobId }; job.wait the jobId (~20-40 s), then ideas.get.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				query: {
+					type: "string",
+					description: 'Topic(s), comma-separated: "ai video editing, descript alternatives".',
+				},
+				seedChannel: {
+					type: "string",
+					description:
+						"A channel the target audience watches: @handle, channel URL or UC id. Give this, query, or both.",
+				},
+				format: { type: "string", description: "videos (long-form, default) | shorts." },
+				minMultiplier: {
+					type: "number",
+					description:
+						"Keep videos at or above this multiple of their channel's median (default 3).",
+				},
+				maxAgeDays: {
+					type: "number",
+					description: "Only outliers published in the last N days (default 365, 0 = any age).",
+				},
+				maxChannels: {
+					type: "number",
+					description: "Channels to read, 3-40 (default 15). More is slower and broader.",
+				},
+				period: {
+					type: "string",
+					description:
+						"Limit the topic search to uploads from the last: any (default) | day | week | month | year.",
+				},
+			},
+		},
+		command: "ideas.research",
+	},
+	{
+		name: "ideas_list",
+		description:
+			"Every outlier research in this workspace, newest first: id, title, options, status, stats and top multiplier. Reuse a recent one instead of researching the same niche again.",
+		inputSchema: {
+			type: "object",
+			properties: {},
+		},
+		command: "ideas.list",
+	},
+	{
+		name: "ideas_get",
+		description:
+			"One research: status, outliers best first (title, url, multiplier, views, channel median, age; onTopic false marks titles that don't mention the topic), the channels read (median views, hit rate, uploads a week) and title patterns (recurring phrases, hook-style shares, title formulas).",
+		inputSchema: {
+			type: "object",
+			properties: {
+				researchId: { type: "string", description: "From ideas.research or ideas.list." },
+				limit: { type: "number", description: "Max outliers returned, 1-200 (default 25)." },
+				offset: { type: "number", description: "Skip this many outliers (to page)." },
+				onTopicOnly: {
+					type: "boolean",
+					description: "Only outliers whose titles mention the topic.",
+				},
+			},
+			required: ["researchId"],
+		},
+		command: "ideas.get",
+	},
+	{
+		name: "ideas_cancel",
+		description: "Stop a running research.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				researchId: { type: "string", description: "The research to stop." },
+			},
+			required: ["researchId"],
+		},
+		command: "ideas.cancel",
+	},
+	{
+		name: "ideas_delete",
+		description: "Forget a research.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				researchId: { type: "string", description: "The research to delete." },
+			},
+			required: ["researchId"],
+		},
+		command: "ideas.delete",
+	},
+	{
+		name: "ideas_channel",
+		description:
+			"One channel's baseline (median views of its recent uploads, hit rate, uploads a week, subscribers) and its uploads that beat it, best first. Use on a competitor, or on the user's own channel to see what already works for them. ~10 s.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				channel: { type: "string", description: "@handle, channel URL or UC id." },
+				format: { type: "string", description: "videos (long-form, default) | shorts." },
+				minMultiplier: { type: "number", description: "Breakout threshold (default 1.5)." },
+				limit: { type: "number", description: "Recent uploads to read, 10-100 (default 40)." },
+				recent: {
+					type: "boolean",
+					description: "Also return every upload read, newest first (default false).",
+				},
+			},
+			required: ["channel"],
+		},
+		command: "ideas.channel",
+	},
+	{
+		name: "ideas_similar",
+		description:
+			"Channels competing for a channel's audience: searches the titles of its best uploads and ranks the channels that keep showing up (matches), each with its baseline (median views, hit rate, uploads a week, subscribers). ~30-60 s.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				channel: { type: "string", description: "@handle, channel URL or UC id." },
+				format: { type: "string", description: "videos (long-form, default) | shorts." },
+				max: { type: "number", description: "Channels to return, 3-25 (default 12)." },
+			},
+			required: ["channel"],
+		},
+		command: "ideas.similar",
+	},
+	{
+		name: "ideas_video",
+		description:
+			"A YouTube video's stats (views, likes, comment count, subscribers), description, tags and chapters. With baseline, also its multiplier against its channel's median: did it break out? With comments > 0, its top comments by likes: what viewers ask for and push back on.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				video: { type: "string", description: "YouTube URL or 11-character id." },
+				baseline: {
+					type: "boolean",
+					description:
+						"Also read its channel's recent uploads and return multiplier and channelMedian. Adds ~5 s.",
+				},
+				comments: {
+					type: "number",
+					description: "Top comments to read, 0-500 (default 0). 100 takes ~10-20 s.",
+				},
+			},
+			required: ["video"],
+		},
+		command: "ideas.video",
+	},
+	{
+		name: "ideas_transcript",
+		description:
+			"A YouTube video's transcript from its captions (uploaded first, else automatic): to study an outlier's hook, structure and pacing.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				video: { type: "string", description: "YouTube URL or 11-character id." },
+				language: { type: "string", description: "Caption language code (default en)." },
+				timestamps: {
+					type: "boolean",
+					description: "Return timed segments instead of plain text (default false).",
+				},
+			},
+			required: ["video"],
+		},
+		command: "ideas.transcript",
+	},
+	{
+		name: "ideas_keywords",
+		description:
+			"What people type into YouTube search around a seed phrase (autocomplete, expanded a-z and with question prefixes). Then ideas.demand on the promising ones.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				seed: { type: "string", description: 'Seed phrase, e.g. "notion template".' },
+				expand: {
+					type: "boolean",
+					description: "Expand with a-z and question prefixes (default true).",
+				},
+			},
+			required: ["seed"],
+		},
+		command: "ideas.keywords",
+	},
+	{
+		name: "ideas_demand",
+		description:
+			"How much a few YouTube search terms pull: for each, the median and top views of its top 20 results, the share under a year old, how many channels, and the 3 most-viewed. Pick the term worth a video after ideas.keywords. ~30 s for 10 terms.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				keywords: {
+					type: "array",
+					items: { type: "string" },
+					description: "Search terms to check (1-15).",
+				},
+			},
+			required: ["keywords"],
+		},
+		command: "ideas.demand",
+	},
+	{
+		name: "ideas_competitors",
+		description:
+			"The channels this workspace tracks, each with its baseline at the last scan and its uploads from the last 90 days at 2x or more (breakouts). Remembered across conversations; ideas.scan refreshes them.",
+		inputSchema: {
+			type: "object",
+			properties: {},
+		},
+		command: "ideas.competitors",
+	},
+	{
+		name: "ideas_track",
+		description:
+			"Start tracking a channel as a competitor (reads it once), or stop with tracked: false. Up to 40 per workspace.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				channel: {
+					type: "string",
+					description: "@handle, channel URL or UC id (to stop: the UC id from ideas.competitors).",
+				},
+				tracked: { type: "boolean", description: "true (default) to track, false to stop." },
+				format: { type: "string", description: "videos (long-form, default) | shorts." },
+			},
+			required: ["channel"],
+		},
+		command: "ideas.track",
+	},
+	{
+		name: "ideas_scan",
+		description:
+			"Re-read every tracked competitor and return the breakouts across all of them (uploads from the last 90 days at 2x or more), best first. ~5-10 s per 5 channels.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				limit: { type: "number", description: "Max breakouts returned, 1-100 (default 20)." },
+			},
+		},
+		command: "ideas.scan",
+	},
 	{
 		name: "export_generate_shots",
 		description:
@@ -7865,14 +8648,14 @@ Read-only tools (project_read, transcript_get / _search / _find_issues, audio_pr
 
 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" / "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:
+"Edit my video" / "make this a Short" with no specifics = this pipeline, in order. In PandaStudio's own chat: write it as a plan first (plan_propose: the steps below that apply, the scope question on it), end your turn, and run it when the user presses Start editing, with plan_update_step after each step. Other clients: 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_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.
+6. audio_enhance (Enhance voice) on clips not yet enhanced with its defaults (Light, plus Studio mic sound on Apple silicon; don't pass strength or restore unless the user asked); 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, then caption_set_template: hormoziEmphasis for vertical, classic for long-form; not glowStack unless asked), 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. No music, intro/outro cards or FX overlays unless the recipe or the user asks for them.

package/package.json

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