@lumenkey/cli 0.3.0 → 0.4.0-rc.1

package/dist/cli/index.js

@@ -1,3 +1,4 @@
+import { zhText } from '../core/chinese-messages.js';
 import { cac } from 'cac';
 import pc from 'picocolors';
 import { loadConfig, saveConfig } from '../core/config.js';
@@ -40,20 +41,20 @@ function commandToken(argv) {
 }
 function usageLines(argv) {
     const usage = [
-        ui('Usage: lumenkey <command> [options]', '用法：lumenkey <命令> [选项]'),
-        ui('Run lumenkey --help to see commands.', '运行 lumenkey --help 查看命令。'),
+        ui('Usage: lumenkey <command> [options]', zhText("m406")),
+        ui('Run lumenkey --help to see commands.', zhText("m405")),
     ];
     const token = commandToken(argv);
     if (!token) {
         const unknown = argv.slice(2).find(arg => arg.startsWith('-') && arg !== '--json' && arg !== '--lang' && !arg.startsWith('--lang=') && arg !== '--');
         return unknown
-            ? [ui(`Unknown option ${JSON.stringify(unknown)}.`, `未知选项 ${JSON.stringify(unknown)}。`), ...usage]
+            ? [ui(`Unknown option ${JSON.stringify(unknown)}.`, (zhText("m402") + (JSON.stringify(unknown)) + "。")), ...usage]
             : usage;
     }
     const shown = token.replace(/[\u0000-\u001f\u007f]/g, '');
     const named = /^(?:lk_|sk_|Bearer\b)/i.test(token)
-        ? ui('That is not a lumenkey command.', '这不是 lumenkey 命令。')
-        : ui(`'${shown}' is not a lumenkey command.`, `'${shown}' 不是 lumenkey 命令。`);
+        ? ui('That is not a lumenkey command.', zhText("m404"))
+        : ui(`'${shown}' is not a lumenkey command.`, ("'" + (shown) + zhText("m403")));
     return [named, ...usage];
 }
 /** CAC's own parse errors become argument errors with readable, localized text. */
@@ -80,19 +81,19 @@ function normalizeCliError(err) {
                 return modelParameterError('MODEL_PARAM_INVALID', 'count');
         }
         // Same as the MCP surface: with a confirm requested, the outcome still says nothing was sent.
-        return nothingSentIfConfirmed(new LumenKeyError('INPUT_INVALID', undefined, undefined, original ? ui(`Unknown option ${JSON.stringify(original.split('=')[0])}.`, `未知选项 ${JSON.stringify(original.split('=')[0])}。`) : err.message), { confirm: argv.includes('--confirm') });
+        return nothingSentIfConfirmed(new LumenKeyError('INPUT_INVALID', undefined, undefined, original ? ui(`Unknown option ${JSON.stringify(original.split('=')[0])}.`, (zhText("m402") + (JSON.stringify(original.split('=')[0])) + "。")) : err.message), { confirm: argv.includes('--confirm') });
     }
     const missingArgs = err.message.match(/^missing required args for command `([^`]+)`$/);
     if (missingArgs)
-        return new UsageError(ui(err.message, `命令 \`${missingArgs[1]}\` 缺少必填参数。`));
+        return new UsageError(ui(err.message, (zhText("m401") + (missingArgs[1]) + zhText("m320"))));
     return err;
 }
 export async function runCli() {
     const cli = cac('lumenkey');
-    cli.option('--lang <lang>', ui('Message language: zh or en', '界面语言：zh 或 en'));
+    cli.option('--lang <lang>', ui('Message language: zh or en', zhText("m400")));
     cli
-        .command('login', ui('Configure LumenKey API Key', '配置 LumenKey 密钥'))
-        .option('--key <apiKey>', ui('API Key to configure (or leave empty to prompt via env)', '要保存的密钥；留空则改用环境变量'))
+        .command('login', ui('Configure cloud connection', zhText("m399")))
+        .option('--key <apiKey>', ui('API Key to configure (omit to enter interactively)', zhText("m398")))
         .action(async (options) => {
         applyRaw(options, 'key', ['--key']);
         const keyFromCommandLine = typeof options.key === 'string' && options.key.length > 0;
@@ -104,23 +105,23 @@ export async function runCli() {
         if (options.key) {
             saveConfig({ apiKey: options.key });
             if (keyFromCommandLine)
-                console.error(ui('This key was passed with --key and can remain in shell history. Prefer LUMENKEY_API_KEY.', '这个密钥是用 --key 传入的，可能留在 shell 历史里。请改用 LUMENKEY_API_KEY。'));
+                console.error(ui('This key was passed with --key and can remain in shell history. Prefer LUMENKEY_API_KEY.', zhText("m397")));
             if (wantsJson())
                 console.log(JSON.stringify({ saved: true }));
             else
-                console.log(pc.green(ui('✔ API Key saved to ~/.lumenkey/config.json', '✔ 密钥已保存到 ~/.lumenkey/config.json')));
+                console.log(pc.green(ui('✔ API Key saved to ~/.lumenkey/config.json', zhText("m396"))));
         }
         else if (wantsJson()) {
             console.log(JSON.stringify({ saved: false }));
         }
         else {
-            console.log(pc.yellow(ui('Tip: You can also set the environment variable:', '也可以设置环境变量：')));
+            console.log(pc.yellow(ui('Tip: You can also set the environment variable:', zhText("m395"))));
             console.log(pc.cyan('  export LUMENKEY_API_KEY="lk_live_..."'));
         }
     });
     cli
-        .command('models', ui('List all available AI models from catalog', '列出模型目录中的可用模型'))
-        .option('--type <type>', ui('Filter models by type: video | image | text | audio', '按类型筛选：video | image | text | audio'))
+        .command('models', ui('List all available AI models from catalog', zhText("m394")))
+        .option('--type <type>', ui('Filter models by type: video | image | text | audio', zhText("m393")))
         .action(async (options) => {
         applyRaw(options, 'type', ['--type']);
         const config = loadConfig();
@@ -130,34 +131,34 @@ export async function runCli() {
             console.log(JSON.stringify({ count: models.length, models }));
             return;
         }
-        console.log(pc.cyan(ui('Fetching dynamic model catalog from LumenKey...', '正在读取模型目录...')));
+        console.log(pc.cyan(ui('Fetching dynamic model catalog from LumenKey...', zhText("m392"))));
         if (models.length === 0) {
-            console.log(pc.dim(ui('No models available for this request.', '这次请求没有可用模型。')));
+            console.log(pc.dim(ui('No models available for this request.', zhText("m330"))));
             return;
         }
-        console.log(pc.bold(ui('\nAvailable Models:', '\n可用模型：')));
+        console.log(pc.bold(ui('\nAvailable Models:', zhText("m391"))));
         for (const m of models) {
             const title = m.displayName || m.name || m.id;
             const typeBadge = m.type ? `[${m.type}]` : (m.capabilities?.length ? `[${m.capabilities.join(',')}]` : '');
-            const pricingText = m.pricing?.map((p) => ui(`${p.credits} credits/${p.unit}`, `${p.credits} 算力点/${p.unit}`)).join(', ') || '';
+            const pricingText = m.pricing?.map((p) => ui(`${p.credits} credits/${p.unit}`, ("" + (p.credits) + zhText("m390") + (p.unit) + ""))).join(', ') || '';
             console.log(`  ${pc.green(m.id.padEnd(26))} ${pc.dim(typeBadge.padEnd(12))} ${title} ${pricingText ? pc.yellow(`(${pricingText})`) : ''}`);
         }
     });
     registerOptions(cli
-        .command('video [...extra]', ui('Generate AI video (Seedance 2.0 / Wan 3.0 / etc.)', '生成视频')), videoParams)
+        .command('video [...extra]', ui('Generate AI video (Seedance 2.0 / Wan 3.0 / etc.)', zhText("m389"))), videoParams)
         .action(async (extra, options) => {
         if (extra.length)
-            throw new Error(ui(`Unexpected video argument ${JSON.stringify(extra[0])}. Use lumenkey video -m <modelId> -p <prompt>.`, `视频命令多了参数 ${JSON.stringify(extra[0])}。请使用：lumenkey video -m <模型ID> -p <提示词>。`));
+            throw new Error(ui(`Unexpected video argument ${JSON.stringify(extra[0])}. Use lumenkey video -m <modelId> -p <prompt>.`, (zhText("m387") + (JSON.stringify(extra[0])) + zhText("m388"))));
         await runCliGeneration('video', videoParams, options);
     });
     cli
-        .command('status <jobId>', ui('Check status of an asynchronous generation job', '查看异步生成任务的状态'))
+        .command('status <jobId>', ui('Check status of an asynchronous generation job', zhText("m386")))
         .action(async (jobId) => {
         const outcome = await readJob(new LumenKeyClient(loadConfig()), jobId);
         renderOutcome(outcome, ok => console.log(formatJobDetail(ok.job)));
     });
     cli
-        .command('balance', ui('Check current account credits balance', '查看当前账户算力点余额'))
+        .command('balance', ui('Check current account credits balance', zhText("m385")))
         .action(async () => {
         const config = loadConfig();
         const client = new LumenKeyClient(config);
@@ -166,15 +167,15 @@ export async function runCli() {
             console.log(JSON.stringify(balance));
             return;
         }
-        console.log(pc.bold(ui('\nLumenKey Account Balance:', '\nLumenKey 账户余额：')));
-        console.log(ui(`  Available Credits: ${pc.green(pc.bold(String(balance.availableCredits ?? 0)))}`, `  可用算力点：${pc.green(pc.bold(String(balance.availableCredits ?? 0)))}`));
-        console.log(ui(`  Reserved Credits:  ${pc.yellow(String(balance.reservedCredits ?? 0))}`, `  冻结算力点：${pc.yellow(String(balance.reservedCredits ?? 0))}`));
+        console.log(pc.bold(ui('\nLumenKey Account Balance:', zhText("m384"))));
+        console.log(ui(`  Available Credits: ${pc.green(pc.bold(String(balance.availableCredits ?? 0)))}`, (zhText("m383") + (pc.green(pc.bold(String(balance.availableCredits ?? 0)))) + "")));
+        console.log(ui(`  Reserved Credits:  ${pc.yellow(String(balance.reservedCredits ?? 0))}`, (zhText("m382") + (pc.yellow(String(balance.reservedCredits ?? 0))) + "")));
         if (balance.updatedAt) {
-            console.log(ui(`  Updated At:        ${pc.gray(balance.updatedAt)}`, `  更新时间：${pc.gray(balance.updatedAt)}`));
+            console.log(ui(`  Updated At:        ${pc.gray(balance.updatedAt)}`, (zhText("m381") + (pc.gray(balance.updatedAt)) + "")));
         }
     });
     registerOptions(cli
-        .command('chat', ui('Run billable LLM chat inference', '发起计费对话')), chatParams)
+        .command('chat', ui('Run billable LLM chat inference', zhText("m380"))), chatParams)
         .action(async (options) => {
         for (const param of forSurface(chatParams, 'cli'))
             if (param.flag && param.kind === 'string')
@@ -183,45 +184,56 @@ export async function runCli() {
         const client = new LumenKeyClient(loadConfig());
         const outcome = await runChat(client, chatArgs({ ...argsFromCac(chatParams, options), maxCredits: rawOption(['--max-credits']) }, 'cli'));
         renderOutcome(outcome, res => {
-            console.log(pc.green(ui('\nResponse:', '\n回复：')));
+            console.log(pc.green(ui('\nResponse:', zhText("m379"))));
             console.log(res.text);
             console.log(formatChatBilling(res.billing ?? undefined));
             const usage = res.usage;
             if (usage) {
-                const total = usage.total_tokens ?? ui('not reported', '未返回');
-                const promptTokens = usage.prompt_tokens ?? ui('not reported', '未返回');
-                const completionTokens = usage.completion_tokens ?? ui('not reported', '未返回');
-                console.log(pc.gray(ui(`\n[Tokens: ${total} (prompt: ${promptTokens}, completion: ${completionTokens})]`, `\n[词元：${total}（输入：${promptTokens}，输出：${completionTokens}）]`)));
+                const total = usage.total_tokens ?? ui('not reported', zhText("m49"));
+                const promptTokens = usage.prompt_tokens ?? ui('not reported', zhText("m49"));
+                const completionTokens = usage.completion_tokens ?? ui('not reported', zhText("m49"));
+                console.log(pc.gray(ui(`\n[Tokens: ${total} (prompt: ${promptTokens}, completion: ${completionTokens})]`, (zhText("m376") + (total) + zhText("m377") + (promptTokens) + zhText("m378") + (completionTokens) + "）]"))));
                 const reasoning = usage.completion_tokens_details?.reasoning_tokens;
                 if (reasoning !== undefined)
-                    console.log(ui(`Reasoning tokens (included in completion): ${reasoning}`, `推理词元（已计入输出）：${reasoning}`));
+                    console.log(ui(`Reasoning tokens (included in completion): ${reasoning}`, (zhText("m375") + (reasoning) + "")));
             }
-            console.log(pc.gray(ui(`Idempotency key: ${res.idempotencyKey}`, `幂等键：${res.idempotencyKey}`)));
+            console.log(pc.gray(ui(`Idempotency key: ${res.idempotencyKey}`, (zhText("m374") + (res.idempotencyKey) + ""))));
         });
     });
     cli
-        .command('mcp', ui('Start the LumenKey Model Context Protocol (MCP) server over stdio', '通过标准输入输出启动 LumenKey MCP 服务'))
+        .command('mcp', ui('Start the LumenKey Model Context Protocol (MCP) server over stdio', zhText("m373")))
         .action(async () => {
         await runMcpStdio();
     });
+    cli
+        .command('studio [...extra]', ui('Start the local Studio service', zhText("m372")))
+        .option('--output-dir <absolutePath>', ui('Absolute local directory for saved assets', zhText("m371")))
+        .option('--no-open', ui('Headless diagnostics; do not open a browser', zhText("m370")))
+        .action(async (extra, options) => {
+        if (extra.length)
+            throw new Error(ui('Studio does not accept positional arguments.', zhText("m369")));
+        applyRaw(options, 'outputDir', ['--output-dir']);
+        const { runStudioCommand } = await import('../studio/launch.js');
+        await runStudioCommand({ outputDir: options.outputDir, noOpen: options.open === false });
+    });
     registerCopied(cli);
     cli.help((sections) => {
         if (resolveLang() !== 'zh')
             return;
         const titles = {
-            Usage: '用法',
-            Commands: '命令',
-            Options: '选项',
-            Examples: '示例',
-            'For more info, run any command with the `--help` flag': '查看某个命令的说明，请运行该命令并加上 --help',
+            Usage: zhText("m368"),
+            Commands: zhText("m367"),
+            Options: zhText("m366"),
+            Examples: zhText("m365"),
+            'For more info, run any command with the `--help` flag': zhText("m364"),
         };
         return sections.map((section) => ({
             ...section,
             ...(section.title === undefined ? {} : { title: titles[section.title] ?? section.title }),
             body: section.body
-                .replaceAll('Display this message', '显示本说明')
-                .replaceAll('Display version number', '显示版本号')
-                .replace(/ \(default: ([^)\n]+)\)/g, ' (默认：$1)'),
+                .replaceAll('Display this message', zhText("m363"))
+                .replaceAll('Display version number', zhText("m362"))
+                .replace(/ \(default: ([^)\n]+)\)/g, zhText("m361")),
         }));
     });
     cli.version(packageVersion);

package/dist/cli/render.js

@@ -1,3 +1,4 @@
+import { zhText } from '../core/chinese-messages.js';
 import pc from 'picocolors';
 import { formatJobDetail } from '../core/job-display.js';
 import { ui } from '../core/locale.js';
@@ -29,7 +30,10 @@ export function renderOutcome(outcome, human, argv = process.argv) {
 export function renderFailureHuman(failed) {
     if (failed.job)
         console.log(formatJobDetail(failed.job));
-    console.error(pc.red(`${ui('Error: ', '错误：')}${failed.error}`));
+    const line = failed.submission === 'unknown'
+        ? `${failed.message} (${failed.code})${failed.httpStatus ? ` (HTTP ${failed.httpStatus})` : ''}${failed.idempotencyKey ? `\n${ui('Idempotency key', zhText("m408"))}: ${failed.idempotencyKey}` : ''}`
+        : failed.error;
+    console.error(pc.red(`${ui('Error: ', zhText("m407"))}${line}`));
     markFailed();
 }
 //# sourceMappingURL=render.js.map

package/dist/core/asset-stream.d.ts

@@ -0,0 +1,16 @@
+import type { FileHandle } from 'node:fs/promises';
+/** Streams into an already exclusively owned temporary file. Caller owns
+ * path authorization, publication, recovery ownership and closing the handle. */
+export declare function streamAssetBodyToFile(body: ReadableStream<Uint8Array>, handle: FileHandle, options: {
+    limit: number;
+    signal?: AbortSignal;
+    expectedBytes?: number;
+    requireNonEmpty?: boolean;
+    onProgress?(bytes: number): void | Promise<void>;
+    onReadError?(): void;
+}): Promise<{
+    byteLength: number;
+    prefix: Buffer;
+    sha256: string;
+}>;
+//# sourceMappingURL=asset-stream.d.ts.map

package/dist/core/asset-stream.js

@@ -0,0 +1,64 @@
+import { createHash } from 'node:crypto';
+import { Readable, Writable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { LumenKeyError } from './client.js';
+/** Streams into an already exclusively owned temporary file. Caller owns
+ * path authorization, publication, recovery ownership and closing the handle. */
+export async function streamAssetBodyToFile(body, handle, options) {
+    if (!Number.isSafeInteger(options.limit) || options.limit < 1 || (options.expectedBytes !== undefined && (!Number.isSafeInteger(options.expectedBytes) || options.expectedBytes < 0)))
+        throw new LumenKeyError('DOWNLOAD_LENGTH_MISMATCH');
+    if (options.expectedBytes !== undefined && options.expectedBytes > options.limit)
+        throw new LumenKeyError('DOWNLOAD_TOO_LARGE');
+    let byteLength = 0;
+    let prefix = Buffer.alloc(0);
+    const hash = createHash('sha256');
+    options.signal?.throwIfAborted();
+    const reader = body.getReader();
+    const abort = () => { void reader.cancel(options.signal?.reason).catch(() => { }); };
+    options.signal?.addEventListener('abort', abort, { once: true });
+    const source = Readable.from((async function* () {
+        for (;;) {
+            let part;
+            try {
+                part = await reader.read();
+            }
+            catch (error) {
+                options.onReadError?.();
+                throw error;
+            }
+            if (part.done)
+                return;
+            yield part.value;
+        }
+    })());
+    const sink = new Writable({ write(chunk, _encoding, done) {
+            (async () => {
+                byteLength += chunk.byteLength;
+                if (!Number.isSafeInteger(byteLength) || byteLength > options.limit)
+                    throw new LumenKeyError('DOWNLOAD_TOO_LARGE');
+                if (prefix.length < 4096)
+                    prefix = Buffer.concat([prefix, chunk.subarray(0, 4096 - prefix.length)]);
+                hash.update(chunk);
+                await handle.writeFile(chunk);
+                await options.onProgress?.(byteLength);
+            })().then(() => done(), error => done(error));
+        } });
+    // A local write/progress failure can leave the async source waiting on its
+    // next web read. Cancel it here, not after pipeline (which waits for it).
+    sink.on('error', error => { void reader.cancel(error).catch(() => { }); });
+    try {
+        await pipeline(source, sink, { signal: options.signal });
+    }
+    finally {
+        options.signal?.removeEventListener('abort', abort);
+        await reader.cancel().catch(() => { });
+        reader.releaseLock();
+    }
+    if (options.expectedBytes !== undefined && byteLength !== options.expectedBytes)
+        throw new LumenKeyError('DOWNLOAD_LENGTH_MISMATCH');
+    if (options.requireNonEmpty && !byteLength)
+        throw new LumenKeyError('DOWNLOAD_EMPTY');
+    await handle.sync();
+    return { byteLength, prefix, sha256: hash.digest('hex') };
+}
+//# sourceMappingURL=asset-stream.js.map

package/dist/core/atomic-config-file.js

@@ -1,3 +1,4 @@
+import { zhText } from '../core/chinese-messages.js';
 import fs from 'node:fs';
 import path from 'node:path';
 import crypto from 'node:crypto';
@@ -39,20 +40,20 @@ export function assertSafeConfigFile(target) {
 export function classifyConfigFailure(error) {
     if (error instanceof UnsafeConfigPathError) {
         if (error.kind === 'link')
-            return { code: 'CONFIG_UNSAFE_PATH', reason: ui('Symbolic links and hard links are not supported for configuration; use a regular private file and directory.', '配置不支持符号链接或硬链接；请使用独立的普通文件和目录。') };
+            return { code: 'CONFIG_UNSAFE_PATH', reason: ui('Symbolic links and hard links are not supported for configuration; use a regular private file and directory.', zhText("m6")) };
         if (error.kind === 'not-regular-file')
-            return { code: 'CONFIG_NOT_A_FILE', reason: ui('The path exists but is not a regular file (a directory, FIFO, socket or device); replace it with a regular file.', '该路径存在，但不是普通文件（目录、FIFO、套接字或设备）；请换成普通文件。') };
-        return { code: 'CONFIG_NOT_A_FILE', reason: ui('The configuration directory exists but is not a directory.', '配置目录存在，但不是目录。') };
+            return { code: 'CONFIG_NOT_A_FILE', reason: ui('The path exists but is not a regular file (a directory, FIFO, socket or device); replace it with a regular file.', zhText("m5")) };
+        return { code: 'CONFIG_NOT_A_FILE', reason: ui('The configuration directory exists but is not a directory.', zhText("m4")) };
     }
     // User-facing reasons name the condition, never the errno: scripts match the code, people read the sentence.
     const sys = error;
     if (sys?.code === 'ENOTDIR')
-        return { code: 'CONFIG_NOT_A_FILE', reason: ui('A component of the configuration path is not a directory.', '配置路径中有一段不是目录。') };
+        return { code: 'CONFIG_NOT_A_FILE', reason: ui('A component of the configuration path is not a directory.', zhText("m3")) };
     if (sys?.code === 'EISDIR')
-        return { code: 'CONFIG_NOT_A_FILE', reason: ui('The path is a directory, not a regular file.', '该路径是目录，不是普通文件。') };
+        return { code: 'CONFIG_NOT_A_FILE', reason: ui('The path is a directory, not a regular file.', zhText("m2")) };
     if (sys?.code === 'EACCES' || sys?.code === 'EPERM')
-        return { code: 'CONFIG_UNREADABLE', reason: ui('Permission denied for the configuration path.', '没有访问配置路径的权限。') };
-    return { code: 'CONFIG_INVALID', reason: ui('The config file could not be read.', '配置文件无法读取。') };
+        return { code: 'CONFIG_UNREADABLE', reason: ui('Permission denied for the configuration path.', zhText("m1")) };
+    return { code: 'CONFIG_INVALID', reason: ui('The config file could not be read.', zhText("m0")) };
 }
 /**
  * Create the private configuration directory chain (0700) and tighten it if it already exists

package/dist/core/chinese-messages.d.ts

@@ -0,0 +1,4 @@
+import { type ChineseScript } from './chinese-script.js';
+export declare const CHINESE_MESSAGES: Record<ChineseScript, Record<string, string>>;
+export declare function zhText(id: string, script?: ChineseScript): string;
+//# sourceMappingURL=chinese-messages.d.ts.map