goatedit-mcp 1.1.10 → 1.1.12

package/bundle/goatedit-mcp.js

@@ -19858,6 +19858,11 @@ var HIDE_CLIP_IDS = {
   items: { type: "string" },
   description: "Render as if these clips were not there. The timeline is not changed."
 };
+var TEXT_BOX_PROPS = {
+  wrapWidth: num("Widest a line may run before it wraps, as a fraction of the frame width (0.05\u20131). Defaults to about 0.86. Set it to keep body copy inside a column or a card."),
+  anchorX: num("Which point of the text block posX places: 0 its left edge, 0.5 its centre (default), 1 its right edge. Use 0 for left-aligned text so its left edge stays put when the words change."),
+  anchorY: num("Which point of the text block posY places: 0 its top, 0.5 its middle (default), 1 its bottom.")
+};
 var TEXT_STYLE_PROPS = {
   fontSize: num("Font size in pixels, authored against a 1080p-tall frame."),
   fontFamily: str("Font family name."),
@@ -19885,6 +19890,8 @@ var TEXT_STYLE_PROPS = {
   textAccentColor: str("Colour for accent words. Mark an accent word in the text as *word*."),
   textAccentFontFamily: str(`Font for accent words, e.g. "'Great Vibes', cursive" for a script word inside heavy caps.`),
   textAccentScale: num("Size of accent words relative to the rest, e.g. 1.8."),
+  textAccentFontWeight: { type: ["number", "string"], description: `Weight of accent words, 100\u2013900, "normal" or "bold". Default: bold with an accent font, else the text's own weight.` },
+  textAccentFontStyle: { type: "string", enum: ["normal", "italic"], description: "Slant of accent words. Default: italic with an accent font, else the text's own style." },
   textAccentGradientStart: str("Gradient start colour for accent words."),
   textAccentGradientEnd: str("Gradient end colour for accent words."),
   textSwooshUnderline: bool("Hand-drawn swoosh under the last line."),
@@ -19930,7 +19937,8 @@ var BASE_TOOLS = [
         mediaFileId: str("Media bin file id. Omit to list every source that has a transcript."),
         startTime: num("Only return segments overlapping at or after this source time, in seconds."),
         endTime: num("Only return segments overlapping before this source time, in seconds."),
-        includeWords: bool("Include per-word timings. Defaults to true; set false for a much smaller payload.")
+        includeWords: bool("Include per-word timings. Defaults to true; set false for a much smaller payload."),
+        onTimeline: bool("Return the words as they fall on the open sequence, through every cut and trim, in timeline seconds \u2014 what to time captions and shots against after the footage is edited. mediaFileId and the time range are ignored.")
       }
     },
     method: "getTranscript"
@@ -20053,6 +20061,18 @@ var BASE_TOOLS = [
     inputSchema: { type: "object", properties: {} },
     method: "listSequences"
   },
+  {
+    name: "export_design",
+    description: "A sequence as design JSON \u2014 the format the Designs panel saves and inserts, with every sequence nested in it. Text, HTML and shape layers travel whole; media files are listed under files and not included. Read-only.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sequenceId: str("The sequence to export. Default: the open one."),
+        name: str("Name to give the design. Default: the sequence name.")
+      }
+    },
+    method: "exportDesign"
+  },
   {
     name: "create_sequence",
     description: "Make a new, empty sequence. It takes the project's frame size and rate unless width, height or fps say otherwise, and can be given a fixed length. By default it opens, so the edits that follow build it; pass open: false to stay where you are and place it later with add_sequence_clip. Returns its id.",
@@ -20267,7 +20287,8 @@ var BASE_TOOLS = [
         duration: num("How long the card stays on screen, in seconds."),
         startTime: num("Where it starts on the timeline, in seconds. Defaults to 0."),
         trackId: str("Target video track. Defaults to the topmost one that is free across the card\u2019s span, creating a new track above everything if none is free."),
-        ...TEXT_STYLE_PROPS
+        ...TEXT_STYLE_PROPS,
+        ...TEXT_BOX_PROPS
       },
       required: ["text", "duration"]
     },
@@ -20281,7 +20302,8 @@ var BASE_TOOLS = [
       properties: {
         clipId: CLIP_ID,
         text: str("New text. Omit to change only the styling."),
-        ...TEXT_STYLE_PROPS
+        ...TEXT_STYLE_PROPS,
+        ...TEXT_BOX_PROPS
       },
       required: ["clipId"]
     },
@@ -21553,7 +21575,7 @@ var BASE_TOOLS = [
   },
   {
     name: "studio_tasks",
-    description: 'The work GoatEdit Studio has for you in this project. Studio makes a video in stages (brief, research, script, breakdown (the script cut into parts), moodboard, styleGuide (the design language every part follows), storyboard, edit plan, combine (the parts joined into the final edit plan), timeline, mix, QC, export, plus any the user added, whose ids start "x-" and whose document is {"notes": string, "points"?: string[]}); a stage opens once the stages it reads are approved, so several are often open at once. Each task is kind "write" (write that stage\'s JSON document: follow `role` as your system prompt, read `inputs`, follow `lessons` when present (what this user has asked for before), and if `previousDraft` is there, revise it using `note` and `problems`) or kind "run" (ask the tab to do it with studio_run_stage). Open tasks in one run do not depend on each other: hand each to its own subagent and do them side by side. When a task names an `agent`, the user wants that subagent or skill of yours on it: hand the task to the subagent with that name, or use the skill with that name. In a batch of reels each run has `batch` (reel number, name, avatar); stages listed in batch.filled are filled by Studio itself (the locked script, the pilot\'s look), so leave them. For each write task: studio_claim it first (the person sees your agent working on that stage), then studio_submit the document. The reply to a submit names the stages it opened; call studio_tasks again for them. Stages waiting for the person are listed under waitingForPerson \u2014 stop there and tell the user to approve them in the Studio panel.',
+    description: 'The work GoatEdit Studio has for you in this project. Studio makes a video in stages (brief, research, script, breakdown (the script cut into parts), moodboard, styleGuide (the design language every part follows), storyboard, edit plan, combine (the parts joined into the final edit plan), timeline, mix, QC, export, plus any the user added, whose ids start "x-" and whose document is {"notes": string, "points"?: string[]}); a stage opens once the stages it reads are approved, so several are often open at once. Each task is kind "write" (write that stage\'s JSON document: follow `role` as your system prompt, read `inputs`, follow `lessons` when present (what this user has asked for before), and if `previousDraft` is there, revise it using `note` and `problems`) or kind "run" (ask the tab to do it with studio_run_stage). Open tasks in one run do not depend on each other: hand each to its own subagent and do them side by side. When a task names an `agent`, the user wants that subagent or skill of yours on it: hand the task to the subagent with that name, or use the skill with that name. In a batch of reels each run has `batch` (reel number, name, avatar); stages listed in batch.filled are filled by Studio itself (the locked script, the pilot\'s look), so leave them. For each write task: studio_claim it first (the person sees your agent working on that stage), then studio_submit the document. The reply to a submit names the stages it opened; call studio_tasks again for them. Stages waiting for the person are listed under waitingForPerson \u2014 stop there and tell the user to approve them in the Studio panel, unless the user told you to approve them yourself (then studio_approve).',
     inputSchema: {
       type: "object",
       properties: {
@@ -21586,12 +21608,61 @@ var BASE_TOOLS = [
         runId: str("The run, from studio_tasks."),
         stage: str("The stage id."),
         document: { type: "object", description: "The stage's document, in the shape its role card gives." },
-        agent: str("Who wrote it, as in studio_claim.")
+        agent: str("Who wrote it, as in studio_claim."),
+        part: str("For a stage written part by part (the task lists `parts`): the part id. The document then holds only that part's beats (storyboard) or scenes (edit plan), and the part is checked and shown in the Studio gallery on its own.")
       },
       required: ["runId", "stage", "document"]
     },
     method: "studioSubmit"
   },
+  {
+    name: "studio_approve",
+    description: "Approve a Studio stage that is waiting for the person (waitingForPerson in studio_tasks), on their behalf. Only when the user told you to approve it, or to run Studio on their own without stopping: otherwise tell them it is waiting for them in the Studio panel. personSaid keeps what they told you in the run's log, so the panel shows who approved it and why. A stage with rival drafts needs pick; a stage written part by part approves every part waiting. The reply names the stages that opened.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        runId: str("The run, from studio_tasks."),
+        stage: str("The stage id."),
+        agent: str('Who is approving, shown in the log ("Claude Code").'),
+        personSaid: str(`The user's words that let you approve it, e.g. "do everything by yourself".`),
+        pick: num("With rival drafts: which one, 0-based.")
+      },
+      required: ["runId", "stage"]
+    },
+    method: "studioApprove"
+  },
+  {
+    name: "studio_send_back",
+    description: "Send a Studio stage in review back to whoever writes it, with what to change; it opens again with the note. Use it when a draft you are reviewing for the user is not good enough.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        runId: str("The run, from studio_tasks."),
+        stage: str("The stage id."),
+        note: str("What to change.")
+      },
+      required: ["runId", "stage", "note"]
+    },
+    method: "studioSendBack"
+  },
+  {
+    name: "studio_update_run",
+    description: `Change a Studio run under way, for the stages still to come (approved, left-out or running stages keep theirs): who writes each stage and who approves it (the same settings as studio_save_workflow; brief, moodboard, styleGuide and export stay approved by the person), and editSequenceId: a sequence the person already edited, for the timeline and qc stages to restyle in place instead of building a new one. With editSequenceId set, timeline and qc can take writer "outside": you edit that sequence over MCP and studio_submit the stage's document. null for editSequenceId goes back to a new sequence.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        runId: str("The run, from studio_tasks."),
+        stages: {
+          type: "object",
+          description: 'Stage id to { writer?, approver?: "person" | "auto", agent?, instructions?, tier?, review?, enabled? }.',
+          additionalProperties: { type: "object" }
+        },
+        editSequenceId: { type: ["string", "null"], description: "A sequence id from list_sequences, or null." }
+      },
+      required: ["runId"]
+    },
+    method: "studioUpdateRun"
+  },
   {
     name: "studio_run_stage",
     description: `Start a Studio stage the tab does itself: "timeline" (build the edit from the approved plan) or "qc" (check it), or a stage the workflow gives to Studio's agent in the tab. Returns at once; the work goes on in the tab and the panel shows it. Poll studio_tasks to see it finish.`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goatedit-mcp",
-  "version": "1.1.10",
+  "version": "1.1.12",
   "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",