clipugc 0.2.0

package/dist/commands/characters.js

@@ -0,0 +1,261 @@
+import { logger } from '../utils/logger.js';
+import { isJsonMode, printJson, printTable, printPagination, formatStatus } from '../utils/output.js';
+import { confirm } from '../utils/prompt.js';
+import { AbortedError, ValidationError } from '../utils/errors.js';
+import { waitForCompletion } from '../utils/poll.js';
+import { checkImageStatus } from '../services/images.service.js';
+import { MAX_PER_PAGE, createCharacter, deleteCharacter, getCharacter, getDisplayName, getSelectedLookId, listCharacters, parseDnaJson, renameCharacter, setCharacterVisibility, } from '../services/characters.service.js';
+/** "Character created: Isabel Romero, 26 (id: 6)" — name/age fall back gracefully. */
+function characterHeadline(c) {
+    const name = getDisplayName(c);
+    const age = typeof c.age === 'number' ? String(c.age) : undefined;
+    const label = [name, age].filter(Boolean).join(', ');
+    return `Character created: ${label} (id: ${c.id})`;
+}
+/** The staged first clip returned by create with --make-video, when present. */
+function stagedVideo(c) {
+    const video = c.character_video;
+    return video && typeof video === 'object' && video.id !== undefined ? video : undefined;
+}
+/** Print the staged first clip's id + status with a follow-up hint. */
+function printStagedVideo(video) {
+    logger.info(`First clip queued (video id: ${video.id}, status: ${formatStatus(String(video.status ?? 'pending'))}).`);
+    logger.hint(`Follow it with \`clipugc videos status ${video.id}\` (or download it once completed).`);
+}
+function parseIntStrict(value, label) {
+    const n = Number(value);
+    if (!Number.isInteger(n)) {
+        throw new ValidationError(`${label} must be an integer (got "${value}").`);
+    }
+    return n;
+}
+function yesNo(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    return value ? 'yes' : 'no';
+}
+/** Register the `clipugc characters` command group (AI characters CRUD). */
+export function registerCharactersCommands(program) {
+    const characters = program
+        .command('characters')
+        .description('Manage AI characters (create, list, publish, delete)');
+    characters
+        .command('list')
+        .description('List AI characters (your own by default, or the public discover feed)')
+        .option('--discover', 'Browse public characters instead of your own')
+        .option('--mine', 'List your own characters (default)')
+        .option('--feed', 'Combined feed: your characters first (newest), then public ones in unlock order')
+        .option('--search <q>', 'Search by name')
+        .option('--page <n>', 'Page number')
+        .option('--per-page <n>', `Results per page (max ${MAX_PER_PAGE})`)
+        .action(async (options, cmd) => {
+        const json = isJsonMode(cmd);
+        let scope = 'mine';
+        if (options.discover && !options.mine)
+            scope = 'discover';
+        else if (options.feed && !options.mine)
+            scope = 'feed';
+        let perPage = options.perPage !== undefined ? parseIntStrict(options.perPage, '--per-page') : undefined;
+        if (perPage !== undefined && perPage > MAX_PER_PAGE) {
+            if (!json)
+                logger.warn(`--per-page is capped at ${MAX_PER_PAGE}; using ${MAX_PER_PAGE}.`);
+            perPage = MAX_PER_PAGE;
+        }
+        const page = options.page !== undefined ? parseIntStrict(options.page, '--page') : undefined;
+        const result = await listCharacters({ scope, search: options.search, page, perPage });
+        if (json) {
+            printJson(result.raw);
+            return;
+        }
+        const columns = [
+            { header: 'ID', value: (c) => c.id },
+            { header: 'Name', value: (c) => getDisplayName(c) },
+            { header: 'Age', value: (c) => c.age },
+            { header: 'Gender', value: (c) => c.gender },
+            { header: 'Public', value: (c) => yesNo(c.is_public) },
+        ];
+        if (result.items.some((c) => c.is_locked !== undefined && c.is_locked !== null)) {
+            columns.push({ header: 'Locked', value: (c) => yesNo(c.is_locked) });
+        }
+        if (result.items.some((c) => c.status !== undefined && c.status !== null)) {
+            columns.push({ header: 'Status', value: (c) => (c.status ? formatStatus(String(c.status)) : undefined) });
+        }
+        if (result.items.some((c) => getSelectedLookId(c) !== undefined)) {
+            columns.push({ header: 'Selected Look', value: (c) => getSelectedLookId(c) });
+        }
+        printTable(result.items, columns);
+        printPagination(result.pagination);
+    });
+    characters
+        .command('create')
+        .description('Create a new AI character from a text description (the first look is generated automatically, 2 credits)')
+        .option('--description <text>', 'Describe your character in plain words, 10-1000 chars (e.g. "playful italian street musician woman in her 20s")')
+        .option('--scene <text>', 'Optional scene/pose for the first look, up to 600 chars')
+        .option('--inspiration <files...>', 'Optional inspiration images (up to 6 files)')
+        .option('--private', 'Keep the character private (default: public/discoverable, like the web)')
+        .option('--make-video', 'Also stage the character\'s first video clip right after the first look')
+        .option('--motion-prompt <text>', 'Motion/action prompt for that first clip (requires --make-video)')
+        .option('--wait', 'Wait for the first look to finish generating')
+        // Advanced: raw structured DNA instead of a description (rarely needed).
+        .option('--name <full name>', '[advanced] Full name (2-120 chars) — structured create without a description')
+        .option('--age <n>', '[advanced] Age (18-99)')
+        .option('--gender <gender>', '[advanced] Gender (e.g. male, female, other)')
+        .option('--dna-json <file-or-json>', '[advanced] Appearance DNA fields: inline JSON object or a JSON file path')
+        .action(async (options, cmd) => {
+        const json = isJsonMode(cmd);
+        if (!options.description && !options.name) {
+            throw new ValidationError('Describe your character with --description "…" (or use the advanced --name/--dna-json structured path).');
+        }
+        const dna = options.dnaJson !== undefined ? await parseDnaJson(options.dnaJson) : undefined;
+        const age = options.age !== undefined ? parseIntStrict(options.age, '--age') : undefined;
+        const character = await createCharacter({
+            description: options.description,
+            scene: options.scene,
+            inspirationFiles: options.inspiration,
+            name: options.name,
+            age,
+            gender: options.gender,
+            // Web parity: public by default; --private opts out. (Structured path keeps
+            // the server default unless --private is passed.)
+            isPublic: options.description ? !options.private : options.private ? false : undefined,
+            dna,
+            makeVideo: options.makeVideo,
+            motionPrompt: options.motionPrompt,
+        });
+        const rawLooks = character.reference_images;
+        const looks = Array.isArray(rawLooks)
+            ? rawLooks
+            : [];
+        const firstLook = looks[0];
+        const firstClip = stagedVideo(character);
+        if (options.wait && firstLook?.id !== undefined) {
+            const final = await waitForCompletion(() => checkImageStatus(String(firstLook.id)), {
+                label: 'first look',
+                quiet: json,
+            });
+            // The name/age/DNA are extracted asynchronously (in the first-look job), so the
+            // create response had them null — re-fetch now that the look is done.
+            const resolved = await getCharacter(String(character.id)).catch(() => character);
+            if (json) {
+                printJson({ ...resolved, reference_images: [final] });
+                return;
+            }
+            logger.success(characterHeadline(resolved));
+            const clip = stagedVideo(resolved) ?? firstClip;
+            if (clip) {
+                printStagedVideo(clip);
+            }
+            else {
+                logger.hint(`Make a video: clipugc videos create --image ${firstLook.id} --wait`);
+            }
+            return;
+        }
+        if (json) {
+            printJson(character);
+            return;
+        }
+        logger.success(`Character created (id: ${character.id})`);
+        if (firstLook?.id !== undefined && !options.wait) {
+            logger.info('First look is generating; its name & appearance fill in when it finishes.');
+            logger.hint(`Check it with: clipugc images status ${firstLook.id} --wait`);
+        }
+        else if (firstLook?.id === undefined) {
+            logger.hint(`Next: clipugc images generate --character ${character.id}`);
+        }
+        if (firstClip)
+            printStagedVideo(firstClip);
+    });
+    characters
+        .command('show <id>')
+        .description('Show a character in detail')
+        .action(async (id, _options, cmd) => {
+        const json = isJsonMode(cmd);
+        const character = await getCharacter(id);
+        if (json) {
+            printJson(character);
+            return;
+        }
+        for (const [key, value] of Object.entries(character)) {
+            if (value === null || value === undefined || value === '')
+                continue;
+            if (key === 'preview_clip' && typeof value === 'object') {
+                const clip = value;
+                // Locked public rows now return clip_url: null but keep the thumbnail —
+                // render whatever is present instead of dumping the raw object.
+                const url = clip.clip_url ?? clip.url;
+                const thumbnail = clip.clip_thumbnail_url ?? clip.thumbnail_url;
+                if (url)
+                    logger.kv('preview_clip', url);
+                if (thumbnail)
+                    logger.kv('preview_thumbnail', thumbnail);
+                if (url || thumbnail)
+                    continue;
+            }
+            if (typeof value === 'object') {
+                logger.kv(key, JSON.stringify(value));
+            }
+            else if (key === 'status') {
+                logger.kv(key, formatStatus(String(value)));
+            }
+            else {
+                logger.kv(key, String(value));
+            }
+        }
+    });
+    characters
+        .command('rename <id>')
+        .description('Rename a character')
+        .requiredOption('--name <new name>', 'New full name (2-120 characters)')
+        .action(async (id, options, cmd) => {
+        const json = isJsonMode(cmd);
+        const character = await renameCharacter(id, options.name);
+        if (json) {
+            printJson(character);
+            return;
+        }
+        logger.success(`Character ${id} renamed to "${character.display_name ?? character.full_name ?? options.name}".`);
+    });
+    characters
+        .command('publish <id>')
+        .description('Make a character public (discoverable by others)')
+        .action(async (id, _options, cmd) => {
+        const json = isJsonMode(cmd);
+        const character = await setCharacterVisibility(id, true);
+        if (json) {
+            printJson(character);
+            return;
+        }
+        logger.success(`Character ${id} is now public.`);
+    });
+    characters
+        .command('unpublish <id>')
+        .description('Make a character private')
+        .action(async (id, _options, cmd) => {
+        const json = isJsonMode(cmd);
+        const character = await setCharacterVisibility(id, false);
+        if (json) {
+            printJson(character);
+            return;
+        }
+        logger.success(`Character ${id} is now private.`);
+    });
+    characters
+        .command('delete <id>')
+        .description('Delete a character')
+        .option('--yes', 'Skip the confirmation prompt')
+        .action(async (id, options, cmd) => {
+        const json = isJsonMode(cmd);
+        if (!options.yes) {
+            const ok = await confirm(`Delete character ${id}? This cannot be undone.`);
+            if (!ok)
+                throw new AbortedError('Delete cancelled.');
+        }
+        const result = await deleteCharacter(id);
+        if (json) {
+            printJson(result ?? { deleted: true, id });
+            return;
+        }
+        logger.success(`Character ${id} deleted.`);
+    });
+}
+//# sourceMappingURL=characters.js.map

package/dist/commands/characters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"characters.js","sourceRoot":"","sources":["../../src/commands/characters.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtG,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAG3C,sFAAsF;AACtF,SAAS,iBAAiB,CAAC,CAAc;IACvC,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,sBAAsB,KAAK,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;AACrD,CAAC;AAED,gFAAgF;AAChF,SAAS,WAAW,CAAC,CAAc;IACjC,MAAM,KAAK,GAAG,CAAC,CAAC,eAAe,CAAC;IAChC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1F,CAAC;AAED,uEAAuE;AACvE,SAAS,gBAAgB,CAAC,KAA+C;IACvE,MAAM,CAAC,IAAI,CAAC,gCAAgC,KAAK,CAAC,EAAE,aAAa,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC;IACtH,MAAM,CAAC,IAAI,CAAC,0CAA0C,KAAK,CAAC,EAAE,qCAAqC,CAAC,CAAC;AACvG,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,KAAa;IAClD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,eAAe,CAAC,GAAG,KAAK,6BAA6B,KAAK,KAAK,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,KAAK,CAAC,KAAc;IAC3B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,MAAM,UAAU,GAAG,OAAO;SACvB,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,sDAAsD,CAAC,CAAC;IAEvE,UAAU;SACP,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,uEAAuE,CAAC;SACpF,MAAM,CAAC,YAAY,EAAE,8CAA8C,CAAC;SACpE,MAAM,CAAC,QAAQ,EAAE,oCAAoC,CAAC;SACtD,MAAM,CAAC,QAAQ,EAAE,iFAAiF,CAAC;SACnG,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC;SACxC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC;SACnC,MAAM,CAAC,gBAAgB,EAAE,yBAAyB,YAAY,GAAG,CAAC;SAClE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,GAAY,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,GAAiC,MAAM,CAAC;QACjD,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,KAAK,GAAG,UAAU,CAAC;aACrD,IAAI,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,KAAK,GAAG,MAAM,CAAC;QAEvD,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxG,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,YAAY,EAAE,CAAC;YACpD,IAAI,CAAC,IAAI;gBAAE,MAAM,CAAC,IAAI,CAAC,2BAA2B,YAAY,WAAW,YAAY,GAAG,CAAC,CAAC;YAC1F,OAAO,GAAG,YAAY,CAAC;QACzB,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE7F,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAEtF,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAA0B;YACrC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACpC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE;YACnD,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;YACtC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;YAC5C,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;SACvD,CAAC;QACF,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,EAAE,CAAC;YAChF,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC;YAC1E,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5G,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEL,UAAU;SACP,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,0GAA0G,CAAC;SACvH,MAAM,CAAC,sBAAsB,EAAE,iHAAiH,CAAC;SACjJ,MAAM,CAAC,gBAAgB,EAAE,yDAAyD,CAAC;SACnF,MAAM,CAAC,0BAA0B,EAAE,6CAA6C,CAAC;SACjF,MAAM,CAAC,WAAW,EAAE,yEAAyE,CAAC;SAC9F,MAAM,CAAC,cAAc,EAAE,yEAAyE,CAAC;SACjG,MAAM,CAAC,wBAAwB,EAAE,kEAAkE,CAAC;SACpG,MAAM,CAAC,QAAQ,EAAE,8CAA8C,CAAC;QACjE,yEAAyE;SACxE,MAAM,CAAC,oBAAoB,EAAE,8EAA8E,CAAC;SAC5G,MAAM,CAAC,WAAW,EAAE,wBAAwB,CAAC;SAC7C,MAAM,CAAC,mBAAmB,EAAE,8CAA8C,CAAC;SAC3E,MAAM,CAAC,2BAA2B,EAAE,0EAA0E,CAAC;SAC/G,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,GAAY,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC1C,MAAM,IAAI,eAAe,CACvB,yGAAyG,CAC1G,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5F,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEzF,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC;YACtC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,gBAAgB,EAAE,OAAO,CAAC,WAAW;YACrC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG;YACH,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,4EAA4E;YAC5E,kDAAkD;YAClD,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YACtF,GAAG;YACH,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAI,SAA4C,CAAC,gBAAgB,CAAC;QAChF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YACnC,CAAC,CAAE,QAA6D;YAChE,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QAEzC,IAAI,OAAO,CAAC,IAAI,IAAI,SAAS,EAAE,EAAE,KAAK,SAAS,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE;gBAClF,KAAK,EAAE,YAAY;gBACnB,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YACH,gFAAgF;YAChF,sEAAsE;YACtE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACjF,IAAI,IAAI,EAAE,CAAC;gBACT,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,gBAAgB,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACtD,OAAO;YACT,CAAC;YACD,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;YAChD,IAAI,IAAI,EAAE,CAAC;gBACT,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,+CAA+C,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;YACpF,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,0BAA0B,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;QAC1D,IAAI,SAAS,EAAE,EAAE,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;YACzF,MAAM,CAAC,IAAI,CAAC,wCAAwC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;QAC7E,CAAC;aAAM,IAAI,SAAS,EAAE,EAAE,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,6CAA6C,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,SAAS;YAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEL,UAAU;SACP,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,QAAQ,EAAE,GAAY,EAAE,EAAE;QACnD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,EAAE,CAAC,CAAC;QAEzC,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;gBAAE,SAAS;YACpE,IAAI,GAAG,KAAK,cAAc,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACxD,MAAM,IAAI,GAAG,KAKZ,CAAC;gBACF,wEAAwE;gBACxE,gEAAgE;gBAChE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC;gBACtC,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,aAAa,CAAC;gBAChE,IAAI,GAAG;oBAAE,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;gBACxC,IAAI,SAAS;oBAAE,MAAM,CAAC,EAAE,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;gBACzD,IAAI,GAAG,IAAI,SAAS;oBAAE,SAAS;YACjC,CAAC;YACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACxC,CAAC;iBAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,UAAU;SACP,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,oBAAoB,CAAC;SACjC,cAAc,CAAC,mBAAmB,EAAE,kCAAkC,CAAC;SACvE,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAAO,EAAE,GAAY,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,gBAAgB,SAAS,CAAC,YAAY,IAAI,SAAS,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;IACnH,CAAC,CAAC,CAAC;IAEL,UAAU;SACP,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,kDAAkD,CAAC;SAC/D,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,QAAQ,EAAE,GAAY,EAAE,EAAE;QACnD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACzD,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEL,UAAU;SACP,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,QAAQ,EAAE,GAAY,EAAE,EAAE;QACnD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1D,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEL,UAAU;SACP,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,oBAAoB,CAAC;SACjC,MAAM,CAAC,OAAO,EAAE,8BAA8B,CAAC;SAC/C,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAAO,EAAE,GAAY,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACjB,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,oBAAoB,EAAE,0BAA0B,CAAC,CAAC;YAC3E,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,YAAY,CAAC,mBAAmB,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,MAAM,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/config.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from 'commander';
+import type { ClipUgcConfig } from '../types/index.js';
+/** Validate a config key or throw a ValidationError listing the valid keys. */
+export declare function assertValidConfigKey(key: string): asserts key is keyof ClipUgcConfig;
+export declare function registerConfigCommands(program: Command): void;

package/dist/commands/config.js

@@ -0,0 +1,69 @@
+import { getConfigKeys, getConfigPath, getConfigValue, isValidConfigKey, loadConfig, setConfigValue, } from '../utils/config.js';
+import { ValidationError } from '../utils/errors.js';
+import { logger } from '../utils/logger.js';
+import { isJsonMode, printJson } from '../utils/output.js';
+import { maskApiKey } from './auth.js';
+/** Validate a config key or throw a ValidationError listing the valid keys. */
+export function assertValidConfigKey(key) {
+    if (!isValidConfigKey(key)) {
+        throw new ValidationError(`Unknown config key "${key}". Valid keys: ${getConfigKeys().join(', ')}`);
+    }
+}
+/** Mask secret values (apiKey) for display; other values pass through. */
+function displayValue(key, value) {
+    return key === 'apiKey' ? maskApiKey(value) : value;
+}
+export function registerConfigCommands(program) {
+    const config = program
+        .command('config')
+        .description(`Manage CLI configuration (keys: ${getConfigKeys().join(', ')})`);
+    config
+        .command('list')
+        .description('Show all configuration values (apiKey is masked)')
+        .action(async (_options, cmd) => {
+        const values = await loadConfig();
+        const masked = Object.fromEntries(getConfigKeys().map((key) => [key, displayValue(key, values[key])]));
+        if (isJsonMode(cmd)) {
+            printJson(masked);
+            return;
+        }
+        for (const key of getConfigKeys()) {
+            logger.kv(key, masked[key]);
+        }
+    });
+    config
+        .command('get <key>')
+        .description(`Print a single configuration value (keys: ${getConfigKeys().join(', ')})`)
+        .action(async (key, _options, cmd) => {
+        assertValidConfigKey(key);
+        const value = await getConfigValue(key);
+        if (isJsonMode(cmd)) {
+            printJson({ key, value });
+            return;
+        }
+        logger.plain(value);
+    });
+    config
+        .command('set <key> <value>')
+        .description(`Set a configuration value (keys: ${getConfigKeys().join(', ')})`)
+        .action(async (key, value, _options, cmd) => {
+        assertValidConfigKey(key);
+        await setConfigValue(key, value);
+        if (isJsonMode(cmd)) {
+            printJson({ key, value: displayValue(key, value) });
+            return;
+        }
+        logger.success(`Set ${key} = ${displayValue(key, value)}`);
+    });
+    config
+        .command('path')
+        .description('Print the path of the config file')
+        .action(async (_options, cmd) => {
+        if (isJsonMode(cmd)) {
+            printJson({ path: getConfigPath() });
+            return;
+        }
+        logger.plain(getConfigPath());
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

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

package/dist/commands/credits.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerCreditsCommands(program: Command): void;

package/dist/commands/credits.js

@@ -0,0 +1,117 @@
+import chalk from 'chalk';
+import { createApiClient } from '../services/api.js';
+import { getCredits, getCreditTransactions } from '../services/user.service.js';
+import { logger } from '../utils/logger.js';
+import { isJsonMode, printJson, printPagination, printTable } from '../utils/output.js';
+/**
+ * Human-readable labels for the per-action cost keys returned by GET /credits.
+ * Unknown keys fall back to a humanized version of the raw key.
+ */
+const COST_LABELS = {
+    image: 'image',
+    clip: 'clip (5s)',
+    clip_10s: 'clip (10s)',
+    motion_per_second: 'motion control (per second)',
+    scene_staged: 'scene-staged clip',
+    merge: 'merge',
+};
+/** Preferred display order for known cost keys; unknown keys follow, sorted. */
+const COST_ORDER = ['image', 'clip', 'clip_10s', 'scene_staged', 'motion_per_second', 'merge'];
+function costLabel(action) {
+    return COST_LABELS[action] ?? action.replace(/_/g, ' ');
+}
+/** Order cost entries: known keys by COST_ORDER, then any unknown keys sorted. */
+function orderedCosts(costs) {
+    const entries = Object.entries(costs).filter((e) => typeof e[1] === 'number');
+    return entries.sort(([a], [b]) => {
+        const ia = COST_ORDER.indexOf(a);
+        const ib = COST_ORDER.indexOf(b);
+        if (ia !== -1 && ib !== -1)
+            return ia - ib;
+        if (ia !== -1)
+            return -1;
+        if (ib !== -1)
+            return 1;
+        return a.localeCompare(b);
+    }).map(([action, cost]) => ({ action, cost }));
+}
+/** "+3" for a top-up/refund, "-7" for a spend (server already signs the amount). */
+function signedAmount(amount) {
+    if (typeof amount !== 'number')
+        return undefined;
+    return amount > 0 ? `+${amount}` : String(amount);
+}
+export function registerCreditsCommands(program) {
+    const credits = program
+        .command('credits')
+        .description('Show your credit balance and the credit cost of each action')
+        .action(async (_options, cmd) => {
+        const api = await createApiClient();
+        const info = await getCredits(api);
+        if (isJsonMode(cmd)) {
+            printJson(info);
+            return;
+        }
+        logger.plain(`\n  Balance: ${chalk.bold(String(info.balance))} credits\n`);
+        const rows = orderedCosts(info.costs ?? {});
+        printTable(rows, [
+            { header: 'action', value: (row) => costLabel(row.action) },
+            { header: 'credits', value: (row) => row.cost },
+        ]);
+        logger.hint('See your ledger: clipugc credits history   ·   Buy more: clipugc credits packs');
+    });
+    credits
+        .command('history')
+        .description('Show your credit transaction history (spends, top-ups, refunds)')
+        .option('--per-page <n>', 'Results per page (max 100)')
+        .option('--page <n>', 'Page number')
+        .action(async (opts, cmd) => {
+        const api = await createApiClient();
+        const perPage = opts.perPage !== undefined ? Number.parseInt(opts.perPage, 10) : undefined;
+        const page = opts.page !== undefined ? Number.parseInt(opts.page, 10) : undefined;
+        const result = await getCreditTransactions(api, { perPage, page });
+        if (isJsonMode(cmd)) {
+            printJson(result);
+            return;
+        }
+        printTable(result.transactions, [
+            { header: 'Date', value: (t) => t.created_at },
+            { header: 'Description', value: (t) => t.description ?? t.action ?? t.type },
+            { header: 'Amount', value: (t) => signedAmount(t.amount) },
+            { header: 'Balance', value: (t) => t.balance_after },
+        ]);
+        printPagination(result.pagination);
+    });
+    credits
+        .command('packs')
+        .description('List purchasable credit packs (buy on the web dashboard)')
+        .action(async (_options, cmd) => {
+        const api = await createApiClient();
+        const data = await api.get('/credits/packs');
+        const packs = Array.isArray(data?.packs) ? data.packs : [];
+        if (isJsonMode(cmd)) {
+            printJson(packs);
+            return;
+        }
+        if (packs.length === 0) {
+            logger.info('No credit packs are available yet.');
+            return;
+        }
+        printTable(packs, [
+            { header: 'Credits', value: (p) => (p.credits !== undefined ? String(p.credits) : undefined) },
+            { header: 'Name', value: (p) => p.name },
+            {
+                header: 'Price',
+                value: (p) => {
+                    const price = p.prices?.[0];
+                    return price?.amount !== undefined
+                        ? `${(price.amount / 100).toFixed(2)} ${price.currency ?? ''}`.trim()
+                        : undefined;
+                },
+            },
+            { header: 'Buy at', value: (p) => p.checkout_url },
+        ]);
+        logger.hint('Open the "Buy at" link in your browser to complete the purchase; then check `clipugc credits`.');
+    });
+}
+//# sourceMappingURL=credits.js.map

package/dist/commands/credits.js.map

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

package/dist/commands/hooks.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerHooksCommands(program: Command): void;

package/dist/commands/hooks.js

@@ -0,0 +1,32 @@
+import chalk from 'chalk';
+import { createApiClient } from '../services/api.js';
+import { suggestHooks } from '../services/hooks.service.js';
+import { isJsonMode, printJson } from '../utils/output.js';
+import { logger } from '../utils/logger.js';
+export function registerHooksCommands(program) {
+    const hooks = program
+        .command('hooks')
+        .description('AI-generated hook text ideas for your UGC videos');
+    hooks
+        .command('suggest')
+        .description('Suggest hook texts (short attention-grabbing overlays) for your app')
+        .option('--context <text>', 'Describe your app for tailored hooks, e.g. "my app is a habit tracker"')
+        .action(async (opts, cmd) => {
+        const json = isJsonMode(cmd);
+        const api = await createApiClient();
+        const { hooks: suggestions, raw } = await suggestHooks(api, opts.context);
+        if (json) {
+            printJson(raw);
+            return;
+        }
+        if (suggestions.length === 0) {
+            logger.info('No hook suggestions returned. Try again with --context "describe your app".');
+            return;
+        }
+        for (const [index, hook] of suggestions.entries()) {
+            logger.plain(`${chalk.cyan(String(index + 1).padStart(2))}. ${hook}`);
+        }
+        logger.hint('Use one with `clipugc videos merge <videoId> --app-video <file> --hook "..."`');
+    });
+}
+//# sourceMappingURL=hooks.js.map

package/dist/commands/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/commands/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,KAAK,GAAG,OAAO;SAClB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,kDAAkD,CAAC,CAAC;IAEnE,KAAK;SACF,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,qEAAqE,CAAC;SAClF,MAAM,CAAC,kBAAkB,EAAE,wEAAwE,CAAC;SACpG,MAAM,CAAC,KAAK,EAAE,IAA0B,EAAE,GAAY,EAAE,EAAE;QACzD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;QACpC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1E,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,GAAG,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;YAC3F,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/images.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+/** Register the `clipugc images` command group (character looks). */
+export declare function registerImagesCommands(program: Command): void;