creavit-studio-mcp 1.3.7 → 1.3.8

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "creavit-studio-mcp",
-	"version": "1.3.7",
+	"version": "1.3.8",
 	"description": "MCP server that lets AI coding agents (Claude Code, Codex, Cursor) drive the Creavit Studio screen recording app",
 	"keywords": [
 		"mcp",

package/src/tools/editorTools.mjs

@@ -69,7 +69,9 @@ export function editorTools() {
 					}),
 					color: S.string("CSS color for a solid background"),
 					image: S.string("Image URL, local path, or a CMS wallpaper name"),
-					wallpaper: S.string("CMS wallpaper name (see creavit_editor_wallpapers)"),
+					wallpaper: S.string(
+						"CMS wallpaper name (see creavit_editor_wallpapers)",
+					),
 					blur: S.number("Image blur amount"),
 					gradient: S.object(
 						"Gradient configuration: {type, direction, colors:[{color,position}]}.",
@@ -79,7 +81,10 @@ export function editorTools() {
 				["type"],
 			),
 			mapResult: (result) =>
-				textResult({ ...result, note: "Applied. Call creavit_project_save to persist." }),
+				textResult({
+					...result,
+					note: "Applied. Call creavit_project_save to persist.",
+				}),
 		}),
 
 		bridgeTool({
@@ -108,7 +113,10 @@ export function editorTools() {
 			}),
 			timeoutMs: 60_000,
 			mapResult: (result) =>
-				textResult({ ...result, note: "Applied. Call creavit_project_save to persist." }),
+				textResult({
+					...result,
+					note: "Applied. Call creavit_project_save to persist.",
+				}),
 		}),
 
 		bridgeTool({
@@ -119,16 +127,39 @@ export function editorTools() {
 		}),
 
 		bridgeTool({
-			name: "creavit_editor_camera_set",
-			command: "editor.setCamera",
+			name: "creavit_editor_reframe",
+			command: "editor.reframe",
 			description:
-				"Partially updates camera overlay settings: visible, size, radius, shadow, position crop, cropZoom, followMouse, oscillationMovement, mirror, aspectRatio, border, background removal, mergeWithCursor, lockSizeOnZoom and sizeOnZoom. Call creavit_project_save afterwards.",
+				"Re-frames the whole composition for another aspect ratio in ONE call — use this for \"make it vertical / for mobile / a story\" requests instead of setting the ratio and then nudging padding, camera and zooms by hand. Ask the user which format they want first (9:16 story, 4:5 or 1:1 feed, 3:4) when they did not say. It sets the ratio, refits padding/radius so the content stays as large as possible, enlarges the camera and anchors it bottom-center so it reads on a narrow frame, and scales the cursor. Existing zooms are preserved untouched unless tightenZooms is true. Call creavit_project_save afterwards.",
 			inputSchema: schema(
-				{ settings: S.object("Camera settings to update") },
-				["settings"],
+				{
+					ratio: S.string("16:9, 9:16, 1:1, 4:3, 3:4, or empty string for auto", {
+						enum: ["", "16:9", "9:16", "1:1", "4:3", "3:4"],
+					}),
+					cameraPlacement: S.string("bottom | top | keep", {
+						enum: ["bottom", "top", "keep"],
+					}),
+					tightenZooms: S.bool(
+						"Raise low zoom scales so text stays readable on a phone (default false)",
+					),
+				},
+				["ratio"],
 			),
+		}),
+
+		bridgeTool({
+			name: "creavit_editor_camera_set",
+			command: "editor.setCamera",
+			description:
+				"Partially updates camera overlay settings: visible, size, radius, shadow, position crop, cropZoom, followMouse, oscillationMovement, mirror, aspectRatio, border, background removal, mergeWithCursor, lockSizeOnZoom and sizeOnZoom. Background removal is a real toggle: pass removeBackground (or optimizedBackgroundRemoval) true/false and the app loads the segmentation engine and starts the pipeline, exactly like the settings panel does — optionally tune it with optimizedBackgroundRemovalSettings. Call creavit_project_save afterwards.",
+			inputSchema: schema({ settings: S.object("Camera settings to update") }, [
+				"settings",
+			]),
 			mapResult: (result) =>
-				textResult({ ...result, note: "Applied. Call creavit_project_save to persist." }),
+				textResult({
+					...result,
+					note: "Applied. Call creavit_project_save to persist.",
+				}),
 		}),
 
 		{
@@ -144,7 +175,8 @@ export function editorTools() {
 				["action"],
 			),
 			run: async ({ action }) => {
-				if (action === "status") return textResult(await callCommand("editor.getAudio", {}));
+				if (action === "status")
+					return textResult(await callCommand("editor.getAudio", {}));
 				if (action !== "mute" && action !== "unmute") {
 					throw new Error("`action` must be status, mute, or unmute");
 				}
@@ -207,7 +239,8 @@ export function editorTools() {
 		bridgeTool({
 			name: "creavit_editor_perspectives",
 			command: "editor.listPerspectives",
-			description: "Lists all perspective (3D animation) ranges on the timeline.",
+			description:
+				"Lists all perspective (3D animation) ranges on the timeline.",
 			inputSchema: schema(),
 		}),
 
@@ -228,7 +261,8 @@ export function editorTools() {
 		bridgeTool({
 			name: "creavit_editor_update_perspective",
 			command: "editor.updatePerspective",
-			description: "Updates an existing perspective range by id or zero-based index.",
+			description:
+				"Updates an existing perspective range by id or zero-based index.",
 			inputSchema: schema(
 				{
 					id: S.string("Perspective range ID"),
@@ -242,7 +276,8 @@ export function editorTools() {
 		bridgeTool({
 			name: "creavit_editor_remove_perspective",
 			command: "editor.removePerspective",
-			description: "Deletes a perspective range by id/index, or all perspective ranges with all=true.",
+			description:
+				"Deletes a perspective range by id/index, or all perspective ranges with all=true.",
 			inputSchema: schema({
 				id: S.string("Perspective range ID"),
 				index: S.number("Perspective range index"),
@@ -274,7 +309,9 @@ export function editorTools() {
 			command: "editor.seek",
 			description:
 				"Moves the playhead to the given time and renders that frame. Combine with creavit_editor_screenshot to inspect a specific moment.",
-			inputSchema: schema({ time: S.number("Target time in seconds") }, ["time"]),
+			inputSchema: schema({ time: S.number("Target time in seconds") }, [
+				"time",
+			]),
 		}),
 
 		{
@@ -304,8 +341,15 @@ export function editorTools() {
 			timeoutMs: 120_000,
 			mapResult: (result) => ({
 				content: [
-					{ type: "image", data: result.base64, mimeType: result.mimeType || "image/png" },
-					{ type: "text", text: `Canvas frame @ ${Number(result.atTime || 0).toFixed(2)}s` },
+					{
+						type: "image",
+						data: result.base64,
+						mimeType: result.mimeType || "image/png",
+					},
+					{
+						type: "text",
+						text: `Canvas frame @ ${Number(result.atTime || 0).toFixed(2)}s`,
+					},
 				],
 			}),
 		}),
@@ -314,7 +358,7 @@ export function editorTools() {
 			name: "creavit_editor_export",
 			command: "editor.export",
 			description:
-				"Exports the video idempotently; concurrent retries share one render. This takes a LONG time (minutes). Follow progress with creavit_events (export.started / export.finished / export.failed), then use creavit_file_open when the user asks to open/play it. If filePath is omitted, the export is written beside the open .crvt project.",
+				"Exports the video idempotently; concurrent retries share one render. This takes a LONG time (minutes). Follow progress with creavit_events (export.started / export.finished / export.failed), then use creavit_file_open when the user asks to open/play it. If filePath is omitted, the export is written beside the open .crvt project. Exporting requires an active Creavit Studio license, or a remaining free export credit. When neither is available the export is REFUSED before any rendering starts and the error explains why (expired license / free credits used up); relay that message to the user in their own language and point them at the purchase page instead of retrying.",
 			inputSchema: schema({
 				filePath: S.string("Target file path (.mp4)"),
 				format: S.string("mp4 or gif", { enum: ["mp4", "gif"] }),
@@ -329,14 +373,18 @@ export function editorTools() {
 			name: "creavit_editor_export_start",
 			command: "editor.export.start",
 			description:
-				"Starts one export in the background and returns immediately. Use this when tool latency matters. Progress/completion is reported by creavit_events; set openWhenFinished=true to open/play the result automatically without showing export UI.",
+				"Starts one export in the background and returns immediately. Use this when tool latency matters. Progress/completion is reported by creavit_events; set openWhenFinished=true to open/play the result automatically without showing export UI. Exporting requires an active Creavit Studio license, or a remaining free export credit. When neither is available the export is REFUSED before any rendering starts and the error explains why (expired license / free credits used up); relay that message to the user in their own language and point them at the purchase page instead of retrying.",
 			inputSchema: schema({
-				filePath: S.string("Target file path (.mp4); omit to export beside the project"),
+				filePath: S.string(
+					"Target file path (.mp4); omit to export beside the project",
+				),
 				format: S.string("mp4 or gif", { enum: ["mp4", "gif"] }),
 				resolution: S.string("e.g. 720p, 1080p, 4k"),
 				fps: S.number("Frame rate, e.g. 30 or 60"),
 				quality: S.string("compact | high | max"),
-				openWhenFinished: S.bool("Open the exported file automatically when rendering completes"),
+				openWhenFinished: S.bool(
+					"Open the exported file automatically when rendering completes",
+				),
 			}),
 			timeoutMs: 30_000,
 		}),