@writepanda/mcp 1.21.0 → 1.22.1

package/bin/server.mjs

@@ -163,6 +163,208 @@ const TOOLS = [
 		command: "system.list",
 	},
 
+	// ── workspaces (v1.19) ──────────────────────────────────────────
+	// Multi-workspace isolation: each workspace has its own projects,
+	// exports, Replicate key, and (v1.19.0+) YouTube connections.
+	// Agents managing an agency account can switch workspaces mid-
+	// flow to operate inside a specific client's bucket.
+	{
+		name: "workspace_list",
+		description:
+			"List every workspace on this machine. Returns `currentWorkspaceId` + a `limit` object describing the plan's cap (`max: null` for unlimited on Team, 1 on Starter/Trial, 3 on Creator). Call this first to see what workspaces exist and which one every other query defaults to.",
+		inputSchema: { type: "object", properties: {} },
+		command: "workspace.list",
+	},
+	{
+		name: "workspace_current",
+		description: "Return the active workspace (what every workspace-scoped query defaults to).",
+		inputSchema: { type: "object", properties: {} },
+		command: "workspace.current",
+	},
+	{
+		name: "workspace_create",
+		description:
+			"Create a new workspace. On plan cap: returns `{ ok: false, details: { code: 'workspace_limit_reached', upgradeTo: 'Creator' | 'Team' | null } }` — surface that to the user instead of retrying. Pass `switchTo: true` to make the new workspace active immediately.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				name: { type: "string", description: "Display name, max 80 chars." },
+				switchTo: {
+					type: "boolean",
+					description: "Switch to the new workspace immediately. Default false.",
+				},
+			},
+			required: ["name"],
+		},
+		command: "workspace.create",
+	},
+	{
+		name: "workspace_rename",
+		description: "Rename a workspace. No cross-workspace side effects.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string" },
+				name: { type: "string", description: "New name, max 80 chars." },
+			},
+			required: ["id", "name"],
+		},
+		command: "workspace.rename",
+	},
+	{
+		name: "workspace_delete",
+		description:
+			"Hard-delete a workspace and everything inside it: project rows (on-disk .pandastudio files remain), exports, shots, Replicate key + YouTube connections. Refuses to delete the last remaining workspace. Call `workspace.contents` first and show the user what they'll lose.",
+		inputSchema: {
+			type: "object",
+			properties: { id: { type: "string" } },
+			required: ["id"],
+		},
+		command: "workspace.delete",
+	},
+	{
+		name: "workspace_switch",
+		description:
+			"Change the active workspace. All subsequent project.*/export.*/motion.* queries operate inside the target until the next switch.",
+		inputSchema: {
+			type: "object",
+			properties: { id: { type: "string" } },
+			required: ["id"],
+		},
+		command: "workspace.switch",
+	},
+	{
+		name: "workspace_contents",
+		description:
+			"Count projects / exports / published YouTube videos in a workspace. Use before `workspace.delete` for the 'you will lose N items' warning.",
+		inputSchema: {
+			type: "object",
+			properties: { id: { type: "string" } },
+			required: ["id"],
+		},
+		command: "workspace.contents",
+	},
+
+	// ── YouTube publishing (v1.19) ──────────────────────────────────
+	// Connect Google accounts per workspace, publish exports, edit
+	// already-published videos. All verbs operate on the active
+	// workspace unless the agent switches first.
+	{
+		name: "youtube_is_configured",
+		description:
+			"Return whether this PandaStudio build has Google OAuth credentials baked in. When false, every other `youtube.*` verb will fail — tell the user this build can't publish to YouTube.",
+		inputSchema: { type: "object", properties: {} },
+		command: "youtube.is-configured",
+	},
+	{
+		name: "youtube_connect",
+		description:
+			"Start Google OAuth in the user's system browser. Long-running: waits up to 5 minutes for consent. On success, stores refresh token encrypted under the active workspace and returns the account + its channels. INTERACTIVE — only call when the user explicitly asks to connect a YouTube account.",
+		inputSchema: { type: "object", properties: {} },
+		command: "youtube.connect",
+	},
+	{
+		name: "youtube_disconnect",
+		description:
+			"Revoke and delete a YouTube account from the active workspace. Published videos stay on YouTube; only the local connection + cached channels + encrypted refresh token are removed.",
+		inputSchema: {
+			type: "object",
+			properties: { accountId: { type: "string" } },
+			required: ["accountId"],
+		},
+		command: "youtube.disconnect",
+	},
+	{
+		name: "youtube_list_accounts",
+		description:
+			"List connected Google accounts in the active workspace + cached YouTube channels. Call this before `export.publish-youtube` so the user can pick account + channel.",
+		inputSchema: { type: "object", properties: {} },
+		command: "youtube.list-accounts",
+	},
+	{
+		name: "youtube_list_channels",
+		description:
+			"Re-pull the channel list for a connected account from YouTube (bypasses local cache). Useful if the user just created a new channel under the same Google account.",
+		inputSchema: {
+			type: "object",
+			properties: { accountId: { type: "string" } },
+			required: ["accountId"],
+		},
+		command: "youtube.list-channels",
+	},
+	{
+		name: "export_publish_youtube",
+		description:
+			"Upload an export-library entry to YouTube via resumable upload. Stamps title/description/tags/privacy on the video and (optionally) pushes the entry's thumbnail. Returns `{ videoId, videoUrl }`. LONG-RUNNING (expect ~30 s per 100 MB). The export row is marked `youtubeVideoId` on success, so repeated calls on an already-published entry should check that field first.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Export entry id." },
+				accountId: { type: "string" },
+				channelId: { type: "string" },
+				title: { type: "string" },
+				description: { type: "string" },
+				tags: { type: "array", items: { type: "string" } },
+				categoryId: { type: "string" },
+				privacyStatus: {
+					type: "string",
+					description: "public | unlisted | private. Default unlisted.",
+				},
+				setThumbnail: { type: "boolean" },
+			},
+			required: ["id", "accountId", "channelId", "title"],
+		},
+		command: "export.publish-youtube",
+	},
+	{
+		name: "export_list_youtube",
+		description:
+			"List recently-published videos on a connected account (includes videos not published via PandaStudio). Dashboard data.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				accountId: { type: "string" },
+				max: { type: "number", description: "Default 25, max 50." },
+			},
+			required: ["accountId"],
+		},
+		command: "export.list-youtube",
+	},
+	{
+		name: "export_update_youtube",
+		description:
+			"Update an already-published video's metadata (title / description / tags / category / privacyStatus). Pass only the fields you want to change. Cannot replace the video file — YouTube requires deleting and re-uploading for that.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				accountId: { type: "string" },
+				videoId: { type: "string" },
+				title: { type: "string" },
+				description: { type: "string" },
+				tags: { type: "array", items: { type: "string" } },
+				categoryId: { type: "string" },
+				privacyStatus: { type: "string" },
+			},
+			required: ["accountId", "videoId"],
+		},
+		command: "export.update-youtube",
+	},
+	{
+		name: "export_update_youtube_thumbnail",
+		description:
+			"Replace an already-published video's thumbnail on YouTube via thumbnails.set. Expects a local 1280×720 image (no auto-crop — pre-process or use `export.generate-thumbnail` output).",
+		inputSchema: {
+			type: "object",
+			properties: {
+				accountId: { type: "string" },
+				videoId: { type: "string" },
+				imagePath: { type: "string" },
+			},
+			required: ["accountId", "videoId", "imagePath"],
+		},
+		command: "export.update-youtube-thumbnail",
+	},
+
 	// ── project lifecycle ───────────────────────────────────────────
 	{
 		name: "project_list",
@@ -1176,6 +1378,39 @@ const TOOLS = [
 		},
 		command: "motion.concat",
 	},
+	{
+		name: "motion_verify_frames",
+		description:
+			"Extract PNG frames at given timestamps from a rendered video so the agent can VISUALLY verify the motion graphics landed. This operationalises the 'lint passing ≠ design working — VIEW THE FRAMES' rule in reference/motion-philosophy.md §4. Call this after motion_render_html or export.start and BEFORE declaring a motion-graphics deliverable done. Pass either entryId (export-library entry) or videoPath (arbitrary MP4). Timestamps are in seconds, typically 8-15 spread across hero moments. Returns { frames: [{timestampSeconds, path}...] } — the agent must then Read each path as an image (multimodal) and confirm no cropped faces / text overflow / blank frames / forbidden-zone occlusion / flat-white headlines.",
+		inputSchema: {
+			type: "object",
+			required: ["timestamps"],
+			properties: {
+				entryId: {
+					type: "string",
+					description:
+						"Export library entry id. Mutually exclusive with videoPath — one must be provided.",
+				},
+				videoPath: {
+					type: "string",
+					description:
+						"Absolute path to an MP4 (e.g. a motion.render-html intermediate output). Mutually exclusive with entryId.",
+				},
+				timestamps: {
+					type: "array",
+					items: { type: "number" },
+					description:
+						"Timestamps in seconds to extract frames at (e.g. [0.5, 1.5, 3.0, 5.0, 7.5, 10.0, 12.5, 15.0]). Max 30 per call.",
+				},
+				outputName: {
+					type: "string",
+					description:
+						"Optional subdir stem for the output PNGs. Defaults to verify-<rand>. Frames land in RECORDINGS_DIR/<stem>/frame-<ms>.png.",
+				},
+			},
+		},
+		command: "motion.verify-frames",
+	},
 
 	// ── assets ──────────────────────────────────────────────────────
 	{
@@ -1273,6 +1508,96 @@ const TOOLS = [
 		inputSchema: { type: "object", properties: {} },
 		command: "export.list",
 	},
+	{
+		name: "export_generate_thumbnail",
+		description:
+			"Generate a YouTube thumbnail for an export-library entry via Replicate's gpt-image-2 model. If `prompt` isn't supplied, the local LLM writes one from the transcript (an opinionated YouTube-thumbnail art-director prompt targeting 3:2 aspect, photorealistic or bold-graphic, high contrast, optional short overlay text). Requires the user's Replicate API key to be set in Settings → Integrations (the key is stored encrypted via OS keychain; PandaStudio never sees the user's OpenAI bill). Returns { imagePath, prompt, iterations } on success.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Export entry id." },
+				prompt: {
+					type: "string",
+					description:
+						"Optional explicit prompt. If omitted, the local LLM auto-writes one from the transcript.",
+				},
+				referenceImagePath: {
+					type: "string",
+					description:
+						"Optional reference image (absolute path or https URL) passed as gpt-image-2 `input_images`.",
+				},
+				quality: {
+					type: "string",
+					description: "gpt-image-2 quality. 'low' | 'medium' (default) | 'high'.",
+				},
+			},
+			required: ["id"],
+		},
+		command: "export.generate-thumbnail",
+	},
+	{
+		name: "export_edit_thumbnail",
+		description:
+			"Iterate on the existing thumbnail via natural-language edit prompt ('make it more red', 'add bold text at top', 'remove the logo'). The current thumbnail is passed to gpt-image-2 as input_images, and the result replaces it. The previous thumbnail is pushed onto `entry.thumbnailIterations` so the user can revert. Quality is fixed at 'low' on edits — fast and cheap, suitable for rapid iteration.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Export entry id." },
+				editPrompt: {
+					type: "string",
+					description: "What to change. One-sentence natural-language instruction.",
+				},
+			},
+			required: ["id", "editPrompt"],
+		},
+		command: "export.edit-thumbnail",
+	},
+	{
+		name: "export_set_thumbnail",
+		description:
+			"Attach a manually-chosen image file (PNG / JPEG / WebP) as the thumbnail. Use this when the user provides a ready-made image, or when an agent has already generated one elsewhere. Copies the file into the managed thumbnails directory; iteration history is cleared. Prefer `export.generate-thumbnail` for AI-generated thumbnails so iteration history is preserved.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Export entry id." },
+				sourcePath: {
+					type: "string",
+					description: "Absolute path to the local image file (PNG / JPEG / WebP).",
+				},
+			},
+			required: ["id", "sourcePath"],
+		},
+		command: "export.set-thumbnail",
+	},
+	{
+		name: "export_clear_thumbnail",
+		description: "Remove the current thumbnail and wipe its iteration history.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Export entry id." },
+			},
+			required: ["id"],
+		},
+		command: "export.clear-thumbnail",
+	},
+	{
+		name: "export_revert_thumbnail",
+		description:
+			"Revert to a previous thumbnail from the iteration history (`entry.thumbnailIterations[].id`). The current image gets pushed onto history, so the revert itself is undoable.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				id: { type: "string", description: "Export entry id." },
+				iterationId: {
+					type: "string",
+					description: "id of the iteration entry from `entry.thumbnailIterations`.",
+				},
+			},
+			required: ["id", "iterationId"],
+		},
+		command: "export.revert-thumbnail",
+	},
 
 	// ── preview overlay (v1.9.2) ────────────────────────────────────
 	{

package/package.json

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