@lumenkey/cli 0.1.0

package/README.md

@@ -0,0 +1,134 @@
+# @lumenkey/cli
+
+> **光钥 (LumenKey) 官方 CLI 命令行工具 & 智能体 MCP (Model Context Protocol) 统一服务包**  
+> 一套代码同构支持：**人类终端命令行 (CLI)** 与 **AI Agent (Cursor / Claude Code / Codex / Antigravity) 原生工具挂载 (MCP Server)**。
+
+---
+
+## 🌟 核心特性
+
+- ⚡ **双模一体 (Dual-Mode)**：既能作为人类敲命令、脚本批处理的 CLI，又能作为 MCP Server 一键挂载进智能体。
+- 🎬 **全模态视频直接出片**：现网直通 **Seedance 2.0 (`doubao-seedance-2.0`)**、**通义万相 Wan 3.0 (`wan3.0-video`)** 等顶流模型，带实时状态轮询与自动下载。
+- 🔍 **动态模型目录 (Dynamic Catalog)**：实时拉取最新模型池与价格，新模型上线与旧模型兼容零延迟。
+- 🔒 **工业级安全与规范**：MCP 标准 `stdout` 仅输出协议，调试日志纯走 `stderr`，完美适配 Cursor 与 Claude。
+
+---
+
+## 📦 极速上手 (Quick Start)
+
+### 1. 认证配置
+
+可通过环境变量或配置命令设置您的 API Key：
+
+```bash
+# 方式一：设置环境变量（推荐）
+export LUMENKEY_API_KEY="lk_live_xxxxxxxx"
+
+# 方式二：保存至本地 ~/.lumenkey/config.json
+npx @lumenkey/cli login --key lk_live_xxxxxxxx
+```
+
+---
+
+## 💻 命令行模式 (CLI Usage)
+
+### 1. 浏览全站可用模型
+```bash
+# 查看全站模型（文本/视频/生图）
+npx @lumenkey/cli models
+
+# 只看视频模型
+npx @lumenkey/cli models --type video
+```
+
+### 2. 一键生成视频（自动轮询并下载）
+```bash
+npx @lumenkey/cli video \
+  --model doubao-seedance-2.0 \
+  --prompt "赛博朋克风格的雨夜街道，霓虹灯倒影在积水中，电影级运镜" \
+  --duration 5 \
+  --resolution 720p \
+  --output ./cyberpunk.mp4
+```
+
+### 3. 查询异步任务状态
+```bash
+npx @lumenkey/cli status <jobId>
+```
+
+### 4. 查看账户算力余额
+```bash
+npx @lumenkey/cli balance
+```
+
+---
+
+## 🤖 智能体挂载 (MCP Server for AI Agents)
+
+任何支持 **Model Context Protocol (MCP)** 的工具或编辑器（Cursor、Claude Code、Claude Desktop、Codex、Antigravity），只需配置 3 行代码：
+
+### 1. 在 Cursor 中配置 (`.cursor/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "lumenkey": {
+      "command": "npx",
+      "args": ["-y", "@lumenkey/cli", "mcp"],
+      "env": {
+        "LUMENKEY_API_KEY": "lk_live_xxxxxxxx",
+        "LUMENKEY_BASE_URL": "https://123outlets.com"
+      }
+    }
+  }
+}
+```
+
+### 2. 在 Claude Code 中配置
+
+```bash
+claude mcp add lumenkey npx -y @lumenkey/cli mcp
+```
+
+### 3. 在 Claude Desktop 中配置 (`claude_desktop_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "lumenkey": {
+      "command": "npx",
+      "args": ["-y", "@lumenkey/cli", "mcp"],
+      "env": {
+        "LUMENKEY_API_KEY": "lk_live_xxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+---
+
+## 🛠️ MCP 暴露给 Agent 的工具集
+
+| 工具名 (Tool) | 描述 |
+| :--- | :--- |
+| `lumenkey_list_models` | 动态获取站内所有模型目录、模态分类与价格 |
+| `lumenkey_generate_video` | 调度 Seedance 2.0 / Wan 3.0 生成视频并自动保存 |
+| `lumenkey_generate_image` | 调度商业级图像模型生成图片 |
+| `lumenkey_query_job` | 根据任务 ID 异步查询进度与生成产物 URL |
+| `lumenkey_check_balance` | 实时查询账户算力点数与充值状态 |
+
+---
+
+## 🏗️ 架构与底层协议
+
+遵循光钥华语站/国际站 OpenAPI 标准：
+1. `POST /v1/generation-quotes`：获取单次生成报价与算力预扣凭据；
+2. `POST /v1/generation-jobs`：附带 `Idempotency-Key` 幂等创建异步作业；
+3. `GET /v1/generation-jobs/{jobId}`：指数退避轮询任务状态；
+4. `POST /v1/generation-jobs/{jobId}/cancel`：超时或主动中断任务。
+
+---
+
+## 📄 License
+MIT © 2026 LumenKey Team.

package/bin/lumenkey-mcp.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runMcpStdio } from '../dist/mcp/server.js';
+
+runMcpStdio().catch((err) => {
+  process.stderr.write(`[LumenKey MCP Fatal] ${err?.message || err}\n`);
+  process.exit(1);
+});

package/bin/lumenkey.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runCli } from '../dist/cli/index.js';
+
+runCli().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/dist/cli/copied.d.ts

@@ -0,0 +1,27 @@
+import type { CAC } from 'cac';
+import { LumenKeyClient } from '../core/client.js';
+import type { GenerationJobDetail, ModelItem } from '../core/types.js';
+export declare function wantsJson(argv?: string[]): boolean;
+export declare function rawOption(names: string[], argv?: string[]): string | undefined;
+export declare function applyRaw(options: Record<string, unknown>, key: string, names: string[]): void;
+export declare function emit(data: unknown, human: () => void, argv?: string[]): void;
+export declare function submitQuote(modelId: string, input: Record<string, unknown>, options: Record<string, unknown>): Promise<{
+    jobId: string;
+    idempotencyKey: string;
+} | undefined>;
+export declare function buildGenerationInput(modelId: string, fields: Record<string, unknown>, pairs: string[], known?: ModelItem): Promise<{
+    input: Record<string, unknown>;
+    properties: Record<string, unknown>;
+}>;
+export declare function registerCopied(cli: CAC): void;
+export declare function outputUrls(detail: {
+    outputs?: Array<{
+        url?: string;
+    }>;
+}): string[];
+export declare function pollConfirmed(api: LumenKeyClient, jobId: string, options: {
+    interval?: unknown;
+    timeout?: unknown;
+}): Promise<GenerationJobDetail>;
+export declare function promptForKey(): Promise<string | undefined>;
+//# sourceMappingURL=copied.d.ts.map

package/dist/cli/copied.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copied.d.ts","sourceRoot":"","sources":["../../src/cli/copied.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAiB,MAAM,mBAAmB,CAAC;AAMlE,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AASvE,wBAAgB,SAAS,CAAC,IAAI,WAAe,GAAG,OAAO,CAEtD;AAOD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,WAAe,GAAG,MAAM,GAAG,SAAS,CAYlF;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAI7F;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,IAAI,WAAe,GAAG,IAAI,CAMhF;AAYD,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAyBnL;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAOjN;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAsS7C;AAqBD,wBAAgB,UAAU,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,MAAM,EAAE,CAElF;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmBxJ;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAIhE"}

package/dist/cli/copied.js

@@ -0,0 +1,489 @@
+import crypto from 'node:crypto';
+import os from 'node:os';
+import { describeKey, loadConfig } from '../core/config.js';
+import { LumenKeyClient, LumenKeyError } from '../core/client.js';
+import { explainModel, findModels } from '../core/explain.js';
+import { applyKeyValues, asPairs, validateKnownEnums } from '../core/set-values.js';
+import { createProfile, currentProfile, deleteProfile, listProfiles, publicProfile, setNamedProfileFields, setProfile, setProfileFields, unsetProfile } from '../core/profiles.js';
+import { waitForJob } from '../core/wait.js';
+import { assertJobResult, downloadFile, pollJob } from '../core/poller.js';
+const COMPLETIONS = {
+    bash: `_lumenkey() {\n  local cur prev\n  cur="\${COMP_WORDS[COMP_CWORD]}"\n  prev="\${COMP_WORDS[COMP_CWORD-1]}"\n  case "$prev" in\n    model) COMPREPLY=( $(compgen -W "search get explain" -- "$cur") ) ;;\n    image) COMPREPLY=( $(compgen -W "generate" -- "$cur") ) ;;\n    tasks) COMPREPLY=( $(compgen -W "progress wait cancel" -- "$cur") ) ;;\n    profile) COMPREPLY=( $(compgen -W "list create set unset key host delete" -- "$cur") ) ;;\n    auth) COMPREPLY=( $(compgen -W "profile" -- "$cur") ) ;;\n    *) COMPREPLY=( $(compgen -W "login models video status balance chat mcp model image tasks profile auth doctor completion" -- "$cur") ) ;;\n  esac\n}\ncomplete -F _lumenkey lumenkey\n`,
+    zsh: `#compdef lumenkey\n_lumenkey() {\n  if (( CURRENT == 2 )); then\n    compadd login models video status balance chat mcp model image tasks profile auth doctor completion\n  elif [[ \${words[2]} == model ]]; then\n    compadd search get explain\n  elif [[ \${words[2]} == image ]]; then\n    compadd generate\n  elif [[ \${words[2]} == tasks ]]; then\n    compadd progress wait cancel\n  fi\n}\ncompdef _lumenkey lumenkey\n`,
+    tcsh: `complete lumenkey 'p/1/(login models video status balance chat mcp model image tasks profile auth doctor completion)/' 'n/model/(search get explain)/' 'n/image/(generate)/' 'n/tasks/(progress wait cancel)/'\n`,
+    fish: `complete -c lumenkey -n "__fish_use_subcommand" -a "login models video status balance chat mcp model image tasks profile auth doctor completion"\ncomplete -c lumenkey -n "__fish_seen_subcommand_from model" -a "search get explain"\ncomplete -c lumenkey -n "__fish_seen_subcommand_from image" -a "generate"\ncomplete -c lumenkey -n "__fish_seen_subcommand_from tasks" -a "progress wait cancel"\n`,
+};
+export function wantsJson(argv = process.argv) {
+    return argv.includes('--json');
+}
+function spellings(name) {
+    const camel = name.replace(/([a-z])-([a-z])/g, (_, a, b) => a + b.toUpperCase());
+    return camel === name ? [name] : [name, camel];
+}
+export function rawOption(names, argv = process.argv) {
+    const all = names.flatMap(spellings);
+    let found;
+    for (let i = 2; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === '--')
+            break;
+        for (const name of all) {
+            if (arg === name && i + 1 < argv.length)
+                found = argv[i + 1];
+            else if (arg.startsWith(`${name}=`))
+                found = arg.slice(name.length + 1);
+        }
+    }
+    return found;
+}
+export function applyRaw(options, key, names) {
+    const raw = rawOption(names);
+    if (raw !== undefined)
+        options[key] = raw;
+    else if (options[key] !== undefined && typeof options[key] !== 'string')
+        throw new Error(`${names[0]} could not be read as text. Use ${names[0]} <value>.`);
+}
+export function emit(data, human, argv = process.argv) {
+    if (wantsJson(argv)) {
+        console.log(JSON.stringify(data));
+        return;
+    }
+    human();
+}
+function client() {
+    return new LumenKeyClient(loadConfig());
+}
+function propertiesOf(model) {
+    const properties = model.inputSchema?.properties;
+    if (!properties || typeof properties !== 'object' || Array.isArray(properties))
+        throw new LumenKeyError('MODEL_INPUT_SCHEMA_INVALID');
+    return properties;
+}
+export async function submitQuote(modelId, input, options) {
+    const api = client();
+    const rawKey = rawOption(['--idempotency-key']);
+    if (rawKey !== undefined) {
+        if (!rawKey.trim())
+            throw new Error('--idempotency-key must not be empty.');
+        options.idempotencyKey = rawKey;
+    }
+    const schemaProperties = options.schemaProperties;
+    if (schemaProperties && typeof schemaProperties === 'object' && !Array.isArray(schemaProperties))
+        validateKnownEnums(schemaProperties, input);
+    const quote = await api.getQuote({ modelId, input });
+    if (!options.confirm) {
+        emit({ ...quote, submitted: false }, () => {
+            console.log(`Quote ID: ${quote.quoteId} (${quote.credits} credits)`);
+            console.log('Quote only. No job submitted.');
+        });
+        return;
+    }
+    if (options.maxCredits !== undefined && (!Number.isSafeInteger(Number(options.maxCredits)) || Number(options.maxCredits) < 0 || quote.credits > Number(options.maxCredits)))
+        throw new Error('QUOTE_CREDIT_LIMIT');
+    const provided = options.idempotencyKey == null ? '' : String(options.idempotencyKey).trim();
+    const key = provided || crypto.randomUUID();
+    console.error('Submitting generation job...');
+    const projectId = options.projectId == null || options.projectId === '' ? undefined : String(options.projectId);
+    const job = await api.createJob({ quoteId: quote.quoteId, projectId, input }, key);
+    if (!options.suppressEmit)
+        emit({ ...job, idempotencyKey: key, submitted: true }, () => console.log(`Job created: ${job.jobId}`));
+    return { jobId: job.jobId, idempotencyKey: key };
+}
+export async function buildGenerationInput(modelId, fields, pairs, known) {
+    const model = known?.id === modelId ? known : (await client().listModels()).find((item) => item.id === modelId);
+    if (!model)
+        throw new LumenKeyError('MODEL_NOT_IN_CATALOG');
+    const properties = propertiesOf(model);
+    const declared = Object.fromEntries(Object.entries(fields).filter(([key, value]) => value !== undefined && Object.prototype.hasOwnProperty.call(properties, key)));
+    const extra = applyKeyValues({}, pairs);
+    return { input: { ...declared, ...extra }, properties };
+}
+export function registerCopied(cli) {
+    cli.option('--json', 'Emit machine-readable JSON');
+    cli.command('model <action> [name]', 'model search | get | explain')
+        .example('lumenkey model search wan --type video')
+        .example('lumenkey model get minimax-h3')
+        .example('lumenkey --json model explain minimax-h3')
+        .option('--type <type>', 'Filter or disambiguate by catalog type')
+        .action(async (action, name, options) => {
+        applyRaw(options, 'type', ['--type']);
+        if (action === 'search') {
+            const models = findModels(await client().listModels(), name || '', options.type);
+            emit({ query: name || '', count: models.length, models }, () => {
+                for (const model of models)
+                    console.log(model.id);
+                if (models.length === 0)
+                    console.log('No models available for this request.');
+            });
+            return;
+        }
+        if (!name)
+            throw new Error('Model name is required. Try: model search');
+        if (action === 'get') {
+            const exact = findModels(await client().listModels(), '').filter((model) => model.id === name || (model.displayName || model.name || '').toLowerCase() === name.toLowerCase());
+            if (exact.length !== 1)
+                throw new Error(`Expected exactly one model match for ${name}, got ${exact.length}. Try: model search ${name}`);
+            emit(exact[0], () => console.log(JSON.stringify(exact[0], null, 2)));
+            return;
+        }
+        if (action === 'explain') {
+            const all = await client().listModels();
+            const exact = all.filter((model) => model.id === name || (model.displayName || model.name || '').toLowerCase() === name.toLowerCase());
+            const chosen = exact.length === 1 ? exact[0] : findModels(all, name, options.type).length === 1 ? findModels(all, name, options.type)[0] : undefined;
+            if (!chosen)
+                throw new Error(`Expected exactly one model match for ${name}, got ${exact.length}. Try: model search ${name}`);
+            const explained = explainModel(chosen);
+            emit(explained, () => console.log(JSON.stringify(explained, null, 2)));
+            return;
+        }
+        throw new Error(`Unknown model command: ${action}`);
+    });
+    cli.command('image <action>', 'image generate')
+        .example('lumenkey image generate -m wan2.7-image -p "red circle"')
+        .example('lumenkey image generate -m wan2.7-image -p "red circle" --set seed=2 --dry-run')
+        .option('-m, --model <modelId>', 'Model id')
+        .option('-p, --prompt <prompt>', 'Prompt')
+        .option('--resolution <res>', 'Resolution, only if the catalog declares it')
+        .option('--aspect-ratio <ratio>', 'Aspect ratio, only if the catalog declares it')
+        .option('--count <count>', 'Count, only if the catalog declares it')
+        .option('--image <image>', 'Reference image, only if the catalog declares it')
+        .option('-s, --set <pair>', 'Extra key=value. Repeatable')
+        .option('--dry-run', 'Print the projected input and do not quote')
+        .option('--confirm', 'Submit this quote')
+        .option('--idempotency-key <key>', 'Stable operation key')
+        .option('--max-credits <credits>', 'Reject quotes above this limit')
+        .option('-o, --output <outputPath>', 'Save the first result to this path. Omit it to print the URLs only')
+        .option('--interval <seconds>', 'Poll interval seconds after confirm', { default: 5 })
+        .option('--timeout <seconds>', 'Poll timeout seconds after confirm', { default: 1800 })
+        .action(async (action, options) => {
+        if (action !== 'generate')
+            throw new Error(`Unknown image command: ${action}`);
+        applyRaw(options, 'model', ['--model', '-m']);
+        applyRaw(options, 'prompt', ['--prompt', '-p']);
+        applyRaw(options, 'resolution', ['--resolution']);
+        applyRaw(options, 'aspectRatio', ['--aspect-ratio']);
+        applyRaw(options, 'count', ['--count']);
+        applyRaw(options, 'image', ['--image']);
+        applyRaw(options, 'idempotencyKey', ['--idempotency-key']);
+        applyRaw(options, 'output', ['--output', '-o']);
+        if (!options.model)
+            throw new LumenKeyError('MODEL_REQUIRED');
+        if (!options.prompt)
+            throw new Error('--prompt is required.');
+        const model = (await client().listModels()).find((item) => item.id === options.model);
+        if (!model)
+            throw new LumenKeyError('MODEL_NOT_IN_CATALOG');
+        const props = propertiesOf(model);
+        const fields = { prompt: String(options.prompt) };
+        const put = (name, value) => {
+            if (value !== undefined && Object.prototype.hasOwnProperty.call(props, name))
+                fields[name] = coerceDeclared(props[name], value);
+        };
+        put('resolution', options.resolution);
+        put('aspect_ratio', options.aspectRatio);
+        put('ratio', options.aspectRatio);
+        put('count', options.count);
+        put('image', options.image);
+        const built = await buildGenerationInput(String(options.model), fields, asPairs(options.set), model);
+        if (options.dryRun) {
+            emit({ dryRun: true, modelId: options.model, input: built.input }, () => console.log(JSON.stringify({ dryRun: true, modelId: options.model, input: built.input })));
+            return;
+        }
+        const created = await submitQuote(String(options.model), built.input, { ...options, schemaProperties: built.properties });
+        if (!created || wantsJson())
+            return;
+        const detail = await pollConfirmed(client(), created.jobId, options);
+        assertJobResult(detail, true);
+        const urls = outputUrls(detail);
+        for (const url of urls)
+            console.log(url);
+        if (urls[0] && typeof options.output === 'string' && options.output) {
+            const savedPath = await downloadFile(urls[0], options.output);
+            console.log(`Saved to ${savedPath}`);
+        }
+    });
+    cli.command('tasks <action> <jobId>', 'tasks progress | wait | cancel')
+        .example('lumenkey tasks progress <jobId>')
+        .example('lumenkey tasks wait <jobId> --interval 5 --timeout 1800')
+        .example('lumenkey tasks cancel <jobId> --yes')
+        .option('--interval <seconds>', 'Poll interval seconds', { default: 5 })
+        .option('--timeout <seconds>', 'Timeout seconds', { default: 1800 })
+        .option('--yes', 'Confirm cancellation')
+        .action(async (action, jobId, options) => {
+        if (action === 'progress') {
+            const detail = await client().getJob(jobId);
+            assertJobResult(detail, false);
+            emit(detail, () => console.log(JSON.stringify(detail, null, 2)));
+            return;
+        }
+        if (action === 'wait') {
+            const interval = Number(options.interval);
+            const timeout = Number(options.timeout);
+            if (!Number.isFinite(interval) || interval < 0 || !Number.isFinite(timeout) || timeout < 0)
+                throw new Error('--interval and --timeout must be non-negative numbers.');
+            if (interval * 1000 > 2_147_483_647)
+                throw new Error('--interval must be between 0 and 2147483 seconds.');
+            try {
+                const detail = await waitForJob(client(), jobId, { intervalMs: interval * 1000, timeoutMs: timeout * 1000 });
+                const failed = detail.error != null || ['failed', 'rejected', 'cancelled', 'expired'].includes(detail.status);
+                const body = { ...detail, ok: detail.status === 'succeeded' && !failed, timedOut: false };
+                emit(body, () => console.log(JSON.stringify(body, null, 2)));
+                if (!body.ok)
+                    process.exitCode = 1;
+                return;
+            }
+            catch (err) {
+                if (err instanceof LumenKeyError && err.code === 'WAIT_TIMEOUT') {
+                    const body = { status: 'TIMEOUT', ok: false, timedOut: true, jobId };
+                    emit(body, () => console.log(JSON.stringify(body)));
+                    process.exitCode = 1;
+                    return;
+                }
+                throw err;
+            }
+        }
+        if (action === 'cancel') {
+            if (!options.yes)
+                throw new Error('Refusing to cancel without --yes.');
+            const result = await client().cancelJob(jobId);
+            emit(result, () => console.log(JSON.stringify(result)));
+            return;
+        }
+        throw new Error(`Unknown tasks command: ${action}`);
+    });
+    cli.command('profile <action> [value]', 'profile list | create | set | unset | key | host | delete')
+        .example('lumenkey profile create work')
+        .example('lumenkey profile key')
+        .example('lumenkey profile host https://123outlets.com')
+        .example('lumenkey --json profile list')
+        .action(async (action, value) => {
+        if (action === 'list') {
+            const listed = listProfiles();
+            emit(listed, () => {
+                for (const row of listed.profiles)
+                    console.log(`${row.isSet ? '* ' : '  '}${row.profile}  ${row.settings.join(', ')}`);
+            });
+            return;
+        }
+        if (action === 'unset') {
+            unsetProfile();
+            emit({ current: null }, () => console.log('Default profile unset.'));
+            return;
+        }
+        if (action === 'key') {
+            const key = await readProfileKey();
+            const name = setProfileFields({ key });
+            emit({ profile: name, hasStoredToken: true }, () => console.log(`Key set for profile ${name}.`));
+            return;
+        }
+        if (!value)
+            throw new Error(`Profile ${action} needs a name.`);
+        if (action === 'create') {
+            const result = createProfile(value);
+            const text = result === 'exists' ? `Profile ${value} already exists.` : `Profile ${value} created.`;
+            emit({ name: value, created: result === 'created' }, () => console.log(text));
+            return;
+        }
+        if (action === 'set') {
+            try {
+                setProfile(value);
+            }
+            catch (err) {
+                if (!(err instanceof Error) || !err.message.includes('does not exist'))
+                    throw err;
+                console.error(`Profile ${value} does not exist.`);
+                const answer = (await ask('Would you like to create it? (y/N): ')).trim().toLowerCase();
+                if (answer !== 'y' && answer !== 'yes') {
+                    emit({ current: null, created: false }, () => console.log('Profile creation cancelled.'));
+                    return;
+                }
+                createProfile(value);
+            }
+            emit({ current: value }, () => console.log(`Default profile set to ${value}.`));
+            return;
+        }
+        if (action === 'host') {
+            try {
+                new LumenKeyClient({ baseUrl: value, timeoutMs: 1000 });
+            }
+            catch {
+                throw new LumenKeyError('BASE_URL_INVALID');
+            }
+            const name = setProfileFields({ host: value });
+            emit({ profile: name, host: value }, () => console.log(`Host set to ${value}.`));
+            return;
+        }
+        if (action === 'delete') {
+            const removed = deleteProfile(value);
+            const text = removed ? `Profile ${value} deleted.` : `Profile ${value} does not exist.`;
+            emit({ deleted: removed, name: value }, () => console.log(text));
+            return;
+        }
+        throw new Error(`Unknown profile command: ${action}`);
+    });
+    cli.command('auth <group> [action] [name]', 'auth status | profile list | use | save | delete')
+        .example('lumenkey auth profile list')
+        .example('lumenkey auth profile save work')
+        .example('lumenkey auth profile use work')
+        .example('lumenkey auth profile delete work --yes')
+        .option('--yes', 'Confirm deletion')
+        .option('--store-token', 'Store the environment key after a balance check')
+        .option('--no-activate', 'Do not make the saved profile active')
+        .action(async (group, action, name, options) => {
+        if (group === 'status') {
+            const body = describeKey();
+            emit(body, () => console.log(`key: ${body.keyConfigured ? body.keySource : 'not configured'}`));
+            return;
+        }
+        if (group !== 'profile')
+            throw new Error(`Unknown auth command: ${group}`);
+        if (action === 'list') {
+            const data = listProfiles();
+            const body = { active: data.current ?? null, profiles: data.profiles.map((row) => ({ name: row.profile, settings: row.settings })) };
+            emit(body, () => console.log(JSON.stringify(body, null, 2)));
+            return;
+        }
+        if (!name)
+            throw new Error(`Auth profile ${action} needs a name.`);
+        if (action === 'use') {
+            setProfile(name);
+            const record = currentProfile().record;
+            emit({ name, hasStoredToken: Boolean(record?.key), account: publicProfile(record) }, () => console.log(`Profile ${name} activated.`));
+            return;
+        }
+        if (action === 'save') {
+            const activate = options.activate !== false;
+            if (createProfile(name, undefined, activate) === 'exists' && activate)
+                setProfile(name);
+            if (options.storeToken) {
+                const key = process.env.LUMENKEY_API_KEY;
+                if (!key)
+                    throw new Error('LUMENKEY_API_KEY is not configured.');
+                await client().getBalance();
+                setNamedProfileFields(name, { key, host: process.env.LUMENKEY_BASE_URL });
+            }
+            const record = listProfiles().profiles.find((row) => row.profile === name);
+            emit({ name, active: activate, storedToken: Boolean(options.storeToken), settings: record?.settings ?? [] }, () => console.log(`Auth profile ${name} saved.`));
+            return;
+        }
+        if (action === 'delete') {
+            if (!options.yes)
+                throw new Error('Refusing to delete auth profile without --yes.');
+            const removed = deleteProfile(name);
+            const text = removed ? `Auth profile ${name} deleted.` : `Profile ${name} does not exist.`;
+            emit({ deleted: removed, name }, () => console.log(text));
+            return;
+        }
+        throw new Error(`Unknown auth profile command: ${action}`);
+    });
+    cli.command('doctor', 'Local environment summary. --online checks the key by reading balance')
+        .option('--online', 'Verify the configured key')
+        .action(async (options) => {
+        const config = loadConfig();
+        const checks = [
+            { name: 'cli', status: 'pass', version: '0.1.0' },
+            { name: 'runtime', status: 'pass', value: process.version },
+            { name: 'platform', status: 'pass', value: `${process.platform} ${os.release()}` },
+            { name: 'host', status: hostStatus(config), value: config.baseUrl },
+            { name: 'key', status: config.apiKey ? 'pass' : 'warn', configured: Boolean(config.apiKey) },
+        ];
+        if (options.online) {
+            try {
+                const balance = await new LumenKeyClient(config).getBalance();
+                checks.push({ name: 'onlineAuth', status: 'pass', availableCredits: balance.availableCredits });
+            }
+            catch (err) {
+                checks.push({ name: 'onlineAuth', status: 'fail', message: err instanceof Error ? err.message : 'online auth failed' });
+            }
+        }
+        const ok = checks.every((check) => check.status !== 'fail');
+        emit({ ok, checks }, () => {
+            console.log(`cli: 0.1.0`);
+            console.log(`runtime: ${process.version}`);
+            console.log(`platform: ${process.platform} ${os.release()}`);
+            console.log(`host: ${config.baseUrl}`);
+            console.log(`key: ${config.apiKey ? 'configured' : 'not configured'}`);
+            if (options.online)
+                console.log(`onlineAuth: ${checks.find((check) => check.name === 'onlineAuth')?.status}`);
+        });
+        if (!ok)
+            process.exitCode = 1;
+    });
+    cli.command('completion <shell>', 'Print a shell completion script')
+        .action((shell) => {
+        const script = COMPLETIONS[shell];
+        if (!script)
+            throw new Error('Shell must be bash, zsh, tcsh, or fish.');
+        console.log(script);
+    });
+}
+function hostStatus(config) {
+    try {
+        new LumenKeyClient({ baseUrl: config.baseUrl, timeoutMs: config.timeoutMs, apiKey: config.apiKey });
+        return 'pass';
+    }
+    catch {
+        return 'fail';
+    }
+}
+function coerceDeclared(spec, value) {
+    const type = spec && typeof spec === 'object' && !Array.isArray(spec) ? spec.type : undefined;
+    if (type === 'integer' || type === 'number') {
+        const parsed = Number(value);
+        if (!Number.isFinite(parsed))
+            throw new Error(`Invalid number: ${String(value)}`);
+        return type === 'integer' ? Math.trunc(parsed) : parsed;
+    }
+    return String(value);
+}
+export function outputUrls(detail) {
+    return (detail.outputs ?? []).map((item) => item.url).filter((url) => typeof url === 'string' && url.length > 0);
+}
+export async function pollConfirmed(api, jobId, options) {
+    const interval = Number(options.interval ?? 5);
+    const timeout = Number(options.timeout ?? 1800);
+    if (!Number.isFinite(interval) || interval < 0 || interval * 1000 > 2_147_483_647 || !Number.isFinite(timeout) || timeout < 0) {
+        throw new Error('--interval and --timeout must be non-negative numbers.');
+    }
+    const onSigint = () => {
+        api.cancelJob(jobId).catch(() => undefined).finally(() => process.exit(130));
+    };
+    process.once('SIGINT', onSigint);
+    try {
+        return await pollJob(api, jobId, {
+            initialIntervalMs: interval * 1000,
+            timeoutMs: timeout * 1000,
+            onProgress: (row) => process.stderr.write(`  Status: ${row.status}\n`),
+        });
+    }
+    finally {
+        process.off('SIGINT', onSigint);
+    }
+}
+export async function promptForKey() {
+    if (!process.stdin.isTTY || process.stdin.readableEnded || process.stdin.destroyed)
+        return undefined;
+    const key = (await ask('Enter the key: ')).trim();
+    return key || undefined;
+}
+async function ask(prompt) {
+    if (process.stdin.readableEnded || process.stdin.destroyed)
+        throw new Error('stdin closed before an answer was given.');
+    const readline = await import('node:readline');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+    return await new Promise((resolve, reject) => {
+        let answered = false;
+        rl.once('line', (line) => { answered = true; rl.close(); resolve(line); });
+        rl.once('close', () => { if (!answered)
+            reject(new Error('stdin closed before an answer was given.')); });
+        rl.setPrompt(prompt);
+        rl.prompt();
+    });
+}
+async function readProfileKey() {
+    const key = (await ask('Enter the key: ')).trim();
+    if (!key)
+        throw new Error('Enter the key: empty.');
+    return key;
+}
+//# sourceMappingURL=copied.js.map