@vibeframe/mcp-server 0.104.1 → 0.104.3

package/dist/index.js

@@ -7613,7 +7613,7 @@ YAML cues that drive narration, backdrop generation, and timing.
 
 \`\`\`yaml
 narration: "Introduce the promise in one crisp sentence."
-backdrop: "Cinematic abstract technology backdrop, precise light, premium editorial feel"
+backdrop: "Topic-aligned editorial background plate, abstract visual system, no readable text, no logos, no consumer products, clean negative space for HTML overlays"
 duration: 4
 \`\`\`
 
@@ -7624,7 +7624,7 @@ screen and one spoken breath.
 
 \`\`\`yaml
 narration: "Show the mechanism or proof point that makes the promise believable."
-backdrop: "Layered interface details, subtle motion trails, high-contrast product storytelling"
+backdrop: "Topic-aligned analytical background plate, abstract dashboard structure, no readable text, no product photos, no shoes, no unrelated objects"
 duration: 4
 \`\`\`
 
@@ -7635,7 +7635,7 @@ before/after.
 
 \`\`\`yaml
 narration: "Close with the action the viewer should remember."
-backdrop: "Resolved hero frame, confident final composition, clean negative space"
+backdrop: "Resolved editorial background plate, confident final composition, clean negative space, no readable text, no logos, no unrelated products"
 duration: 4
 \`\`\`
 
@@ -7688,6 +7688,25 @@ consult this file \u2014 run the generate command directly.
 Browse named styles: \`vibe scene list-styles\`. Re-seed from one with
 \`vibe scene init . --visual-style "Swiss Pulse"\` (idempotent).
 
+## Provider keys and project scope
+
+Use VibeFrame CLI generation for project assets:
+\`vibe generate image|video|speech ...\`. This lets VibeFrame use keys
+from \`vibe setup --scope project\`.
+
+Project-scope keys may live in a parent directory, for example
+\`../.vibeframe/config.yaml\` when this scene was created by
+\`vibe init launch\`. The \`vibe\` CLI searches upward automatically, so do
+not decide keys are missing just because \`.vibeframe/config.yaml\` is not
+inside this scene folder.
+
+To verify scope without exposing secrets, run \`vibe doctor --json\` from
+this directory and inspect \`data.scope.activeScope\` plus
+\`data.scope.project.configPath\`. Never print config contents. Do not use
+a host agent's built-in image/audio generation tool for VibeFrame project
+assets unless the user explicitly requests an external, non-VibeFrame
+asset.
+
 ## Skills \u2014 USE THESE FIRST
 
 @SKILL.md
@@ -7749,7 +7768,11 @@ npx hyperframes render
    \`\`\`
 4. Videos use \`muted\` with a separate \`<audio>\` element for the audio track.
 5. Sub-compositions use \`data-composition-src="compositions/file.html"\`.
-6. Only deterministic logic \u2014 no \`Date.now()\`, \`Math.random()\`, or network fetches.
+6. For render-stable text, do not apply continuous \`scale\`, \`x\`, \`y\`, or
+   \`filter\` tweens to \`.scene-content\` or any ancestor containing live text.
+   Animate background/media layers instead; text/cards should enter briefly and
+   then hold still at their final CSS positions.
+7. Only deterministic logic \u2014 no \`Date.now()\`, \`Math.random()\`, or network fetches.
 
 ## Linting \u2014 run after changes
 
@@ -25916,21 +25939,8 @@ async function prompt(question, hidden = false) {
   });
 }
 async function getApiKey(envVar, providerName, optionValue) {
-  if (optionValue) {
-    return optionValue;
-  }
-  const providerKey = providerKeyForEnvVar(envVar);
-  if (providerKey) {
-    const configKey = await getApiKeyFromConfig(providerKey);
-    if (configKey) {
-      return configKey;
-    }
-  }
-  loadEnv();
-  const envValue = getEnvValue2(envVar);
-  if (envValue) {
-    return envValue;
-  }
+  const configuredKey = await getConfiguredApiKey(envVar, optionValue);
+  if (configuredKey) return configuredKey;
   if (!process.stdin.isTTY) {
     return null;
   }
@@ -25951,6 +25961,19 @@ async function getApiKey(envVar, providerName, optionValue) {
   }
   return apiKey.trim();
 }
+async function getConfiguredApiKey(envVar, optionValue, options = {}) {
+  if (optionValue) return optionValue;
+  const providerKey = providerKeyForEnvVar(envVar);
+  if (providerKey) {
+    const configKey = await getApiKeyFromConfig(providerKey, { cwd: options.cwd });
+    if (configKey) return configKey;
+  }
+  loadEnv();
+  return getEnvValue2(envVar);
+}
+async function hasConfiguredApiKey(envVar, optionValue, options = {}) {
+  return Boolean(await getConfiguredApiKey(envVar, optionValue, options));
+}
 function hasApiKey(envVar) {
   loadEnv();
   return !!getEnvValue2(envVar);
@@ -26047,7 +26070,7 @@ var init_api_key = __esm({
 
 // ../cli/src/commands/_shared/tts-resolve.ts
 async function resolveTtsProvider(preferred = "auto") {
-  const choice = preferred === "auto" ? hasApiKey("ELEVENLABS_API_KEY") ? "elevenlabs" : "kokoro" : preferred;
+  const choice = preferred === "auto" ? await getConfiguredApiKey("ELEVENLABS_API_KEY") ? "elevenlabs" : "kokoro" : preferred;
   if (choice === "elevenlabs") {
     return buildElevenLabs();
   }
@@ -26091,7 +26114,6 @@ var init_tts_resolve = __esm({
     "use strict";
     init_dist();
     init_api_key();
-    init_api_key();
     TtsKeyMissingError = class extends Error {
       constructor(provider) {
         super(
@@ -449161,13 +449183,18 @@ Requirements (non-negotiable):
   producer's seek lands past the timeline's natural end and visibility state
   goes stale \u2014 the hold phase renders BLACK. Anchor the timeline to the full
   beat duration via either:
-    1. A subtle idle motion spanning 0\u2192duration on a parent element, e.g.
-       \`tl.fromTo(".scene-content", { scale: 1.0 }, { scale: 1.015, duration: <beat>, ease: "none" }, 0);\`
+    1. A subtle idle motion spanning 0\u2192duration on a background/media layer,
+       e.g. \`tl.fromTo(".backdrop", { scale: 1.0 }, { scale: 1.015, duration: <beat>, ease: "none" }, 0);\`
        (Ken-Burns, breathing opacity, gradient drift \u2014 should be barely
        perceptible so it doesn't compete with entry/exit beats).
     2. OR an explicit \`tl.set(target, { ...natural state... }, <beat - 0.001>)\`
        anchor at the end.
   This is the #2 source of "text disappears mid-beat" bugs after \`.clip\` sizing.
+- Do not apply continuous \`scale\`, \`x\`, \`y\`, \`filter\`, or other transform
+  tweens to \`.scene-content\` or any ancestor that contains live text/cards.
+  Animate the backdrop/media plane instead; let text enter briefly, then hold
+  still at its final CSS position. Continuous transforms on text ancestors can
+  create subpixel shimmer in screenshot-captured renders.
 - Timed children inside the composition have \`class="clip"\` plus
   \`data-start\`, \`data-duration\`, \`data-track-index\`.
 - If \`assets/backdrop-${ctx.beat.id}.png\` exists, use that local file as the
@@ -449237,7 +449264,9 @@ Reference shape (verbatim \u2014 match this skeleton exactly, no DOCTYPE / html
       const tl = gsap.timeline({ paused: true });
       // Idle motion spanning full beat duration \u2014 required to keep timeline
       // length aligned with data-duration (otherwise hold phase goes black).
-      tl.fromTo(".scene-content", { scale: 1.0 }, { scale: 1.015, duration: <sec>, ease: "none" }, 0);
+      // Keep continuous motion on the background/media layer so live text does
+      // not shimmer from subpixel resampling.
+      tl.fromTo(".backdrop", { scale: 1.0 }, { scale: 1.015, duration: <sec>, ease: "none" }, 0);
       // entry tweens
       window.__timelines["${compositionId}"] = tl;
     </script>
@@ -451179,6 +451208,32 @@ var init_build_asset_metadata = __esm({
   }
 });
 
+// ../cli/src/commands/_shared/build-backdrop-prompt.ts
+function augmentBackdropPrompt(cue) {
+  const trimmed = cue.trim();
+  const lower = trimmed.toLowerCase();
+  const requestsTextOrMarks = /\b(text|typography|title|headline|label|caption|logo|logos|wordmark|brand mark|brand marks)\b/.test(lower);
+  const forbidsTextOrMarks = /\b(no|without|avoid)\s+(readable\s+)?(text|typography|titles?|headlines?|labels?|captions?|brand\s+logos?|logos?|wordmarks?|brand\s+marks?)\b/.test(
+    lower
+  );
+  const allowsTextOrMarks = requestsTextOrMarks && !forbidsTextOrMarks;
+  const overlayContract = allowsTextOrMarks ? "The image is a video background or end-card plate; do not add any text, logos, charts, or UI beyond what the scene cue explicitly requests." : "The image is a background only; HTML overlays will provide all final text, charts, logos, and UI labels.";
+  const textRule = allowsTextOrMarks ? "If text, logos, or brand marks are explicitly requested, keep them minimal, legible, and do not invent extras." : "No readable text, labels, UI copy, logos, brand marks, watermarks, or invented typography.";
+  return [
+    "Create a 16:9 video background plate for a HyperFrames scene.",
+    overlayContract,
+    `Scene cue: ${trimmed}`,
+    textRule,
+    "Avoid unrelated consumer product photography, shoes, packaging, food, people, celebrity faces, advertisements, and random objects unless explicitly requested by the scene cue.",
+    "Leave generous negative space for overlay text and cards. Keep the result topic-aligned, editorial, cinematic, and non-distracting."
+  ].join(" ");
+}
+var init_build_backdrop_prompt = __esm({
+  "../cli/src/commands/_shared/build-backdrop-prompt.ts"() {
+    "use strict";
+  }
+});
+
 // ../cli/src/commands/_shared/storyboard-edit.ts
 function validateStoryboardMarkdown(markdown) {
   const parsed = parseStoryboard(markdown);
@@ -451463,6 +451518,7 @@ async function createBuildPlan(opts) {
     const voice = stringOrUndefined3(cue.voice) ?? resolved.voice;
     const narrationText = stringOrUndefined3(cue.narration);
     const backdropPrompt = stringOrUndefined3(cue.backdrop);
+    const augmentedBackdropPrompt = backdropPrompt ? augmentBackdropPrompt(backdropPrompt) : null;
     const videoPrompt = stringOrUndefined3(cue.video);
     const musicPrompt = stringOrUndefined3(cue.music);
     const genericReference = resolveGenericAssetReference(projectDir, cue.asset);
@@ -451482,9 +451538,9 @@ async function createBuildPlan(opts) {
       voice,
       ext: resolved.narration.resolved === "elevenlabs" ? "mp3" : "wav"
     }) : null;
-    const backdropCache = backdropPrompt && !backdropReference ? backdropCacheDescriptor({
+    const backdropCache = augmentedBackdropPrompt && !backdropReference ? backdropCacheDescriptor({
       beatId: beat.id,
-      cue: backdropPrompt,
+      cue: augmentedBackdropPrompt,
       provider: resolved.image.resolved,
       quality: imageQuality,
       size: imageSize2,
@@ -452014,6 +452070,7 @@ var init_build_plan = __esm({
     init_build_asset_reference();
     init_build_cache();
     init_build_asset_metadata();
+    init_build_backdrop_prompt();
     init_composer_resolve();
     init_storyboard_parse();
     init_project_config();
@@ -452436,7 +452493,7 @@ async function executeVideoGenerate(options) {
       fal: "FAL_API_KEY"
     };
     const envKey = envKeyMap[provider] || "";
-    const key2 = apiKey || (hasApiKey(envKey) ? process.env[envKey] : void 0);
+    const key2 = await getConfiguredApiKey(envKey, apiKey);
     if (!key2) return { success: false, error: `${envKeyMap[provider]} required for ${provider}` };
     let referenceImage;
     let referenceImageBuffer;
@@ -452868,7 +452925,7 @@ var init_validate = __esm({
 // ../cli/src/commands/generate/music-status.ts
 async function executeMusicStatus(options) {
   try {
-    const apiKey = options.apiKey ?? (hasApiKey("REPLICATE_API_TOKEN") ? await getApiKeyFromConfig("replicate") || process.env.REPLICATE_API_TOKEN : null);
+    const apiKey = await getConfiguredApiKey("REPLICATE_API_TOKEN", options.apiKey);
     if (!apiKey)
       return { success: false, error: "REPLICATE_API_TOKEN required for music status" };
     const replicate = new ReplicateProvider();
@@ -452941,7 +452998,6 @@ var init_music_status = __esm({
     init_source();
     init_dist();
     init_api_key();
-    init_config();
     init_output();
   }
 });
@@ -453741,7 +453797,7 @@ async function executeMusic(options) {
   try {
     const provider = options.provider || "elevenlabs";
     if (provider === "elevenlabs") {
-      const apiKey2 = hasApiKey("ELEVENLABS_API_KEY") ? await getApiKeyFromConfig("elevenlabs") || process.env.ELEVENLABS_API_KEY : null;
+      const apiKey2 = await getConfiguredApiKey("ELEVENLABS_API_KEY");
       if (!apiKey2)
         return {
           success: false,
@@ -453761,7 +453817,7 @@ async function executeMusic(options) {
       await writeFile18(outputPath2, result2.audioBuffer);
       return { success: true, outputPath: outputPath2, provider: "elevenlabs", duration: duration2 };
     }
-    const apiKey = hasApiKey("REPLICATE_API_TOKEN") ? await getApiKeyFromConfig("replicate") || process.env.REPLICATE_API_TOKEN : null;
+    const apiKey = await getConfiguredApiKey("REPLICATE_API_TOKEN");
     if (!apiKey)
       return {
         success: false,
@@ -453996,7 +454052,6 @@ var init_music = __esm({
     init_ora();
     init_dist();
     init_api_key();
-    init_config();
     init_output();
     init_validate();
     init_status_jobs();
@@ -454770,8 +454825,9 @@ async function dispatchNarration(beat, ctx) {
 async function dispatchBackdrop(beat, ctx) {
   const reference = assetReferenceForBeat(ctx.projectDir, "backdrop", beat);
   if (reference) return referencePrimitiveOutcome("backdrop", beat, ctx, reference);
-  const prompt3 = stringOrUndefined4(beat.cues?.backdrop);
-  if (!prompt3) return { status: "no-cue" };
+  const cue = stringOrUndefined4(beat.cues?.backdrop);
+  if (!cue) return { status: "no-cue" };
+  const prompt3 = augmentBackdropPrompt(cue);
   const rel = `assets/backdrop-${beat.id}.png`;
   const abs = join33(ctx.projectDir, rel);
   const size = ctx.imageSize ?? "1536x1024";
@@ -455749,6 +455805,7 @@ var init_scene_build = __esm({
     init_root_sync();
     init_build_cache();
     init_build_asset_metadata();
+    init_build_backdrop_prompt();
     init_ai_video();
     init_music();
     init_status_jobs();
@@ -462409,7 +462466,7 @@ import { resolve as resolve54 } from "node:path";
 import { writeFile as writeFile32 } from "node:fs/promises";
 async function executeSoundEffect(options) {
   try {
-    const apiKey = hasApiKey("ELEVENLABS_API_KEY") ? await getApiKeyFromConfig("elevenlabs") || process.env.ELEVENLABS_API_KEY : null;
+    const apiKey = await getConfiguredApiKey("ELEVENLABS_API_KEY");
     if (!apiKey)
       return {
         success: false,
@@ -462508,7 +462565,6 @@ var init_sound_effect = __esm({
     init_ora();
     init_dist();
     init_api_key();
-    init_config();
     init_output();
     init_validate();
   }
@@ -462590,7 +462646,7 @@ import { resolve as resolve55, dirname as dirname30 } from "node:path";
 import { writeFile as writeFile33, mkdir as mkdir23 } from "node:fs/promises";
 async function executeBackground(options) {
   try {
-    const apiKey = options.apiKey ?? (hasApiKey("OPENAI_API_KEY") ? await getApiKeyFromConfig("openai") || process.env.OPENAI_API_KEY : null);
+    const apiKey = await getConfiguredApiKey("OPENAI_API_KEY", options.apiKey);
     if (!apiKey)
       return { success: false, error: "OPENAI_API_KEY required for background generation" };
     const openaiImage = new OpenAIImageProvider();
@@ -462721,7 +462777,6 @@ var init_background = __esm({
     init_ora();
     init_dist();
     init_api_key();
-    init_config();
     init_output();
     init_validate();
   }
@@ -462962,7 +463017,7 @@ import { resolve as resolve57 } from "node:path";
 import { writeFile as writeFile35 } from "node:fs/promises";
 async function executeSpeech(options) {
   try {
-    const apiKey = hasApiKey("ELEVENLABS_API_KEY") ? await getApiKeyFromConfig("elevenlabs") || process.env.ELEVENLABS_API_KEY : null;
+    const apiKey = await getConfiguredApiKey("ELEVENLABS_API_KEY");
     if (!apiKey)
       return {
         success: false,
@@ -463177,7 +463232,6 @@ var init_speech = __esm({
     init_dist();
     init_api_key();
     init_tty();
-    init_config();
     init_output();
     init_validate();
   }
@@ -463978,7 +464032,7 @@ Examples:
             )
           );
         }
-        if (providerEnvMap[provider] && !hasApiKey(providerEnvMap[provider]) && !options.apiKey) {
+        if (providerEnvMap[provider] && !await hasConfiguredApiKey(providerEnvMap[provider], options.apiKey)) {
           const resolved = resolveProvider("image");
           if (resolved) {
             log(source_default.dim(`  ${provider} key not found. Using ${resolved.label} instead.`));
@@ -465418,7 +465472,7 @@ Examples:
           );
           provider = "seedance";
         }
-        if (videoEnvMap[provider] && !hasApiKey(videoEnvMap[provider]) && !options.apiKey) {
+        if (videoEnvMap[provider] && !await hasConfiguredApiKey(videoEnvMap[provider], options.apiKey)) {
           const resolved = resolveProvider("video");
           if (resolved) {
             log(source_default.dim(`  ${provider} key not found. Using ${resolved.label} instead.`));

package/package.json

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