venice-video-harness 2.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-preflight.d.ts","sourceRoot":"","sources":["../../src/venice/audio-preflight.ts"],"names":[],"mappings":"AA4BA,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAY5F;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY9E;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBxE;AAED,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBvE;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAahB"}

package/dist/venice/audio-preflight.js

@@ -0,0 +1,142 @@
+// ---------------------------------------------------------------------------
+// Audio pre-flight helpers for Wan 2.7 (and any future model that constrains
+// `audio_url` input duration).
+//
+// Wan 2.7's `audio_url` rejects clips shorter than 3 seconds with HTTP 400:
+//   "audio_url: Audio duration is too short. Minimum is 3 seconds."
+//
+// POST /video/quote does NOT validate audio duration, so the error only
+// surfaces at queue time. This module:
+//
+//   - probes audio duration via `ffprobe`
+//   - throws `WanAudioTooShortError` when below a model's `minAudioInputSec`
+//   - pads short clips with TRAILING silence via `ffmpeg apad`
+//
+// Trailing (not leading) silence is the right call:
+// leading silence wastes the most-interesting visual portion on a held pose
+// before the mouth moves. Trailing silence lets the model finish speech and
+// idle (blinks, micro-motion) naturally.
+// ---------------------------------------------------------------------------
+import { execFile } from 'node:child_process';
+import { mkdir } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+import { promisify } from 'node:util';
+import { getVideoModel } from './models.js';
+const execFileAsync = promisify(execFile);
+export class WanAudioTooShortError extends Error {
+    model;
+    audioPath;
+    durationSec;
+    minSec;
+    constructor(info) {
+        super(`[WanAudioTooShort] ${info.model} requires audio_url >= ${info.minSec}s, ` +
+            `got ${info.durationSec.toFixed(3)}s (${info.audioPath}). ` +
+            `Pad with trailing silence via padAudioForModel().`);
+        this.name = 'WanAudioTooShortError';
+        this.model = info.model;
+        this.audioPath = info.audioPath;
+        this.durationSec = info.durationSec;
+        this.minSec = info.minSec;
+    }
+}
+/**
+ * Probe an audio file's duration in seconds via ffprobe.
+ *
+ * Throws if ffprobe is not on PATH or the file cannot be read.
+ */
+export async function probeAudioDurationSec(audioPath) {
+    const { stdout } = await execFileAsync('ffprobe', [
+        '-v', 'error',
+        '-show_entries', 'format=duration',
+        '-of', 'default=noprint_wrappers=1:nokey=1',
+        audioPath,
+    ]);
+    const seconds = parseFloat(stdout.trim());
+    if (!Number.isFinite(seconds)) {
+        throw new Error(`Could not parse ffprobe duration for ${audioPath} (got "${stdout.trim()}")`);
+    }
+    return seconds;
+}
+/**
+ * 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 async function padAudioWithTrailingSilence(opts) {
+    const fromSec = await probeAudioDurationSec(opts.inputPath);
+    if (fromSec >= opts.targetSec) {
+        return { outputPath: opts.inputPath, paddedFromSec: fromSec, toSec: fromSec };
+    }
+    await mkdir(dirname(opts.outputPath), { recursive: true });
+    // `apad=pad_dur=<delta>` appends `<delta>` seconds of silence; `-t targetSec`
+    // is a belt-and-braces cap in case ffmpeg's apad rounding overshoots.
+    const padDur = (opts.targetSec - fromSec).toFixed(3);
+    await execFileAsync('ffmpeg', [
+        '-y',
+        '-i', opts.inputPath,
+        '-af', `apad=pad_dur=${padDur}`,
+        '-t', String(opts.targetSec),
+        opts.outputPath,
+    ]);
+    return { outputPath: opts.outputPath, paddedFromSec: fromSec, toSec: opts.targetSec };
+}
+/**
+ * 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 async function padAudioForModel(opts) {
+    const spec = getVideoModel(opts.model);
+    const minSec = opts.targetSec ?? spec?.minAudioInputSec;
+    if (!minSec) {
+        const durationSec = await probeAudioDurationSec(opts.audioPath);
+        return { outputPath: opts.audioPath, padded: false, durationSec };
+    }
+    const fromSec = await probeAudioDurationSec(opts.audioPath);
+    if (fromSec >= minSec) {
+        return { outputPath: opts.audioPath, padded: false, durationSec: fromSec };
+    }
+    const dir = opts.paddedDir ?? join(dirname(opts.audioPath), 'padded');
+    const baseName = basename(opts.audioPath);
+    const outPath = join(dir, baseName);
+    const { toSec } = await padAudioWithTrailingSilence({
+        inputPath: opts.audioPath,
+        outputPath: outPath,
+        targetSec: minSec,
+    });
+    return { outputPath: outPath, padded: true, durationSec: toSec };
+}
+/**
+ * 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 async function assertAudioMeetsModelMin(opts) {
+    const spec = getVideoModel(opts.model);
+    const minSec = spec?.minAudioInputSec;
+    if (!minSec)
+        return;
+    const durationSec = await probeAudioDurationSec(opts.audioPath);
+    if (durationSec < minSec) {
+        throw new WanAudioTooShortError({
+            model: opts.model,
+            audioPath: opts.audioPath,
+            durationSec,
+            minSec,
+        });
+    }
+}
+//# sourceMappingURL=audio-preflight.js.map

package/dist/venice/audio-preflight.js.map

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

package/dist/venice/audio.d.ts

@@ -0,0 +1,88 @@
+import type { VeniceClient } from './client.js';
+export declare const DEFAULT_VENICE_TTS_MODEL = "tts-kokoro";
+export declare const DEFAULT_VENICE_MUSIC_MODEL = "elevenlabs-music";
+export declare const DEFAULT_VENICE_SFX_MODEL = "elevenlabs-sound-effects-v2";
+/** BytePlus Seed Audio 1.0 — expressive prompt-driven speech/audio via the audio queue. */
+export declare const DEFAULT_VENICE_SEED_AUDIO_MODEL = "seed-audio-1-0";
+/**
+ * @deprecated Use DEFAULT_VENICE_MUSIC_MODEL or DEFAULT_VENICE_SFX_MODEL.
+ * Kept for backward compatibility with existing scripts.
+ */
+export declare const DEFAULT_VENICE_AUDIO_MODEL = "stable-audio-25";
+export interface TTSOptions {
+    voiceId: string;
+    text: string;
+    modelId?: string;
+    /** Qwen3 TTS style prompt (e.g. "Very happy.", "Sad and slow.") */
+    prompt?: string;
+    speed?: number;
+    responseFormat?: 'mp3' | 'wav' | 'flac' | 'aac' | 'opus' | 'pcm';
+    streaming?: boolean;
+    /** Qwen3 TTS only */
+    language?: string;
+    /** Qwen3 TTS only: sampling temperature (0-2) */
+    temperature?: number;
+    /** Qwen3 TTS only: nucleus sampling (0-1) */
+    top_p?: number;
+}
+export interface DialogueLine {
+    shotNumber: number;
+    character: string;
+    voiceId: string;
+    text: string;
+    voicePrompt?: string;
+}
+export declare function generateSpeech(client: VeniceClient, options: TTSOptions, outputPath: string): Promise<string>;
+export declare function generateDialogueForShots(client: VeniceClient, lines: DialogueLine[], outputDir: string): Promise<{
+    shotNumber: number;
+    character: string;
+    text: string;
+    path: string;
+}[]>;
+export interface SFXOptions {
+    text: string;
+    durationSeconds?: number;
+    modelId?: string;
+}
+export declare function generateSoundEffect(client: VeniceClient, options: SFXOptions, outputPath: string): Promise<string>;
+export interface MusicOptions {
+    prompt: string;
+    durationSeconds?: number;
+    modelId?: string;
+    lyricsPrompt?: string;
+    forceInstrumental?: boolean;
+    voice?: string;
+    /** Playback speed for speed-enabled models (e.g. seed-audio-1-0: 0.5–2). */
+    speed?: number;
+    /** ISO 639-1 language code for models with supports_language_code. */
+    languageCode?: string;
+}
+export declare function generateMusic(client: VeniceClient, options: MusicOptions, outputPath: string): Promise<string>;
+export interface SeedAudioOptions {
+    /** The text/script to speak, or an audio description. Up to 2048 chars. */
+    prompt: string;
+    /** A voice from the model's roster, or "Describe in prompt" to steer via text. */
+    voice?: string;
+    /** Playback speed, 0.5–2 (default 1). */
+    speed?: number;
+    /** Generation length in seconds (default 120). */
+    durationSeconds?: number;
+    /** Override the model id (defaults to seed-audio-1-0). */
+    modelId?: string;
+}
+export declare function generateSeedAudio(client: VeniceClient, options: SeedAudioOptions, outputPath: string): Promise<string>;
+interface QueuedAudioOptions {
+    prompt: string;
+    modelId?: string;
+    durationSeconds?: number;
+    forceInstrumental?: boolean;
+    voice?: string;
+    languageCode?: string;
+    speed?: number;
+    lyricsPrompt?: string;
+    pollIntervalMs?: number;
+    maxPollAttempts?: number;
+}
+export declare function generateQueuedAudio(client: VeniceClient, options: QueuedAudioOptions, outputPath: string): Promise<string>;
+export {};
+//# sourceMappingURL=audio.d.ts.map

package/dist/venice/audio.d.ts.map

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

package/dist/venice/audio.js

@@ -0,0 +1,234 @@
+// ---------------------------------------------------------------------------
+// Venice Audio API -- TTS, music, sound effects, queued audio generation
+// ---------------------------------------------------------------------------
+import { execFile } from 'node:child_process';
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, extname, join } from 'node:path';
+import { promisify } from 'node:util';
+import { getMusicModel } from './models.js';
+const execFileAsync = promisify(execFile);
+// ---- Default Models -------------------------------------------------------
+export const DEFAULT_VENICE_TTS_MODEL = 'tts-kokoro';
+export const DEFAULT_VENICE_MUSIC_MODEL = 'elevenlabs-music';
+export const DEFAULT_VENICE_SFX_MODEL = 'elevenlabs-sound-effects-v2';
+/** BytePlus Seed Audio 1.0 — expressive prompt-driven speech/audio via the audio queue. */
+export const DEFAULT_VENICE_SEED_AUDIO_MODEL = 'seed-audio-1-0';
+/**
+ * @deprecated Use DEFAULT_VENICE_MUSIC_MODEL or DEFAULT_VENICE_SFX_MODEL.
+ * Kept for backward compatibility with existing scripts.
+ */
+export const DEFAULT_VENICE_AUDIO_MODEL = 'stable-audio-25';
+export async function generateSpeech(client, options, outputPath) {
+    const { voiceId, text, modelId = DEFAULT_VENICE_TTS_MODEL, prompt, speed = 1, responseFormat = 'mp3', streaming = false, language, temperature, top_p, } = options;
+    const body = {
+        input: text,
+        model: modelId,
+        voice: voiceId,
+        response_format: responseFormat,
+        speed,
+        streaming,
+    };
+    if (prompt && (modelId.startsWith('tts-qwen3') || modelId.startsWith('elevenlabs'))) {
+        body.prompt = prompt;
+    }
+    if (language && modelId.startsWith('tts-qwen3')) {
+        body.language = language;
+    }
+    if (temperature !== undefined && modelId.startsWith('tts-qwen3')) {
+        body.temperature = temperature;
+    }
+    if (top_p !== undefined && modelId.startsWith('tts-qwen3')) {
+        body.top_p = top_p;
+    }
+    const audioBuffer = await client.postBinary('/api/v1/audio/speech', body);
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, audioBuffer);
+    return outputPath;
+}
+export async function generateDialogueForShots(client, lines, outputDir) {
+    await mkdir(outputDir, { recursive: true });
+    const results = [];
+    for (const line of lines) {
+        const shotNum = String(line.shotNumber).padStart(3, '0');
+        const filename = `dialogue-shot-${shotNum}.mp3`;
+        const outputPath = `${outputDir}/${filename}`;
+        await generateSpeech(client, {
+            voiceId: line.voiceId,
+            text: line.text,
+            prompt: line.voicePrompt,
+        }, outputPath);
+        results.push({
+            shotNumber: line.shotNumber,
+            character: line.character,
+            text: line.text,
+            path: outputPath,
+        });
+        console.log(`  TTS [${line.character}] shot ${shotNum}: "${line.text.slice(0, 40)}..." -> ${filename}`);
+    }
+    return results;
+}
+export async function generateSoundEffect(client, options, outputPath) {
+    const { text, durationSeconds = 5, modelId = DEFAULT_VENICE_SFX_MODEL, } = options;
+    return generateQueuedAudio(client, {
+        prompt: text,
+        modelId,
+        durationSeconds: clamp(durationSeconds, 1, 190),
+    }, outputPath);
+}
+export async function generateMusic(client, options, outputPath) {
+    const { prompt, durationSeconds = 60, modelId = DEFAULT_VENICE_MUSIC_MODEL, lyricsPrompt, forceInstrumental, voice, speed, languageCode, } = options;
+    return generateQueuedAudio(client, {
+        prompt,
+        modelId,
+        durationSeconds: clamp(durationSeconds, 1, 190),
+        lyricsPrompt,
+        forceInstrumental,
+        voice,
+        speed,
+        languageCode,
+    }, outputPath);
+}
+export async function generateSeedAudio(client, options, outputPath) {
+    const modelId = options.modelId ?? DEFAULT_VENICE_SEED_AUDIO_MODEL;
+    const spec = getMusicModel(modelId);
+    const prompt = options.prompt?.trim() ?? '';
+    const minLen = spec?.minPromptLength ?? 1;
+    const maxLen = spec?.promptCharacterLimit ?? 2048;
+    if (prompt.length < minLen) {
+        throw new Error(`${modelId}: prompt is required (min ${minLen} char).`);
+    }
+    if (prompt.length > maxLen) {
+        throw new Error(`${modelId}: prompt is ${prompt.length} chars, exceeds the ${maxLen}-char limit. ` +
+            `Split into multiple calls and concatenate the audio.`);
+    }
+    // Only send a voice the model actually offers; otherwise let the model use
+    // its default ("Describe in prompt" for seed-audio) so voice steering can
+    // live in the prompt text.
+    let voice = options.voice;
+    if (voice && spec?.voices && !spec.voices.includes(voice)) {
+        throw new Error(`${modelId}: unknown voice "${voice}". Valid voices: ${spec.voices.join(', ')}.`);
+    }
+    if (!voice && spec?.defaultVoice)
+        voice = spec.defaultVoice;
+    let speed = options.speed;
+    if (speed !== undefined && spec?.supportsSpeed) {
+        speed = clamp(speed, spec.minSpeed ?? 0.5, spec.maxSpeed ?? 2);
+    }
+    else if (speed !== undefined && spec && !spec.supportsSpeed) {
+        speed = undefined; // model ignores speed; drop it to keep the request clean
+    }
+    const durationSeconds = options.durationSeconds ?? spec?.defaultDurationSec ?? 120;
+    return generateQueuedAudio(client, {
+        prompt,
+        modelId,
+        durationSeconds,
+        voice,
+        speed,
+    }, outputPath);
+}
+export async function generateQueuedAudio(client, options, outputPath) {
+    const { prompt, modelId = DEFAULT_VENICE_MUSIC_MODEL, durationSeconds, forceInstrumental, voice, languageCode, speed, lyricsPrompt, pollIntervalMs = 5_000, maxPollAttempts = 120, } = options;
+    const queueBody = {
+        model: modelId,
+        prompt,
+    };
+    if (durationSeconds !== undefined) {
+        queueBody.duration_seconds = durationSeconds;
+    }
+    if (forceInstrumental !== undefined) {
+        queueBody.force_instrumental = forceInstrumental;
+    }
+    if (voice) {
+        queueBody.voice = voice;
+    }
+    if (languageCode) {
+        queueBody.language_code = languageCode;
+    }
+    if (speed !== undefined) {
+        queueBody.speed = speed;
+    }
+    if (lyricsPrompt) {
+        queueBody.lyrics_prompt = lyricsPrompt;
+    }
+    const queued = await client.post('/api/v1/audio/queue', queueBody);
+    for (let attempt = 0; attempt < maxPollAttempts; attempt++) {
+        if (attempt > 0) {
+            await sleep(pollIntervalMs);
+        }
+        const response = await client.postBinaryOrJson('/api/v1/audio/retrieve', {
+            model: queued.model,
+            queue_id: queued.queue_id,
+            delete_media_on_completion: false,
+        });
+        if (Buffer.isBuffer(response.value)) {
+            await writeAudioBuffer(response.value, response.contentType, outputPath);
+            await client.post('/api/v1/audio/complete', {
+                model: queued.model,
+                queue_id: queued.queue_id,
+            });
+            return outputPath;
+        }
+        const status = response.value;
+        if (status.status === 'PROCESSING') {
+            console.log(`  Audio still processing (${Math.round(status.execution_duration / 1000)}s / ~${Math.round(status.average_execution_time / 1000)}s)`);
+        }
+    }
+    throw new Error(`Timed out waiting for Venice audio generation: ${queued.model} (${queued.queue_id})`);
+}
+// ---- Internals ------------------------------------------------------------
+async function writeAudioBuffer(buffer, contentType, outputPath) {
+    await mkdir(dirname(outputPath), { recursive: true });
+    const inputExt = extensionFromContentType(contentType);
+    const outputExt = extname(outputPath).toLowerCase();
+    if (!inputExt || inputExt === outputExt) {
+        await writeFile(outputPath, buffer);
+        return;
+    }
+    const tempDir = await mkdtemp(join(tmpdir(), 'venice-audio-'));
+    const tempInput = join(tempDir, `source${inputExt}`);
+    try {
+        await writeFile(tempInput, buffer);
+        const ffmpegArgs = ffmpegTranscodeArgs(tempInput, outputPath, outputExt);
+        await execFileAsync('ffmpeg', ffmpegArgs);
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true });
+    }
+}
+function extensionFromContentType(contentType) {
+    if (contentType.includes('audio/mpeg'))
+        return '.mp3';
+    if (contentType.includes('audio/wav'))
+        return '.wav';
+    if (contentType.includes('audio/flac'))
+        return '.flac';
+    if (contentType.includes('audio/aac'))
+        return '.aac';
+    if (contentType.includes('audio/opus'))
+        return '.opus';
+    if (contentType.includes('audio/pcm'))
+        return '.pcm';
+    return null;
+}
+function ffmpegTranscodeArgs(inputPath, outputPath, outputExt) {
+    switch (outputExt) {
+        case '.mp3':
+            return ['-y', '-i', inputPath, '-vn', '-codec:a', 'libmp3lame', '-q:a', '2', outputPath];
+        case '.wav':
+            return ['-y', '-i', inputPath, '-vn', '-codec:a', 'pcm_s16le', outputPath];
+        case '.flac':
+            return ['-y', '-i', inputPath, '-vn', '-codec:a', 'flac', outputPath];
+        case '.aac':
+            return ['-y', '-i', inputPath, '-vn', '-codec:a', 'aac', outputPath];
+        default:
+            return ['-y', '-i', inputPath, outputPath];
+    }
+}
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=audio.js.map

package/dist/venice/audio.js.map

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

package/dist/venice/client.d.ts

@@ -0,0 +1,86 @@
+export declare class VeniceRequestError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+export interface VeniceDeprecationNotice {
+    modelId: string | null;
+    modelName: string | null;
+    warning: string;
+    date: string | null;
+}
+/**
+ * Inspect a Response's headers for Venice deprecation notices and emit
+ * a structured stderr warning the first time each unique notice is seen
+ * in this process. Returns the parsed notice when present (mostly for
+ * testing), otherwise null.
+ *
+ * Exported for tests; callers in this file invoke it from each request
+ * path so every response shape (json, binary, json-or-binary) is covered.
+ */
+export declare function reportVeniceDeprecation(headers: Headers, requestPath: string): VeniceDeprecationNotice | null;
+/**
+ * Test-only: reset the per-process deduplication state so unit tests can
+ * exercise the warn-once behavior across multiple invocations.
+ */
+export declare function _resetDeprecationDedupeForTests(): void;
+export declare class VeniceClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    /**
+     * Timestamp (epoch ms) of the last request that completed.  Used by the
+     * simple rate-limiter to ensure a minimum gap between consecutive calls.
+     */
+    private lastRequestAt;
+    /**
+     * @param apiKey  Bearer token for the Venice API.  Falls back to the
+     *                `VENICE_API_KEY` environment variable when omitted.
+     * @param baseUrl Root URL for the API (no trailing slash).
+     */
+    constructor(apiKey?: string, baseUrl?: string);
+    /** Send a GET request and return parsed JSON. Used by setup/doctor checks. */
+    get<T = unknown>(path: string): Promise<T>;
+    /**
+     * Send a POST request to `path` with a JSON body and return the parsed
+     * response.
+     *
+     * Automatically retries on transient failures (HTTP 429 / 5xx) up to
+     * {@link MAX_RETRIES} times using exponential back-off.  A small delay is
+     * inserted between consecutive requests to stay within rate limits.
+     *
+     * @typeParam T  Expected shape of the parsed JSON response.
+     * @param path   API path **including** the leading slash (e.g. `/api/v1/image/generate`).
+     * @param body   Request payload -- will be JSON-stringified.
+     * @returns      Parsed JSON response body.
+     * @throws {VeniceRequestError} On non-retryable HTTP errors (4xx other than 429).
+     * @throws {Error}              When all retry attempts are exhausted.
+     */
+    post<T = unknown>(path: string, body: Record<string, unknown>): Promise<T>;
+    /**
+     * POST with JSON body, receive raw binary (e.g. image/png from multi-edit).
+     * Same retry/rate-limit logic as {@link post}.
+     */
+    postBinary(path: string, body: Record<string, unknown>): Promise<Buffer>;
+    /**
+     * POST with JSON body, receive either JSON status data or raw binary media.
+     * Useful for async retrieval endpoints that return JSON while processing and
+     * switch to binary once the asset is ready for download.
+     */
+    postBinaryOrJson<T = unknown>(path: string, body: Record<string, unknown>): Promise<{
+        contentType: string;
+        value: T | Buffer;
+    }>;
+    /**
+     * Send a chat completion request with multimodal content (text + images).
+     * Uses the OpenAI-compatible chat completions endpoint.
+     */
+    chatWithVision(model: string, systemPrompt: string, imageDataUris: string[], userPrompt: string): Promise<string>;
+    /**
+     * Ensure at least {@link RATE_LIMIT_DELAY_MS} ms have elapsed since the
+     * previous request completed.
+     */
+    private applyRateLimit;
+    /** Promise-based sleep helper. */
+    private static sleep;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/venice/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/venice/client.ts"],"names":[],"mappings":"AAkBA,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,OAAO,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAM3D;AA6BD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,GAClB,uBAAuB,GAAG,IAAI,CA2BhC;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAK;IAE1B;;;;OAIG;gBACS,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAa7C,8EAA8E;IACxE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAuBhD;;;;;;;;;;;;;;OAcG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmFhF;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA+D9E;;;;OAIG;IACG,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAA;KAAE,CAAC;IAyEtD;;;OAGG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EAAE,EACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;IA0BlB;;;OAGG;YACW,cAAc;IAO5B,kCAAkC;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK;CAGrB"}