@writepanda/mcp 1.259.0 → 1.265.0

package/bin/server.mjs

@@ -35,7 +35,13 @@ import path from "node:path";
 import process from "node:process";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import {
+	CallToolRequestSchema,
+	ListResourcesRequestSchema,
+	ListResourceTemplatesRequestSchema,
+	ListToolsRequestSchema,
+	ReadResourceRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
 import {
 	appLaunchEnv,
 	callWithReconnect,
@@ -47,6 +53,14 @@ import {
 	IN_APP_UNAVAILABLE,
 	isInAppCaller,
 } from "./appConnection.mjs";
+import {
+	APP_TOOLS,
+	clientSupportsUi,
+	listUiResources,
+	MediaRegistry,
+	readUiResource,
+	toolUiMeta,
+} from "./apps/index.mjs";
 import { portableSchema } from "./portableSchema.mjs";
 
 // ── Credentials + transport ───────────────────────────────────────────
@@ -569,13 +583,25 @@ const MOTION_ELEMENT_TYPES = [
 	"ticker",
 	"credits",
 	"crawl",
+	"reelWall",
+	"cardFan",
+	"orbit",
+	"polaroids",
+	"wordWall",
+	"neon",
+	"bloom",
+	"scrapbook",
+	"keycaps",
+	"productCard",
+	"scrollList",
+	"splitScreen",
 ];
 const MOTION_ELEMENT_PROPS = {
 	type: { type: "string", enum: MOTION_ELEMENT_TYPES },
 	content: {
 		type: ["object", "string", "array"],
 		description:
-			'keyword/chip/stamp/slam/behind/highlight { text } (or a bare string); count { value, to?, prefix?, suffix?, label?, decimals? } (value "20-30" = range); steps { items[], cues? (ms offsets from start) }; lowerThird { title, subtitle? (<=320 chars, wraps), look?: plate|plain|typewriter, typeSpeed? (typewriter pace, 5-80 chars/s, default ~22) }; endCard { lines: [a, b] }; progress { label?, fromMs?, toMs? }; iconPop { emoji } | { icon }; frame { look: viewfinder | selection | corners, label? }; sticker { image: transparent PNG path, label? }; ticker { text (one story per line, <=2000 chars), label?, speed? (40-600 px/s) }; credits { title?, entries: [{ role?, name }] | "Role: Name" strings (<=200) }; crawl { title?, text (<=6000 chars), tilt? (0-80), turn? (-60..60) }. Any script, symbols and emoji draw.',
+			'keyword/chip/stamp/slam/behind/highlight { text } (or a bare string); count { value, to?, prefix?, suffix?, label?, decimals? } (value "20-30" = range); steps { items[], cues? (ms offsets from start) }; lowerThird { title, subtitle? (<=320 chars, wraps), look?: plate|plain|typewriter, typeSpeed? (typewriter pace, 5-80 chars/s, default ~22) }; endCard { lines: [a, b] }; progress { label?, fromMs?, toMs? }; iconPop { emoji } | { icon }; frame { look: viewfinder | selection | corners, label? }; sticker { image: transparent PNG path or "@speaker" (the speaker cut out of her shot), label?, twin? (mirrored pair, one each side) }; ticker { text (one story per line, <=2000 chars), label?, speed? (40-600 px/s) }; credits { title?, entries: [{ role?, name }] | "Role: Name" strings (<=200) }; crawl { title?, text (<=6000 chars), tilt? (0-80), turn? (-60..60) }. Creator effects (picture slots take a path or "@speaker" = the speaker\'s own live shot, the default): reelWall { images?, count? 4-24 } (tiles of her shot behind her); cardFan { images?, count? 3-9 } (card reveal: cards fan in an arc behind her head); orbit { images?, count? 2-6 } (cards circle her, layer around); polaroids { images?, count? 2-8, captions? } (scattered around her, layer around); wordWall { text, rows? 3-14, background? } (word repeated in rows behind her); neon { text, flicker? }; bloom { text } (colour bloom); scrapbook { text } (ransom-note letters); keycaps { text <=24 } (keys falling, pile at the bottom); productCard { title, subtitle?, price?, image?, button? ("Add to cart"), done? ("Added") }; scrollList { title?, items: (string | { title, subtitle?, image? })[] <=30, look?: playlist|feed } (phone list scrolling); splitScreen { panels? 2|3, images?, zooms? 1-4 } (three scenes). Any script, symbols and emoji draw.',
 	},
 	atMs: { type: "number", description: "Start, edited ms. Or wordId." },
 	wordId: {
@@ -619,7 +645,12 @@ const MOTION_ELEMENT_PROPS = {
 		description:
 			"auto (clear of the face) | top | upper | center | lower | bottom | { x, y, w? } (% of frame; x,y = centre).",
 	},
-	layer: { type: "string", enum: ["front", "behind"] },
+	layer: {
+		type: "string",
+		enum: ["front", "behind", "around"],
+		description:
+			"front | behind (behind the speaker's cut-out) | around (orbit, polaroids: the far side behind her, the near side in front; their default). Default per type.",
+	},
 	sound: {
 		type: "string",
 		enum: ["auto", "none", "pop", "whoosh", "hit", "tick", "bell"],
@@ -1705,6 +1736,19 @@ const TOOLS = [
 		},
 		command: "project.show",
 	},
+	{
+		name: "project_edit_summary",
+		description:
+			"What the edit contains now: lengths (editedDurationMs, sourceDurationMs, removedMs cut or sped up), counts (cuts, zooms, motionElements, graphics, transitions, brollBeats, mediaOverlays, captions { on, template }, audio { narration, music, soundEffects }, ...) and highlights[] (plain lines). Cheap; use it to report an editing pass instead of project_read.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+			},
+		},
+		command: "project.edit-summary",
+	},
 	{
 		name: "matte_status",
 		description:
@@ -3045,7 +3089,10 @@ const TOOLS = [
 					type: "boolean",
 					description: "Follow the recorded cursor (screen recordings).",
 				},
-				soundUrl: { type: "string", description: 'Default bundled:sound/swoosh-fast; "none".' },
+				soundUrl: {
+					type: "string",
+					description: 'Default bundled:sound/motion-swoosh-up; "none".',
+				},
 				soundVolume: { type: "number", description: "0-1." },
 				anchorSourceMs: ANCHOR_PROP,
 				anchorSourceEndMs: ANCHOR_END_PROP,
@@ -4711,7 +4758,8 @@ const TOOLS = [
 				},
 				frameRate: {
 					type: ["number", "string"],
-					description: "auto (default) | 30 | 60 | source (fastest source).",
+					description:
+						"auto (default) | 23.976 | 24 | 25 | 29.97 | 30 | 50 | 59.94 | 60 (25 / 50 for PAL) | source (fastest source).",
 				},
 				expectedRevision: { type: "number" },
 			},
@@ -6100,6 +6148,33 @@ const TOOLS = [
 		inputSchema: { type: "object", properties: {} },
 		command: "recording.list-sources",
 	},
+	{
+		name: "recording_open_recorder",
+		description:
+			"Open PandaStudio's recorder for the USER to record themselves, with the script you wrote loaded in the teleprompter (scrolls with the take, voice tracking available, hidden from the recording). Use after writing a script the user will read on camera; then tell them to press Record in PandaStudio's recorder bar. You never start their camera or microphone. When they stop, the take opens in the editor as a new project (project_current). Returns { opened, mode, teleprompter: { words, readSeconds } | false }. For an unattended screen capture use recording_start.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				script: {
+					type: "string",
+					description: "What the user will read, plain text (no markdown or stage directions), up to 20,000 characters.",
+				},
+				mode: {
+					type: "string",
+					enum: ["camera", "screen", "both"],
+					description: "camera (solo; default with a script), screen (screen only), or both (screen + camera bubble; default without a script).",
+				},
+				orientation: {
+					type: "string",
+					enum: ["landscape", "portrait"],
+					description: "landscape 16:9 (YouTube) or portrait 9:16 (Shorts, Reels, TikTok): the camera shape for a camera take; a screen take's final shape is set while editing.",
+				},
+				speed: { type: "number", description: "Teleprompter scroll speed 0.25-3." },
+				fontSize: { type: "number", description: "Teleprompter text size in px, 16-72." },
+			},
+		},
+		command: "recording.open-recorder",
+	},
 	{
 		name: "recording_start",
 		description:
@@ -6315,7 +6390,7 @@ const TOOLS = [
 	{
 		name: "project_compose_soundtrack",
 		description:
-			"Score this edit: music + sound design composed FROM THE PROJECT'S OWN TIMELINE (zooms, graphics, pops, cuts, speech, stressed words) and placed under the voice with ducking; takes over zoom/overlay default sounds; replaces the previous score on re-run. Call LAST, after cuts/zooms/graphics. dryRun returns the score for media_compose_soundtrack. Returns { audioPath, scorePath, events, heroMoments, acts, soundsTakenOver, replaced }.",
+			"Score this edit: music composed FROM THE PROJECT'S OWN TIMELINE (zooms, graphics, pops, cuts, speech, stressed words) placed under the voice with ducking, plus sound effects as recorded library cues (group score-sfx, sparse under a voice); takes over zoom/overlay/graphic sounds; replaces the previous score and its cues on re-run. Call LAST, after cuts/zooms/graphics, and again after changing them (project_read composedScore.stale / doubledSounds). dryRun returns the score and sfxCues. Returns { audioPath, scorePath, events, heroMoments, acts, soundsTakenOver, sfxCues, paperSfx, replaced }.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -6327,7 +6402,8 @@ const TOOLS = [
 				sfx: { type: "boolean", description: "Default true." },
 				useSpeech: {
 					type: "boolean",
-					description: "Hero hits on the most stressed words. Default true.",
+					description:
+						"Hits on the most stressed words even with nothing on screen. Default true for promo only.",
 				},
 				cues: {
 					type: "array",
@@ -6354,7 +6430,7 @@ const TOOLS = [
 	{
 		name: "project_add_motion_element",
 		description:
-			"Native motion element: an editable, word-timed graphic the engine draws (preview = export, no HTML render): keyword headline, chip, stamp, count (number/range rolls up), steps, slam (+ camera kick), behind (word behind the speaker), lowerThird, highlight, endCard, progress, iconPop, frame (viewfinder / selection box / corners around the speaker). Anchor with wordId (follows the word through cuts) or atMs. Brand kit by default. Returns { elementId, element }.",
+			'Native motion element: an editable, word-timed graphic the engine draws (preview = export, no HTML render): keyword headline, chip, stamp, count (number/range rolls up), steps, slam (+ camera kick), behind (word behind the speaker), lowerThird, highlight, endCard, progress, iconPop, frame (viewfinder / selection box / corners around the speaker), sticker, ticker, credits, crawl, and the short-form creator effects around the speaker: reelWall, cardFan (card reveal), orbit, polaroids, wordWall, neon, bloom (colour bloom), scrapbook, keycaps (keys falling), productCard (add to cart), scrollList (scroll overlay), splitScreen (three scenes); "@speaker" in any picture slot shows her own live shot. Anchor with wordId (follows the word through cuts) or atMs. Brand kit by default. Returns { elementId, element }.',
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -7170,16 +7246,165 @@ const TOOLS = [
 		},
 		command: "recipe.prepare-reference",
 	},
+	{
+		name: "reference_check_link",
+		description:
+			"Check a pasted reference link without downloading: YouTube, TikTok, Instagram and X video links are accepted. Returns { url, platform } or a clear error (not a supported site, not a single video, local/private address).",
+		inputSchema: {
+			type: "object",
+			properties: { url: { type: "string" } },
+			required: ["url"],
+		},
+		command: "reference.check-link",
+	},
+	{
+		name: "reference_gallery",
+		description:
+			"Curated reference videos (Home → Start from a proven edit → Don't see your style?): real creators' videos worth copying the edit of, from the signed gallery on writepanda.ai. Returns { entries: [{ id, title, creator (@handle), creatorName, avatar, platform, format, views, viewsLabel, durationMs, poster, sourceUrl (the original post), referenceVideo (hover preview, optional), resultVideo, recipeId, tags }] }. Prepare one with reference_prepare { galleryId } (fetches the whole original from sourceUrl on this computer); recipeId = a prebuilt recipe for its style.",
+		inputSchema: { type: "object", properties: {} },
+		command: "reference.gallery",
+	},
+	{
+		name: "reference_prepare",
+		description:
+			"'Make my video like this one': bring in a reference video and study it. Exactly one of url (YouTube / TikTok / Instagram / X video link, fetched on this computer), file (absolute .mp4/.mov/.webm) or galleryId (reference_gallery). Up to 30 minutes. Async: returns { jobId }; job_wait gives { id, title, durationMs, manifestPath (overview + motion sheets, audio excerpts), source }. Clear errors for private / sign-in-only videos and unsupported sites. From then on the reference is GUARDED: every media verb and export refuses it (code REFERENCE_MEDIA). Next: reference_analyze, then reference_render.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				url: { type: "string", description: "YouTube / TikTok / Instagram / X video link." },
+				file: { type: "string", description: "Absolute path of an .mp4 / .mov / .webm." },
+				galleryId: { type: "string", description: "Curated reference id (reference_gallery)." },
+				title: { type: "string" },
+			},
+		},
+		command: "reference.prepare",
+	},
+	{
+		name: "reference_analyze",
+		description:
+			"The setup-screen analysis of a prepared reference: title, format, aspect, summary, the rebuild list (elements: every graphic / transition / caption / effect / camera move with its reference time) and up to 5 slots for the user's material (footage first; logo, screen, product, text). Without `analysis` it runs on the user's own assistant model with the contact sheets attached (async { jobId }; default slots + analysisError when no model). If you looked at the sheets yourself, pass your own `analysis` (same shape): stored at once.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Reference id." },
+				analysis: {
+					type: "object",
+					description:
+						"{ title, format: short|long, aspect: 9:16|16:9|1:1|3:4, summary, elements: [{ name, kind: graphic|transition|caption|effect|camera|sound, atMs, description }], slots: [{ key, kind: footage|logo|screen|product|text, label, hint, required }] }",
+				},
+				providerId: { type: "string" },
+				modelId: { type: "string" },
+			},
+			required: ["id"],
+		},
+		command: "reference.analyze",
+	},
+	{
+		name: "reference_render",
+		description:
+			"The one instruction that makes the user's video in the reference's style, from the filled slots: mode learn (learn the style from the evidence; saveRecipe keeps it as a personal recipe, default true) or recipe (apply recipeId, default the curated entry's prebuilt recipe), then rebuild every element natively, project_render_frame → reference_compare → reference_score each one BEFORE the user's content goes in. mode save: only study the reference and save its style as a personal recipe named recipeTitle, no video now (slots ignored). Returns { prompt, missing } (required slots still empty; always empty for save). Follow the prompt. Changes nothing itself.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Reference id." },
+				slots: {
+					type: "object",
+					description:
+						'{ "<slot key>": { "mode": "file", "path": "/abs" } | { "mode": "files", "paths": ["/abs"] } | { "mode": "text", "text": "..." } | { "mode": "agent" } }',
+				},
+				mode: { type: "string", enum: ["learn", "recipe", "save"] },
+				recipeTitle: { type: "string", description: "mode save: the new recipe's name." },
+				recipeId: { type: "string" },
+				saveRecipe: { type: "boolean" },
+				projectId: { type: "string", description: "Edit this project instead of a new one." },
+				note: { type: "string", description: "The user's own words." },
+			},
+			required: ["id"],
+		},
+		command: "reference.render",
+	},
+	{
+		name: "reference_compare",
+		description:
+			"Side-by-side JPG of the reference at atMs (reference time, left) and a rendered frame of the user's edit (the PNG from project_render_frame, right), to judge one rebuilt graphic / transition / effect. Returns { path, referenceFrame }. Look at it, then reference_score.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				frame: { type: "string", description: "Absolute path of the rendered frame." },
+				atMs: { type: "number", description: "Reference time (ms)." },
+			},
+			required: ["id", "frame", "atMs"],
+		},
+		command: "reference.compare",
+	},
+	{
+		name: "reference_score",
+		description:
+			"Record how close a rebuilt element is to the reference after reference_compare: score 1-5 (4 = close enough to ship, 5 = indistinguishable in look, motion and timing) and a note of what still differs. One score per element name.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				element: { type: "string" },
+				score: { type: "number", minimum: 1, maximum: 5 },
+				note: { type: "string" },
+				atMs: { type: "number" },
+			},
+			required: ["id", "element", "score"],
+		},
+		command: "reference.score",
+	},
+	{
+		name: "reference_attach",
+		description:
+			"Record on a project which reference it follows (and the recipe), so later turns can pick the work up; project_read shows it as `reference`. clear=true removes it. Metadata only: the reference's media never enters the project.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Reference id (not needed with clear)." },
+				projectId: { type: "string" },
+				recipeId: { type: "string" },
+				clear: { type: "boolean" },
+			},
+			required: ["projectId"],
+		},
+		command: "reference.attach",
+	},
+	{
+		name: "reference_get",
+		description:
+			"One prepared reference: { id, title, source, durationMs, manifestPath, analysis, scores, projectIds }.",
+		inputSchema: { type: "object", properties: { id: { type: "string" } }, required: ["id"] },
+		command: "reference.get",
+	},
+	{
+		name: "reference_list",
+		description: "Prepared references, newest first.",
+		inputSchema: { type: "object", properties: {} },
+		command: "reference.list",
+	},
+	{
+		name: "reference_delete",
+		description:
+			"Delete a prepared reference (its downloaded video, study sheets, side-by-sides). An uploaded file stays where the user keeps it; projects made from it are untouched.",
+		inputSchema: { type: "object", properties: { id: { type: "string" } }, required: ["id"] },
+		command: "reference.delete",
+	},
 	{
 		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.",
+			"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 (defaultId when nothing clearly fits, never a plain clean-up), then recipe_apply_style + recipe_render. A Short cut from a landscape long-form video (a project_fork_from_shot fork, a landscape source, or format short on a 16:9 project) comes back fromLongForm with its own default. On a 16:9 project the user wants as a Short, pass format short.",
 		inputSchema: {
 			type: "object",
 			properties: {
 				id: { type: "string", description: "Project id (default: the open project)." },
 				path: { type: "string" },
-				format: { type: "string", enum: ["short", "long"] },
+				format: {
+					type: "string",
+					enum: ["short", "long"],
+					description: "Default from the project's aspect ratio (9:16 = short).",
+				},
 				footage: {
 					type: "string",
 					enum: ["camera", "screen", "podcast", "audio", "none"],
@@ -7810,7 +8035,8 @@ const TOOLS = [
 				},
 				frameRate: {
 					type: ["number", "string"],
-					description: "30 | 60 | source | auto; omit = project setting.",
+					description:
+						"23.976 | 24 | 25 | 29.97 | 30 | 50 | 59.94 | 60 | source | auto; omit = project setting.",
 				},
 				format: {
 					type: "string",
@@ -7865,6 +8091,24 @@ const TOOLS = [
 		},
 		command: "export.verify",
 	},
+	{
+		name: "export_timeline",
+		description:
+			"Export the edit as an editable timeline for Premiere Pro / DaVinci Resolve / Final Cut: an FCP 7 XML on the original media (every cut, speed as Time Remap, camera on V2, overlays above, voice + music tracks) plus an .srt of the kept words. Zooms, caption styling, motion graphics, layouts and grade are not in it: tell the user the returned notes. Sync: { xmlPath, srtPath, fps, durationMs, cuts, missingFiles, notes }.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				path: { type: "string" },
+				outputPath: {
+					type: "string",
+					description: "A .xml path or a folder; default the recordings folder.",
+				},
+				captions: { type: "boolean", description: "Write the .srt beside it (default true)." },
+			},
+		},
+		command: "export.timeline",
+	},
 	{
 		name: "export_list",
 		description:
@@ -8001,6 +8245,24 @@ const TOOLS = [
 		},
 		command: "clips.delete",
 	},
+	{
+		name: "clips_remove_clip",
+		description:
+			"Remove ONE clip from a clip set (the Clips screen's Remove on a clip card). Its stills go and its moment is remembered so clips.retry won't make it again; its project moves to the Trash (recoverable) unless keepProject is true. Exported files stay in My Exports. A clip still being made is dropped by the running job. Returns { clipSetId, removed, projectDeleted, clipsLeft }.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Clip set id." },
+				clipId: { type: "string", description: "The clip's id (from clips_get)." },
+				keepProject: {
+					type: "boolean",
+					description: "Keep the clip's project in Projects instead of the Trash. Default false.",
+				},
+			},
+			required: ["id", "clipId"],
+		},
+		command: "clips.remove-clip",
+	},
 	{
 		name: "ideas_research",
 		description:
@@ -8654,8 +8916,9 @@ 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.
+5b. A Short from a landscape video (a long-form recording, the project isn't 9:16): cut the Short out now. export_generate_shots { projectId }, then project_fork_from_shot on the best shot (offer the top shots when the user is there) and run steps 6-9 on the fork. Only a clip already under about 90 s goes vertical in place (project_set_aspect_ratio 9:16).
 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.
+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; a Short cut from a long-form video comes back fromLongForm and its defaultId is made for that), 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. Never trade the default for a plain edit because no candidate fits perfectly. 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.
@@ -8669,6 +8932,8 @@ Publishing has daily limits (YouTube uploads and updates per license, social pos
 
 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.
 
+Views: in chat apps that show MCP views, preview_show, project_render_frame / _render_sheet and project_edit_summary also show the frames and what the edit contains, and clips_get / clips_make show the clips as cards the user can open, export or remove. Summarise in a line instead of describing each frame or clip; what the user does in a view arrives as context, don't redo it.
+
 Review items: the user can pin notes and drawings on the preview and send them in one turn (listed in the editor context and the message, crops attached in item order). Apply each one, then review_resolve with its id. review_list shows the open ones with a crop image path.
 
 Destination decides everything: infer it (Shorts/TikTok/vertical/<=90s: shorts; YouTube/tutorial/>8 min: youtube-long; LinkedIn; Loom/internal), else ask once.
@@ -8683,23 +8948,49 @@ const server = new Server(
 	{
 		capabilities: {
 			tools: {},
+			// Only the ui:// views (MCP Apps), listed for clients that render them.
+			resources: {},
 		},
 		instructions: INSTRUCTIONS,
 	},
 );
 
+/** Whether the connected client renders MCP Apps views (apps/index.mjs). */
+const uiEnabled = () => clientSupportsUi(server.getClientCapabilities(), { inApp: IN_APP });
+/** Image paths the app reported this session, served to views by ui_read_media. */
+const media = new MediaRegistry();
+
 server.setRequestHandler(ListToolsRequestSchema, async () => {
-	return {
-		tools: TOOLS.map((t) => ({
+	const ui = uiEnabled();
+	const tools = TOOLS.map((t) => {
+		const meta = ui ? toolUiMeta(t.name) : undefined;
+		return {
 			name: t.name,
 			description: t.description,
 			// Gemini rejects multi-type fields that JSON Schema allows.
 			inputSchema: portableSchema(t.inputSchema),
-		})),
-	};
+			...(meta ? { _meta: meta } : {}),
+		};
+	});
+	return { tools: ui ? [...tools, ...APP_TOOLS] : tools };
+});
+
+server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+	resources: uiEnabled() ? listUiResources() : [],
+}));
+server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({
+	resourceTemplates: [],
+}));
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+	const res = readUiResource(request.params.uri, mcpVersion());
+	if (!res) throw new Error(`unknown resource: ${request.params.uri}`);
+	return res;
 });
 
 server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+	if (request.params.name === "ui_read_media") {
+		return media.read(request.params.arguments?.paths);
+	}
 	const tool = TOOLS.find((t) => t.name === request.params.name);
 	if (!tool) {
 		return {
@@ -8753,6 +9044,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
 		];
 		try {
 			const data = result?.data ?? result;
+			media.note(data);
 			const previews = collectInlinePreviewPaths(command, data);
 			for (const previewPath of previews) {
 				const fs = await import("node:fs/promises");

package/package.json

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