creavit-studio-mcp 1.0.0

package/src/tools/systemTools.mjs

@@ -0,0 +1,104 @@
+// MCP araçları — uygulama durumu, kayıt akışı, cihazlar ve olay akışı.
+
+import { bridgeTool, schema, S, textResult } from "./defineTool.mjs";
+import { callCommand } from "../bridgeClient.mjs";
+
+export function systemTools() {
+	return [
+		bridgeTool({
+			name: "creavit_app_info",
+			description:
+				"Returns app state: version, open windows, agent-connected renderers, project folder path, recording state. Start every session with this — confirm the app is running and see which windows are open.",
+			command: "app.info",
+			inputSchema: schema(),
+		}),
+
+		bridgeTool({
+			name: "creavit_app_window",
+			command: "app.focusWindow",
+			description:
+				"Brings an app window to the front and focuses it. Get window IDs from creavit_app_info.",
+			inputSchema: schema({ windowId: S.number("Window ID") }, ["windowId"]),
+		}),
+
+		bridgeTool({
+			name: "creavit_devices_list",
+			command: "devices.list",
+			description:
+				"Lists recording sources: displays, windows, cameras, audio input devices. The IDs required by creavit_recording_start come from here.",
+			inputSchema: schema({
+				kinds: S.array("Which kinds to fetch: screens, windows, cameras, audio (default: all)", {
+					type: "string",
+					enum: ["screens", "windows", "cameras", "audio"],
+				}),
+			}),
+			timeoutMs: 60_000,
+		}),
+
+		bridgeTool({
+			name: "creavit_recording_status",
+			command: "recording.status",
+			description: "Whether a recording is in progress, and which devices are selected.",
+			inputSchema: schema(),
+		}),
+
+		bridgeTool({
+			name: "creavit_recording_start",
+			command: "recording.start",
+			description:
+				"Starts a screen recording. Get source IDs from creavit_devices_list first. Monitor with creavit_recording_status, and finish with creavit_recording_stop.",
+			inputSchema: schema({
+				options: S.object(
+					"Recording options: {sourceType:'display'|'window'|'area', sourceId, cameraEnabled, micEnabled, systemAudioEnabled, delayMs, area:{x,y,width,height}}",
+				),
+			}),
+			timeoutMs: 180_000,
+			mapParams: (args) => ({ options: args.options || {} }),
+		}),
+
+		bridgeTool({
+			name: "creavit_recording_stop",
+			command: "recording.stop",
+			description:
+				"Stops the recording. Processing can take a few minutes; the editor opens automatically when it finishes. Track progress with creavit_events (watch for recording.stopped and project.loaded).",
+			inputSchema: schema(),
+			timeoutMs: 600_000,
+		}),
+
+		bridgeTool({
+			name: "creavit_permissions",
+			command: "permissions.check",
+			description:
+				"Returns macOS screen recording / camera / microphone permission states. Check here first when recording fails to start.",
+			inputSchema: schema(),
+		}),
+
+		bridgeTool({
+			name: "creavit_events",
+			command: "events.tail",
+			description:
+				"Reads the app event stream: recording and export lifecycle, project loads, errors. To follow a long operation, call repeatedly passing `since` set to the highest seq you have already seen.",
+			inputSchema: schema({
+				since: S.number("Return events after this seq number (use 0 on the first call)"),
+				limit: S.number("Maximum events to return (default 200)"),
+			}),
+		}),
+
+		{
+			name: "creavit_app_mode",
+			description:
+				"Switches the app between recording mode and an empty editor. To open a specific project, use creavit_project_open instead.",
+			inputSchema: schema(
+				{ mode: S.string("record or editor", { enum: ["record", "editor"] }) },
+				["mode"],
+			),
+			run: async ({ mode }) => {
+				if (mode !== "record" && mode !== "editor") {
+					throw new Error("`mode` must be either 'record' or 'editor'");
+				}
+				const command = mode === "record" ? "app.openRecordMode" : "app.openEditor";
+				return textResult(await callCommand(command, {}, 60_000));
+			},
+		},
+	];
+}