goatedit-mcp 1.1.8 → 1.1.9

package/bundle/goatedit-mcp.js

@@ -20584,6 +20584,60 @@ var BASE_TOOLS = [
     },
     method: "setProjectSettings"
   },
+  {
+    name: "begin_request",
+    description: 'Call once at the start of each new request from the user, before editing. It tells the editor what kind of edit this is and which words describe the style, so it can learn what this user means by them, and measures any reference video the user gave. Pass words from the request ("punchy", "cinematic"), not the request itself \u2014 nothing else is kept. References must be in the media bin (import_local_file or add_media_file first); only their measurements are kept (cut pacing, grade, colours), never frames. Replies with those measurements, to use while editing.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        editType: {
+          type: "string",
+          enum: ["reel", "short", "ad", "promo", "trailer", "podcast", "interview", "talking-head", "vlog", "tutorial", "explainer", "documentary", "music-video", "wedding", "event", "product", "real-estate", "gaming", "montage", "slideshow", "corporate", "other"],
+          description: "What the user is making."
+        },
+        styleWords: { type: "array", items: { type: "string" }, description: 'Style words from the request, e.g. ["punchy", "warm"].' },
+        referenceMediaIds: { type: "array", items: { type: "string" }, description: "Media ids of reference videos the user gave (up to 3)." }
+      }
+    },
+    method: "beginRequest"
+  },
+  {
+    name: "record_choice",
+    description: "When you offer the user several versions of an edit (one sequence each, e.g. a fast cut, a story cut, a minimal cut) and they pick one, record it here. The editor compares the pick with the others \u2014 pacing, transitions, effects, text size, music level, grade \u2014 and learns which way this user leans, which get_style_profile then reports under preferences. A pick says more than many silent edits, so offer variants for open-ended requests.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sequenceIds: { type: "array", items: { type: "string" }, description: "Every variant offered, as sequence ids (2\u20136)." },
+        chosenSequenceId: str("The one the user picked.")
+      },
+      required: ["sequenceIds", "chosenSequenceId"]
+    },
+    method: "recordChoice"
+  },
+  {
+    name: "set_style_brand",
+    description: "Say which brand or client this project is for, so its style is learned and read apart from the user\u2019s other clients. Ask the user first \u2014 when get_style_profile reports a brandGuess, confirm it with them before setting it. name: null files the project under the user\u2019s own style again.",
+    inputSchema: {
+      type: "object",
+      properties: { name: { type: ["string", "null"], description: 'Brand or client name, e.g. "Nike"; null for none.' } },
+      required: ["name"]
+    },
+    method: "setStyleBrand"
+  },
+  {
+    name: "get_style_profile",
+    description: 'What this user\u2019s edits have in common, learned from their past projects: pacing, transitions, text and captions, colour, effects, audio levels, frame shape \u2014 plus the changes they keep making to the agent\u2019s work (corrections) and what their style words ("punchy", "clean") have meant before. Read it before choosing a look, and treat it as defaults: the request in front of you wins. Pass topic to get just one part. Scoped to the project\u2019s brand/client when it has one, so one editor\u2019s clients stay apart. Reports enabled: false when the user has not switched style memory on.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        topic: { type: "string", enum: ["pacing", "transitions", "text", "color", "effects", "audio", "format"], description: "One part of the style. Omit for all of it." },
+        brandId: str("Read another brand\u2019s style instead of this project\u2019s."),
+        editType: str("Read the style for this kind of edit (reel, ad, podcast\u2026) instead of this project\u2019s own."),
+        sheets: bool("Also return up to 2 contact sheets of the user\u2019s own exported edits that fit (people are blurred out). Off by default: each is an image.")
+      }
+    },
+    method: "getStyleProfile"
+  },
   {
     name: "set_audio_master",
     description: "The sequence\u2019s master bus: tag tracks as voice, music or sfx, duck music under voice, and put a safety limiter on the mix. Ducking follows the spans of clips on voice-role tracks (and nested sequences placed on them), dipping music-role tracks by duckDb, starting `attack` seconds before each line so the first word is clear. Playback, probe_audio and export all hear the same bus. With no arguments it reports the current roles and settings.",
@@ -21032,6 +21086,19 @@ function resolveRefs(value, refs) {
   }
   return value;
 }
+function withRunProject(stepArgs, projectId) {
+  if (typeof projectId !== "string" || !projectId || typeof stepArgs.projectId === "string") return stepArgs;
+  return { ...stepArgs, projectId };
+}
+
+// src/tab-registry.ts
+function indexTabs(reports, isOpen) {
+  const index = /* @__PURE__ */ new Map();
+  for (const r of [...reports].sort((a, b) => a.at - b.at)) {
+    if (isOpen(r.socket)) index.set(r.projectId, r);
+  }
+  return index;
+}
 
 // src/index.ts
 var WEBSOCKET_PORT = 9e3;
@@ -21091,7 +21158,7 @@ var VERSION = (() => {
   }
   return "0.0.0";
 })();
-var INSTRUCTIONS = `Edits a GoatEdit video project live in the user's browser tab at ai.goatedit.com. Call get_timeline before your first edit \u2014 clip ids change after every split, trim or delete, and a stale id is rejected. Each edit's reply carries timelineChanges (clips added, with their ids and placement; clips changed; ids removed), so take the next ids from there instead of reading the timeline again. get_timeline is lean by default; pass detail: "full" only when you need effect parameters, and trackId or from/to to read part of it. Several edits in a row go faster as one run_tools call. With more than one tab open, call list_connected_projects, then use_project to pick one. render_preview_frame and preview_media accept saveToDisk: true, which writes the frame to a file and returns its path instead of the image. If a tool reports the editor is not connected, ask the user to open ai.goatedit.com and switch on Local in the AI status menu.`;
+var INSTRUCTIONS = `Edits a GoatEdit video project live in the user's browser tab at ai.goatedit.com. At the start of each new request from the user, call begin_request with the kind of edit, its style words and any reference videos, then get_style_profile for how this user edits; treat that style as defaults, the request wins. Call get_timeline before your first edit \u2014 clip ids change after every split, trim or delete, and a stale id is rejected. Each edit's reply carries timelineChanges (clips added, with their ids and placement; clips changed; ids removed), so take the next ids from there instead of reading the timeline again. get_timeline is lean by default; pass detail: "full" only when you need effect parameters, and trackId or from/to to read part of it. Several edits in a row go faster as one run_tools call. With more than one tab open, call list_connected_projects, then use_project to pick one. To work on several projects at once (one helper agent per video), do not use use_project \u2014 it moves every caller \u2014 but pass projectId on each call, or once on run_tools for all its steps. render_preview_frame and preview_media accept saveToDisk: true, which writes the frame to a file and returns its path instead of the image. If a tool reports the editor is not connected, ask the user to open ai.goatedit.com and switch on Local in the AI status menu.`;
 var MEDIA_TYPES = {
   ".mp4": { mime: "video/mp4", kind: "video" },
   ".m4v": { mime: "video/mp4", kind: "video" },
@@ -21347,6 +21414,14 @@ var wss = new import_websocket_server.default({
 wss.on("error", () => {
 });
 var tabs = /* @__PURE__ */ new Map();
+var tabReports = /* @__PURE__ */ new Map();
+function reindexTabs() {
+  tabs.clear();
+  for (const [pid, r] of indexTabs(tabReports.values(), (s) => s.readyState === import_websocket.default.OPEN)) {
+    tabs.set(pid, { ws: r.socket, projectId: pid, projectName: r.projectName });
+  }
+  if (lastActiveProjectId && !tabs.has(lastActiveProjectId)) lastActiveProjectId = null;
+}
 var lastActiveProjectId = null;
 var chosenProjectId = null;
 var controllerSockets = /* @__PURE__ */ new Set();
@@ -21420,7 +21495,7 @@ wss.on("connection", (ws, req) => {
         }
         const target = resolveTab(projectId);
         if (id !== void 0) controllerRequests.set(String(id), ws);
-        target.ws.send(JSON.stringify({ id, method, params }));
+        target.ws.send(JSON.stringify({ id, method, params, projectId: target.projectId }));
       } catch (err) {
         sendJson(ws, { id, error: err?.message ?? String(err) });
       }
@@ -21433,7 +21508,6 @@ wss.on("connection", (ws, req) => {
     return;
   }
   console.error("[GoatEdit MCP] Browser editor connected via WebSocket");
-  let myProjectId = null;
   ws.on("message", (data) => {
     let message;
     try {
@@ -21445,10 +21519,9 @@ wss.on("connection", (ws, req) => {
     if (message.type === "status") {
       if (typeof message.projectId === "string" && message.projectId) {
         const pid = message.projectId;
-        if (myProjectId && myProjectId !== pid && tabs.get(myProjectId)?.ws === ws) tabs.delete(myProjectId);
-        myProjectId = pid;
-        tabs.set(pid, { ws, projectId: pid, projectName: message.projectName ?? null });
+        tabReports.set(ws, { socket: ws, projectId: pid, projectName: message.projectName ?? null, at: Date.now() });
         lastActiveProjectId = pid;
+        reindexTabs();
         console.error(`[GoatEdit MCP] Active project: ${message.projectName} (${pid})`);
       }
       for (const controller2 of controllerSockets) sendJson(controller2, message);
@@ -21473,11 +21546,8 @@ wss.on("connection", (ws, req) => {
   ws.on("close", () => {
     console.error("[GoatEdit MCP] Browser editor disconnected");
     rejectPendingOn(ws, "The editor tab disconnected");
-    for (const [pid, tab] of tabs) {
-      if (tab.ws !== ws) continue;
-      tabs.delete(pid);
-      if (lastActiveProjectId === pid) lastActiveProjectId = null;
-    }
+    tabReports.delete(ws);
+    reindexTabs();
   });
 });
 var ownsPort = false;
@@ -21586,7 +21656,7 @@ async function sendToBrowser(method, params = {}, projectId) {
       reject(new Error(`Request timed out after ${REQUEST_TIMEOUT_MS / 1e3}s: ${method}. Call get_timeline to see whether it landed.`));
     }, REQUEST_TIMEOUT_MS);
     pendingRequests.set(id, { resolve, reject, timeoutId, socket: tab.ws, method });
-    tab.ws.send(JSON.stringify({ id, method, params }));
+    tab.ws.send(JSON.stringify({ id, method, params, projectId: tab.projectId }));
   });
 }
 var LOCAL_HANDLERS = {
@@ -21656,7 +21726,8 @@ var LOCAL_TOOLS = [
           }
         },
         continueOnError: { type: "boolean", description: "Run the remaining steps after one fails." },
-        rollback: { type: "boolean", description: "Take a checkpoint first and restore it if any step fails, so a run either lands whole or not at all. Cannot be combined with continueOnError." }
+        rollback: { type: "boolean", description: "Take a checkpoint first and restore it if any step fails, so a run either lands whole or not at all. Cannot be combined with continueOnError." },
+        projectId: { type: "string", description: "Run every step on this project (from list_connected_projects). Use it when several agents edit different tabs at once; a step's own projectId wins." }
       },
       required: ["calls"]
     }
@@ -21743,7 +21814,7 @@ async function runTools(args) {
   let failed = 0;
   let checkpointId;
   if (args.rollback) {
-    const made = await callTool("create_checkpoint", { name: "run_tools rollback" });
+    const made = await callTool("create_checkpoint", withRunProject({ name: "run_tools rollback" }, args.projectId));
     checkpointId = made?.checkpointId;
   }
   for (let i = 0; i < calls.length; i++) {
@@ -21751,7 +21822,7 @@ async function runTools(args) {
     const tool = typeof step?.tool === "string" ? step.tool : "";
     try {
       const stepArgs = resolveRefs(step.args && typeof step.args === "object" ? step.args : {}, refs);
-      const raw = await callTool(tool, stepArgs);
+      const raw = await callTool(tool, withRunProject(stepArgs, args.projectId));
       if (typeof step.as === "string" && step.as) {
         if (raw && typeof raw === "object" && !Array.isArray(raw)) {
           const { _image, _images, ...kept } = raw;
@@ -21781,7 +21852,7 @@ async function runTools(args) {
   let rolledBack;
   if (failed && checkpointId) {
     try {
-      await callTool("restore_checkpoint", { checkpointId });
+      await callTool("restore_checkpoint", withRunProject({ checkpointId }, args.projectId));
       rolledBack = true;
     } catch (err) {
       rolledBack = `failed: ${err?.message ?? err}. Restore ${checkpointId} with restore_checkpoint.`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goatedit-mcp",
-  "version": "1.1.8",
+  "version": "1.1.9",
   "description": "Local MCP server for the GoatEdit video editor: drive your open editor tab from Claude Code or any MCP client",
   "license": "UNLICENSED",
   "type": "module",