@vibeframe/mcp-server 0.113.3 → 0.113.5

package/dist/index.js

@@ -472894,6 +472894,14 @@ async function createBuildPlan(opts) {
       duration: beat.duration,
       keyframe: keyframePrompt
     }) : null;
+    const keyframeCache2 = keyframePrompt ? keyframeCacheDescriptor({
+      beatId: beat.id,
+      cue: keyframePrompt,
+      provider: resolved.image.resolved,
+      quality: imageQuality,
+      size: imageSize2,
+      ratio: imageRatio
+    }) : null;
     const musicCache = musicPrompt && !musicReference ? musicCacheDescriptor({
       beatId: beat.id,
       cue: musicPrompt,
@@ -472929,6 +472937,19 @@ async function createBuildPlan(opts) {
       cost: backdropCostUsd(imageQuality),
       active: includeAssets
     }) : null;
+    const keyframe = keyframePrompt && !opts.skipKeyframe ? assetPlan({
+      kind: "keyframe",
+      beatId: beat.id,
+      cue: keyframePrompt,
+      provider: resolved.image.resolved,
+      path: `assets/keyframe-${beat.id}.png`,
+      cache: keyframeCache2,
+      reference: null,
+      projectDir,
+      force: opts.force,
+      cost: backdropCostUsd(imageQuality),
+      active: includeAssets
+    }) : null;
     const video = videoCue && !opts.skipVideo ? assetPlan({
       kind: "video",
       beatId: beat.id,
@@ -472961,7 +472982,7 @@ async function createBuildPlan(opts) {
     }) : null;
     const compositionPath = `compositions/scene-${beat.id}.html`;
     const compositionExists = existsSync33(join30(projectDir, compositionPath));
-    for (const asset of [narration, backdrop, video, music]) {
+    for (const asset of [narration, backdrop, keyframe, video, music]) {
       if (!asset) continue;
       if (asset.referenceError) {
         missing.add("assets");
@@ -472986,13 +473007,9 @@ async function createBuildPlan(opts) {
     if (narration?.willGenerate) noteProviderNeed(resolved.narration, "Narration");
     if (backdrop?.willGenerate && isSupportedBuildImageProvider(resolved.image.resolved))
       noteProviderNeed(resolved.image, "Backdrop generation");
+    if (keyframe?.willGenerate && isSupportedBuildImageProvider(resolved.image.resolved))
+      noteProviderNeed(resolved.image, "Keyframe generation");
     if (video?.willGenerate) noteProviderNeed(resolved.video, "Video generation");
-    if (keyframePrompt && video?.willGenerate) {
-      estimatedCostUsd += backdropCostUsd(imageQuality);
-      providers.add(resolved.image.resolved);
-      if (isSupportedBuildImageProvider(resolved.image.resolved))
-        noteProviderNeed(resolved.image, "Keyframe generation");
-    }
     if (music?.willGenerate) noteProviderNeed(resolved.music, "Music generation");
     if (!compositionExists) missing.add("compositions");
     if (includeCompose && !compositionExists && mode !== "agent") {
@@ -473005,7 +473022,7 @@ async function createBuildPlan(opts) {
       heading: beat.heading,
       durationSec: beat.duration ?? null,
       cues: cue,
-      assets: { narration, backdrop, video, music },
+      assets: { narration, backdrop, keyframe, video, music },
       composition: {
         path: compositionPath,
         exists: compositionExists
@@ -473221,6 +473238,7 @@ function providerResolutionsForPlan(resolved, beats, opts, includeAssets) {
   return [
     includeAssets && !opts.skipNarration && needsProvider("narration") ? resolved.narration : null,
     includeAssets && !opts.skipBackdrop && needsProvider("backdrop") ? resolved.image : null,
+    includeAssets && !opts.skipKeyframe && needsProvider("keyframe") ? resolved.image : null,
     includeAssets && !opts.skipVideo && needsProvider("video") ? resolved.video : null,
     includeAssets && !opts.skipMusic && needsProvider("music") ? resolved.music : null,
     resolved.composer ?? null
@@ -473781,10 +473799,17 @@ async function executeSceneBuild(opts) {
   const onProgress = opts.onProgress ?? (() => {
   });
   const mode = resolveSceneBuildMode(opts);
-  const selectedStage = opts.stage ?? (opts.skipRender ? "sync" : "all");
+  let selectedStage = opts.stage ?? (opts.skipRender ? "sync" : "all");
+  const skipVideoStopsRender = (opts.skipVideo ?? false) && (selectedStage === "all" || selectedStage === "render");
+  if (skipVideoStopsRender) selectedStage = "sync";
   const stageReports = createEmptyStageReports();
   const warnings = [];
   const retryWith = [];
+  if (skipVideoStopsRender) {
+    warnings.push(
+      "--skip-video: skipped render (no clips to capture). Review assets/keyframe-*.png, then build without --skip-video to animate them."
+    );
+  }
   let sceneRepair = skippedSceneRepairSummary();
   const storyboardPath = join31(projectDir, "STORYBOARD.md");
   const buildPlan = await createBuildPlan({
@@ -473795,6 +473820,7 @@ async function executeSceneBuild(opts) {
     skipNarration: opts.skipNarration,
     skipBackdrop: opts.skipBackdrop,
     skipVideo: opts.skipVideo,
+    skipKeyframe: opts.skipKeyframe,
     skipMusic: opts.skipMusic,
     ttsProvider: opts.ttsProvider,
     voice: opts.voice,
@@ -473943,7 +473969,7 @@ async function executeSceneBuild(opts) {
   if (shouldRunStage(selectedStage, "assets")) {
     onProgress({ type: "phase-start", phase: "primitives" });
     const characterPaths = /* @__PURE__ */ new Map();
-    if (!(opts.skipVideo ?? false)) {
+    if (!((opts.skipVideo ?? false) && (opts.skipKeyframe ?? false))) {
       const referenced = /* @__PURE__ */ new Set();
       for (const beat of activeBeats) {
         for (const name of beatCharacterNames(beat.cues)) referenced.add(name);
@@ -473980,6 +474006,7 @@ async function executeSceneBuild(opts) {
         skipNarration: opts.skipNarration ?? false,
         skipBackdrop: opts.skipBackdrop ?? false,
         skipVideo: opts.skipVideo ?? false,
+        skipKeyframe: opts.skipKeyframe ?? false,
         skipMusic: opts.skipMusic ?? false,
         force: opts.force ?? false,
         onProgress,
@@ -474356,10 +474383,11 @@ async function executeSceneBuild(opts) {
   });
 }
 async function buildBeatPrimitives(beat, ctx) {
+  const keyframe = ctx.skipKeyframe ? await skipped("keyframe", beat.id, "--skip-keyframe", ctx) : await dispatchKeyframe(beat, ctx);
   const [narration, backdrop, video, music] = await Promise.all([
     ctx.skipNarration ? skipped("narration", beat.id, "--skip-narration", ctx) : dispatchNarration(beat, ctx),
     ctx.skipBackdrop ? skipped("backdrop", beat.id, "--skip-backdrop", ctx) : dispatchBackdrop(beat, ctx),
-    ctx.skipVideo ? skipped("video", beat.id, "--skip-video", ctx) : dispatchVideo(beat, ctx),
+    ctx.skipVideo ? skipped("video", beat.id, "--skip-video", ctx) : dispatchVideo(beat, ctx, keyframe),
     ctx.skipMusic ? skipped("music", beat.id, "--skip-music", ctx) : dispatchMusic(beat, ctx)
   ]);
   return {
@@ -474403,8 +474431,8 @@ async function buildBeatPrimitives(beat, ctx) {
       videoMetadataPath: video.metadataPath,
       videoFreshness: video.freshness,
       videoSourcePath: video.sourcePath,
-      keyframeStatus: video.keyframeStatus,
-      keyframePath: video.keyframePath,
+      keyframeStatus: keyframe.status,
+      keyframePath: keyframe.path,
       musicStatus: music.status,
       musicPath: music.path,
       musicJobId: music.job?.id,
@@ -474975,7 +475003,21 @@ function imageProviderKeyInfo(provider) {
   if (provider === "grok") return { configKey: "xai", envVar: "XAI_API_KEY" };
   return { configKey: "openai", envVar: "OPENAI_API_KEY" };
 }
-async function dispatchVideo(beat, ctx) {
+async function dispatchKeyframe(beat, ctx) {
+  const keyframeCue = stringOrUndefined4(beat.cues?.keyframe);
+  if (!keyframeCue) return { status: "no-cue" };
+  const characterRefsRel = beatCharacterNames(beat.cues).map((name) => ctx.characterPaths?.get(name)).filter((p2) => typeof p2 === "string");
+  const kf = await ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel);
+  if (kf.status === "failed") {
+    ctx.onProgress({ type: "keyframe-failed", beatId: beat.id, error: kf.error });
+    return { status: "failed", error: kf.error };
+  }
+  ctx.onProgress(
+    kf.status === "cached" ? { type: "keyframe-cached", beatId: beat.id, path: kf.rel } : { type: "keyframe-generated", beatId: beat.id, path: kf.rel, provider: ctx.imageProvider }
+  );
+  return { status: kf.status, path: kf.rel, provider: ctx.imageProvider };
+}
+async function dispatchVideo(beat, ctx, keyframe) {
   const reference = assetReferenceForBeat(ctx.projectDir, "video", beat);
   if (reference) return referencePrimitiveOutcome("video", beat, ctx, reference);
   const keyframeCue = stringOrUndefined4(beat.cues?.keyframe);
@@ -475045,20 +475087,14 @@ async function dispatchVideo(beat, ctx) {
       freshness: "fresh"
     };
   }
-  loadSceneBuildEnv(ctx.projectDir);
-  let keyframeStatus;
-  let keyframeRel;
-  let keyframeImageAbs;
-  if (keyframeCue) {
-    const kf = await ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel);
-    if (kf.status === "failed") {
-      ctx.onProgress({ type: "video-failed", beatId: beat.id, error: kf.error });
-      return { status: "failed", error: kf.error };
-    }
-    keyframeStatus = kf.status;
-    keyframeRel = kf.rel;
-    keyframeImageAbs = join31(ctx.projectDir, kf.rel);
+  const keyframeImageRel = keyframeCue && (keyframe.status === "generated" || keyframe.status === "cached") ? keyframe.path : void 0;
+  if (keyframeCue && !keyframeImageRel) {
+    const reason = keyframe.status === "failed" ? `keyframe unavailable: ${keyframe.error ?? "generation failed"}` : "keyframe not generated (build without --skip-keyframe first)";
+    ctx.onProgress({ type: "video-skipped", beatId: beat.id, reason });
+    return { status: "skipped" };
   }
+  const keyframeImageAbs = keyframeImageRel ? join31(ctx.projectDir, keyframeImageRel) : void 0;
+  loadSceneBuildEnv(ctx.projectDir);
   const result = await executeVideoGenerate({
     prompt: prompt3,
     provider: ctx.videoProvider,
@@ -475104,9 +475140,7 @@ async function dispatchVideo(beat, ctx) {
       cachePath: cache.path,
       cacheKey: cache.key,
       metadataPath,
-      freshness: "fresh",
-      keyframeStatus,
-      keyframePath: keyframeRel
+      freshness: "fresh"
     };
   }
   const job = await createAndWriteJobRecord({
@@ -475138,9 +475172,7 @@ async function dispatchVideo(beat, ctx) {
     provider: job.provider,
     cachePath: cache.path,
     cacheKey: cache.key,
-    metadataPath,
-    keyframeStatus,
-    keyframePath: keyframeRel
+    metadataPath
   };
 }
 async function dispatchMusic(beat, ctx) {
@@ -499699,7 +499731,7 @@ var server2 = new Server(
   {
     name: "vibeframe",
     // Stamped with the package version by build.js at bundle time.
-    version: "0.113.3"
+    version: "0.113.5"
   },
   {
     capabilities: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/mcp-server",
-  "version": "0.113.3",
+  "version": "0.113.5",
   "description": "VibeFrame MCP Server - AI-native video editing via Model Context Protocol",
   "type": "module",
   "bin": {
@@ -60,8 +60,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/cli": "0.113.3",
-    "@vibeframe/core": "0.113.3"
+    "@vibeframe/cli": "0.113.5",
+    "@vibeframe/core": "0.113.5"
   },
   "engines": {
     "node": ">=20"