touka-ai 0.2.0

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "touka-ai",
+  "version": "0.2.0",
+  "description": "Touka CLI — AI Gateway client for skills, LLM, AIGC, ASR, TTS",
+  "type": "module",
+  "bin": {
+    "touka": "./src/cli.js"
+  },
+  "files": [
+    "src/cli.js"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "start": "node src/cli.js"
+  },
+  "keywords": ["ai", "agent", "skill", "cli", "codex", "claude-code", "llm", "tts", "asr", "aigc"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/touka-ai/touka-cli"
+  }
+}

package/src/cli.js

@@ -0,0 +1,585 @@
+#!/usr/bin/env node
+
+/**
+ * Touka CLI v0.2.0 — AI Gateway Client
+ * Modules: skill, aigc, llm, asr, tts, config
+ *
+ * Requires Node.js >= 18
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, unlinkSync } from 'fs';
+import { join, resolve, basename } from 'path';
+import { homedir } from 'os';
+
+const PKG_NAME = 'touka-ai';
+const VERSION = '0.2.0';
+const CONFIG_DIR = join(homedir(), '.touka');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const UPDATE_CHECK_FILE = join(CONFIG_DIR, '.update-check');
+const MAX_ROWS = 20;
+
+// ── Update check (non-blocking, runs in background) ──
+function checkForUpdate() {
+  try {
+    // Only check once per day
+    if (existsSync(UPDATE_CHECK_FILE)) {
+      const last = JSON.parse(readFileSync(UPDATE_CHECK_FILE, 'utf-8'));
+      if (Date.now() - last.ts < 86400000) {
+        if (last.latest && last.latest !== VERSION) {
+          console.log(`\n  Update available: v${VERSION} → v${last.latest}`);
+          console.log(`  Run: touka update\n`);
+        }
+        return;
+      }
+    }
+  } catch {}
+  // Fire-and-forget: query npm registry
+  fetch(`https://registry.npmjs.org/${PKG_NAME}/latest`, { signal: AbortSignal.timeout(3000) })
+    .then(r => r.ok ? r.json() : null)
+    .then(d => {
+      if (!d?.version) return;
+      mkdirSync(CONFIG_DIR, { recursive: true });
+      writeFileSync(UPDATE_CHECK_FILE, JSON.stringify({ ts: Date.now(), latest: d.version }));
+      if (d.version !== VERSION) {
+        console.log(`\n  Update available: v${VERSION} → v${d.version}`);
+        console.log(`  Run: touka update\n`);
+      }
+    })
+    .catch(() => {}); // silently ignore network errors
+}
+
+// ── Config ──
+function loadConfig() { try { return existsSync(CONFIG_FILE) ? JSON.parse(readFileSync(CONFIG_FILE, 'utf-8')) : {}; } catch { return {}; } }
+function saveConfig(c) { mkdirSync(CONFIG_DIR, { recursive: true }); writeFileSync(CONFIG_FILE, JSON.stringify(c, null, 2)); }
+function ep() { return loadConfig().endpoint || process.env.SKYLINK_ENDPOINT || ''; }
+function ak() { return loadConfig().api_key || process.env.SKYLINK_API_KEY || ''; }
+function tk() { return loadConfig().token || process.env.SKYLINK_TOKEN || ''; }
+
+// ── HTTP ──
+async function api(method, path, { body, stream, auth } = {}) {
+  const e = ep();
+  if (!e) throw new Error('Not configured.\n  Run: touka config set --endpoint URL --api-key KEY');
+  const t = auth === 'token' ? tk() : ak();
+  if (!t) throw new Error(`Missing ${auth === 'token' ? 'token' : 'API key'}.\n  Run: touka config set --${auth === 'token' ? 'token T' : 'api-key K'}`);
+  const url = `${e.replace(/\/$/, '')}/v1${path}`;
+  const h = { 'Authorization': `Bearer ${t}` };
+  const o = { method, headers: h };
+  if (body instanceof FormData) o.body = body;
+  else if (body) { h['Content-Type'] = 'application/json'; o.body = JSON.stringify(body); }
+  const r = await fetch(url, o);
+  if (stream) return r;
+  const d = await r.json();
+  if (r.status >= 400) throw new Error(d?.message || d?.detail || d?.data?.message || `HTTP ${r.status}`);
+  return d?.data ?? d;
+}
+
+// ── Output ──
+function out(text, code = 0, t = Date.now()) { console.log(text); console.log(`[exit:${code} | ${Date.now()-t}ms]`); process.exit(code); }
+function fail(err, t = Date.now()) { console.error(`[error] ${err instanceof Error ? err.message : err}`); console.error(`[exit:1 | ${Date.now()-t}ms]`); process.exit(1); }
+function tbl(rows, cols) {
+  if (!rows.length) return '(no results)';
+  const w = cols.map(c => Math.max(c.l.length, ...rows.map((r, i) => String(c.f(r, i)).length)));
+  return [cols.map((c, i) => c.l.padEnd(w[i])).join('  '), cols.map((_, i) => '-'.repeat(w[i])).join('  '),
+    ...rows.map((r, ri) => cols.map((c, i) => String(c.f(r, ri)).padEnd(w[i])).join('  '))].join('\n');
+}
+function flag(args, short, long) { for (let i = 0; i < args.length; i++) if ((args[i]===short||args[i]===long) && args[i+1]) return args[++i]; return null; }
+function hasHelp(args) { return args.includes('-h') || args.includes('--help'); }
+function positional(args) { return args.filter(a => !a.startsWith('-')); }
+
+// ════════════════════════════════════════════
+// CONFIG
+// ════════════════════════════════════════════
+async function cmdConfig(args) {
+  const t = Date.now(), sub = args[0];
+  if (!sub || hasHelp(args)) out(
+    'Usage: touka config <command>\n\nManage CLI configuration.\n\n' +
+    'Commands:\n  set      Set values (--endpoint, --api-key, --token)\n  show     Show current config\n  reset    Clear all config\n\n' +
+    'Options:\n  -h, --help    Show this help\n\n' +
+    'Examples:\n  touka config set --endpoint https://gateway.example.com --api-key sk-xxx\n  touka config set --token YOUR_USER_TOKEN\n  touka config show', 0, t);
+  if (sub === 'set') {
+    const c = loadConfig();
+    const e = flag(args, null, '--endpoint'), a = flag(args, null, '--api-key'), to = flag(args, null, '--token');
+    if (e) c.endpoint = e; if (a) c.api_key = a; if (to) c.token = to;
+    saveConfig(c); out(`Saved to ${CONFIG_FILE}`, 0, t);
+  } else if (sub === 'show') {
+    const c = loadConfig();
+    out(`endpoint: ${c.endpoint||'(not set)'}\napi_key:  ${c.api_key?c.api_key.slice(0,8)+'...':'(not set)'}\ntoken:    ${c.token?c.token.slice(0,8)+'...':'(not set)'}\nfile:     ${CONFIG_FILE}`, 0, t);
+  } else if (sub === 'reset') { saveConfig({}); out('Config reset.', 0, t); }
+  else out(`[error] Unknown: ${sub}\n  Available: set, show, reset`, 1, t);
+}
+
+// ════════════════════════════════════════════
+// SKILL
+// ════════════════════════════════════════════
+async function cmdSkill(args) {
+  const t = Date.now(), sub = args[0];
+  if (!sub || hasHelp([sub])) out(
+    'Usage: touka skill <command> [args] [flags]\n\nSearch, install, and publish AI agent skills.\n\n' +
+    'Commands:\n  search <query>     Search public skills\n  install <slug>     Download and install a skill by name\n  info <slug>        Show skill details\n  publish <path>     Upload a skill zip\n  list               List your skills\n\n' +
+    'Flags:\n  -c, --category <cat>   coding, devops, testing, writing, other\n  -n, --limit <n>        Max results (default: 20)\n  -h, --help\n\n' +
+    'Install:\n' +
+    '  Skills are installed to ~/.codex/skills/<slug>/ for Codex.\n' +
+    '  If a skill is not found on SkillHub, ClawHub will be searched.\n\n' +
+    'Examples:\n  touka skill search "code review" -c coding\n  touka skill install code-review-cn\n  touka skill info touka-guide\n  touka skill publish ./s.zip --slug my-skill --name "My Skill"', 0, t);
+
+  const sa = args.slice(1);
+  if (sub === 'search') {
+    const q = positional(sa).join(' ');
+    if (!q) out('[error] Missing <query>\n  Usage: touka skill search <query> [-c cat] [-n limit]', 1, t);
+    const cat = flag(sa, '-c', '--category'), lim = flag(sa, '-n', '--limit') || 20;
+    let p = `/skillhub/skills/search?q=${encodeURIComponent(q)}&limit=${lim}`;
+    if (cat) p += `&category=${cat}`;
+    const d = await api('GET', p);
+    if (!(d.items||[]).length) out(`No skills found for "${q}".`, 0, t);
+    let r = tbl(d.items.slice(0, MAX_ROWS), [
+      {l:'#',f:(_,i)=>i+1}, {l:'ID',f:r=>r.id}, {l:'SLUG',f:r=>r.slug},
+      {l:'NAME',f:r=>(r.display_name||'').slice(0,25)}, {l:'BY',f:r=>(r.author||'').slice(0,12)},
+      {l:'⬇',f:r=>r.install_count}, {l:'❤',f:r=>r.like_count||0}, {l:'VER',f:r=>r.version},
+    ]);
+    if (d.items.length > MAX_ROWS) r += `\n--- ${MAX_ROWS} of ${d.items.length} ---`;
+    r += `\n\n${d.items.length} result(s). Install: touka skill install <SLUG>`;
+    out(r, 0, t);
+  }
+  if (sub === 'info') {
+    const slug = sa[0]; if (!slug) out('[error] Missing <slug>\n  Usage: touka skill info <slug>', 1, t);
+    const d = await api('GET', `/skillhub/skills/by-slug/${encodeURIComponent(slug)}`);
+    out([`${d.display_name} v${d.version}`,`by ${d.author||'?'}  ❤ ${d.like_count||0}  ⬇ ${d.install_count}`,'',
+      d.description||'(no description)','','── SKILL.md Preview ──',d.skill_md_preview||'(none)',
+      '',`Install: touka skill install ${d.slug}`].join('\n'), 0, t);
+  }
+  if (sub === 'install') {
+    const slug = sa[0]; if (!slug) out('[error] Missing <slug>\n  Usage: touka skill install <slug>\n  Find slugs: touka skill search <query>', 1, t);
+
+    // Step 1: resolve slug to ID via internal SkillHub
+    let skillId = null, skillSlug = slug, skillVer = '?';
+    try {
+      const info = await api('GET', `/skillhub/skills/by-slug/${encodeURIComponent(slug)}`);
+      skillId = info.id;
+      skillSlug = info.slug;
+      skillVer = info.version;
+      console.log(`Found "${info.display_name}" v${skillVer} on SkillHub`);
+    } catch {
+      // Not found on SkillHub → search ClawHub directly
+      console.log(`"${slug}" not found on SkillHub, searching ClawHub...`);
+      try {
+        const chResp = await fetch(`https://wry-manatee-359.convex.site/api/v1/search?q=${encodeURIComponent(slug)}&limit=5`);
+        if (!chResp.ok) throw new Error('ClawHub search failed');
+        const chData = await chResp.json();
+        const results = chData?.results || [];
+        const match = results.find(r => r.slug === slug) || results[0];
+        if (!match) out(`[error] "${slug}" not found on SkillHub or ClawHub.\n  Try: touka skill search <keyword>`, 1, t);
+
+        const chSlug = match.slug;
+        console.log(`Found "${match.displayName}" on ClawHub (${chSlug})`);
+        console.log(`Downloading from ClawHub...`);
+
+        // Download zip from ClawHub
+        const dlResp = await fetch(`https://wry-manatee-359.convex.site/api/v1/download?slug=${encodeURIComponent(chSlug)}`);
+        if (!dlResp.ok) throw new Error(`ClawHub download failed: ${dlResp.status}`);
+        const chBuf = Buffer.from(await dlResp.arrayBuffer());
+
+        // Install to Codex
+        const codexDir = join(homedir(), '.codex', 'skills', chSlug);
+        mkdirSync(codexDir, { recursive: true });
+        const tmpZ = join(codexDir, '__tmp.zip'); writeFileSync(tmpZ, chBuf);
+        const { execSync } = await import('child_process');
+        try { execSync(`unzip -o "${tmpZ}" -d "${codexDir}"`, { stdio: 'pipe' }); }
+        catch (e) { throw new Error(`unzip failed: ${e.message}`); }
+        try { unlinkSync(tmpZ); } catch {}
+        // Clean up .git dir from ClawHub packages
+        const gitDir = join(codexDir, '.git');
+        if (existsSync(gitDir)) try { execSync(`rm -rf "${gitDir}"`, { stdio: 'pipe' }); } catch {}
+        const fls = readdirSync(codexDir, { recursive: true }).filter(f => !String(f).startsWith('__') && !String(f).startsWith('.git'));
+
+        out([
+          `Installed from ClawHub: ${chSlug} → ${codexDir}`,
+          ...fls.map(f => `  ${f}`), '',
+          `Source: ClawHub (${match.displayName})`,
+          `Use in Codex: the skill is now available as /${chSlug}`,
+        ].join('\n'), 0, t);
+      } catch (chErr) {
+        out(`[error] "${slug}" not found on SkillHub.\nClawHub: ${chErr.message}\n  Try: touka skill search <keyword>`, 1, t);
+      }
+    }
+
+    if (!skillId) process.exit(0);
+
+    // Step 3: download from SkillHub
+    console.log(`Downloading ${skillSlug} v${skillVer}...`);
+    const r = await api('GET', `/skillhub/skills/${skillId}/download?agent_type=codex`, { stream: true });
+    if (!r.ok) { const e = await r.json().catch(()=>({})); throw new Error(e?.message||`HTTP ${r.status}`); }
+    const buf = Buffer.from(await r.arrayBuffer());
+
+    // Step 4: install to Codex skill directory (~/.codex/skills/<slug>/)
+    const codexSkillDir = join(homedir(), '.codex', 'skills', skillSlug);
+    mkdirSync(codexSkillDir, { recursive: true });
+    const tmp = join(codexSkillDir, '__tmp.zip'); writeFileSync(tmp, buf);
+    const { execSync } = await import('child_process');
+    try { execSync(`unzip -o "${tmp}" -d "${codexSkillDir}"`, { stdio: 'pipe' }); }
+    catch (e) { throw new Error(`unzip failed: ${e.message}`); }
+    try { unlinkSync(tmp); } catch {}
+    // Clean up .git dir
+    const gitD = join(codexSkillDir, '.git');
+    if (existsSync(gitD)) try { execSync(`rm -rf "${gitD}"`, { stdio: 'pipe' }); } catch {}
+    const files = readdirSync(codexSkillDir, { recursive: true }).filter(f => !String(f).startsWith('__') && !String(f).startsWith('.git'));
+    out([
+      `Installed ${skillSlug} v${skillVer} → ${codexSkillDir}`,
+      ...files.map(f => `  ${f}`), '',
+      `Use in Codex: the skill is now available as /${skillSlug}`,
+    ].join('\n'), 0, t);
+  }
+  if (sub === 'publish') {
+    const zp = sa[0]; if (!zp) out('[error] Missing <path>\n  Usage: touka skill publish <path.zip> --slug s --name "N" [--category c] [--visibility v] [--version ver] [--tags t1,t2]', 1, t);
+    const abs = resolve(zp);
+    if (!existsSync(abs)) throw new Error(`File not found: ${abs}`);
+    if (!abs.endsWith('.zip')) throw new Error('Not a .zip file.\n  Create: zip -r my-skill.zip SKILL.md');
+    const sl = flag(sa, null, '--slug'), nm = flag(sa, null, '--name');
+    if (!sl) throw new Error('Missing --slug'); if (!nm) throw new Error('Missing --name');
+    const desc = flag(sa, null, '--description'), cat = flag(sa, null, '--category');
+    const vis = flag(sa, null, '--visibility') || 'private', ver = flag(sa, null, '--version') || '1.0.0';
+    const tags = flag(sa, null, '--tags');
+    console.log(`Uploading ${basename(abs)}...`);
+    const fd = new FormData();
+    fd.append('file', new Blob([readFileSync(abs)], { type: 'application/zip' }), basename(abs));
+    fd.append('slug', sl); fd.append('display_name', nm);
+    if (desc) fd.append('description', desc); if (cat) fd.append('category', cat);
+    if (tags) fd.append('tags', JSON.stringify(tags.split(',')));
+    fd.append('visibility', vis); fd.append('version', ver);
+    const d = await api('POST', '/admin/skillhub/skills', { body: fd, auth: 'token' });
+    const lines = [`Published: ${sl} v${ver} (id: ${d.id})`, `Visibility: ${d.visibility}`];
+    if (d.review_status==='rejected') lines.push(`Review: REJECTED — ${d.review_notes}`);
+    else if (d.review_status==='approved') lines.push('Review: APPROVED');
+    out(lines.join('\n'), 0, t);
+  }
+  if (sub === 'list') {
+    const d = await api('GET', '/admin/skillhub/skills?my_only=true&page_size=50', { auth: 'token' });
+    if (!(d.items||[]).length) out('No skills yet.\n  Publish: touka skill publish ./s.zip --slug s --name "S"', 0, t);
+    out(tbl(d.items, [{l:'ID',f:r=>r.id},{l:'SLUG',f:r=>r.slug},{l:'NAME',f:r=>(r.display_name||'').slice(0,25)},
+      {l:'VIS',f:r=>r.visibility},{l:'VER',f:r=>r.version},{l:'⬇',f:r=>r.install_count},{l:'❤',f:r=>r.like_count||0}])
+      +`\n\n${d.items.length} skill(s)`, 0, t);
+  }
+}
+
+// ════════════════════════════════════════════
+// AIGC (image, video, status)
+// ════════════════════════════════════════════
+async function cmdAigc(args) {
+  const t = Date.now(), sub = args[0];
+  if (!sub || hasHelp([sub])) out(
+    'Usage: touka aigc <command> [args] [flags]\n\nGenerate images and videos via AI.\n\n' +
+    'Commands:\n  image <prompt>     Text-to-image generation\n  video <prompt>     Text-to-video generation\n  status <task_id>   Check task status\n\n' +
+    'Image flags:\n' +
+    '  --model <model>    Model (default: doubao-seedream-5-0-260128)\n' +
+    '  --size <WxH>       Size: 1024x1024, 768x1024, 512x512 etc.\n' +
+    '  -n <count>         Number of images 1-8 (default: 1)\n' +
+    '  --negative <text>  Negative prompt\n\n' +
+    'Video flags:\n' +
+    '  --model <model>    Model (default: doubao-seedance-1-5-pro-251215)\n' +
+    '  --image <url>      Reference image URL (for image-to-video)\n' +
+    '  --duration <sec>   Video duration 1-120 seconds\n' +
+    '  --ratio <ratio>    Aspect ratio: 16:9, 9:16, 1:1 etc.\n' +
+    '  --negative <text>  Negative prompt\n\n' +
+    'Options:\n  -h, --help\n\n' +
+    'Available image models:\n' +
+    '  doubao-seedream-5-0-260128     (default, latest)\n' +
+    '  doubao-seedream-4-5-251128\n' +
+    '  doubao-seedream-4-0-250828\n' +
+    '  doubao-seedream-3-0-t2i-250415\n\n' +
+    'Available video models:\n' +
+    '  doubao-seedance-1-5-pro-251215 (default, best quality)\n' +
+    '  doubao-seedance-1-0-pro-250528\n' +
+    '  doubao-seedance-1-0-lite-t2v-250428\n' +
+    '  doubao-seedance-1-0-lite-i2v-250428\n\n' +
+    'Examples:\n' +
+    '  touka aigc image "a cat on a laptop"\n' +
+    '  touka aigc image "sunset" --size 768x1024 --model doubao-seedream-4-5-251128 -n 2\n' +
+    '  touka aigc video "city night timelapse" --duration 10\n' +
+    '  touka aigc video "dancing character" --image https://example.com/ref.jpg\n' +
+    '  touka aigc status task_abc123', 0, t);
+
+  const sa = args.slice(1);
+  if (sub === 'image') {
+    const prompt = positional(sa).join(' ');
+    if (!prompt) out('[error] Missing <prompt>\n  Usage: touka aigc image <prompt> [--model m] [--size WxH] [-n count]\n  Example: touka aigc image "a futuristic city"', 1, t);
+    const model = flag(sa, null, '--model') || 'doubao-seedream-5-0-260128';
+    const size = flag(sa, null, '--size') || null;
+    const n = parseInt(flag(sa, '-n', null) || '1');
+    const neg = flag(sa, null, '--negative') || null;
+    console.log(`Generating ${n} image(s) with ${model}${size ? ` (${size})` : ''}...`);
+    const body = { model, prompt, n };
+    if (size) body.size = size;
+    if (neg) body.negative_prompt = neg;
+    const d = await api('POST', '/aigc/images/generations', { body });
+    // Response could be async task or direct result
+    if (d.task_id) {
+      out(`Task submitted: ${d.task_id}\nModel: ${model}\nCheck: touka aigc status ${d.task_id}`, 0, t);
+    } else {
+      const urls = (d?.data||[]).map((x,i) => `  [${i+1}] ${x.url || '(processing)'}`);
+      out(`Image(s):\n${urls.join('\n')||'  (check task status)'}`, 0, t);
+    }
+  }
+
+  if (sub === 'video') {
+    const prompt = positional(sa).join(' ');
+    if (!prompt) out('[error] Missing <prompt>\n  Usage: touka aigc video <prompt> [--model m] [--image url] [--duration s]\n  Example: touka aigc video "ocean waves"', 1, t);
+    const model = flag(sa, null, '--model') || 'doubao-seedance-1-5-pro-251215';
+    const imageUrl = flag(sa, null, '--image') || null;
+    const duration = flag(sa, null, '--duration') || null;
+    const ratio = flag(sa, null, '--ratio') || null;
+    const neg = flag(sa, null, '--negative') || null;
+    console.log(`Submitting video (${model})${imageUrl ? ' with reference image' : ''}...`);
+    const body = { model, prompt };
+    if (imageUrl) body.images = [{ url: imageUrl }];
+    if (duration) body.duration_seconds = parseInt(duration);
+    if (ratio) body.aspect_ratio = ratio;
+    if (neg) body.negative_prompt = neg;
+    const d = await api('POST', '/aigc/videos/generations', { body });
+    const tid = d?.task_id || 'unknown';
+    out(`Task: ${tid}\nModel: ${model}\nCheck: touka aigc status ${tid}`, 0, t);
+  }
+
+  if (sub === 'status') {
+    const tid = sa[0]; if (!tid) out('[error] Missing <task_id>\n  Usage: touka aigc status <task_id>', 1, t);
+    const d = await api('GET', `/aigc/tasks/${tid}`);
+    const lines = [`Task: ${d.task_id||tid}`, `Status: ${d.status||'unknown'}`, `Progress: ${d.progress_percent||0}%`];
+    if (d.prompt) lines.push(`Prompt: ${d.prompt}`);
+    if (d.status_message) lines.push(`Message: ${d.status_message}`);
+    if (d.preview_url) lines.push(`Preview: ${d.preview_url}`);
+    if (d.output_assets?.length) d.output_assets.forEach((a,i) => lines.push(`Output[${i}]: ${a.url||'(pending)'}`));
+    if (d.error_message) lines.push(`Error: ${d.error_message}`);
+    out(lines.join('\n'), 0, t);
+  }
+}
+
+// ════════════════════════════════════════════
+// LLM (chat, models)
+// ════════════════════════════════════════════
+async function cmdLlm(args) {
+  const t = Date.now(), sub = args[0];
+  if (!sub || hasHelp([sub])) out(
+    'Usage: touka llm <command> [args] [flags]\n\nChat with large language models.\n\n' +
+    'Commands:\n  chat <message>     Send a message\n  models             List available models\n\n' +
+    'Chat flags:\n' +
+    '  --model <model>    Model (default: doubao-1-5-pro-32k-250115)\n' +
+    '  --system <prompt>  System prompt\n' +
+    '  --max-tokens <n>   Max tokens (default: 2048)\n' +
+    '  --temperature <t>  0-2 (default: 0.7)\n\n' +
+    'Options:\n  -h, --help\n\n' +
+    'Available models:\n' +
+    '  doubao-1-5-pro-32k-250115    (default)\n' +
+    '  doubao-1-5-lite-32k-250115\n' +
+    '  deepseek-v3-250324\n' +
+    '  deepseek-r1-250528\n' +
+    '  kimi-k2-250905\n' +
+    '  glm-4-5-air\n' +
+    '  qwen3-235b-a22b\n\n' +
+    'Examples:\n' +
+    '  touka llm chat "What is machine learning?"\n' +
+    '  touka llm chat "翻译成英文：你好" --model deepseek-v3-250324\n' +
+    '  touka llm chat "Write a poem" --system "You are a poet" --temperature 1.2', 0, t);
+
+  const sa = args.slice(1);
+  if (sub === 'chat') {
+    const msg = positional(sa).join(' ');
+    if (!msg) out('[error] Missing <message>\n  Usage: touka llm chat <message> [--model m] [--system s]', 1, t);
+    const model = flag(sa, null, '--model') || 'doubao-1-5-pro-32k-250115';
+    const sys = flag(sa, null, '--system') || '';
+    const maxT = parseInt(flag(sa, null, '--max-tokens') || '2048');
+    const temp = parseFloat(flag(sa, null, '--temperature') || '0.7');
+    const messages = []; if (sys) messages.push({ role: 'system', content: sys });
+    messages.push({ role: 'user', content: msg });
+    console.log(`[${model}] Thinking...`);
+    const d = await api('POST', '/llm/chat/completions', { body: { model, messages, max_tokens: maxT, temperature: temp } });
+    const reply = d?.choices?.[0]?.message?.content || '(no response)';
+    const u = d?.usage;
+    let r = reply;
+    if (u) r += `\n\n── ${u.prompt_tokens||0} in + ${u.completion_tokens||0} out = ${u.total_tokens||0} tokens ──`;
+    out(r, 0, t);
+  }
+  if (sub === 'models') {
+    out('Available LLM models:\n' +
+      '  doubao-1-5-pro-32k-250115    (recommended)\n' +
+      '  doubao-1-5-lite-32k-250115   (fast)\n' +
+      '  deepseek-v3-250324           (strong reasoning)\n' +
+      '  deepseek-r1-250528           (deepseek latest)\n' +
+      '  kimi-k2-250905               (kimi)\n' +
+      '  glm-4-5-air                  (zhipu)\n' +
+      '  qwen3-235b-a22b              (alibaba)', 0, t);
+  }
+}
+
+// ════════════════════════════════════════════
+// ASR (speech-to-text)
+// ════════════════════════════════════════════
+async function cmdAsr(args) {
+  const t = Date.now(), sub = args[0];
+  if (!sub || hasHelp([sub])) out(
+    'Usage: touka asr <command> [args] [flags]\n\nSpeech-to-text — transcribe audio.\n\n' +
+    'Commands:\n  transcribe <url>   Transcribe audio from URL\n  query <task_id>    Query transcription result\n\n' +
+    'Transcribe flags:\n' +
+    '  --model <model>      ASR model (default: byteplus-asr)\n' +
+    '  --language <lang>    zh-CN (default), en-US\n' +
+    '  --format <fmt>       mp3, wav, ogg, mp4\n' +
+    '  --speaker            Enable speaker detection\n\n' +
+    'Options:\n  -h, --help\n\n' +
+    'Note: Audio must be a publicly accessible URL.\n' +
+    '      For local files, upload to S3/OSS first.\n\n' +
+    'Examples:\n' +
+    '  touka asr transcribe https://example.com/audio.mp3\n' +
+    '  touka asr transcribe https://example.com/en.wav --language en-US\n' +
+    '  touka asr query task_abc123', 0, t);
+
+  const sa = args.slice(1);
+  if (sub === 'transcribe') {
+    const url = sa[0]; if (!url || url.startsWith('-')) out('[error] Missing <url>\n  Usage: touka asr transcribe <audio_url> [--language lang]\n  Note: Audio must be a publicly accessible URL.', 1, t);
+    const model = flag(sa, null, '--model') || 'byteplus-asr';
+    const lang = flag(sa, null, '--language') || 'zh-CN';
+    const fmt = flag(sa, null, '--format') || null;
+    const speaker = sa.includes('--speaker');
+    console.log(`Transcribing (${model}, ${lang})...`);
+    const body = { model, audio_url: url, language: lang, enable_punc: true, enable_itn: true };
+    if (fmt) body.audio_format = fmt;
+    if (speaker) body.enable_speaker_info = true;
+    const d = await api('POST', '/asr/recognize', { body });
+    if (d.task_id) out(`Task submitted: ${d.task_id}\nQuery: touka asr query ${d.task_id}`, 0, t);
+    else out(`Result:\n${d.text || JSON.stringify(d, null, 2)}`, 0, t);
+  }
+  if (sub === 'query') {
+    const tid = sa[0]; if (!tid) out('[error] Missing <task_id>\n  Usage: touka asr query <task_id>', 1, t);
+    const d = await api('POST', '/asr/query', { body: { task_id: tid } });
+    const lines = [`Task: ${tid}`, `Status: ${d.status||'unknown'}`];
+    if (d.text) lines.push(`\nTranscription:\n${d.text}`);
+    if (d.segments?.length) lines.push(`\nSegments: ${d.segments.length}`);
+    out(lines.join('\n'), 0, t);
+  }
+}
+
+// ════════════════════════════════════════════
+// TTS (text-to-speech)
+// ════════════════════════════════════════════
+async function cmdTts(args) {
+  const t = Date.now(), sub = args[0];
+  if (!sub || hasHelp([sub])) out(
+    'Usage: touka tts <command> [args] [flags]\n\nText-to-speech — synthesize audio from text.\n\n' +
+    'Commands:\n  speak <text>       Synthesize speech\n  voices             List available voices\n  query <task_id>    Query synthesis result\n  download <task_id> Download audio file\n\n' +
+    'Speak flags:\n' +
+    '  --model <model>    TTS model (default: byteplus-tts)\n' +
+    '  --voice <voice>    Voice ID (required)\n' +
+    '  --format <fmt>     mp3 (default), wav, pcm\n' +
+    '  --sample-rate <n>  8000, 16000, 24000 (default)\n\n' +
+    'Options:\n  -h, --help\n\n' +
+    'Examples:\n' +
+    '  touka tts voices\n' +
+    '  touka tts speak "你好世界" --voice zh_female_shuangkuaisisi_moon_bigtts\n' +
+    '  touka tts speak "Hello world" --voice en_male_adam_bigtts --format wav\n' +
+    '  touka tts query task_abc123\n' +
+    '  touka tts download task_abc123', 0, t);
+
+  const sa = args.slice(1);
+  if (sub === 'speak') {
+    const text = positional(sa).join(' ');
+    if (!text) out('[error] Missing <text>\n  Usage: touka tts speak <text> --voice <voice_id>\n  List voices: touka tts voices', 1, t);
+    const voice = flag(sa, null, '--voice');
+    if (!voice) out('[error] Missing --voice\n  Usage: touka tts speak <text> --voice <voice_id>\n  List voices: touka tts voices', 1, t);
+    const model = flag(sa, null, '--model') || 'byteplus-tts';
+    const fmt = flag(sa, null, '--format') || 'mp3';
+    const sr = parseInt(flag(sa, null, '--sample-rate') || '24000');
+    console.log(`Synthesizing (${model}, voice=${voice})...`);
+    const d = await api('POST', '/tts/synthesize', { body: { model, text, voice, audio_format: fmt, sample_rate: sr } });
+    if (d.task_id) out(`Task: ${d.task_id}\nStatus: ${d.status||'processing'}\nQuery: touka tts query ${d.task_id}\nDownload: touka tts download ${d.task_id}`, 0, t);
+    else out(`Result: ${JSON.stringify(d)}`, 0, t);
+  }
+  if (sub === 'voices') {
+    console.log('Fetching voices...');
+    try {
+      const d = await api('GET', '/tts/voices');
+      const voices = d?.voices || d?.data || d || [];
+      if (Array.isArray(voices) && voices.length) {
+        const t2 = tbl(voices.slice(0, 30), [
+          {l:'VOICE_ID',f:r=>r.voice_id||r.id||''}, {l:'NAME',f:r=>r.name||r.voice_name||''},
+          {l:'LANG',f:r=>r.language||''}, {l:'GENDER',f:r=>r.gender||''},
+        ]);
+        out(t2, 0, t);
+      } else out(`Voices: ${JSON.stringify(voices).slice(0,500)}`, 0, t);
+    } catch (e) { out(`Failed to list voices: ${e.message}\n  Common voices: zh_female_shuangkuaisisi_moon_bigtts`, 0, t); }
+  }
+  if (sub === 'query') {
+    const tid = sa[0]; if (!tid) out('[error] Missing <task_id>', 1, t);
+    const model = flag(sa, null, '--model') || 'byteplus-tts';
+    const d = await api('POST', '/tts/query', { body: { task_id: tid, model } });
+    out(`Task: ${tid}\nStatus: ${d.status||'unknown'}\n${d.status==='completed'?`Download: touka tts download ${tid}`:''}`, 0, t);
+  }
+  if (sub === 'download') {
+    const tid = sa[0]; if (!tid) out('[error] Missing <task_id>', 1, t);
+    const model = flag(sa, null, '--model') || 'byteplus-tts';
+    console.log(`Downloading audio for ${tid}...`);
+    const resp = await api('GET', `/tts/result/${tid}?model=${encodeURIComponent(model)}`, { stream: true });
+    if (!resp.ok) { const e = await resp.json().catch(()=>({})); throw new Error(e?.message||`HTTP ${resp.status}`); }
+    const buf = Buffer.from(await resp.arrayBuffer());
+    const outFile = `${tid}.mp3`;
+    writeFileSync(outFile, buf);
+    out(`Saved: ${outFile} (${(buf.length/1024).toFixed(1)}KB)`, 0, t);
+  }
+}
+
+// ════════════════════════════════════════════
+// Main
+// ════════════════════════════════════════════
+async function main() {
+  const t = Date.now(), args = process.argv.slice(2), cmd = args[0];
+  if (!cmd || cmd==='-h' || cmd==='--help') out(
+    `Touka CLI v${VERSION} — AI Gateway Client\n\n` +
+    'Usage: touka <command> [args] [flags]\n\n' +
+    'Commands:\n' +
+    '  skill     Search, install, publish AI agent skills\n' +
+    '  llm       Chat with language models (doubao, deepseek, kimi, qwen...)\n' +
+    '  aigc      Generate images (seedream) and videos (seedance)\n' +
+    '  asr       Speech-to-text (transcribe audio)\n' +
+    '  tts       Text-to-speech (synthesize audio)\n' +
+    '  config    Configure endpoint and credentials\n' +
+    '  update    Update touka to the latest version\n' +
+    '  version   Show version\n\n' +
+    'Options:\n  -h, --help    Show help (works on any command)\n\n' +
+    'Get started:\n  touka config set --endpoint https://your-gateway.com --api-key YOUR_KEY\n\n' +
+    'Examples:\n' +
+    '  touka skill search "code review"\n' +
+    '  touka llm chat "Hello!"\n' +
+    '  touka aigc image "a cat" --size 512x512\n' +
+    '  touka aigc video "ocean waves" --image https://example.com/ref.jpg\n' +
+    '  touka asr transcribe https://example.com/audio.wav\n' +
+    '  touka tts speak "你好" --voice zh_female_shuangkuaisisi_moon_bigtts\n\n' +
+    `Node.js >= 18 required. Current: ${process.version}`, 0, t);
+
+  if (cmd==='version'||cmd==='--version'||cmd==='-v') out(`touka v${VERSION}`, 0, t);
+
+  if (cmd==='update'||cmd==='self-update') {
+    console.log('Checking for updates...');
+    try {
+      const resp = await fetch(`https://registry.npmjs.org/${PKG_NAME}/latest`, { signal: AbortSignal.timeout(10000) });
+      if (!resp.ok) throw new Error(`npm registry: HTTP ${resp.status}`);
+      const d = await resp.json();
+      if (d.version === VERSION) out(`Already on latest: v${VERSION}`, 0, t);
+      console.log(`Updating: v${VERSION} → v${d.version}...`);
+      const { execSync } = await import('child_process');
+      execSync(`npm install -g ${PKG_NAME}@latest`, { stdio: 'inherit' });
+      // Clear update check cache
+      try { unlinkSync(UPDATE_CHECK_FILE); } catch {}
+      out(`Updated to v${d.version}`, 0, t);
+    } catch (e) { fail(`Update failed: ${e.message}\n  Manual: npm install -g ${PKG_NAME}@latest`, t); }
+  }
+
+  // Background update check (non-blocking)
+  checkForUpdate();
+
+  try {
+    if (cmd==='config') await cmdConfig(args.slice(1));
+    else if (cmd==='skill') await cmdSkill(args.slice(1));
+    else if (cmd==='aigc') await cmdAigc(args.slice(1));
+    else if (cmd==='llm') await cmdLlm(args.slice(1));
+    else if (cmd==='asr') await cmdAsr(args.slice(1));
+    else if (cmd==='tts') await cmdTts(args.slice(1));
+    else fail(`Unknown command: ${cmd}\n  Available: skill, llm, aigc, asr, tts, config, update, version\n  Run: touka -h`, t);
+  } catch (e) { fail(e, t); }
+}
+
+main();