creavit-studio-mcp 1.3.4 → 1.3.6

package/README.md

@@ -120,6 +120,20 @@ files directly and work with the app closed.
 > `creavit_editor_add_zoom` only when the user asks for a zoom at a specific
 > moment.
 
+**Sensitive content** — `creavit_editor_video_frame`,
+`creavit_editor_sensitive_areas`, `creavit_editor_add_sensitive`,
+`creavit_editor_update_sensitive`, `creavit_editor_remove_sensitive`,
+`creavit_editor_sensitive_visibility`
+
+> To cover a password field, an email or an API key: scan the recording with
+> `creavit_editor_video_frame` (pass several `times` in one call) until you see
+> it, read its pixel box off that frame, then pass the box as `rectPx` together
+> with the frame's `frameWidth`/`frameHeight` as `refWidth`/`refHeight`. The
+> region is anchored to the video content, so it follows zoom, perspective and
+> crop. Use `creavit_editor_video_frame` — **not** `creavit_editor_screenshot` —
+> for measuring: the screenshot is the composed canvas and its pixels do not map
+> onto the mask.
+
 **Perspective** — `creavit_editor_perspectives`,
 `creavit_editor_add_perspective`, `creavit_editor_update_perspective`,
 `creavit_editor_remove_perspective`

package/package.json

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

package/src/protocol.mjs

@@ -1,12 +1,20 @@
 // MCP sunucusu — köprü protokolü sabitleri.
 // electron/agentBridge/protocol.cjs ile eşleşmeli.
 
+import { createRequire } from "node:module";
+
+const require = createRequire(import.meta.url);
+const packageMetadata = require("../package.json");
+
 export const BRIDGE_PROTOCOL_VERSION = 1;
 export const ENDPOINT_FILENAME = "agent-bridge.json";
 
 export const MCP_PROTOCOL_VERSION = "2024-11-05";
 export const SERVER_NAME = "creavit-studio";
-export const SERVER_VERSION = "1.3.2";
+// package.json is the single version source used by npm, the CLI and the MCP
+// initialize response. Keeping a second literal here made 1.3.4 report itself
+// as 1.3.2 even though npx had installed the correct package.
+export const SERVER_VERSION = packageMetadata.version;
 
 export const JSONRPC_ERRORS = {
 	PARSE_ERROR: -32700,

package/src/tools/index.mjs

@@ -2,6 +2,7 @@
 
 import { projectTools } from "./projectTools.mjs";
 import { editorTools } from "./editorTools.mjs";
+import { sensitiveTools } from "./sensitiveTools.mjs";
 import { motionTools } from "./motionTools.mjs";
 import { systemTools } from "./systemTools.mjs";
 import { browserTools } from "./browserTools.mjs";
@@ -18,6 +19,7 @@ function buildRegistry() {
 		...systemTools(),
 		...projectTools(),
 		...editorTools(),
+		...sensitiveTools(),
 		...motionTools(),
 		...browserTools(),
 		...inputTools(),

package/src/tools/sensitiveTools.mjs

@@ -0,0 +1,135 @@
+// MCP araçları — hassas içerik maskeleri (blur / pixelate / solid).
+// Editör penceresinin açık olmasını gerektirir (creavit_project_open).
+
+import { bridgeTool, schema, S, textResult } from "./defineTool.mjs";
+
+const RECT_PROPS = {
+	rectPx: S.object(
+		"Region measured in PIXELS on a creavit_editor_video_frame image: {x, y, width, height}. This is the easy way — look at the frame, read the box off it.",
+	),
+	refWidth: S.number(
+		"Width of the image the rectPx was measured on (the `frameWidth` reported by creavit_editor_video_frame). Required whenever that frame was downscaled.",
+	),
+	refHeight: S.number(
+		"Height of the image the rectPx was measured on (the `frameHeight` reported by creavit_editor_video_frame).",
+	),
+	x: S.number("Left edge, normalized 0-1 (alternative to rectPx)"),
+	y: S.number("Top edge, normalized 0-1"),
+	width: S.number("Width, normalized 0-1"),
+	height: S.number("Height, normalized 0-1"),
+	effect: S.string("blur (default), pixelate, or solid", {
+		enum: ["blur", "pixelate", "solid"],
+	}),
+	intensity: S.number("How strongly the region is obscured, 0-100 (default 55)"),
+	radius: S.number("Corner rounding percentage, 0-50 (default 12)"),
+	solidColor: S.string("Fill color when effect is 'solid', e.g. '#111114'"),
+};
+
+export function sensitiveTools() {
+	return [
+		bridgeTool({
+			name: "creavit_editor_video_frame",
+			command: "editor.videoFrame",
+			description:
+				"Returns the RAW source video frame — no background, padding, zoom or perspective, just what was recorded. This is the coordinate reference for sensitive-content masks: a pixel you see here maps directly onto the mask region. Use it to FIND something in the recording (a password field, an email, an API key) and to work out WHEN it is on screen: pass `times` with up to 8 timestamps to scan the video in one call, then narrow down. Do not use creavit_editor_screenshot for this — that one is the composed canvas and its pixels do not map onto the mask.",
+			inputSchema: schema({
+				time: S.number("Single timestamp in seconds"),
+				times: S.array("Up to 8 timestamps in seconds, scanned in one call", {
+					type: "number",
+				}),
+				maxWidth: S.number(
+					"Downscale the returned image to this width (default: full source width). Whatever comes back, pass its frameWidth/frameHeight as refWidth/refHeight when you measure on it.",
+				),
+			}),
+			timeoutMs: 120_000,
+			mapResult: (result) => {
+				const frames = Array.isArray(result?.frames) ? result.frames : [];
+				const content = [];
+				for (const frame of frames) {
+					content.push({
+						type: "image",
+						data: frame.base64,
+						mimeType: frame.mimeType || "image/png",
+					});
+					const at =
+						frame.atTime === null || frame.atTime === undefined
+							? "current playhead"
+							: `${Number(frame.atTime).toFixed(2)}s`;
+					content.push({
+						type: "text",
+						text: `Source frame @ ${at} — image is ${frame.frameWidth}x${frame.frameHeight}, video content is ${frame.contentWidth}x${frame.contentHeight}. Measuring a region on this image? pass refWidth=${frame.frameWidth} refHeight=${frame.frameHeight} together with rectPx.`,
+					});
+				}
+				if (content.length === 0) {
+					return textResult({ ...result, note: "No frame could be captured." });
+				}
+				return { content };
+			},
+		}),
+
+		bridgeTool({
+			name: "creavit_editor_sensitive_areas",
+			command: "editor.listSensitiveAreas",
+			description:
+				"Lists the sensitive-content masks on the timeline: id, start/end in seconds, the region both normalized (0-1) and in video pixels, effect, intensity and corner radius. Also reports the video content size and whether masks are currently hidden.",
+			inputSchema: schema(),
+		}),
+
+		bridgeTool({
+			name: "creavit_editor_add_sensitive",
+			command: "editor.addSensitiveArea",
+			description:
+				"Covers a region of the screen with a blur / pixelate / solid mask for a time range — for passwords, emails, API keys, names and the like. The region is anchored to the VIDEO CONTENT, so it follows zoom, perspective and crop and never uncovers what is underneath. Workflow: call creavit_editor_video_frame (with several `times`) to find the moment the thing is visible and read its pixel box off the frame, then call this with `rectPx` plus the frame's refWidth/refHeight and the start/end of the interval it is on screen. Pad the box a few pixels beyond the element. Verify afterwards with creavit_editor_screenshot, and call creavit_project_save to persist.",
+			inputSchema: schema(
+				{
+					start: S.number("Start time in seconds"),
+					end: S.number("End time in seconds, greater than start"),
+					...RECT_PROPS,
+				},
+				["start", "end"],
+			),
+			mapResult: (result) =>
+				textResult({
+					...result,
+					note: "Added. Check it with creavit_editor_screenshot, then creavit_project_save to persist.",
+				}),
+		}),
+
+		bridgeTool({
+			name: "creavit_editor_update_sensitive",
+			command: "editor.updateSensitiveArea",
+			description:
+				"Updates an existing sensitive-content mask — move or resize the region, change the time range, the effect or its intensity. Target it by id (from creavit_editor_sensitive_areas) or by zero-based index. Put the changed fields in `patch`; the same rectPx/refWidth/refHeight or normalized x/y/width/height forms are accepted there.",
+			inputSchema: schema(
+				{
+					id: S.string("ID of the mask"),
+					index: S.number("Or its position in the list (0-based)"),
+					patch: S.object(
+						"Fields to change: start, end, rectPx (+refWidth/refHeight), x, y, width, height, effect, intensity, radius, solidColor",
+					),
+				},
+				["patch"],
+			),
+		}),
+
+		bridgeTool({
+			name: "creavit_editor_remove_sensitive",
+			command: "editor.removeSensitiveArea",
+			description:
+				"Deletes a sensitive-content mask by id or zero-based index, or every mask with all=true.",
+			inputSchema: schema({
+				id: S.string("ID of the mask"),
+				index: S.number("Or its position in the list (0-based)"),
+				all: S.bool("Delete every mask"),
+			}),
+		}),
+
+		bridgeTool({
+			name: "creavit_editor_sensitive_visibility",
+			command: "editor.setSensitiveHidden",
+			description:
+				"Shows or hides every sensitive-content mask at once — the same switch as 'Hide masks' in the settings panel. Hiding does not delete anything; use it only to peek at what is underneath.",
+			inputSchema: schema({ hidden: S.bool("true hides all masks") }, ["hidden"]),
+		}),
+	];
+}