@helix3/helix-cli 0.1.13-helix3.74 → 0.1.13-helix3.76

package/dist/audioCommand.d.ts

@@ -1,6 +1,30 @@
 import type { Command } from 'commander';
 import { type GenerateAudioInput, type StandaloneGeneratedAsset } from './assets';
 import type { CliCredentials } from './config';
+type GenerateAudioOptions = {
+    mode: string;
+    additionalPrompt?: string;
+    model?: string;
+    outputFormat?: string;
+    projectId?: string;
+    sessionId?: string;
+    title?: string;
+    durationSeconds?: string;
+    loop?: boolean;
+    promptInfluence?: string;
+    forceInstrumental?: boolean;
+    text?: string;
+    voiceId?: string;
+    languageCode?: string;
+    seed?: string;
+    stability?: string;
+    similarityBoost?: string;
+    style?: string;
+    speed?: string;
+    speakerBoost?: boolean;
+    pronunciationDictionaryIds?: string;
+    output?: string;
+};
 export type GenerateAudioCommandDependencies = {
     requireAuth: () => CliCredentials;
     generateAudio: (creds: CliCredentials, input: GenerateAudioInput, options?: {
@@ -12,4 +36,30 @@ export type GenerateAudioCommandDependencies = {
     printJson: (value: unknown) => void;
     fail: (message: string) => never;
 };
+export declare const AUDIO_MODES: readonly ["sound_effect", "music", "text_to_speech"];
+export declare const AUDIO_OPTIONS: {
+    flags: string;
+    description: string;
+    default?: string;
+    shared?: boolean;
+}[];
+/** Attach the audio flags. `skipShared` omits the ones the target command already declares. */
+export declare function addAudioOptions(command: Command, opts?: {
+    skipShared?: boolean;
+}): Command;
+export type AudioFlagValues = Omit<GenerateAudioOptions, 'output'>;
+/**
+ * Parse the audio flags into the library's input shape. Shared by both routes so a flag can never
+ * mean one thing synchronously and another durably.
+ */
+export declare function buildAudioInput(prompt: string | undefined, opts: AudioFlagValues, fail: (message: string) => never): GenerateAudioInput;
+/**
+ * Everything that can be known to be wrong BEFORE any LIX moves. Returns the problems rather than
+ * throwing, so callers can render them all at once with the fix named.
+ *
+ * The voice check is deliberately NOT done here — it needs the catalog, and a network lookup that
+ * fails must not become a new way to block a valid job.
+ */
+export declare function validateAudioRequest(prompt: string | undefined, opts: AudioFlagValues): string[];
 export declare function registerGenerateAudioCommand(assets: Command, dependencies: GenerateAudioCommandDependencies): void;
+export {};

package/dist/audioCommand.js

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUDIO_OPTIONS = exports.AUDIO_MODES = void 0;
+exports.addAudioOptions = addAudioOptions;
+exports.buildAudioInput = buildAudioInput;
+exports.validateAudioRequest = validateAudioRequest;
 exports.registerGenerateAudioCommand = registerGenerateAudioCommand;
 const api_1 = require("./api");
 const assets_1 = require("./assets");
-const AUDIO_MODES = [
+exports.AUDIO_MODES = [
     'sound_effect',
     'music',
     'text_to_speech',
@@ -24,73 +28,140 @@ function commaList(value) {
         .filter(Boolean);
     return values?.length ? values : undefined;
 }
+// The audio flags, as DATA, so the synchronous route (`generate-audio`) and the durable route
+// (`assets start audio`) attach the SAME names from one definition. They drifted once already:
+// `start` accepted no mode/text/voice flags at all, so the async path agents are told to prefer
+// could only ever produce a sound effect, and music and speech were reachable only by blocking the
+// call with no job id to poll.
+//
+// `start` already declares --title/--additional-prompt/--project-id/--session-id/--duration-seconds
+// /--loop for every kind, so those are marked shared and skipped when attaching there.
+exports.AUDIO_OPTIONS = [
+    { flags: '--mode <mode>', description: 'sound_effect, music, or text_to_speech', default: 'sound_effect' },
+    { flags: '--additional-prompt <text>', description: 'additional generation guidance', shared: true },
+    { flags: '--model <model>', description: 'an allowlisted ElevenLabs model id for the selected --mode' },
+    { flags: '--output-format <format>', description: 'portable MP3 output format, e.g. mp3_44100_128' },
+    { flags: '--project-id <id>', description: 'Dreamer project id', shared: true },
+    { flags: '--session-id <id>', description: 'Dreamer session id', shared: true },
+    { flags: '--title <title>', description: 'asset title', shared: true },
+    { flags: '--duration-seconds <n>', description: 'requested duration — sound_effect: 0.5-30s; music: 3-600s', shared: true },
+    { flags: '--loop', description: 'sound_effect only: request a seamless loop', shared: true },
+    { flags: '--prompt-influence <n>', description: 'sound_effect only: how closely to follow the prompt (0-1)' },
+    { flags: '--force-instrumental', description: 'music only: request an instrumental-only composition' },
+    { flags: '--text <text>', description: 'text_to_speech only: the text to convert to speech' },
+    { flags: '--voice-id <id>', description: 'text_to_speech only: the voice id to speak with (see `helix assets voices`)' },
+    { flags: '--language-code <code>', description: 'text_to_speech only: ISO 639-1 language code' },
+    { flags: '--seed <n>', description: 'text_to_speech only: a seed for deterministic output' },
+    { flags: '--stability <n>', description: 'text_to_speech only: voice stability (0-1)' },
+    { flags: '--similarity-boost <n>', description: 'text_to_speech only: voice similarity boost (0-1)' },
+    { flags: '--style <n>', description: 'text_to_speech only: voice style (0-1)' },
+    { flags: '--speed <n>', description: 'text_to_speech only: voice speed (0.7-1.2)' },
+    { flags: '--speaker-boost', description: 'text_to_speech only: enable speaker boost' },
+    {
+        flags: '--pronunciation-dictionary-ids <a,b,c>',
+        description: 'text_to_speech only: up to 3 comma-separated pronunciation dictionary ids',
+    },
+];
+/** Attach the audio flags. `skipShared` omits the ones the target command already declares. */
+function addAudioOptions(command, opts = {}) {
+    for (const option of exports.AUDIO_OPTIONS) {
+        if (opts.skipShared && option.shared)
+            continue;
+        if (option.default === undefined)
+            command.option(option.flags, option.description);
+        else
+            command.option(option.flags, option.description, option.default);
+    }
+    return command;
+}
+/**
+ * Parse the audio flags into the library's input shape. Shared by both routes so a flag can never
+ * mean one thing synchronously and another durably.
+ */
+function buildAudioInput(prompt, opts, fail) {
+    const stability = optionalNumber(opts.stability, '--stability', fail);
+    const similarityBoost = optionalNumber(opts.similarityBoost, '--similarity-boost', fail);
+    const style = optionalNumber(opts.style, '--style', fail);
+    const speed = optionalNumber(opts.speed, '--speed', fail);
+    const voiceSettings = stability === undefined &&
+        similarityBoost === undefined &&
+        style === undefined &&
+        speed === undefined &&
+        opts.speakerBoost === undefined
+        ? undefined
+        : { stability, similarityBoost, style, speed, speakerBoost: opts.speakerBoost };
+    return {
+        prompt,
+        audioMode: opts.mode,
+        additionalPrompt: opts.additionalPrompt,
+        model: opts.model,
+        outputFormat: opts.outputFormat,
+        projectId: opts.projectId,
+        sessionId: opts.sessionId,
+        title: opts.title,
+        durationSeconds: optionalNumber(opts.durationSeconds, '--duration-seconds', fail),
+        loop: opts.loop,
+        promptInfluence: optionalNumber(opts.promptInfluence, '--prompt-influence', fail),
+        forceInstrumental: opts.forceInstrumental,
+        text: opts.text,
+        voiceId: opts.voiceId,
+        languageCode: opts.languageCode,
+        seed: optionalNumber(opts.seed, '--seed', fail),
+        voiceSettings,
+        pronunciationDictionaryIds: commaList(opts.pronunciationDictionaryIds),
+    };
+}
+/**
+ * Everything that can be known to be wrong BEFORE any LIX moves. Returns the problems rather than
+ * throwing, so callers can render them all at once with the fix named.
+ *
+ * The voice check is deliberately NOT done here — it needs the catalog, and a network lookup that
+ * fails must not become a new way to block a valid job.
+ */
+function validateAudioRequest(prompt, opts) {
+    const problems = [];
+    const mode = opts.mode;
+    if (!exports.AUDIO_MODES.includes(mode)) {
+        problems.push(`--mode must be ${exports.AUDIO_MODES.join(', ')}; got '${opts.mode}'`);
+        return problems; // every other rule is mode-specific
+    }
+    if (mode === 'text_to_speech') {
+        if (!opts.text?.trim()) {
+            problems.push('text_to_speech needs --text "<what to say>" (the prompt argument is not used for speech)');
+        }
+        if (!opts.voiceId?.trim()) {
+            problems.push('text_to_speech needs --voice-id <id> — list them with `helix assets voices`');
+        }
+    }
+    else if (!prompt?.trim()) {
+        problems.push(`${mode} needs a prompt argument describing the audio to generate`);
+    }
+    if (mode !== 'music' && opts.forceInstrumental) {
+        problems.push('--force-instrumental applies to music only');
+    }
+    if (mode !== 'sound_effect' && opts.loop) {
+        problems.push('--loop applies to sound_effect only');
+    }
+    if (mode !== 'sound_effect' && opts.promptInfluence !== undefined) {
+        problems.push('--prompt-influence applies to sound_effect only');
+    }
+    return problems;
+}
 function registerGenerateAudioCommand(assets, dependencies) {
-    assets
+    const command = assets
         .command('generate-audio')
-        .description('Generate a sound effect, music track, or spoken line via ElevenLabs (through Dreamer), auto-publish it to Vault, and optionally save it locally')
-        .argument('[prompt]', 'generation prompt — required for sound_effect/music; text_to_speech uses --text instead')
-        .option('--mode <mode>', 'sound_effect, music, or text_to_speech', 'sound_effect')
-        .option('--additional-prompt <text>', 'additional generation guidance')
-        .option('--model <model>', 'an allowlisted ElevenLabs model id for the selected --mode')
-        .option('--output-format <format>', 'portable MP3 output format, e.g. mp3_44100_128')
-        .option('--project-id <id>', 'Dreamer project id')
-        .option('--session-id <id>', 'Dreamer session id')
-        .option('--title <title>', 'asset title')
-        .option('--duration-seconds <n>', 'requested duration — sound_effect: 0.5-30s; music: 3-600s')
-        .option('--loop', 'sound_effect only: request a seamless loop')
-        .option('--prompt-influence <n>', 'sound_effect only: how closely to follow the prompt (0-1)')
-        .option('--force-instrumental', 'music only: request an instrumental-only composition')
-        .option('--text <text>', 'text_to_speech only: the text to convert to speech')
-        .option('--voice-id <id>', 'text_to_speech only: the ElevenLabs voice id to speak with')
-        .option('--language-code <code>', 'text_to_speech only: ISO 639-1 language code')
-        .option('--seed <n>', 'text_to_speech only: a seed for deterministic output')
-        .option('--stability <n>', 'text_to_speech only: voice stability (0-1)')
-        .option('--similarity-boost <n>', 'text_to_speech only: voice similarity boost (0-1)')
-        .option('--style <n>', 'text_to_speech only: voice style (0-1)')
-        .option('--speed <n>', 'text_to_speech only: voice speed (0.7-1.2)')
-        .option('--speaker-boost', 'text_to_speech only: enable speaker boost')
-        .option('--pronunciation-dictionary-ids <a,b,c>', 'text_to_speech only: up to 3 comma-separated pronunciation dictionary ids')
+        .description('Generate a sound effect, music track, or spoken line via ElevenLabs (through Dreamer), auto-publish it to Vault, and optionally save it locally. Blocks until done — use `helix assets start audio` for a pollable job.')
+        .argument('[prompt]', 'generation prompt — required for sound_effect/music; text_to_speech uses --text instead');
+    addAudioOptions(command)
         .option('--output <path>', 'save the generated audio file to this path')
         .action(async (prompt, opts) => {
-        if (!AUDIO_MODES.includes(opts.mode)) {
-            dependencies.fail(`✖ --mode must be ${AUDIO_MODES.join(', ')}; got '${opts.mode}'`);
+        const problems = validateAudioRequest(prompt, opts);
+        if (problems.length) {
+            dependencies.fail(`✖ ${problems.join('\n  ✖ ')}`);
         }
-        const durationSeconds = optionalNumber(opts.durationSeconds, '--duration-seconds', dependencies.fail);
-        const promptInfluence = optionalNumber(opts.promptInfluence, '--prompt-influence', dependencies.fail);
-        const seed = optionalNumber(opts.seed, '--seed', dependencies.fail);
-        const stability = optionalNumber(opts.stability, '--stability', dependencies.fail);
-        const similarityBoost = optionalNumber(opts.similarityBoost, '--similarity-boost', dependencies.fail);
-        const style = optionalNumber(opts.style, '--style', dependencies.fail);
-        const speed = optionalNumber(opts.speed, '--speed', dependencies.fail);
-        const voiceSettings = stability === undefined &&
-            similarityBoost === undefined &&
-            style === undefined &&
-            speed === undefined &&
-            opts.speakerBoost === undefined
-            ? undefined
-            : { stability, similarityBoost, style, speed, speakerBoost: opts.speakerBoost };
         const creds = dependencies.requireAuth();
         try {
-            const job = await dependencies.generateAudio(creds, {
-                prompt,
-                audioMode: opts.mode,
-                additionalPrompt: opts.additionalPrompt,
-                model: opts.model,
-                outputFormat: opts.outputFormat,
-                projectId: opts.projectId,
-                sessionId: opts.sessionId,
-                title: opts.title,
-                durationSeconds,
-                loop: opts.loop,
-                promptInfluence,
-                forceInstrumental: opts.forceInstrumental,
-                text: opts.text,
-                voiceId: opts.voiceId,
-                languageCode: opts.languageCode,
-                seed,
-                voiceSettings,
-                pronunciationDictionaryIds: commaList(opts.pronunciationDictionaryIds),
-            }, { timeoutMs: assets_1.AUDIO_GENERATION_TIMEOUT_MS });
+            const job = await dependencies.generateAudio(creds, buildAudioInput(prompt, opts, dependencies.fail), { timeoutMs: assets_1.AUDIO_GENERATION_TIMEOUT_MS });
             if (opts.output && job.status === 'succeeded' && job.asset) {
                 await dependencies.saveGeneratedAsset(job.asset, opts.output, {
                     apiUrl: creds.apiUrl,

package/dist/audioCommand.js.map

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

package/dist/index.js

@@ -299,7 +299,25 @@ program
     .argument('[directory]', 'bundle directory', '.')
     .option('--thumbnail <file>', 'cover image (png, jpg/jpeg, webp, avif, or gif); otherwise uses thumbnail.<ext> at the bundle root')
     .option('--skip-subpath-check', 'skip the pre-publish sub-path load check (not recommended: it is the only gate that serves the bundle the way production does)')
+    .option('--description <text>', `catalog description, max ${lib_1.WORLD_DESCRIPTION_MAX} chars (pass "" to clear). helix.json cannot carry this — the manifest schema forbids unknown fields`)
+    .option('--description-file <path>', 'read the catalog description from a file')
     .action(async (directory, opts) => {
+    // Pure input checks first — bad flags should fail before auth, the network, or any upload.
+    if (opts.description !== undefined && opts.descriptionFile) {
+        fail('✖ Pass --description or --description-file, not both');
+    }
+    let description = opts.description;
+    if (opts.descriptionFile) {
+        try {
+            description = (0, node_fs_1.readFileSync)((0, node_path_1.resolve)(opts.descriptionFile), 'utf8').trim();
+        }
+        catch (err) {
+            fail(`✖ could not read --description-file: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (description !== undefined && description.length > lib_1.WORLD_DESCRIPTION_MAX) {
+        fail(`✖ description is ${description.length} chars; the limit is ${lib_1.WORLD_DESCRIPTION_MAX}. Nothing was published.`);
+    }
     const creds = requireAuth();
     const mismatch = (0, config_1.credsEnvMismatchWarning)(creds.apiUrl);
     if (mismatch)
@@ -325,7 +343,10 @@ program
         }
     }
     try {
-        const result = await (0, lib_1.publishWorld)((0, node_path_1.resolve)(directory), creds, (msg) => console.log(msg), { thumbnail: opts.thumbnail ? (0, node_path_1.resolve)(opts.thumbnail) : undefined });
+        const result = await (0, lib_1.publishWorld)((0, node_path_1.resolve)(directory), creds, (msg) => console.log(msg), {
+            thumbnail: opts.thumbnail ? (0, node_path_1.resolve)(opts.thumbnail) : undefined,
+            description,
+        });
         console.log(`✔ Published "${result.title}" build ${result.buildNumber}`);
         if (result.playUrl)
             console.log(`  play: ${result.playUrl}`);
@@ -816,19 +837,29 @@ function buildQuoteInput(kind, prompt, opts) {
  * A quote failure never blocks the generation (the server prices it anyway); it warns, because a
  * hard dependency on an advisory call would make the estimate a new way to fail.
  */
-async function showEstimateBeforeSpending(creds, kind, prompt, opts) {
+async function showEstimateBeforeSpending(creds, 
+// The EXACT body the generation call will send. Passing the real request (rather than rebuilding
+// an approximation of it) is what stops the quoted price and the charged price drifting apart.
+input, opts) {
     if (opts.estimate === false)
         return;
     try {
-        const quote = await (0, lib_1.quoteGeneration)(creds, buildQuoteInput(kind, prompt, opts));
+        const quote = await (0, lib_1.quoteGeneration)(creds, input);
         const balance = await (0, lib_1.getLixBalance)(creds).catch(() => null);
         console.log((0, lib_1.formatQuote)(quote, balance));
+        // Guard the CAP, not the estimate. A metered music job is billed on the duration the provider
+        // ACCEPTS, which can exceed the one requested — so its authorized maximum sits above the quote.
+        // Comparing --max-lix against the estimate lets someone approve a bound the charge is then
+        // permitted to exceed, which is the whole point of the flag defeated.
         const maxLix = optionalNumber(typeof opts.maxLix === 'string' ? opts.maxLix : undefined, '--max-lix');
-        if (maxLix !== undefined && quote.totalLix > maxLix) {
-            fail(`✖ Estimated ${quote.totalLix} LIX exceeds --max-lix ${maxLix}. Nothing was charged.`);
+        if (maxLix !== undefined && quote.maxLix > maxLix) {
+            const overshoot = quote.maxLix > quote.totalLix
+                ? ` (estimated ${quote.totalLix}, but this job may be charged up to ${quote.maxLix})`
+                : '';
+            fail(`✖ This job can cost ${quote.maxLix} LIX, which exceeds --max-lix ${maxLix}${overshoot}. Nothing was charged.`);
         }
-        if (balance && balance.source === 'lix-billing' && quote.totalLix > balance.available) {
-            fail(`✖ Not enough LIX: this job needs ${quote.totalLix} and you have ${balance.available} available. Nothing was charged.`);
+        if (balance && balance.source === 'lix-billing' && quote.maxLix > balance.available) {
+            fail(`✖ Not enough LIX: this job can cost up to ${quote.maxLix} and you have ${balance.available} available. Nothing was charged.`);
         }
         console.log('');
     }
@@ -1140,11 +1171,14 @@ assets
         fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
     }
 });
-assets
+const assetsStart = assets
     .command('start')
-    .description('Start one generation job without waiting; prop/character use Dreamer, other supported kinds use the shared asset pipeline')
+    .description('Start one generation job without waiting; prop/character use Dreamer, other supported kinds use the shared asset pipeline. For audio, --mode selects sound_effect (default), music, or text_to_speech.')
     .argument('<kind>', 'prop, character, image, material, audio, gaussian_splat, or animation (explicit unavailable stub)')
-    .argument('<prompt>', 'asset prompt')
+    // Optional at the parser level ON PURPOSE: text_to_speech takes its content from --text, and a
+    // commander-level "missing required argument 'prompt'" would be actively misleading there.
+    // Required-ness is enforced below, per kind, with a message that names the right flag.
+    .argument('[prompt]', 'asset prompt (sound_effect/music/other kinds; speech uses --text)')
     .option('--title <title>', 'asset title')
     .option('--additional-prompt <text>', 'additional generation guidance')
     .option('--target-polycount <n>', 'prop/character triangle target')
@@ -1156,7 +1190,11 @@ assets
     .option('--repeat-per-meter <n>', 'material physical scale: tile repeats per metre')
     .option('--splat-scope <scope>', 'Gaussian-splat scope: object or environment', 'environment')
     .option('--max-lix <n>', 'refuse to start if the estimate exceeds this many LIX')
-    .option('--no-estimate', 'skip the up-front cost estimate')
+    .option('--no-estimate', 'skip the up-front cost estimate');
+// The audio surface, attached from the SAME definition `generate-audio` uses (minus the flags
+// `start` already declares for every kind), so the durable route reaches music and speech with
+// identical flag names instead of only ever producing a sound effect.
+(0, audioCommand_1.addAudioOptions)(assetsStart, { skipShared: true })
     .action(async (kind, prompt, opts) => {
     const supported = [
         'prop',
@@ -1170,6 +1208,13 @@ assets
     if (!supported.includes(kind)) {
         fail(`✖ kind must be ${supported.join(', ')}; got '${kind}'`);
     }
+    // Every kind except audio takes its subject from the prompt argument.
+    if (kind !== 'audio' && !prompt?.trim()) {
+        fail(`✖ ${kind} needs a prompt argument describing what to generate`);
+    }
+    // Past the guard above, only the audio path can still have an absent prompt, and that path
+    // never reads this binding (speech uses --text; sound_effect/music are checked separately).
+    const promptText = prompt ?? '';
     const resolution = optionalNumber(opts.resolution, '--resolution');
     if (resolution !== 1024 && resolution !== 2048) {
         fail('✖ --resolution must be 1024 or 2048');
@@ -1178,22 +1223,70 @@ assets
         !['object', 'environment'].includes(opts.splatScope)) {
         fail('✖ --splat-scope must be object or environment');
     }
+    // Audio is the one kind whose request shape is mode-dependent, so build and check it before
+    // anything else. Until now `start` accepted no audio flags at all, which meant the durable
+    // route agents are told to prefer could only ever emit a sound effect: music and speech were
+    // reachable only by blocking the call, with no job id to poll.
+    let audioInput = null;
+    if (kind === 'audio') {
+        const problems = (0, audioCommand_1.validateAudioRequest)(prompt, opts);
+        if (problems.length) {
+            fail(`✖ ${problems.join('\n  ✖ ')}`);
+        }
+        audioInput = {
+            kind,
+            ...(0, audioCommand_1.buildAudioInput)(prompt, opts, fail),
+        };
+    }
     const creds = requireAuth();
-    await showEstimateBeforeSpending(creds, kind, prompt, opts);
+    // A voice id that is not in the catalog fails HERE, before the quote and before any LIX
+    // moves. A lookup that cannot run only warns — an advisory check must not become a new way
+    // to block a valid job.
+    if (audioInput && typeof audioInput.voiceId === 'string') {
+        const voiceId = audioInput.voiceId;
+        try {
+            const known = await (0, lib_1.listDreamerVoices)(creds, { search: voiceId, pageSize: 100 });
+            const match = known.voices.find((v) => v.id === voiceId);
+            if (!match) {
+                const nearby = known.voices.slice(0, 5).map((v) => `${v.id} (${v.name})`);
+                fail(`✖ No voice "${voiceId}" in the catalog. Nothing was charged.\n` +
+                    `  List them with: helix assets voices\n` +
+                    (nearby.length ? `  Close matches: ${nearby.join(', ')}` : ''));
+            }
+            const languageCode = audioInput.languageCode;
+            if (typeof languageCode === 'string' &&
+                match.languages.length &&
+                !match.languages.some((l) => l.code === languageCode)) {
+                fail(`✖ Voice "${match.name}" does not support language "${languageCode}". Nothing was charged.\n` +
+                    `  It supports: ${match.languages.map((l) => l.code).join(', ')}`);
+            }
+        }
+        catch (err) {
+            if (err instanceof lib_1.ApiError) {
+                console.warn(`  • could not verify the voice id against the catalog: ${err.message}`);
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    const generationInput = audioInput ?? buildQuoteInput(kind, promptText, opts);
+    await showEstimateBeforeSpending(creds, generationInput, opts);
     try {
         if (kind === 'prop' || kind === 'character') {
             printJson(await (0, lib_1.startDreamerAssetGeneration)(creds, {
                 kind,
-                prompt,
+                prompt: promptText,
                 title: opts.title,
                 additionalPrompt: opts.additionalPrompt,
                 targetPolycount: optionalNumber(opts.targetPolycount, '--target-polycount'),
             }));
             return;
         }
-        printJson(await (0, lib_1.startStandaloneAssetGeneration)(creds, {
+        // For audio, send the SAME object that was just quoted — not a re-derived one.
+        printJson(await (0, lib_1.startStandaloneAssetGeneration)(creds, audioInput ?? {
             kind: kind,
-            prompt,
+            prompt: promptText,
             title: opts.title,
             additionalPrompt: opts.additionalPrompt,
             projectId: opts.projectId,
@@ -1210,6 +1303,36 @@ assets
     }
 });
 // ---- Money: what you have, and what a job will cost BEFORE it runs ---------
+program
+    .command('jobs')
+    .description('List your generation jobs with what each one cost — the answer to "what was I charged for?" after a failure')
+    .option('--state <state>', 'all, unfinished, failed, published, or awaiting_approval', 'all')
+    .option('--limit <n>', 'how many to show', '20')
+    .option('--offset <n>', 'skip this many')
+    .option('--json', 'emit the raw rows')
+    .action(async (opts) => {
+    const states = ['all', 'unfinished', 'failed', 'published', 'awaiting_approval'];
+    if (opts.state && !states.includes(opts.state)) {
+        fail(`✖ --state must be ${states.join(', ')}; got '${opts.state}'`);
+    }
+    const creds = requireAuth();
+    try {
+        const result = await (0, lib_1.listJobs)(creds, {
+            state: opts.state,
+            limit: optionalNumber(opts.limit, '--limit'),
+            offset: optionalNumber(opts.offset, '--offset'),
+        });
+        if (opts.json)
+            printJson(result);
+        else
+            console.log((0, lib_1.formatJobs)(result));
+    }
+    catch (err) {
+        fail(err instanceof lib_1.ApiError
+            ? err.render()
+            : `✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
 program
     .command('balance')
     .description('Show your LIX balance: available, held by open jobs, and total')
@@ -1412,7 +1535,7 @@ assets
         fail(`✖ --visibility must be public, unlisted, or private`);
     }
     const creds = requireAuth();
-    await showEstimateBeforeSpending(creds, kind, prompt, opts);
+    await showEstimateBeforeSpending(creds, buildQuoteInput(kind, prompt, opts), opts);
     try {
         printJson(await (0, lib_1.generateAndPublishAsset)(creds, {
             kind,