@vibeframe/cli 0.112.0 → 0.113.0

package/dist/commands/_shared/build-plan.d.ts

@@ -104,4 +104,13 @@ export interface CreateBuildPlanOptions {
     composer?: string;
     force?: boolean;
 }
+/**
+ * Honest per-image estimate for backdrop generation at 1536x1024.
+ * OpenAI GPT Image 1.5/2 (mid-2026 pricing): "standard" maps to the API's
+ * medium tier (~$0.04/image) and "hd" to high (~$0.13–0.17/image); values
+ * below add ~20% headroom for retries. The previous flat $3/image
+ * overstated real spend 15–70x and scared users away from backdrops
+ * (e.g. 7 beats quoted as ~$21 when the real cost is ~$0.35–1.40).
+ */
+export declare function backdropCostUsd(quality: "standard" | "hd"): number;
 export declare function createBuildPlan(opts: CreateBuildPlanOptions): Promise<BuildPlanResult>;

package/dist/commands/_shared/project-config.d.ts

@@ -4,7 +4,7 @@ export declare const LEGACY_VIBE_PROJECT_FILENAME = "vibe.project.yaml";
 export type CompositionEngine = "hyperframes";
 export type ProjectImageProvider = "openai" | "gemini" | "grok" | null;
 export type ProjectVideoProvider = "seedance" | "grok" | "kling" | "runway" | "veo" | null;
-export type ProjectNarrationProvider = "elevenlabs" | "kokoro" | null;
+export type ProjectNarrationProvider = "elevenlabs" | "openai" | "kokoro" | null;
 export type ProjectComposerProvider = "claude" | "openai" | "gemini" | null;
 export type ProjectQuality = "draft" | "standard" | "high";
 export interface VibeProjectConfigV1 {

package/dist/commands/_shared/scene-build.d.ts

@@ -12,7 +12,7 @@
  * Idempotent: assets that already exist on disk are reused unless `force`.
  *
  * Scope held tight for v0.60:
- *   - TTS via `resolveTtsProvider` (ElevenLabs / Kokoro auto-fallback)
+ *   - TTS via `resolveTtsProvider` (ElevenLabs / OpenAI / Kokoro auto-fallback)
  *   - T2I via OpenAI, Gemini, or Grok
  *   - No Whisper transcribe step (compose handles its own)
  *   - No root `index.html` synthesis — driver expects the project to

package/dist/commands/_shared/scene-project.d.ts

@@ -45,7 +45,7 @@ export interface VibeProjectConfig {
     /** Default providers per capability. `null` means "auto-resolve from env". */
     providers: {
         image: "openai" | "gemini" | "grok" | null;
-        tts: "elevenlabs" | "kokoro" | null;
+        tts: "elevenlabs" | "openai" | "kokoro" | null;
         transcribe: "whisper" | null;
     };
     /** Cost ceiling for `vibe remix` runs in this project. 0 disables. */

package/dist/commands/_shared/tts-resolve.d.ts

@@ -8,18 +8,21 @@
  * Routes between:
  *   - **ElevenLabs** — cloud, API-key gated, paid (~$0.02/scene). Default
  *     when `ELEVENLABS_API_KEY` is set.
- *   - **Kokoro** — local Apache 2.0 model, free, ~330MB first-call download.
+ *   - **OpenAI** — cloud gpt-4o-mini-tts, cheap (~$0.015/min of audio).
+ *     Default when only `OPENAI_API_KEY` is set — the common Claude Desktop
+ *     case where one key already covers backdrop images.
+ *   - **Kokoro** — local Apache 2.0 model, free, ~90MB first-call download.
  *     The fallback for key-less users.
  *
  * The router exposes a uniform `TtsCallable` shape so call sites don't have
- * to branch on provider id. Both providers already return the same
+ * to branch on provider id. All providers already return the same
  * `{ success, audioBuffer, error?, characterCount? }` result.
  */
 import type { KokoroLoadEvent } from "@vibeframe/ai-providers";
 /** TTS providers VibeFrame can route to. `"auto"` picks based on key availability. */
-export type TtsProviderName = "auto" | "elevenlabs" | "kokoro";
+export type TtsProviderName = "auto" | "elevenlabs" | "openai" | "kokoro";
 /** Concrete provider id surfaced in result metadata. Never `"auto"`. */
-export type ResolvedTtsProvider = "elevenlabs" | "kokoro";
+export type ResolvedTtsProvider = "elevenlabs" | "openai" | "kokoro";
 /** Options accepted by every {@link TtsCallable}. Subset of provider-specific options. */
 export interface TtsCallOptions {
     /**
@@ -56,10 +59,11 @@ export interface TtsResolution {
  * Resolution policy:
  *   - `"elevenlabs"`: requires `ELEVENLABS_API_KEY`. Throws an `ApiKeyError`-style
  *     error via {@link getApiKey} (consumed by `requireApiKey`/`exitWithError`).
+ *   - `"openai"`: requires `OPENAI_API_KEY`.
  *   - `"kokoro"`: always available (local). No key check.
- *   - `"auto"` (or `undefined`): if an ElevenLabs key is configured in
- *     project/user config.yaml, .env, or process env, picks ElevenLabs;
- *     otherwise falls back to Kokoro.
+ *   - `"auto"` (or `undefined`): ElevenLabs key configured → ElevenLabs
+ *     (preserves pre-0.113 behavior — a dedicated TTS key signals intent);
+ *     else OpenAI key configured → OpenAI; else Kokoro.
  */
 export declare function resolveTtsProvider(preferred?: TtsProviderName): Promise<TtsResolution>;
 /**