videoclaw 3.0.0-alpha.1

package/dist/video/audio-platform/native-lyria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-lyria.js","sourceRoot":"","sources":["../../../src/video/audio-platform/native-lyria.ts"],"names":[],"mappings":"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"}

package/dist/video/audio-platform/native-lyria3.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Music generation via Google Lyria 3 on the **Gemini Developer API** (NOT
+ * Vertex). This is an API-KEY product, so it resolves a key from the existing
+ * Gemini key pool (GEMINI_API_KEYS / GOOGLE_API_KEYS / GOOGLE_API_KEY) via
+ * `fetchGeminiWithPool` — no Vertex project, no billing, just a Gemini key.
+ *
+ * VERIFIED LIVE (2026-06-01) against the Gemini Developer API:
+ *
+ *   POST https://generativelanguage.googleapis.com/v1beta/models/{MODEL}:generateContent?key={KEY}
+ *   Content-Type: application/json
+ *   Body: { contents: [{ parts: [ { text: "<prompt>" } , <optional image part> ] }] }
+ *
+ *   Optional image-to-music conditioning attaches a second part in the SAME
+ *   parts array:
+ *     { inlineData: { mimeType: "image/png", data: "<base64>" } }
+ *
+ *   Response: candidates[0].content.parts[] — find the part whose
+ *   inlineData.mimeType starts with "audio/" (observed "audio/mpeg"); its
+ *   inlineData.data is base64 MP3. (There is also a { text: "<instrumental>" }
+ *   part which we ignore.)
+ *
+ * MODEL (via LYRIA3_MODEL env, default lyria-3-clip-preview):
+ *   - lyria-3-clip-preview  Lyria 3, 30s clip, text + image  (default)
+ *   - lyria-3-pro-preview   Lyria 3 Pro, full song up to ~184s, text + image
+ *
+ * Output is MP3 (audio/mpeg) — the file is always written with a `.mp3`
+ * extension regardless of the requested outputPath suffix. durationMs is a
+ * deterministic estimate from input.durationSec (or a model-default: 180s for
+ * a 'pro' model, 30s otherwise) — true MP3 duration parsing is out of scope.
+ *
+ * Availability: a Gemini key is resolvable (pool size > 0 or one of the env
+ * vars set); gated via the descriptor's requiresGeminiKey flag in the registry.
+ */
+import type { MusicBackend } from './types.js';
+export declare const lyria3Backend: MusicBackend;
+//# sourceMappingURL=native-lyria3.d.ts.map

package/dist/video/audio-platform/native-lyria3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-lyria3.d.ts","sourceRoot":"","sources":["../../../src/video/audio-platform/native-lyria3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,YAAY,CAAC;AAmF9E,eAAO,MAAM,aAAa,EAAE,YA0H3B,CAAC"}

package/dist/video/audio-platform/native-lyria3.js

@@ -0,0 +1,210 @@
+/**
+ * Music generation via Google Lyria 3 on the **Gemini Developer API** (NOT
+ * Vertex). This is an API-KEY product, so it resolves a key from the existing
+ * Gemini key pool (GEMINI_API_KEYS / GOOGLE_API_KEYS / GOOGLE_API_KEY) via
+ * `fetchGeminiWithPool` — no Vertex project, no billing, just a Gemini key.
+ *
+ * VERIFIED LIVE (2026-06-01) against the Gemini Developer API:
+ *
+ *   POST https://generativelanguage.googleapis.com/v1beta/models/{MODEL}:generateContent?key={KEY}
+ *   Content-Type: application/json
+ *   Body: { contents: [{ parts: [ { text: "<prompt>" } , <optional image part> ] }] }
+ *
+ *   Optional image-to-music conditioning attaches a second part in the SAME
+ *   parts array:
+ *     { inlineData: { mimeType: "image/png", data: "<base64>" } }
+ *
+ *   Response: candidates[0].content.parts[] — find the part whose
+ *   inlineData.mimeType starts with "audio/" (observed "audio/mpeg"); its
+ *   inlineData.data is base64 MP3. (There is also a { text: "<instrumental>" }
+ *   part which we ignore.)
+ *
+ * MODEL (via LYRIA3_MODEL env, default lyria-3-clip-preview):
+ *   - lyria-3-clip-preview  Lyria 3, 30s clip, text + image  (default)
+ *   - lyria-3-pro-preview   Lyria 3 Pro, full song up to ~184s, text + image
+ *
+ * Output is MP3 (audio/mpeg) — the file is always written with a `.mp3`
+ * extension regardless of the requested outputPath suffix. durationMs is a
+ * deterministic estimate from input.durationSec (or a model-default: 180s for
+ * a 'pro' model, 30s otherwise) — true MP3 duration parsing is out of scope.
+ *
+ * Availability: a Gemini key is resolvable (pool size > 0 or one of the env
+ * vars set); gated via the descriptor's requiresGeminiKey flag in the registry.
+ */
+import { mkdir, writeFile, readFile } from 'node:fs/promises';
+import { dirname, extname } from 'node:path';
+import { fetchGeminiWithPool } from '../gemini-key-pool.js';
+import { VclawError } from '../errors.js';
+const DEFAULT_LYRIA3_MODEL = 'lyria-3-clip-preview';
+/** Default clip lengths (seconds) when the caller omits durationSec. */
+const PRO_DEFAULT_SEC = 180;
+const CLIP_DEFAULT_SEC = 30;
+/**
+ * Gemini API key sources, in the same precedence as the global key pool
+ * (gemini-key-pool.ts). Used to resolve an explicit key from a caller-supplied
+ * `input.env` so the pool (which only reads process.env) can be bypassed.
+ */
+const GEMINI_KEY_VARS = ['GEMINI_API_KEYS', 'GOOGLE_API_KEYS', 'GOOGLE_API_KEY'];
+/**
+ * Resolve the first key from a caller-supplied env that process.env does not
+ * already expose. Returns undefined when no env was passed, or when the passed
+ * env adds no key beyond process.env (in which case the global pool selects).
+ * Mirrors native-gemini-tts.ts's resolver.
+ */
+function resolveKeyOverrideFromEnv(env) {
+    if (!env || env === process.env)
+        return undefined;
+    for (const varName of GEMINI_KEY_VARS) {
+        const raw = env[varName];
+        if (typeof raw !== 'string' || raw.trim() === '')
+            continue;
+        if (process.env[varName] === raw)
+            continue;
+        const first = raw.split(/[,;\n\s]+/).map((t) => t.trim()).find((t) => t.length > 0);
+        if (first)
+            return first;
+    }
+    return undefined;
+}
+/** Force a `.mp3` extension on the output path (Lyria 3 returns MP3). */
+function forceMp3Path(p) {
+    const ext = extname(p);
+    if (ext.toLowerCase() === '.mp3')
+        return p;
+    return ext ? `${p.slice(0, p.length - ext.length)}.mp3` : `${p}.mp3`;
+}
+/** Map a file extension to an image MIME type for the inlineData part. */
+function imageMimeForPath(p) {
+    switch (extname(p).toLowerCase()) {
+        case '.jpg':
+        case '.jpeg':
+            return 'image/jpeg';
+        case '.webp':
+            return 'image/webp';
+        case '.gif':
+            return 'image/gif';
+        case '.png':
+        default:
+            return 'image/png';
+    }
+}
+/**
+ * Defensive extraction of the first base64 inlineData payload whose mimeType
+ * starts with "audio/". The Gemini response also carries a { text } part (the
+ * instrumental description) which must be ignored.
+ */
+function extractAudioBase64(parsed) {
+    if (typeof parsed !== 'object' || parsed === null)
+        return undefined;
+    const candidates = parsed.candidates;
+    if (!Array.isArray(candidates) || candidates.length === 0)
+        return undefined;
+    const parts = candidates[0]?.content?.parts;
+    if (!Array.isArray(parts))
+        return undefined;
+    for (const part of parts) {
+        const inlineData = part?.inlineData;
+        const mime = inlineData?.mimeType;
+        const data = inlineData?.data;
+        if (typeof mime === 'string' &&
+            mime.startsWith('audio/') &&
+            typeof data === 'string' &&
+            data.length > 0) {
+            return data;
+        }
+    }
+    return undefined;
+}
+export const lyria3Backend = {
+    id: 'lyria3',
+    kind: 'music',
+    displayName: 'Lyria 3 (Gemini API)',
+    // API-key product, not Vertex. Availability is resolved from the Gemini key
+    // pool (see isMusicBackendAvailable), so requiredEnv stays empty and the
+    // registry gates on requiresGeminiKey instead of this backend's id.
+    requiredEnv: [],
+    requiresVertex: false,
+    requiresGeminiKey: true,
+    summary: 'Music generation via Google Lyria 3 on the Gemini Developer API (key-based, NOT Vertex). Default lyria-3-clip-preview (30s); LYRIA3_MODEL=lyria-3-pro-preview for a full song (~184s). Optional image-to-music conditioning via imagePath. Returns MP3. Requires a Gemini API key (GEMINI_API_KEYS / GOOGLE_API_KEYS / GOOGLE_API_KEY).',
+    async generate(input) {
+        const env = input.env ?? process.env;
+        const model = env['LYRIA3_MODEL'] ?? DEFAULT_LYRIA3_MODEL;
+        const isPro = model.includes('pro');
+        const durationSec = input.durationSec ?? (isPro ? PRO_DEFAULT_SEC : CLIP_DEFAULT_SEC);
+        const durationMs = durationSec * 1000;
+        const outputPath = forceMp3Path(input.outputPath);
+        if (!input.prompt.trim()) {
+            throw new VclawError('music_gen_failed', 'Cannot generate music with an empty prompt.', {
+                backend: 'lyria3',
+            });
+        }
+        // Dry-run: estimate duration from the model/request; do NOT touch network.
+        // Write a placeholder MP3 (empty) so downstream existsSync() stays consistent.
+        if (input.dryRun) {
+            await mkdir(dirname(outputPath), { recursive: true });
+            await writeFile(outputPath, Buffer.alloc(0));
+            return { path: outputPath, durationMs, backendId: 'lyria3' };
+        }
+        // Build the contents body: text prompt + optional image-to-music part.
+        const parts = [{ text: input.prompt }];
+        if (input.imagePath) {
+            let imgBytes;
+            try {
+                imgBytes = await readFile(input.imagePath);
+            }
+            catch (err) {
+                throw new VclawError('music_gen_failed', `Could not read image for image-to-music conditioning: ${input.imagePath}`, { backend: 'lyria3', error: err instanceof Error ? err.message : String(err) });
+            }
+            parts.push({
+                inlineData: {
+                    mimeType: imageMimeForPath(input.imagePath),
+                    data: imgBytes.toString('base64'),
+                },
+            });
+        }
+        const requestBody = JSON.stringify({ contents: [{ parts }] });
+        // Resolve a key from input.env when it carries one the global pool (which
+        // only reads process.env) cannot see; otherwise the pool selects.
+        const keyOverride = resolveKeyOverrideFromEnv(input.env);
+        const poolOptions = {};
+        if (input.fetcher)
+            poolOptions.fetcher = input.fetcher;
+        if (keyOverride)
+            poolOptions.keyOverride = keyOverride;
+        const response = await fetchGeminiWithPool((key) => `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${encodeURIComponent(key)}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: requestBody,
+        }, poolOptions);
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new VclawError('music_gen_failed', `Lyria 3 (Gemini API) request failed with HTTP ${response.status}.`, { backend: 'lyria3', status: response.status, body: body.slice(0, 500) });
+        }
+        let parsed;
+        try {
+            parsed = await response.json();
+        }
+        catch (err) {
+            throw new VclawError('music_gen_failed', 'Lyria 3 returned a non-JSON response.', {
+                backend: 'lyria3',
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        const b64 = extractAudioBase64(parsed);
+        if (!b64) {
+            throw new VclawError('music_gen_failed', 'Lyria 3 response contained no audio/* inlineData part.', { backend: 'lyria3' });
+        }
+        const bytes = Buffer.from(b64, 'base64');
+        if (bytes.length === 0) {
+            throw new VclawError('music_gen_failed', 'Lyria 3 returned an empty audio payload.', {
+                backend: 'lyria3',
+            });
+        }
+        await mkdir(dirname(outputPath), { recursive: true });
+        await writeFile(outputPath, bytes);
+        // durationMs is an estimate from the request/model (MP3 duration parsing is
+        // out of scope — Lyria 3 returns audio/mpeg without a trivial header read).
+        return { path: outputPath, durationMs, backendId: 'lyria3' };
+    },
+};
+//# sourceMappingURL=native-lyria3.js.map

package/dist/video/audio-platform/native-lyria3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-lyria3.js","sourceRoot":"","sources":["../../../src/video/audio-platform/native-lyria3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAEpD,wEAAwE;AACxE,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B;;;;GAIG;AACH,MAAM,eAAe,GAAG,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,CAAU,CAAC;AAE1F;;;;;GAKG;AACH,SAAS,yBAAyB,CAAC,GAAkC;IACnE,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAClD,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QAC3D,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,GAAG;YAAE,SAAS;QAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACpF,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,yEAAyE;AACzE,SAAS,YAAY,CAAC,CAAS;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,MAAM;QAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;AACvE,CAAC;AAED,0EAA0E;AAC1E,SAAS,gBAAgB,CAAC,CAAS;IACjC,QAAQ,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,YAAY,CAAC;QACtB,KAAK,OAAO;YACV,OAAO,YAAY,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,MAAe;IACzC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACpE,MAAM,UAAU,GAAI,MAAmC,CAAC,UAAU,CAAC;IACnE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5E,MAAM,KAAK,GAAI,UAAU,CAAC,CAAC,CAAuC,EAAE,OAAO,EAAE,KAAK,CAAC;IACnF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAI,IAAgE,EAAE,UAAU,CAAC;QACjG,MAAM,IAAI,GAAG,UAAU,EAAE,QAAQ,CAAC;QAClC,MAAM,IAAI,GAAG,UAAU,EAAE,IAAI,CAAC;QAC9B,IACE,OAAO,IAAI,KAAK,QAAQ;YACxB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YACzB,OAAO,IAAI,KAAK,QAAQ;YACxB,IAAI,CAAC,MAAM,GAAG,CAAC,EACf,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAiB;IACzC,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,sBAAsB;IACnC,4EAA4E;IAC5E,yEAAyE;IACzE,oEAAoE;IACpE,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,KAAK;IACrB,iBAAiB,EAAE,IAAI;IACvB,OAAO,EACL,yUAAyU;IAE3U,KAAK,CAAC,QAAQ,CAAC,KAAoB;QACjC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;QACrC,MAAM,KAAK,GAAG,GAAG,CAAC,cAAc,CAAC,IAAI,oBAAoB,CAAC;QAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;QACtF,MAAM,UAAU,GAAG,WAAW,GAAG,IAAI,CAAC;QACtC,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAElD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,6CAA6C,EAAE;gBACtF,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;QACL,CAAC;QAED,2EAA2E;QAC3E,+EAA+E;QAC/E,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QAC/D,CAAC;QAED,uEAAuE;QACvE,MAAM,KAAK,GAEP,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAE7B,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,QAAgB,CAAC;YACrB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,yDAAyD,KAAK,CAAC,SAAS,EAAE,EAC1E,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC/E,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,IAAI,CAAC;gBACT,UAAU,EAAE;oBACV,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC;oBAC3C,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;iBAClC;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAE9D,0EAA0E;QAC1E,kEAAkE;QAClE,MAAM,WAAW,GAAG,yBAAyB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEzD,MAAM,WAAW,GAAqD,EAAE,CAAC;QACzE,IAAI,KAAK,CAAC,OAAO;YAAE,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QACvD,IAAI,WAAW;YAAE,WAAW,CAAC,WAAW,GAAG,WAAW,CAAC;QAEvD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CACxC,CAAC,GAAG,EAAE,EAAE,CACN,2DAA2D,KAAK,wBAAwB,kBAAkB,CAAC,GAAG,CAAC,EAAE,EACnH;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,WAAW;SAClB,EACD,WAAW,CACZ,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,iDAAiD,QAAQ,CAAC,MAAM,GAAG,EACnE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACzE,CAAC;QACJ,CAAC;QAED,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,uCAAuC,EAAE;gBAChF,OAAO,EAAE,QAAQ;gBACjB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,wDAAwD,EACxD,EAAE,OAAO,EAAE,QAAQ,EAAE,CACtB,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,0CAA0C,EAAE;gBACnF,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAEnC,4EAA4E;QAC5E,4EAA4E;QAC5E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC/D,CAAC;CACF,CAAC"}

package/dist/video/audio-platform/registry.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Audio-platform registry — enumerates all known MusicBackend implementations
+ * and provides availability helpers.
+ *
+ * A backend is available iff:
+ *   - every var in requiredEnv is set (non-empty) in env, AND
+ *   - (!requiresVertex || at least one of GOOGLE_CLOUD_PROJECT / VERTEX_PROJECT
+ *     / GCLOUD_PROJECT is set in env), AND
+ *   - (!requiresGeminiKey || at least one of GEMINI_API_KEYS / GOOGLE_API_KEYS
+ *     / GOOGLE_API_KEY is set in env)
+ *
+ * The Gemini-key gate (requiresGeminiKey) covers API-key Gemini products such
+ * as the Lyria 3 music backend: they declare an empty requiredEnv (no single
+ * fixed var) and resolve a key from the pool sources. Gating on the flag — not
+ * the backend id — keeps the rule decoupled from backend identity.
+ *
+ * Vertex credential liveness (ADC token validity) is NOT checked here — that
+ * would require a network call. The check is intentionally env-only so it is
+ * synchronous, pure, and testable.
+ */
+import type { MusicBackend, SfxBackend, TtsBackend } from './types.js';
+/** All registered music backends, in priority order. */
+export declare const MUSIC_BACKENDS: MusicBackend[];
+/**
+ * All registered TTS backends, in priority order. `gemini-tts` stays first (the
+ * documented default), with `elevenlabs-tts` as the Gemini-free alternative —
+ * selected explicitly via `--backend elevenlabs-tts` (or auto-picked when it is
+ * the only available backend).
+ */
+export declare const TTS_BACKENDS: TtsBackend[];
+/**
+ * Returns true if the backend's runtime prerequisites are satisfied in `env`.
+ * Pure and synchronous — no network calls.
+ */
+export declare function isMusicBackendAvailable(b: MusicBackend, env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Returns all music backends that are currently available in `env`.
+ */
+export declare function listAvailableMusicBackends(env?: NodeJS.ProcessEnv): MusicBackend[];
+/**
+ * Returns the MusicBackend with the given `id`, or throws if not found.
+ * Does NOT check availability — the caller decides whether to gate on it.
+ */
+export declare function getMusicBackend(id: string): MusicBackend;
+/**
+ * Returns true if the TTS backend's runtime prerequisites are satisfied in
+ * `env`. Pure and synchronous — no network calls.
+ *
+ * Backends that set `requiresGeminiKey` (e.g. gemini-tts) declare an empty
+ * requiredEnv (an API-key product, not a fixed env-var product), so
+ * availability additionally requires a Gemini key from the pool sources: at
+ * least one of GEMINI_API_KEYS / GOOGLE_API_KEYS / GOOGLE_API_KEY must be set
+ * and non-empty. Gating on the flag (not the backend id) keeps this rule
+ * decoupled from backend identity and extensible to future TTS backends.
+ */
+export declare function isTtsBackendAvailable(b: TtsBackend, env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Returns all TTS backends that are currently available in `env`.
+ */
+export declare function listAvailableTtsBackends(env?: NodeJS.ProcessEnv): TtsBackend[];
+/**
+ * Returns the TtsBackend with the given `id`, or throws if not found.
+ * Does NOT check availability — the caller decides whether to gate on it.
+ */
+export declare function getTtsBackend(id: string): TtsBackend;
+/** All registered SFX backends, in priority order. */
+export declare const SFX_BACKENDS: SfxBackend[];
+/**
+ * Returns true if the SFX backend's runtime prerequisites are satisfied in
+ * `env`. Pure and synchronous — no network calls.
+ */
+export declare function isSfxBackendAvailable(b: SfxBackend, env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Returns all SFX backends that are currently available in `env`.
+ */
+export declare function listAvailableSfxBackends(env?: NodeJS.ProcessEnv): SfxBackend[];
+/**
+ * Returns the SfxBackend with the given `id`, or throws if not found.
+ * Does NOT check availability — the caller decides whether to gate on it.
+ */
+export declare function getSfxBackend(id: string): SfxBackend;
+//# sourceMappingURL=registry.d.ts.map

package/dist/video/audio-platform/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/video/audio-platform/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvE,wDAAwD;AACxD,eAAO,MAAM,cAAc,EAAE,YAAY,EAAiE,CAAC;AAE3G;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,UAAU,EAA+B,CAAC;AAkBrE;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,YAAY,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAkCT;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,YAAY,EAAE,CAEhB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAOxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,UAAU,EACb,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAiBT;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,UAAU,EAAE,CAEd;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAOpD;AAMD,sDAAsD;AACtD,eAAO,MAAM,YAAY,EAAE,UAAU,EAAoB,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,UAAU,EACb,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,UAAU,EAAE,CAEd;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAOpD"}

package/dist/video/audio-platform/registry.js

@@ -0,0 +1,189 @@
+/**
+ * Audio-platform registry — enumerates all known MusicBackend implementations
+ * and provides availability helpers.
+ *
+ * A backend is available iff:
+ *   - every var in requiredEnv is set (non-empty) in env, AND
+ *   - (!requiresVertex || at least one of GOOGLE_CLOUD_PROJECT / VERTEX_PROJECT
+ *     / GCLOUD_PROJECT is set in env), AND
+ *   - (!requiresGeminiKey || at least one of GEMINI_API_KEYS / GOOGLE_API_KEYS
+ *     / GOOGLE_API_KEY is set in env)
+ *
+ * The Gemini-key gate (requiresGeminiKey) covers API-key Gemini products such
+ * as the Lyria 3 music backend: they declare an empty requiredEnv (no single
+ * fixed var) and resolve a key from the pool sources. Gating on the flag — not
+ * the backend id — keeps the rule decoupled from backend identity.
+ *
+ * Vertex credential liveness (ADC token validity) is NOT checked here — that
+ * would require a network call. The check is intentionally env-only so it is
+ * synchronous, pure, and testable.
+ */
+import { sunoBackend } from './suno-backend.js';
+import { lyriaBackend } from './native-lyria.js';
+import { lyria3Backend } from './native-lyria3.js';
+import { flowMusicBackend } from './native-flowmusic.js';
+import { geminiTts } from './native-gemini-tts.js';
+import { elevenLabsTts } from './native-elevenlabs-tts.js';
+import { elevenLabsSfx } from './native-elevenlabs-sfx.js';
+/** All registered music backends, in priority order. */
+export const MUSIC_BACKENDS = [sunoBackend, lyriaBackend, lyria3Backend, flowMusicBackend];
+/**
+ * All registered TTS backends, in priority order. `gemini-tts` stays first (the
+ * documented default), with `elevenlabs-tts` as the Gemini-free alternative —
+ * selected explicitly via `--backend elevenlabs-tts` (or auto-picked when it is
+ * the only available backend).
+ */
+export const TTS_BACKENDS = [geminiTts, elevenLabsTts];
+/**
+ * Gemini API key sources (same precedence as src/video/gemini-key-pool.ts).
+ * The gemini-tts backend is an API-key product; availability is satisfied iff
+ * at least one of these env vars is set (non-empty) in `env`.
+ */
+const GEMINI_KEY_VARS = ['GEMINI_API_KEYS', 'GOOGLE_API_KEYS', 'GOOGLE_API_KEY'];
+const VERTEX_PROJECT_VARS = [
+    'GOOGLE_CLOUD_PROJECT',
+    'VERTEX_PROJECT',
+    'GCLOUD_PROJECT',
+];
+/** Shared useapi.net bearer token (same var the dreamina/runway routes use). */
+const USEAPI_TOKEN_VAR = 'USEAPI_API_TOKEN';
+/**
+ * Returns true if the backend's runtime prerequisites are satisfied in `env`.
+ * Pure and synchronous — no network calls.
+ */
+export function isMusicBackendAvailable(b, env = process.env) {
+    // All declared env vars must be set and non-empty.
+    for (const varName of b.requiredEnv) {
+        const val = env[varName];
+        if (!val || val.trim() === '')
+            return false;
+    }
+    // Vertex backends additionally require a project env var.
+    if (b.requiresVertex) {
+        const hasProject = VERTEX_PROJECT_VARS.some((v) => {
+            const val = env[v];
+            return val && val.trim() !== '';
+        });
+        if (!hasProject)
+            return false;
+    }
+    // API-key Gemini backends (e.g. lyria3) additionally require a Gemini key
+    // from any of the pool sources. Gated on the flag, not the backend id.
+    if (b.requiresGeminiKey) {
+        const hasKey = GEMINI_KEY_VARS.some((v) => {
+            const val = env[v];
+            return val && val.trim() !== '';
+        });
+        if (!hasKey)
+            return false;
+    }
+    // useapi-transport backends (e.g. flowmusic) require the shared useapi.net
+    // bearer token. Gated on the flag, not the backend id.
+    if (b.requiresUseApi) {
+        const token = env[USEAPI_TOKEN_VAR];
+        if (!token || token.trim() === '')
+            return false;
+    }
+    return true;
+}
+/**
+ * Returns all music backends that are currently available in `env`.
+ */
+export function listAvailableMusicBackends(env = process.env) {
+    return MUSIC_BACKENDS.filter((b) => isMusicBackendAvailable(b, env));
+}
+/**
+ * Returns the MusicBackend with the given `id`, or throws if not found.
+ * Does NOT check availability — the caller decides whether to gate on it.
+ */
+export function getMusicBackend(id) {
+    const backend = MUSIC_BACKENDS.find((b) => b.id === id);
+    if (!backend) {
+        const known = MUSIC_BACKENDS.map((b) => b.id).join(', ');
+        throw new Error(`Unknown music backend '${id}'. Known backends: ${known}`);
+    }
+    return backend;
+}
+/**
+ * Returns true if the TTS backend's runtime prerequisites are satisfied in
+ * `env`. Pure and synchronous — no network calls.
+ *
+ * Backends that set `requiresGeminiKey` (e.g. gemini-tts) declare an empty
+ * requiredEnv (an API-key product, not a fixed env-var product), so
+ * availability additionally requires a Gemini key from the pool sources: at
+ * least one of GEMINI_API_KEYS / GOOGLE_API_KEYS / GOOGLE_API_KEY must be set
+ * and non-empty. Gating on the flag (not the backend id) keeps this rule
+ * decoupled from backend identity and extensible to future TTS backends.
+ */
+export function isTtsBackendAvailable(b, env = process.env) {
+    // All declared env vars must be set and non-empty.
+    for (const varName of b.requiredEnv) {
+        const val = env[varName];
+        if (!val || val.trim() === '')
+            return false;
+    }
+    // Backends requiring a Gemini API key need one from any of the pool sources.
+    if (b.requiresGeminiKey) {
+        const hasKey = GEMINI_KEY_VARS.some((v) => {
+            const val = env[v];
+            return val && val.trim() !== '';
+        });
+        if (!hasKey)
+            return false;
+    }
+    return true;
+}
+/**
+ * Returns all TTS backends that are currently available in `env`.
+ */
+export function listAvailableTtsBackends(env = process.env) {
+    return TTS_BACKENDS.filter((b) => isTtsBackendAvailable(b, env));
+}
+/**
+ * Returns the TtsBackend with the given `id`, or throws if not found.
+ * Does NOT check availability — the caller decides whether to gate on it.
+ */
+export function getTtsBackend(id) {
+    const backend = TTS_BACKENDS.find((b) => b.id === id);
+    if (!backend) {
+        const known = TTS_BACKENDS.map((b) => b.id).join(', ');
+        throw new Error(`Unknown TTS backend '${id}'. Known backends: ${known}`);
+    }
+    return backend;
+}
+// ---------------------------------------------------------------------------
+// SFX registry
+// ---------------------------------------------------------------------------
+/** All registered SFX backends, in priority order. */
+export const SFX_BACKENDS = [elevenLabsSfx];
+/**
+ * Returns true if the SFX backend's runtime prerequisites are satisfied in
+ * `env`. Pure and synchronous — no network calls.
+ */
+export function isSfxBackendAvailable(b, env = process.env) {
+    for (const varName of b.requiredEnv) {
+        const val = env[varName];
+        if (!val || val.trim() === '')
+            return false;
+    }
+    return true;
+}
+/**
+ * Returns all SFX backends that are currently available in `env`.
+ */
+export function listAvailableSfxBackends(env = process.env) {
+    return SFX_BACKENDS.filter((b) => isSfxBackendAvailable(b, env));
+}
+/**
+ * Returns the SfxBackend with the given `id`, or throws if not found.
+ * Does NOT check availability — the caller decides whether to gate on it.
+ */
+export function getSfxBackend(id) {
+    const backend = SFX_BACKENDS.find((b) => b.id === id);
+    if (!backend) {
+        const known = SFX_BACKENDS.map((b) => b.id).join(', ');
+        throw new Error(`Unknown SFX backend '${id}'. Known backends: ${known}`);
+    }
+    return backend;
+}
+//# sourceMappingURL=registry.js.map

package/dist/video/audio-platform/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/video/audio-platform/registry.ts"],"names":[],"mappings":"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"}

package/dist/video/audio-platform/suno-backend.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Suno music backend — wraps the existing generateMusic() from
+ * src/video/assemble/music.ts (Kie.ai Suno provider).
+ *
+ * This backend delegates entirely to the proven assemble-layer
+ * implementation; it does NOT re-implement any transport logic.
+ * Availability: requires KIE_API_KEY in env.
+ */
+import type { MusicBackend } from './types.js';
+export declare const sunoBackend: MusicBackend;
+//# sourceMappingURL=suno-backend.d.ts.map

package/dist/video/audio-platform/suno-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suno-backend.d.ts","sourceRoot":"","sources":["../../../src/video/audio-platform/suno-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,YAAY,CAAC;AAE9E,eAAO,MAAM,WAAW,EAAE,YAuBzB,CAAC"}

package/dist/video/audio-platform/suno-backend.js

@@ -0,0 +1,33 @@
+/**
+ * Suno music backend — wraps the existing generateMusic() from
+ * src/video/assemble/music.ts (Kie.ai Suno provider).
+ *
+ * This backend delegates entirely to the proven assemble-layer
+ * implementation; it does NOT re-implement any transport logic.
+ * Availability: requires KIE_API_KEY in env.
+ */
+import { generateMusic } from '../assemble/music.js';
+export const sunoBackend = {
+    id: 'suno',
+    kind: 'music',
+    displayName: 'Suno (Kie.ai)',
+    requiredEnv: ['KIE_API_KEY'],
+    summary: 'Background-music generation via Kie.ai Suno V5 (submit → poll → download). Requires KIE_API_KEY.',
+    async generate(input) {
+        const env = input.env ?? process.env;
+        const result = await generateMusic({
+            prompt: input.prompt,
+            durationSec: input.durationSec,
+            outputPath: input.outputPath,
+            dryRun: input.dryRun,
+            apiKey: env['KIE_API_KEY'],
+            ...(input.fetcher ? { fetcher: input.fetcher } : {}),
+        });
+        return {
+            path: result.path,
+            durationMs: result.durationMs,
+            backendId: 'suno',
+        };
+    },
+};
+//# sourceMappingURL=suno-backend.js.map

package/dist/video/audio-platform/suno-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suno-backend.js","sourceRoot":"","sources":["../../../src/video/audio-platform/suno-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,eAAe;IAC5B,WAAW,EAAE,CAAC,aAAa,CAAC;IAC5B,OAAO,EAAE,kGAAkG;IAE3G,KAAK,CAAC,QAAQ,CAAC,KAAoB;QACjC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;YACjC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC;YAC1B,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD,CAAC,CAAC;QACH,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,MAAM;SAClB,CAAC;IACJ,CAAC;CACF,CAAC"}