@instavar/mcp-server 0.2.2 → 0.3.0

package/dist/index.js

@@ -153,6 +153,7 @@ var briefSceneSchema = z.object({
     "custom"
   ]),
   durationInFrames: z.number().optional(),
+  narrationText: z.string().optional(),
   title: z.string().optional(),
   subtitle: z.string().optional(),
   text: z.string().optional(),
@@ -172,7 +173,13 @@ var briefSceneSchema = z.object({
   totalSteps: z.number().optional(),
   items: z.array(z.object({ label: z.string(), value: z.number() })).optional(),
   src: z.string().optional(),
-  caption: z.string().optional()
+  caption: z.string().optional(),
+  // A-roll generation (video-window scenes): source "generate" triggers
+  // flag-gated WaveSpeed image/video gen server-side from generatePrompt;
+  // "url" (default) uses src as-is. Kept in sync with the app's
+  // briefSceneSchema - see the parity test in the app suite.
+  source: z.enum(["url", "generate"]).optional(),
+  generatePrompt: z.string().optional()
 });
 var directionsBriefSchema = z.object({
   subtitle: z.string().optional(),
@@ -221,8 +228,15 @@ var createBriefShape = {
   lessonTitle: z.string().optional().describe("Display title rendered inside the video"),
   steps: z.array(briefStepSchema).optional().describe("Structured steps for educational content (LaTeX)"),
   scenes: z.array(briefSceneSchema).optional().describe("Scene graph for the UniversalVideo composition"),
-  aspectRatio: z.enum(ASPECT_RATIOS).default("9:16").describe("Aspect ratio (default 9:16)"),
+  // No zod .default() here: a default would materialize into the parsed tool
+  // arguments and relay to /api/v1/jobs as if the caller stated it, corrupting
+  // the resolution provenance the API echoes back. Unset must stay absent;
+  // the API re-applies 9:16 server-side.
+  aspectRatio: z.enum(ASPECT_RATIOS).optional().describe("Aspect ratio (defaults to 9:16 when omitted)"),
   compositionId: z.string().optional().describe("Remotion composition ID override (advanced)"),
+  voiceId: z.string().optional().describe(
+    "TTS narrator voice ID. Unknown IDs are rejected before rendering; when omitted, the org's saved voice preference or the system default is used and reported in the response's resolution block."
+  ),
   directions: directionsBriefSchema.optional().describe(
     "DirectionsWalkthrough 'find-us' payload: source clips (legs), decision-point cues on the realtime walk timeline, outro, and optional music. Set compositionId 'DirectionsWalkthrough' (or objective 'directions')."
   )
@@ -241,6 +255,9 @@ var editBriefShape = {
   ),
   publishTarget: z.enum(PUBLISH_TARGETS).optional().describe(
     "Updated target social platform. Distribution metadata only - does not trigger a re-render."
+  ),
+  voiceId: z.string().optional().describe(
+    "Updated TTS narrator voice ID. Triggers a re-render with the new voice."
   )
 };
 
@@ -353,7 +370,7 @@ function registerTools(server) {
     "edit_video_brief",
     {
       title: "Edit video brief",
-      description: "Edit an existing job's brief (only provided fields change). Changing the script, caption, title, lessonTitle, objective, steps, scenes or aspectRatio triggers a re-render and returns the new run ID; objective also re-routes the composition. Changing only publishTarget updates the job's target platform without re-rendering. For a brand-new video use create_video_brief.",
+      description: "Edit an existing job's brief (only provided fields change). Changing the script, caption, title, lessonTitle, objective, steps, scenes, aspectRatio or voiceId triggers a re-render and returns the new run ID; objective also re-routes the composition. Changing only publishTarget updates the job's target platform without re-rendering. For a brand-new video use create_video_brief.",
       inputSchema: editBriefShape,
       annotations: SAFE_WRITE
     },
@@ -461,7 +478,7 @@ function registerTools(server) {
 // package.json
 var package_default = {
   name: "@instavar/mcp-server",
-  version: "0.2.2",
+  version: "0.3.0",
   mcpName: "com.instavar/mcp-server",
   description: "Instavar Studio MCP server \u2014 drive the full video create\u2192render\u2192approve\u2192publish\u2192metrics workflow from Claude Code or Codex with an API key.",
   type: "module",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instavar/mcp-server",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "mcpName": "com.instavar/mcp-server",
   "description": "Instavar Studio MCP server — drive the full video create→render→approve→publish→metrics workflow from Claude Code or Codex with an API key.",
   "type": "module",