venice-video-harness 2.4.0

package/dist/storyboard/shot-planner.js

@@ -0,0 +1,446 @@
+// ---------------------------------------------------------------------------
+// Shot Planner -- breaks a Scene into an ordered sequence of camera shots.
+//
+// Analyses the scene's action beats, dialogue exchanges, and emotional
+// cues to produce a cinematically sensible shot list that a prompt builder
+// can turn into image-generation prompts.
+// ---------------------------------------------------------------------------
+// ---- Lens mapping ---------------------------------------------------------
+const LENS_BY_SHOT_TYPE = {
+    "extreme-wide": "14mm ultra-wide",
+    wide: "24mm wide",
+    "medium-wide": "35mm standard",
+    medium: "50mm standard",
+    "medium-close-up": "50mm standard",
+    "close-up": "85mm portrait",
+    "extreme-close-up": "100mm macro",
+    insert: "100mm macro",
+};
+// ---- Keyword sets for heuristic classification ----------------------------
+const EMOTIONAL_KEYWORDS = new Set([
+    "tears",
+    "crying",
+    "cries",
+    "weeps",
+    "sobbing",
+    "screams",
+    "whispers",
+    "trembles",
+    "shaking",
+    "heartbreak",
+    "anguish",
+    "devastated",
+    "shock",
+    "stunned",
+    "gasps",
+    "smiles",
+    "laughs",
+    "grins",
+    "kisses",
+    "embraces",
+    "holds",
+    "hugs",
+    "love",
+    "fear",
+    "terror",
+    "horror",
+    "rage",
+    "fury",
+    "anger",
+    "joy",
+    "elation",
+]);
+const ACTION_KEYWORDS = new Set([
+    "runs",
+    "chases",
+    "fights",
+    "punches",
+    "kicks",
+    "ducks",
+    "jumps",
+    "climbs",
+    "crashes",
+    "explodes",
+    "fires",
+    "shoots",
+    "falls",
+    "leaps",
+    "dives",
+    "rolls",
+    "sprints",
+    "charges",
+    "tackles",
+    "slams",
+    "breaks",
+    "smashes",
+    "throws",
+    "dodges",
+]);
+const INSERT_KEYWORDS = new Set([
+    "letter",
+    "note",
+    "phone",
+    "screen",
+    "photo",
+    "photograph",
+    "document",
+    "newspaper",
+    "headline",
+    "clock",
+    "watch",
+    "ring",
+    "key",
+    "gun",
+    "weapon",
+    "knife",
+    "blood",
+    "hand",
+    "envelope",
+    "map",
+    "badge",
+    "wallet",
+    "glass",
+    "bottle",
+    "pill",
+    "syringe",
+    "book",
+    "diary",
+    "mirror",
+    "sign",
+]);
+const DISSOLVE_KEYWORDS = new Set([
+    "later",
+    "hours pass",
+    "time passes",
+    "morning",
+    "sunset",
+    "dawn",
+    "dusk",
+    "next day",
+    "the following",
+    "weeks",
+    "months",
+    "years",
+]);
+const MATCH_CUT_KEYWORDS = new Set([
+    "match cut",
+    "smash cut",
+    "match on",
+]);
+// ---- Helpers --------------------------------------------------------------
+/**
+ * Check whether a text block contains any word from a keyword set.
+ */
+function containsKeyword(text, keywords) {
+    const lower = text.toLowerCase();
+    for (const kw of keywords) {
+        if (lower.includes(kw))
+            return true;
+    }
+    return false;
+}
+/**
+ * Extract potential object insert subjects from an action line.
+ */
+function findInsertSubjects(text) {
+    const lower = text.toLowerCase();
+    const found = [];
+    for (const kw of INSERT_KEYWORDS) {
+        if (lower.includes(kw)) {
+            found.push(kw);
+        }
+    }
+    return found;
+}
+/**
+ * Determine the default transition OUT for a shot based on surrounding text.
+ */
+function inferTransitionOut(actionText, isLastInScene) {
+    if (containsKeyword(actionText, MATCH_CUT_KEYWORDS))
+        return "MATCH CUT";
+    if (containsKeyword(actionText, DISSOLVE_KEYWORDS))
+        return "DISSOLVE";
+    if (isLastInScene)
+        return undefined; // scene boundary handled externally
+    return "CUT";
+}
+/**
+ * Infer whether a scene heading indicates an exterior location.
+ * Parses the heading for INT/EXT prefixes.
+ */
+function isExterior(heading) {
+    const upper = heading.toUpperCase().trim();
+    // EXT. or EXT/INT. -- exterior establishing shots
+    return upper.startsWith("EXT.") || upper.startsWith("EXT/INT");
+}
+/**
+ * Split action text into discrete beats (paragraphs or sentences that
+ * represent distinct visual moments).
+ */
+function splitActionBeats(actionLines) {
+    // Each element of the action array is already a paragraph from the parser.
+    // If a single paragraph is very long, split on sentence boundaries.
+    const beats = [];
+    for (const paragraph of actionLines) {
+        const trimmed = paragraph.trim();
+        if (!trimmed)
+            continue;
+        // If the paragraph is short enough, treat it as one beat.
+        if (trimmed.length < 200) {
+            beats.push(trimmed);
+            continue;
+        }
+        // Split long paragraphs on sentence boundaries.
+        const sentences = trimmed
+            .split(/(?<=[.!?])\s+(?=[A-Z])/)
+            .map((s) => s.trim())
+            .filter(Boolean);
+        if (sentences.length > 1) {
+            beats.push(...sentences);
+        }
+        else {
+            beats.push(trimmed);
+        }
+    }
+    return beats.length > 0 ? beats : [];
+}
+/**
+ * Extract character names mentioned in an action beat. Matches known
+ * scene characters by checking for their names (case-insensitive) in
+ * the beat text.
+ */
+function findCharactersInBeat(beat, knownCharacters) {
+    const upperBeat = beat.toUpperCase();
+    return knownCharacters.filter((c) => upperBeat.includes(c.toUpperCase()));
+}
+// ---- Dialogue grouping ----------------------------------------------------
+/**
+ * Group sequential dialogue lines into exchanges. An exchange is a
+ * contiguous block of dialogue lines between 2 or more speakers.
+ * A single-speaker monologue becomes its own exchange.
+ */
+function groupDialogueExchanges(dialogue) {
+    if (dialogue.length === 0)
+        return [];
+    const speakers = new Set(dialogue.map((d) => d.character));
+    // Single speaker -- each line is its own exchange.
+    if (speakers.size === 1) {
+        return dialogue.map((d) => [d]);
+    }
+    // Multiple speakers -- group into contiguous exchanges. Start a new
+    // exchange when the set of active speakers grows large (3+) and the
+    // current group is already substantial.
+    const exchanges = [];
+    let current = [];
+    for (const line of dialogue) {
+        current.push(line);
+        const currentSpeakers = new Set(current.map((d) => d.character));
+        if (currentSpeakers.size >= 3 && current.length >= 6) {
+            exchanges.push(current);
+            current = [];
+        }
+    }
+    if (current.length > 0) {
+        exchanges.push(current);
+    }
+    return exchanges;
+}
+// ---- Core planning --------------------------------------------------------
+/**
+ * Plan a sequence of camera shots for a given scene.
+ *
+ * The planner follows classical cinematographic conventions:
+ *
+ * 1. Every scene opens with an establishing shot (extreme-wide or wide).
+ * 2. Action beats get wide-to-medium coverage with dynamic camera movement.
+ * 3. Dialogue exchanges are covered with a two-shot opener followed by
+ *    over-the-shoulder singles alternating between speakers.
+ * 4. Emotional moments receive close-ups or extreme close-ups.
+ * 5. Important objects mentioned in action text receive insert shots.
+ * 6. Transitions default to CUT; DISSOLVE is used for time passages and
+ *    MATCH CUT where the screenplay indicates one.
+ */
+export function planShots(scene) {
+    const shots = [];
+    let shotCounter = 0;
+    const push = (partial) => {
+        shotCounter++;
+        shots.push({ shotNumber: shotCounter, ...partial });
+    };
+    const exterior = isExterior(scene.heading);
+    // ---- 1. Establishing shot ------------------------------------------------
+    push({
+        type: exterior ? "extreme-wide" : "wide",
+        angle: "eye-level",
+        movement: exterior ? "crane" : "dolly-in",
+        lens: exterior
+            ? LENS_BY_SHOT_TYPE["extreme-wide"]
+            : LENS_BY_SHOT_TYPE["wide"],
+        characters: scene.characters.slice(0, 3),
+        action: `Establishing shot: ${scene.heading}`,
+        transitionIn: "CUT",
+        notes: `Establish location: ${scene.location}, ${scene.timeOfDay}.`,
+    });
+    // ---- 2. Action beats -----------------------------------------------------
+    if (scene.action.length > 0) {
+        const beats = splitActionBeats(scene.action);
+        for (let i = 0; i < beats.length; i++) {
+            const beat = beats[i];
+            const beatCharacters = findCharactersInBeat(beat, scene.characters);
+            const isLast = i === beats.length - 1 && scene.dialogue.length === 0;
+            // Emotional beat
+            if (containsKeyword(beat, EMOTIONAL_KEYWORDS)) {
+                const focus = beatCharacters[0];
+                push({
+                    type: "close-up",
+                    angle: "eye-level",
+                    movement: "dolly-in",
+                    lens: LENS_BY_SHOT_TYPE["close-up"],
+                    characters: beatCharacters,
+                    focusCharacter: focus,
+                    action: beat,
+                    transitionOut: inferTransitionOut(beat, isLast),
+                    notes: "Emotional beat -- close-up to capture performance.",
+                });
+                continue;
+            }
+            // Insert shot for important objects
+            const insertSubjects = findInsertSubjects(beat);
+            if (insertSubjects.length > 0) {
+                push({
+                    type: "insert",
+                    angle: "high-angle",
+                    movement: "static",
+                    lens: LENS_BY_SHOT_TYPE["insert"],
+                    characters: [],
+                    action: `Insert: ${insertSubjects.join(", ")} -- ${beat}`,
+                    transitionOut: inferTransitionOut(beat, isLast),
+                    notes: `Insert shot of: ${insertSubjects.join(", ")}.`,
+                });
+                // Reaction shot if characters are present
+                if (beatCharacters.length > 0) {
+                    push({
+                        type: "medium-close-up",
+                        angle: "eye-level",
+                        movement: "static",
+                        lens: LENS_BY_SHOT_TYPE["medium-close-up"],
+                        characters: beatCharacters,
+                        focusCharacter: beatCharacters[0],
+                        action: `Reaction to ${insertSubjects.join(", ")}`,
+                        transitionOut: inferTransitionOut(beat, isLast),
+                        notes: "Reaction shot following insert.",
+                    });
+                }
+                continue;
+            }
+            // Physical action beat
+            if (containsKeyword(beat, ACTION_KEYWORDS)) {
+                push({
+                    type: beatCharacters.length > 2 ? "wide" : "medium-wide",
+                    angle: "eye-level",
+                    movement: "tracking",
+                    lens: beatCharacters.length > 2
+                        ? LENS_BY_SHOT_TYPE["wide"]
+                        : LENS_BY_SHOT_TYPE["medium-wide"],
+                    characters: beatCharacters,
+                    focusCharacter: beatCharacters[0],
+                    action: beat,
+                    transitionOut: inferTransitionOut(beat, isLast),
+                    notes: "Action coverage with tracking camera.",
+                });
+                continue;
+            }
+            // Default action beat
+            push({
+                type: beatCharacters.length > 2 ? "medium-wide" : "medium",
+                angle: "eye-level",
+                movement: "static",
+                lens: beatCharacters.length > 2
+                    ? LENS_BY_SHOT_TYPE["medium-wide"]
+                    : LENS_BY_SHOT_TYPE["medium"],
+                characters: beatCharacters,
+                focusCharacter: beatCharacters[0],
+                action: beat,
+                transitionOut: inferTransitionOut(beat, isLast),
+                notes: "Standard coverage.",
+            });
+        }
+    }
+    // ---- 3. Dialogue coverage ------------------------------------------------
+    if (scene.dialogue.length > 0) {
+        const exchanges = groupDialogueExchanges(scene.dialogue);
+        for (const exchange of exchanges) {
+            const speakers = [...new Set(exchange.map((d) => d.character))];
+            // Two-shot opener for conversations with 2+ speakers
+            if (speakers.length >= 2) {
+                push({
+                    type: "medium",
+                    angle: "eye-level",
+                    movement: "static",
+                    lens: LENS_BY_SHOT_TYPE["medium"],
+                    characters: speakers.slice(0, 2),
+                    action: `Two-shot: ${speakers[0]} and ${speakers[1]} in conversation.`,
+                    dialogue: exchange[0].text,
+                    transitionOut: "CUT",
+                    notes: "Two-shot opener for dialogue exchange.",
+                });
+            }
+            // OTS singles for each line
+            for (let i = 0; i < exchange.length; i++) {
+                const line = exchange[i];
+                const otherSpeaker = speakers.find((s) => s !== line.character);
+                const isEmotionalLine = containsKeyword(line.text + (line.parenthetical ?? ""), EMOTIONAL_KEYWORDS);
+                const isLastLine = i === exchange.length - 1 &&
+                    exchange === exchanges[exchanges.length - 1];
+                if (isEmotionalLine) {
+                    push({
+                        type: "close-up",
+                        angle: "eye-level",
+                        movement: "dolly-in",
+                        lens: LENS_BY_SHOT_TYPE["close-up"],
+                        characters: [line.character],
+                        focusCharacter: line.character,
+                        action: line.parenthetical
+                            ? `${line.character} (${line.parenthetical})`
+                            : `${line.character} speaks with intensity.`,
+                        dialogue: line.text,
+                        transitionOut: inferTransitionOut(line.text, isLastLine),
+                        notes: "Emotional close-up during dialogue.",
+                    });
+                }
+                else {
+                    const shotCharacters = otherSpeaker
+                        ? [line.character, otherSpeaker]
+                        : [line.character];
+                    push({
+                        type: "medium-close-up",
+                        angle: "eye-level",
+                        movement: "static",
+                        lens: LENS_BY_SHOT_TYPE["medium-close-up"],
+                        characters: shotCharacters,
+                        focusCharacter: line.character,
+                        action: otherSpeaker
+                            ? `OTS ${otherSpeaker}, favoring ${line.character}.`
+                            : `Single on ${line.character}.`,
+                        dialogue: line.text,
+                        transitionOut: inferTransitionOut(line.text, isLastLine),
+                        notes: otherSpeaker
+                            ? `Over-the-shoulder from ${otherSpeaker}'s perspective.`
+                            : "Single shot -- no reverse needed.",
+                    });
+                }
+            }
+        }
+    }
+    // ---- 4. Wire up transition chains ----------------------------------------
+    for (let i = 0; i < shots.length; i++) {
+        if (i > 0 && !shots[i].transitionIn) {
+            shots[i].transitionIn = shots[i - 1].transitionOut ?? "CUT";
+        }
+        if (!shots[i].transitionOut && i < shots.length - 1) {
+            shots[i].transitionOut = "CUT";
+        }
+    }
+    return shots;
+}
+//# sourceMappingURL=shot-planner.js.map

package/dist/storyboard/shot-planner.js.map

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

package/dist/user-config.d.ts

@@ -0,0 +1,15 @@
+export interface UserConfig {
+    apiKey?: string;
+    workspace?: string;
+}
+export declare function getConfigDir(): string;
+export declare function getConfigPath(): string;
+export declare function readUserConfig(): Promise<UserConfig>;
+export declare function writeUserConfig(config: UserConfig): Promise<void>;
+export declare function updateUserConfig(patch: Partial<UserConfig>): Promise<UserConfig>;
+export declare function hydrateEnvironmentFromUserConfig(): Promise<void>;
+export declare function getDefaultSetupWorkspace(): string;
+export declare function getWorkspaceDir(override?: string): Promise<string>;
+export declare function maskApiKey(apiKey?: string): string;
+export declare function validateVeniceApiKey(apiKey: string): Promise<void>;
+//# sourceMappingURL=user-config.d.ts.map

package/dist/user-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config.d.ts","sourceRoot":"","sources":["../src/user-config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD,wBAAgB,YAAY,IAAI,MAAM,CAQrC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAY1D;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAcvE;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAOtF;AAED,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC,CAItE;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,wBAAsB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIxE;AAED,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAaxE"}

package/dist/user-config.js

@@ -0,0 +1,103 @@
+import { chmod, mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { homedir, platform } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+function expandHome(value) {
+    if (value === '~')
+        return homedir();
+    if (value.startsWith('~/'))
+        return join(homedir(), value.slice(2));
+    return value;
+}
+export function getConfigDir() {
+    const override = process.env.VENICE_VIDEO_CONFIG_DIR;
+    if (override)
+        return resolve(expandHome(override));
+    if (platform() === 'darwin')
+        return join(homedir(), 'Library', 'Application Support', 'venice-video');
+    if (platform() === 'win32') {
+        return join(process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming'), 'venice-video');
+    }
+    return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), '.config'), 'venice-video');
+}
+export function getConfigPath() {
+    return join(getConfigDir(), 'config.json');
+}
+export async function readUserConfig() {
+    try {
+        const raw = await readFile(getConfigPath(), 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error('configuration root must be a JSON object');
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return {};
+        throw new Error(`Could not read Venice Video config at ${getConfigPath()}: ${error.message}`);
+    }
+}
+export async function writeUserConfig(config) {
+    const configPath = getConfigPath();
+    await mkdir(dirname(configPath), { recursive: true, mode: 0o700 });
+    const temporaryPath = `${configPath}.${process.pid}.tmp`;
+    try {
+        await writeFile(temporaryPath, `${JSON.stringify(config, null, 2)}\n`, {
+            encoding: 'utf-8',
+            mode: 0o600,
+        });
+        await rename(temporaryPath, configPath);
+        if (platform() !== 'win32')
+            await chmod(configPath, 0o600);
+    }
+    finally {
+        await rm(temporaryPath, { force: true }).catch(() => undefined);
+    }
+}
+export async function updateUserConfig(patch) {
+    const next = { ...(await readUserConfig()), ...patch };
+    for (const key of Object.keys(next)) {
+        if (next[key] === undefined || next[key] === '')
+            delete next[key];
+    }
+    await writeUserConfig(next);
+    return next;
+}
+export async function hydrateEnvironmentFromUserConfig() {
+    if (process.env.VENICE_API_KEY)
+        return;
+    const stored = (await readUserConfig()).apiKey;
+    if (stored)
+        process.env.VENICE_API_KEY = stored;
+}
+export function getDefaultSetupWorkspace() {
+    return join(homedir(), 'VeniceVideos');
+}
+export async function getWorkspaceDir(override) {
+    const config = await readUserConfig();
+    const selected = override ?? process.env.VENICE_VIDEO_WORKSPACE ?? config.workspace ?? resolve('output');
+    return resolve(expandHome(selected));
+}
+export function maskApiKey(apiKey) {
+    if (!apiKey)
+        return '(not configured)';
+    if (apiKey.length <= 8)
+        return '••••••••';
+    return `${apiKey.slice(0, 4)}••••${apiKey.slice(-4)}`;
+}
+export async function validateVeniceApiKey(apiKey) {
+    const response = await fetch('https://api.venice.ai/api/v1/models?type=video', {
+        headers: { Authorization: `Bearer ${apiKey}` },
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!response.ok) {
+        let detail = '';
+        try {
+            const body = await response.json();
+            detail = body.error?.message ? `: ${body.error.message}` : '';
+        }
+        catch { /* status is enough */ }
+        throw new Error(`Venice rejected the API key (HTTP ${response.status})${detail}`);
+    }
+}
+//# sourceMappingURL=user-config.js.map

package/dist/user-config.js.map

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

package/dist/venice/audio-preflight.d.ts

@@ -0,0 +1,80 @@
+export declare class WanAudioTooShortError extends Error {
+    readonly model: string;
+    readonly audioPath: string;
+    readonly durationSec: number;
+    readonly minSec: number;
+    constructor(info: {
+        model: string;
+        audioPath: string;
+        durationSec: number;
+        minSec: number;
+    });
+}
+/**
+ * Probe an audio file's duration in seconds via ffprobe.
+ *
+ * Throws if ffprobe is not on PATH or the file cannot be read.
+ */
+export declare function probeAudioDurationSec(audioPath: string): Promise<number>;
+/**
+ * Pad an audio file with TRAILING silence to exactly `targetSec` seconds.
+ *
+ * Writes the padded variant to `outPath`, leaving the source file untouched.
+ * The caller decides where to put it — convention is `audio/dialogue-padded/`
+ * so the original short clip remains usable for non-Wan placements.
+ *
+ * Pads to exactly `targetSec` (no slack). Less padding = less held-pose
+ * visual time after the speech ends.
+ */
+export declare function padAudioWithTrailingSilence(opts: {
+    inputPath: string;
+    outputPath: string;
+    targetSec: number;
+}): Promise<{
+    outputPath: string;
+    paddedFromSec: number;
+    toSec: number;
+}>;
+export interface PadAudioForModelOptions {
+    /** Model id from the registry. `minAudioInputSec` drives the target. */
+    model: string;
+    /** Path to the source audio file. */
+    audioPath: string;
+    /**
+     * Directory where padded variants land. Defaults to `<input dir>/padded/`.
+     * The original file is never modified.
+     */
+    paddedDir?: string;
+    /**
+     * Override the target seconds. Defaults to the model's `minAudioInputSec`.
+     */
+    targetSec?: number;
+}
+/**
+ * Ensure an audio file meets a model's minimum-duration requirement.
+ *
+ * - If the model has no `minAudioInputSec` or the clip already qualifies,
+ *   returns the original path unmodified.
+ * - Otherwise, pads with trailing silence and returns the padded path.
+ *
+ * Throws `WanAudioTooShortError` only if the model declares a minimum AND
+ * padding is explicitly disabled (`paddedDir: null` is reserved for that
+ * future variant; today we always pad rather than throw, because callers
+ * have already paid for the TTS and want the render).
+ */
+export declare function padAudioForModel(opts: PadAudioForModelOptions): Promise<{
+    outputPath: string;
+    padded: boolean;
+    durationSec: number;
+}>;
+/**
+ * Assert an audio file is long enough for a given model.
+ *
+ * Use this when callers want to reject short audio explicitly rather than
+ * silently padding it.
+ */
+export declare function assertAudioMeetsModelMin(opts: {
+    model: string;
+    audioPath: string;
+}): Promise<void>;
+//# sourceMappingURL=audio-preflight.d.ts.map