tripo-cli 0.1.0 → 0.2.1

package/dist/src/commands/docs.js

@@ -1,30 +0,0 @@
-/**
- * `tripo docs` — print bundled documentation. `--llm` prints the skill map
- * designed for AI coding agents (the npm package ships skill/ alongside dist/).
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { UsageError } from '../core/errors.js';
-export function skillRoot() {
-    return new URL('../../skill/', import.meta.url);
-}
-export function readSkillFile(relative) {
-    const url = new URL(relative, skillRoot());
-    if (!existsSync(url))
-        throw new UsageError(`documentation file not found: ${relative}`);
-    return readFileSync(url, 'utf8');
-}
-export function registerDocsCommand(program) {
-    program
-        .command('docs')
-        .description('print bundled docs (default: the LLM/agent skill map)')
-        .option('--llm', 'print the agent-facing SKILL.md (default)')
-        .option('--topic <name>', 'print a specific doc: commands/<cmd> or examples/<scenario> or common-errors')
-        .action((opts) => {
-        if (opts.topic) {
-            const file = opts.topic.endsWith('.md') ? opts.topic : `${opts.topic}.md`;
-            process.stdout.write(readSkillFile(file));
-            return;
-        }
-        process.stdout.write(readSkillFile('SKILL.md'));
-    });
-}

package/dist/src/commands/doctor.js

@@ -1,94 +0,0 @@
-/** `tripo doctor` — environment/config/network self-diagnosis. */
-import { statSync } from 'node:fs';
-import { join } from 'node:path';
-import pc from 'picocolors';
-import { configFileExists, loadConfig, resolveApiBaseUrl, resolveApiKey, tripoHome } from '../config/config.js';
-import { TripoClient } from '../core/client.js';
-import { emitResult } from '../core/output.js';
-import { resolveLlmConfig } from '../ai/llm.js';
-import { terminalSupportsInlineImages } from '../util/term-image.js';
-export function registerDoctorCommand(program) {
-    program
-        .command('doctor')
-        .description('diagnose environment, key, network, and terminal capabilities')
-        .action(async () => {
-        const checks = [];
-        const nodeMajor = Number(process.versions.node.split('.')[0]);
-        checks.push({
-            name: 'node',
-            ok: nodeMajor >= 20,
-            detail: `v${process.versions.node} (need >= 20)`,
-            critical: true,
-        });
-        const key = resolveApiKey();
-        checks.push({
-            name: 'api key',
-            ok: Boolean(key),
-            detail: key
-                ? process.env.TRIPO_API_KEY
-                    ? 'from TRIPO_API_KEY env'
-                    : 'from ~/.tripo/config.json'
-                : 'missing — run "tripo login"',
-            critical: true,
-        });
-        if (configFileExists()) {
-            try {
-                const mode = statSync(join(tripoHome(), 'config.json')).mode & 0o777;
-                checks.push({
-                    name: 'config permissions',
-                    ok: mode === 0o600,
-                    detail: `0${mode.toString(8)} (expect 0600)`,
-                    critical: false,
-                });
-            }
-            catch { }
-        }
-        const baseUrl = resolveApiBaseUrl();
-        if (key) {
-            try {
-                const client = new TripoClient();
-                const balance = await client.getBalance();
-                checks.push({ name: 'api reachability', ok: true, detail: `${baseUrl} · balance ${balance.balance}`, critical: true });
-                checks.push({
-                    name: 'balance',
-                    ok: Number(balance.balance) > 0,
-                    detail: `${balance.balance} credits (${balance.frozen} frozen)${Number(balance.balance) <= 0 ? ' — run "tripo topup"' : ''}`,
-                    critical: false,
-                });
-            }
-            catch (err) {
-                checks.push({
-                    name: 'api reachability',
-                    ok: false,
-                    detail: `${baseUrl}: ${err instanceof Error ? err.message : String(err)}`,
-                    critical: true,
-                });
-            }
-        }
-        else {
-            checks.push({ name: 'api reachability', ok: false, detail: `skipped (no key) · would use ${baseUrl}`, critical: false });
-        }
-        const llm = resolveLlmConfig();
-        checks.push({
-            name: 'llm (tripo ai conversation mode)',
-            ok: true,
-            detail: llm ? `${llm.model} @ ${llm.base_url}` : 'not configured — wizard mode only (this is fine)',
-            critical: false,
-        });
-        checks.push({
-            name: 'terminal',
-            ok: true,
-            detail: `${process.stdout.isTTY ? 'interactive TTY' : 'non-TTY (headless mode)'}${terminalSupportsInlineImages() ? ' · inline images supported' : ''}`,
-            critical: false,
-        });
-        const language = loadConfig().language ?? 'auto';
-        checks.push({ name: 'language', ok: true, detail: language, critical: false });
-        const failedCritical = checks.some((c) => c.critical && !c.ok);
-        const human = checks
-            .map((c) => `${c.ok ? pc.green('✓') : c.critical ? pc.red('✗') : pc.yellow('!')} ${c.name.padEnd(34)} ${c.detail}`)
-            .join('\n');
-        emitResult({ ok: !failedCritical, checks }, human);
-        if (failedCritical)
-            process.exitCode = 1;
-    });
-}

package/dist/src/commands/generate.js

@@ -1,81 +0,0 @@
-/** `tripo generate <endpoint>` — deterministic 1:1 mapping to the 8 generation endpoints. */
-import { UsageError } from '../core/errors.js';
-import { warn } from '../core/output.js';
-import { buildEditMultiview, buildImageToImage, buildImageToModel, buildImageToMultiview, buildImageToSplat, buildMultiviewToModel, buildTextToImage, buildTextToModel, } from '../core/requests.js';
-import { resolveInputValue, runTask } from '../core/task-service.js';
-import { chooseModel } from '../knowledge/models.js';
-import { assignViews } from '../pipeline/make.js';
-import { newClient, printTaskResult, withTaskOptions } from './shared.js';
-export function registerGenerateCommands(program) {
-    const generate = program.command('generate').description('deterministic generation endpoints (text/image/multiview → model/image/splat)');
-    const add = (name, description, inputArity, build) => {
-        const cmd = generate
-            .command(`${name} ${inputArity === 'prompt' ? '<prompt...>' : inputArity === 'single' ? '<input>' : '<inputs...>'}`)
-            .description(description)
-            .option('--model <model>', 'model version override');
-        if (inputArity !== 'prompt')
-            cmd.option('--prompt <text>', 'prompt for prompt-guided endpoints');
-        withTaskOptions(cmd);
-        cmd.action(async (inputs, flags) => {
-            const list = Array.isArray(inputs) ? inputs : [inputs];
-            const client = newClient();
-            const built = await build(client, list, flags);
-            for (const w of built.warnings)
-                warn(w);
-            const result = await runTask({
-                client,
-                request: built.request,
-                taskType: built.taskType,
-                name: flags.name ?? (inputArity === 'prompt' ? list.join(' ') : list[0]),
-                outDir: flags.out,
-                noWait: flags.wait === false,
-                noDownload: flags.download === false,
-                notify: flags.notify,
-                timeoutMs: flags.timeout ? flags.timeout * 1000 : undefined,
-            });
-            printTaskResult(result);
-        });
-    };
-    add('text-to-model', 'text → 3D model', 'prompt', async (_c, inputs, flags) => {
-        const prompt = inputs.join(' ');
-        const { model } = chooseModel({ explicit: flags.model, faceLimit: numberParam(flags, 'face_limit') });
-        return buildTextToModel(prompt, model, flags.param);
-    });
-    add('image-to-model', 'single image → 3D model', 'single', async (client, inputs, flags) => {
-        const { value } = await resolveInputValue(client, inputs[0]);
-        const { model } = chooseModel({ explicit: flags.model, faceLimit: numberParam(flags, 'face_limit') });
-        return buildImageToModel(value, model, flags.param);
-    });
-    add('multiview-to-model', '2–4 view images → 3D model', 'multi', async (client, inputs, flags) => {
-        const views = await assignViews(client, inputs);
-        const { model } = chooseModel({ explicit: flags.model, faceLimit: numberParam(flags, 'face_limit') });
-        return buildMultiviewToModel(views, model, flags.param);
-    });
-    add('text-to-image', 'text → image (concept art / t_pose templates)', 'prompt', async (_c, inputs, flags) => buildTextToImage(inputs.join(' '), { ...(flags.model ? { model: flags.model } : {}), ...flags.param }));
-    add('image-to-image', 'image + prompt → edited image', 'single', async (client, inputs, flags) => {
-        const { value } = await resolveInputValue(client, inputs[0]);
-        const params = { ...(flags.model ? { model: flags.model } : {}), ...flags.param };
-        if (flags.prompt)
-            params.prompt = flags.prompt;
-        if (!params.prompt && !params.template) {
-            throw new UsageError('image-to-image needs --prompt or --param template=...');
-        }
-        return buildImageToImage(value, params);
-    });
-    add('image-to-multiview', 'single image → 4-view sheet', 'single', async (client, inputs, flags) => {
-        const { value } = await resolveInputValue(client, inputs[0]);
-        return buildImageToMultiview(value, flags.param);
-    });
-    add('edit-multiview', 'edit views of a multiview task', 'single', async (client, inputs, flags) => {
-        const { value } = await resolveInputValue(client, inputs[0]);
-        return buildEditMultiview(value, flags.param);
-    });
-    add('image-to-splat', 'image → gaussian splat', 'single', async (client, inputs, flags) => {
-        const { value } = await resolveInputValue(client, inputs[0]);
-        return buildImageToSplat(value, flags.param);
-    });
-}
-function numberParam(flags, key) {
-    const v = flags.param[key];
-    return typeof v === 'number' ? v : undefined;
-}

package/dist/src/commands/home.js

@@ -1,68 +0,0 @@
-/** Bare `tripo` — interactive home: status, quick actions, continue last task. */
-import * as p from '@clack/prompts';
-import pc from 'picocolors';
-import { loadConfig, resolveApiKey } from '../config/config.js';
-import { readHistory } from '../config/history.js';
-import { TripoClient } from '../core/client.js';
-import { isInteractive, log } from '../core/output.js';
-import { t } from '../i18n.js';
-import { runLogin } from './login.js';
-export function registerHomeAction(program) {
-    program.action(async () => {
-        if (!isInteractive()) {
-            program.outputHelp();
-            return;
-        }
-        p.intro(pc.bold('tripo'));
-        const key = resolveApiKey(loadConfig());
-        if (!key) {
-            log(t({ zh: '还没有配置 API Key,先登录吧(新用户可领免费额度)', en: 'no API key yet — log in first (new accounts get free credits)' }));
-            await runLogin({});
-            return;
-        }
-        let balanceLine = '';
-        try {
-            const balance = await new TripoClient().getBalance();
-            balanceLine = t({ zh: `余额 ${balance.balance} 积分`, en: `${balance.balance} credits` });
-        }
-        catch {
-            balanceLine = t({ zh: '余额获取失败', en: 'balance unavailable' });
-        }
-        const last = readHistory().filter((e) => e.status === 'success').pop();
-        log(`${balanceLine}${last ? t({ zh: ` · 上次任务 @${last.name}`, en: ` · last task @${last.name}` }) : ''}`);
-        const action = await p.select({
-            message: t({ zh: '想做什么?', en: 'What do you want to do?' }),
-            options: [
-                { value: 'ai', label: t({ zh: '描述需求,让专家帮我定方案 (tripo ai)', en: 'describe what I want, experts plan it (tripo ai)' }) },
-                { value: 'make', label: t({ zh: '直接生成 (tripo make ...)', en: 'generate directly (tripo make ...)' }) },
-                ...(last ? [{ value: 'view', label: t({ zh: '看看上一个结果 (tripo view)', en: 'view the last result (tripo view)' }) }] : []),
-                { value: 'topup', label: t({ zh: '充值 (tripo topup)', en: 'top up credits (tripo topup)' }) },
-                { value: 'help', label: t({ zh: '看全部命令', en: 'show all commands' }) },
-            ],
-        });
-        if (p.isCancel(action))
-            return;
-        switch (action) {
-            case 'ai':
-                await program.parseAsync(['ai'], { from: 'user' });
-                break;
-            case 'make': {
-                const promptText = await p.text({
-                    message: t({ zh: '输入一句描述或文件路径', en: 'enter a description or file path' }),
-                });
-                if (p.isCancel(promptText) || !promptText.trim())
-                    return;
-                await program.parseAsync(['make', promptText.trim()], { from: 'user' });
-                break;
-            }
-            case 'view':
-                await program.parseAsync(['view'], { from: 'user' });
-                break;
-            case 'topup':
-                await program.parseAsync(['topup'], { from: 'user' });
-                break;
-            default:
-                program.outputHelp();
-        }
-    });
-}

package/dist/src/commands/login.js

@@ -1,225 +0,0 @@
-/**
- * Onboarding loop: `tripo login` (browser flow with paste fallback),
- * `tripo logout`, `tripo whoami`. Key precedence: TRIPO_API_KEY env >
- * ~/.tripo/config.json.
- */
-import { randomBytes } from 'node:crypto';
-import { createServer } from 'node:http';
-import { hostname } from 'node:os';
-import * as p from '@clack/prompts';
-import { deleteApiKey, loadConfig, maskKey, REGION_DEFAULTS, resolveApiKey, resolvePlatformBaseUrl, updateConfig, } from '../config/config.js';
-import { TripoClient } from '../core/client.js';
-import { AuthError, CliError, UsageError } from '../core/errors.js';
-import { emitResult, isInteractive, log, shouldOpen, success, warn } from '../core/output.js';
-import { t } from '../i18n.js';
-import { EXIT } from '../knowledge/error-catalog.js';
-import { openExternal } from '../util/open.js';
-const LOGIN_TIMEOUT_MS = 5 * 60 * 1000;
-export function registerAuthCommands(program) {
-    program
-        .command('login')
-        .description('sign in: browser flow (default) or paste an API key')
-        .option('--paste', 'paste an API key instead of using the browser')
-        .option('--key <key>', 'provide the API key directly (tsk_...)')
-        .option('--region <region>', 'ov (international) or cn (China mainland)')
-        .action(async (opts) => {
-        await runLogin(opts);
-    });
-    program
-        .command('logout')
-        .description('remove the locally stored API key')
-        .action(() => {
-        const config = loadConfig();
-        if (!config.api_key) {
-            log(t({ zh: '本地没有存储 API Key', en: 'no API key stored locally' }));
-        }
-        else {
-            deleteApiKey();
-            success(t({ zh: '已删除本地 API Key', en: 'local API key removed' }));
-        }
-        log(t({
-            zh: `如需吊销 Key 本身,请前往 ${resolvePlatformBaseUrl()} 的 API Keys 页面`,
-            en: `to revoke the key itself, visit the API Keys page at ${resolvePlatformBaseUrl()}`,
-        }));
-    });
-    program
-        .command('whoami')
-        .description('show the active key (masked), region, and balance')
-        .action(async () => {
-        const config = loadConfig();
-        const key = resolveApiKey(config);
-        if (!key)
-            throw new AuthError(t({ zh: '未配置 API Key', en: 'no API key configured' }));
-        const source = process.env.TRIPO_API_KEY ? 'env:TRIPO_API_KEY' : '~/.tripo/config.json';
-        const client = new TripoClient();
-        const balance = await client.getBalance();
-        emitResult({
-            key: maskKey(key),
-            source,
-            region: config.region ?? 'ov',
-            api_base_url: client.baseUrl,
-            balance: balance.balance,
-            frozen: balance.frozen,
-        }, [
-            `key      ${maskKey(key)} (${source})`,
-            `region   ${config.region ?? 'ov'}`,
-            `api      ${client.baseUrl}`,
-            t({ zh: `余额     ${balance.balance} 积分(冻结 ${balance.frozen})`, en: `balance  ${balance.balance} credits (${balance.frozen} frozen)` }),
-        ].join('\n'));
-    });
-}
-export async function runLogin(opts) {
-    let region = normalizeRegion(opts.region);
-    if (opts.key) {
-        region ??= 'ov';
-        await validateAndSave(opts.key, region);
-        return;
-    }
-    if (!isInteractive()) {
-        throw new UsageError(t({
-            zh: '非交互环境请用 TRIPO_API_KEY 环境变量或 tripo login --key tsk_...',
-            en: 'in non-interactive environments use the TRIPO_API_KEY env var or "tripo login --key tsk_..."',
-        }));
-    }
-    p.intro('tripo login');
-    if (!region) {
-        const answer = await p.select({
-            message: t({ zh: '选择服务区域', en: 'Choose your region' }),
-            options: [
-                { value: 'ov', label: t({ zh: '海外 (api: openapi.tripo3d.ai)', en: 'International (openapi.tripo3d.ai)' }) },
-                { value: 'cn', label: t({ zh: '中国大陆 (api: openapi.tripo3d.com)', en: 'China mainland (openapi.tripo3d.com)' }) },
-            ],
-        });
-        if (p.isCancel(answer))
-            throw new CliError('cancelled', EXIT.FATAL);
-        region = answer;
-    }
-    const key = opts.paste ? await pasteFlow(region) : await browserFlow(region);
-    await validateAndSave(key, region);
-    p.outro(t({
-        zh: '登录完成!试试: tripo make "一只可爱的机器人"',
-        en: 'logged in! try: tripo make "a cute robot"',
-    }));
-}
-function normalizeRegion(value) {
-    if (value === undefined)
-        return undefined;
-    if (value === 'ov' || value === 'cn')
-        return value;
-    throw new UsageError('--region must be ov or cn');
-}
-async function pasteFlow(region) {
-    const platform = platformUrlFor(region);
-    log(t({
-        zh: `在 ${platform} 的「API Keys」页面创建 Key(新用户注册可领免费额度)`,
-        en: `create a key on the "API Keys" page at ${platform} (new accounts get free credits)`,
-    }));
-    const answer = await p.password({
-        message: t({ zh: '粘贴你的 API Key (tsk_...)', en: 'Paste your API key (tsk_...)' }),
-        validate: (v) => (v && v.trim().startsWith('tsk_') ? undefined : t({ zh: 'Key 应以 tsk_ 开头', en: 'keys start with tsk_' })),
-    });
-    if (p.isCancel(answer))
-        throw new CliError('cancelled', EXIT.FATAL);
-    return answer.trim();
-}
-/**
- * Browser flow (gh-auth style): open <platform>/cli-auth?state=...&callback=…
- * and wait for the page to POST/GET the new key back to localhost. Races
- * against manual paste so the flow still works before the platform page
- * ships (graceful degradation, zero backend changes required).
- */
-async function browserFlow(region) {
-    const platform = platformUrlFor(region);
-    const state = randomBytes(16).toString('hex');
-    const { server, port, keyPromise } = await startCallbackServer(state);
-    try {
-        const authUrl = `${platform}/cli-auth?state=${state}&callback=${encodeURIComponent(`http://127.0.0.1:${port}/callback`)}&name=${encodeURIComponent(`CLI - ${hostname()}`)}`;
-        if (shouldOpen()) {
-            openExternal(authUrl);
-            log(t({ zh: `已打开浏览器登录页(未弹出请手动访问):\n  ${authUrl}`, en: `opened the browser login page (visit manually if it didn't open):\n  ${authUrl}` }));
-        }
-        else {
-            log(t({ zh: `请访问: ${authUrl}`, en: `visit: ${authUrl}` }));
-        }
-        log(t({
-            zh: '等待浏览器完成登录…(也可以直接在下方粘贴 Key)',
-            en: 'waiting for the browser… (or paste a key below instead)',
-        }));
-        const pastePromise = p
-            .password({
-            message: t({ zh: '或直接粘贴 API Key (tsk_...)', en: 'or paste an API key (tsk_...)' }),
-        })
-            .then((v) => {
-            if (p.isCancel(v))
-                throw new CliError('cancelled', EXIT.FATAL);
-            const trimmed = v.trim();
-            if (!trimmed.startsWith('tsk_'))
-                throw new UsageError(t({ zh: 'Key 应以 tsk_ 开头', en: 'keys start with tsk_' }));
-            return trimmed;
-        });
-        const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new CliError(t({ zh: '登录超时(5 分钟)', en: 'login timed out (5 minutes)' }), EXIT.AUTH)), LOGIN_TIMEOUT_MS));
-        return await Promise.race([keyPromise, pastePromise, timeoutPromise]);
-    }
-    finally {
-        server.close();
-        // Ensure the pending clack prompt does not hold the process open.
-        process.stdin.pause();
-    }
-}
-function startCallbackServer(state) {
-    let resolveKey;
-    const keyPromise = new Promise((resolve) => (resolveKey = resolve));
-    const server = createServer((req, res) => {
-        const url = new URL(req.url ?? '/', 'http://localhost');
-        if (url.pathname !== '/callback') {
-            res.writeHead(404);
-            res.end();
-            return;
-        }
-        const gotState = url.searchParams.get('state');
-        const key = url.searchParams.get('key') ?? url.searchParams.get('api_key');
-        if (gotState !== state || !key || !key.startsWith('tsk_')) {
-            res.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' });
-            res.end('<h3>Invalid login callback. Return to the terminal and try again.</h3>');
-            return;
-        }
-        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-        res.end('<h3>✓ Tripo CLI login complete. You can close this tab and return to the terminal.</h3>');
-        resolveKey(key);
-    });
-    return new Promise((resolve, reject) => {
-        server.once('error', reject);
-        server.listen(0, '127.0.0.1', () => {
-            const address = server.address();
-            const port = typeof address === 'object' && address ? address.port : 0;
-            resolve({ server, port, keyPromise });
-        });
-    });
-}
-async function validateAndSave(key, region) {
-    const config = updateConfig({ region });
-    const client = new TripoClient({ apiKey: key });
-    try {
-        const balance = await client.getBalance();
-        updateConfig({ ...config, api_key: key, region });
-        success(t({
-            zh: `Key 验证通过,当前余额 ${balance.balance} 积分(已保存到 ~/.tripo/config.json,权限 0600)`,
-            en: `key verified; balance ${balance.balance} credits (saved to ~/.tripo/config.json, mode 0600)`,
-        }));
-        if (Number(balance.balance) === 0) {
-            warn(t({
-                zh: '余额为 0:新账号可在控制台领取免费额度,或运行 tripo topup 充值',
-                en: 'balance is 0: claim free credits in the console for new accounts, or run "tripo topup"',
-            }));
-        }
-    }
-    catch (err) {
-        if (err instanceof CliError && err.exitCode === EXIT.AUTH) {
-            throw new AuthError(t({ zh: 'Key 验证失败:无效或已被删除', en: 'key validation failed: invalid or deleted' }));
-        }
-        throw err;
-    }
-}
-function platformUrlFor(region) {
-    return process.env.TRIPO_PLATFORM_BASE_URL || REGION_DEFAULTS[region].platform;
-}

package/dist/src/commands/make.js

@@ -1,142 +0,0 @@
-/**
- * `tripo make` — the magic command. Give it anything (a sentence, an image,
- * 2–4 views, a model file, or @last/task id) and it picks the endpoint, the
- * model, the parameters, runs the chain, and downloads the artifacts.
- */
-import * as p from '@clack/prompts';
-import { UsageError } from '../core/errors.js';
-import { emitResult, isInteractive, log, warn } from '../core/output.js';
-import { t } from '../i18n.js';
-import { scenarioIds } from '../knowledge/scenarios.js';
-import { executeMake, planMake } from '../pipeline/make.js';
-import { newClient, parseChainFlag, printTaskResult, withTaskOptions } from './shared.js';
-import { printInlineImage } from '../util/term-image.js';
-export function registerMakeCommand(program) {
-    const cmd = program
-        .command('make')
-        .description('turn text / images / a model file / a task ref into 3D artifacts (the magic command)')
-        .argument('<input...>', 'prompt text, image file(s), model file, URL, task id, or @last')
-        .option('--for <scenario>', `scenario preset: ${scenarioIds().join('|')}`)
-        .option('--then <steps>', 'processing chain, e.g. "texture,rig,convert:fbx"')
-        .option('--model <model>', 'force model version (tripo-v3.1 / tripo-p1 / ...)')
-        .option('-n, --candidates <n>', 'generate N candidates in parallel', (v) => Number(v), 1)
-        .option('--seed <n>', 'model_seed for reproducible geometry', (v) => Number(v));
-    withTaskOptions(cmd);
-    cmd.action(async (inputs, flags) => {
-        const result = await runMake(inputs, flags);
-        emitMakeOutcome(result);
-    });
-}
-export async function runMake(inputs, flags) {
-    const client = newClient();
-    const params = { ...flags.param };
-    if (flags.seed !== undefined)
-        params.model_seed = flags.seed;
-    const options = {
-        inputs,
-        scenario: flags.for,
-        chain: parseChainFlag(flags.then),
-        model: flags.model,
-        params,
-        name: flags.name,
-        outDir: flags.out,
-        noWait: flags.wait === false,
-        noDownload: flags.download === false,
-        notify: flags.notify,
-        timeoutMs: flags.timeout ? flags.timeout * 1000 : undefined,
-    };
-    const n = flags.candidates;
-    if (n <= 1) {
-        const plan = await planMake(client, options);
-        const outcome = await executeMake(client, plan, options);
-        return { results: [outcome.primary], chainResults: outcome.chainResults, stoppedEarly: outcome.stoppedEarly };
-    }
-    // -n candidates: N parallel generations with distinct seeds.
-    if (n > 4)
-        throw new UsageError('at most 4 candidates per run (-n 4)');
-    const basePlan = await planMake(client, options);
-    if (!basePlan.generation) {
-        throw new UsageError('-n only applies to generation inputs (text/image), not task references');
-    }
-    const chain = basePlan.chain;
-    const interactive = isInteractive();
-    if (chain.length > 0 && !interactive) {
-        throw new UsageError('-n with --then needs an interactive terminal to pick the winner; run the chain afterwards with "tripo make <task-id> --then ..."');
-    }
-    log(t({ zh: `并行生成 ${n} 个候选…`, en: `generating ${n} candidates in parallel…` }));
-    const seeds = Array.from({ length: n }, () => Math.floor(Math.random() * 2 ** 31));
-    const runs = seeds.map((seed, i) => (async () => {
-        const candidateOptions = {
-            ...options,
-            chain: [],
-            params: { ...params, model_seed: seed },
-            name: `${flags.name ?? inputs[0] ?? 'make'}-c${i + 1}`,
-        };
-        const plan = await planMake(client, candidateOptions);
-        plan.chain = [];
-        return executeMake(client, plan, candidateOptions);
-    })());
-    const settled = await Promise.allSettled(runs);
-    const results = [];
-    for (const s of settled) {
-        if (s.status === 'fulfilled')
-            results.push(s.value.primary);
-        else
-            warn(String(s.reason instanceof Error ? s.reason.message : s.reason));
-    }
-    if (results.length === 0)
-        throw new UsageError('all candidates failed');
-    for (const r of results) {
-        if (r.preview)
-            printInlineImage(r.preview);
-    }
-    let chainResults = [];
-    let stoppedEarly;
-    if (chain.length > 0 && interactive) {
-        const pick = await p.select({
-            message: t({ zh: '选择一个候选继续加工链', en: 'pick a candidate to continue the chain' }),
-            options: results.map((r, i) => ({
-                value: r.task_id,
-                label: `#${i + 1} ${r.task_id.slice(0, 8)} ${r.output_dir ?? ''}`,
-            })),
-        });
-        if (!p.isCancel(pick)) {
-            const winner = results.find((r) => r.task_id === pick);
-            const { runChain } = await import('../pipeline/runner.js');
-            const chainRun = await runChain({
-                client,
-                chain,
-                sourceTaskId: winner.task_id,
-                sourceType: winner.type,
-                namePrefix: flags.name ?? 'make',
-                outDir: flags.out,
-                timeoutMs: options.timeoutMs,
-            });
-            chainResults = chainRun.results;
-            stoppedEarly = chainRun.stoppedEarly;
-        }
-    }
-    return { results, chainResults, stoppedEarly };
-}
-export function emitMakeOutcome(outcome) {
-    const finalChain = outcome.chainResults[outcome.chainResults.length - 1];
-    if (outcome.results.length === 1) {
-        const primary = outcome.results[0];
-        const merged = finalChain
-            ? { ...finalChain, chain: undefined, source_task_id: primary.task_id }
-            : primary;
-        if (outcome.chainResults.length > 0)
-            merged.chain = outcome.chainResults;
-        if (outcome.stoppedEarly)
-            merged.stopped_early = outcome.stoppedEarly;
-        printTaskResult(merged);
-        if (merged.preview)
-            printInlineImage(merged.preview);
-    }
-    else {
-        const human = outcome.results
-            .map((r, i) => `#${i + 1} ${r.task_id} ${r.output_dir ?? r.status}`)
-            .join('\n');
-        emitResult({ candidates: outcome.results, chain: outcome.chainResults }, human);
-    }
-}