zelai-cli 1.1.0 → 1.2.0

package/bin/zelai.js

@@ -5,16 +5,37 @@
  */
 'use strict';
 
-require('../src/cli').main(process.argv.slice(2)).catch((err) => {
-  // Last-resort error handler so uncaught failures don't leak a stack trace.
-  const chalk = (() => {
-    try { return require('chalk'); } catch { return null; }
-  })();
-  const tag = chalk ? chalk.red.bold('✖ fatal') : '✖ fatal';
-  const msg = err && err.message ? err.message : String(err);
+// Track interactive mode — kalau true, error apapun jangan exit, cukup print.
+global.__ZELAI_INTERACTIVE__ = false;
+
+function safeStringify(err) {
+  if (!err) return 'unknown error';
+  if (err.message) return err.message;
+  try { return JSON.stringify(err); } catch { return String(err); }
+}
+
+function logErr(label, err) {
+  let chalk;
+  try { chalk = require('chalk'); } catch {}
+  const tag = chalk ? chalk.red.bold('✖ ' + label) : '✖ ' + label;
+  const msg = safeStringify(err);
   process.stderr.write(`${tag} ${msg}\n`);
   if (process.env.ZELAI_DEBUG && err && err.stack) {
     process.stderr.write(err.stack + '\n');
   }
-  process.exit(1);
+}
+
+process.on('uncaughtException', (err) => {
+  logErr('uncaught', err);
+  if (!global.__ZELAI_INTERACTIVE__) process.exit(1);
+});
+
+process.on('unhandledRejection', (err) => {
+  logErr('rejection', err);
+  if (!global.__ZELAI_INTERACTIVE__) process.exit(1);
+});
+
+require('../src/cli').main(process.argv.slice(2)).catch((err) => {
+  logErr('fatal', err);
+  if (!global.__ZELAI_INTERACTIVE__) process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zelai-cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Zelai — official CLI & SDK for the Zelapi Agent API. Chat with AI right from your terminal, Discord, or Telegram. Multi-turn sessions, slash commands, limit warnings, and a built-in Discord/Telegram connector.",
   "keywords": [
     "zelai",

package/src/cli.js

@@ -11,6 +11,8 @@ const config = require('./config');
 const { makeClient, LimitExceededError } = require('./client');
 const commands = require('./commands');
 const session = require('./session');
+const themeMod = require('./theme');
+const versionMod = require('./version');
 const ui = require('./ui');
 
 const VERSION = require('../package.json').version;
@@ -105,6 +107,9 @@ async function main(argv) {
   if (args.flags.endpoint) cfg.endpoint = args.flags.endpoint;
   if (args.flags.system) cfg.system = args.flags.system;
 
+  // Apply theme yang udah dipilih user (atau default 'dark').
+  themeMod.setTheme(cfg.theme || 'dark');
+
   const sub = args._[0];
 
   if (sub === 'login') {
@@ -184,12 +189,18 @@ async function main(argv) {
     return;
   }
 
-  // Kalau belum punya API key — jalanin login interaktif dulu.
+  // Kalau belum punya API key — jalanin login interaktif dulu, terus theme picker.
+  const isFirstLogin = !cfg.apiKey;
   if (!cfg.apiKey) {
     if (!args.flags.noBanner) console.log(ui.banner());
     console.log(`${ui.systemTag()} kayaknya kamu belum login. Yuk masukin API key dulu.`);
     await runLogin(cfg, null);
     cfg = config.load();
+    if (cfg.apiKey) {
+      await pickThemeInteractive();
+      cfg = config.load();
+      themeMod.setTheme(cfg.theme || 'dark');
+    }
   }
 
   // One-shot mode lewat -p.
@@ -227,7 +238,64 @@ async function runOneShot(fn) {
     await fn();
   } catch (err) {
     handleError(err);
-    process.exit(1);
+    if (!global.__ZELAI_INTERACTIVE__) process.exit(1);
+  }
+}
+
+/**
+ * Tanya user mau theme apa setelah login pertama.
+ * Pilihan: dark (default), night.
+ */
+async function pickThemeInteractive() {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    console.log('');
+    console.log('  ' + ui.chalk.bold('🎨 Pilih warna terminal:'));
+    const themes = themeMod.list();
+    themes.forEach((name, i) => {
+      const lbl = themeMod.describe(name);
+      console.log('  ' + ui.chalk.yellow(`${i + 1}.`) + ' ' + ui.chalk.cyan.bold(name.padEnd(8)) + ui.chalk.gray('— ' + lbl));
+    });
+    const ans = await askMasked(rl, `  ${ui.systemTag()} pilih [${themes.join('/')}] (default: dark): `);
+    const choice = (ans || '').trim().toLowerCase();
+    let pick = 'dark';
+    if (themes.includes(choice)) pick = choice;
+    else if (/^\d+$/.test(choice)) {
+      const idx = parseInt(choice, 10) - 1;
+      if (themes[idx]) pick = themes[idx];
+    }
+    themeMod.setTheme(pick);
+    config.update({ theme: pick });
+    console.log(`  ${ui.okTag()} theme ${ui.chalk.cyan(pick)} ${ui.chalk.gray('— ' + themeMod.describe(pick))}`);
+    console.log('');
+  } finally {
+    rl.close();
+  }
+}
+
+/**
+ * Cek versi terbaru dari npm registry (best-effort, async + cached 24h).
+ * Kalau current behind → print warning vulnerable.
+ */
+async function checkVersionWarning() {
+  const cur = VERSION;
+  const cfg = config.load();
+  const DAY = 24 * 60 * 60 * 1000;
+  let latest = cfg.latestKnownVersion;
+  const stale = !cfg.lastVersionCheck || (Date.now() - cfg.lastVersionCheck) > DAY;
+  if (stale) {
+    try {
+      const fetched = await versionMod.getLatest(3000);
+      if (fetched) {
+        latest = fetched;
+        config.update({ latestKnownVersion: fetched, lastVersionCheck: Date.now() });
+      }
+    } catch {
+      // ignored
+    }
+  }
+  if (latest && versionMod.isBehind(cur, latest)) {
+    console.log(ui.vulnerableWarning(cur, latest));
   }
 }
 
@@ -323,10 +391,16 @@ async function runPrompt(cfg, client, prompt, sessionId) {
 }
 
 async function runInteractive(cfg, args) {
+  // Mark interactive mode so global error guards in bin/zelai.js gak ngebunuh process.
+  global.__ZELAI_INTERACTIVE__ = true;
+
   if (!args.flags.noBanner) {
     console.log(ui.banner());
   }
 
+  // Version check warning (vulnerable kalo behind) — async, non-blocking.
+  checkVersionWarning().catch(() => {});
+
   const client = makeClient(cfg);
   const ctx = {
     config: cfg,
@@ -334,6 +408,7 @@ async function runInteractive(cfg, args) {
     history: [],
     sessionId: args.flags.session || cfg.lastSession || null,
     rl: null,
+    connectors: {},
   };
 
   // Auto-reload history dari file sesi sebelumnya kalau ada.
@@ -364,7 +439,10 @@ async function runInteractive(cfg, args) {
   };
 
   const promptFn = () => {
-    rl.setPrompt(ui.userPrompt(ctx.config.model));
+    const modelLabel = ctx.config.modelDisabled ? 'auto' : ctx.config.model;
+    // Chat box: tulis baris atas dulu, terus prompt
+    console.log(ui.userBoxOpen(modelLabel, { model: modelLabel }));
+    rl.setPrompt(ui.userPrompt(modelLabel, { disabledHint: ctx.config.modelDisabled || ctx.config.systemDisabled }));
     rl.prompt();
   };
 
@@ -387,6 +465,7 @@ async function runInteractive(cfg, args) {
       return;
     }
 
+    // SEMUA branch wrapped — REPL never exit on error.
     if (line.startsWith('/')) {
       try {
         const handled = await commands.dispatch(ctx, line, helpers);
@@ -427,15 +506,17 @@ async function handleChat(ctx, content) {
   try {
     res = await ctx.client.sendAgent({
       messages,
-      model: ctx.config.model,
+      // Kalau di-disable, kirim null biar payload gak include field-nya.
+      model: ctx.config.modelDisabled ? null : ctx.config.model,
       endpoint: ctx.config.endpoint,
-      system: ctx.config.system,
+      system: ctx.config.systemDisabled ? null : ctx.config.system,
       sessionId: ctx.sessionId,
     });
   } catch (err) {
     spinner.stop();
     ctx.history.pop();
-    throw err;
+    handleError(err);
+    return; // INTERACTIVE: gak exit, balik ke prompt
   }
   spinner.stop();
 
@@ -450,15 +531,18 @@ async function handleChat(ctx, content) {
   }
   ctx.sessionId = newId;
   session.append(newId, { role: 'user', content }, {
-    model: ctx.config.model,
+    model: ctx.config.modelDisabled ? null : ctx.config.model,
     endpoint: ctx.config.endpoint,
-    system: ctx.config.system,
+    system: ctx.config.systemDisabled ? null : ctx.config.system,
   });
   session.append(newId, { role: 'assistant', content: reply });
   config.update({ lastSession: newId });
 
-  console.log(`${ui.assistantTag(ctx.config.model)}`);
-  console.log(ui.renderMarkdown(reply));
+  // Render assistant bubble.
+  const modelLabel = ctx.config.modelDisabled ? 'auto' : ctx.config.model;
+  console.log(ui.assistantBoxOpen(modelLabel));
+  console.log(ui.gutterIndent(ui.renderMarkdown(reply)));
+  console.log(ui.assistantBoxClose());
 }
 
 async function warnQuotaSoft(client, apiKey) {

package/src/client.js

@@ -90,6 +90,7 @@ function makeClient(config) {
       endpoint: endpoint || '/ai/claila',
       messages: msgs,
     };
+    // model & system di-omit dari payload kalau null/empty (lihat /model:disable, /system:disable).
     if (model) payload.model = model;
     if (system) payload.system = system;
 

package/src/commands.js

@@ -1,6 +1,14 @@
 /**
  * Slash command registry.
- * Setiap handler dipanggil dengan (ctx, args, helpers) — ctx = session state dari cli.js.
+ *
+ * Parser support 2 syntax:
+ *   /cmd arg1 arg2        — normal
+ *   /cmd:arg1 arg2 arg3   — colon-form (e.g. /system:disable, /telegram:<token> <chatid>)
+ *
+ * Setiap handler dipanggil dengan (ctx, args, helpers).
+ *   ctx     : session state dari cli.js (config, history, sessionId, client, rl, …)
+ *   args    : string sisa setelah nama command
+ *   helpers : { ask, …, spawnTelegram, spawnDiscord }
  */
 'use strict';
 
@@ -8,27 +16,38 @@ const ora = require('ora');
 const ui = require('./ui');
 const config = require('./config');
 const session = require('./session');
+const versionMod = require('./version');
+const themeMod = require('./theme');
 const { LimitExceededError } = require('./client');
 
 const HELP_ROWS = [
-  ['/help',     'tampilin daftar command'],
-  ['/status',   'cek status server (/api/status)'],
-  ['/activity', 'tampilin activity logs akun kamu'],
-  ['/usage',    'tampilin pemakaian / kuota API key'],
-  ['/model',    'ganti model — opus | sonnet | haiku'],
-  ['/endpoint', 'ganti AI endpoint, mis: /ai/claila, /ai/spawn'],
-  ['/system',   'set system prompt; kosong → tampilin current'],
-  ['/new',      'mulai sesi baru (lupain history)'],
-  ['/session',  'tampilin / set session ID secara manual'],
-  ['/sessions', 'list semua sesi di folder ./session'],
-  ['/load',     'load sesi tersimpan: /load <id|nomor>'],
-  ['/forget',   'hapus sesi tersimpan: /forget <id|nomor|all>'],
-  ['/save',     'paksa simpan sesi sekarang ke ./session'],
-  ['/login',    'set / ganti API key (zel_…)'],
-  ['/logout',   'hapus API key tersimpan'],
-  ['/config',   'tampilin lokasi & isi config'],
-  ['/clear',    'bersihin layar'],
-  ['/exit',     'keluar (alias: /quit, /q)'],
+  ['/help',            'tampilin daftar command'],
+  ['/status',          'cek status server (/api/status)'],
+  ['/activity',        'tampilin activity logs akun kamu'],
+  ['/usage',           'tampilin pemakaian / kuota API key'],
+  ['/model',           'ganti model: /model opus|sonnet|haiku'],
+  ['/model:disable',   'matikan model di payload (server default)'],
+  ['/model:enable',    'nyalain lagi model di payload'],
+  ['/endpoint',        'ganti AI endpoint, mis: /ai/claila, /ai/spawn'],
+  ['/system',          'set system prompt; kosong → tampilin current'],
+  ['/system:disable',  'matikan system prompt di payload'],
+  ['/system:enable',   'nyalain lagi system prompt di payload'],
+  ['/theme',           'ganti tema: /theme dark|night'],
+  ['/new',             'mulai sesi baru (lupain history)'],
+  ['/session',         'tampilin / set session ID secara manual'],
+  ['/sessions',        'list semua sesi di folder ./session'],
+  ['/load',            'load sesi tersimpan: /load <id|nomor>'],
+  ['/forget',          'hapus sesi tersimpan: /forget <id|nomor|all>'],
+  ['/save',            'paksa simpan sesi sekarang ke ./session'],
+  ['/telegram:<token>','konek bot Telegram: /telegram:<TOKEN> [chatid]'],
+  ['/discord:<token>', 'konek bot Discord: /discord:<TOKEN>'],
+  ['/disconnect',      'matiin semua connector aktif'],
+  ['/update',          'update zelai-cli ke versi terbaru lewat npm'],
+  ['/login',           'set / ganti API key (zel_…)'],
+  ['/logout',          'hapus API key tersimpan'],
+  ['/config',          'tampilin lokasi & isi config'],
+  ['/clear',           'bersihin layar'],
+  ['/exit',            'keluar (alias: /quit, /q)'],
 ];
 
 async function cmdHelp() {
@@ -36,7 +55,7 @@ async function cmdHelp() {
   console.log(ui.chalk.bold('Slash Commands'));
   console.log('');
   for (const [k, v] of HELP_ROWS) {
-    console.log('  ' + ui.chalk.yellow(k.padEnd(11)) + ui.chalk.gray('· ') + ui.chalk.white(v));
+    console.log('  ' + ui.chalk.yellow(k.padEnd(20)) + ui.chalk.gray('· ') + ui.chalk.white(v));
   }
   console.log('');
   console.log(ui.chalk.gray('  Tip: ketik biasa tanpa "/" buat ngobrol sama AI.'));
@@ -49,14 +68,14 @@ async function cmdStatus(ctx) {
     const data = await ctx.client.getStatus();
     spinner.stop();
     console.log(ui.hr());
-    console.log(ui.chalk.bold('Server Status') + ui.chalk.gray('  ·  ') + ui.chalk.cyan.underline('https://zelapioffciall.dpdns.org/api/status'));
+    console.log(ui.chalk.bold('Server Status') + ui.chalk.gray('  ·  ') + ui.theme.current().link('https://zelapioffciall.dpdns.org/api/status'));
     console.log('');
     if (typeof data === 'object' && data !== null) {
-      const known = ['status', 'state', 'health', 'uptime', 'version', 'region', 'latency', 'node', 'env'];
+      const known = ['status', 'state', 'health', 'uptime', 'version', 'region', 'latency', 'node', 'env', 'runtime'];
       const root = data.data && typeof data.data === 'object' ? data.data : data;
       let printed = 0;
       for (const k of known) {
-        if (root[k] !== undefined) {
+        if (root[k] !== undefined && typeof root[k] !== 'object') {
           const v = root[k];
           const value = (k === 'status' || k === 'state' || k === 'health')
             ? (/ok|up|online|healthy|stable/i.test(String(v)) ? ui.chalk.green.bold(String(v)) : ui.chalk.yellow(String(v)))
@@ -65,13 +84,18 @@ async function cmdStatus(ctx) {
           printed++;
         }
       }
-      if (printed === 0) {
-        console.log(ui.chalk.gray(ui.pretty(data)));
-      } else {
+      if (Array.isArray(root.targets) || Array.isArray(data.targets)) {
+        const targets = root.targets || data.targets;
         console.log('');
-        console.log(ui.chalk.gray('  raw:'));
-        console.log(ui.chalk.gray(indent(ui.pretty(data), 2)));
+        console.log('  ' + ui.chalk.bold('targets:'));
+        for (const t of targets) {
+          const dot = t.online ? ui.chalk.green('●') : ui.chalk.red('●');
+          console.log('  ' + dot + ' ' + ui.chalk.white((t.name || t.id || '').padEnd(20)) +
+            ui.chalk.gray(' · ping ') + ui.chalk.cyan(String(t.ping ?? '—') + 'ms'));
+        }
+        printed++;
       }
+      if (printed === 0) console.log(ui.chalk.gray(ui.pretty(data)));
     } else {
       console.log(String(data));
     }
@@ -155,15 +179,26 @@ function maybeShowQuotaBar(flat) {
 
 async function cmdModel(ctx, args) {
   const next = (args || '').trim().toLowerCase();
+  if (next === 'disable') {
+    ctx.config = config.update({ modelDisabled: true });
+    console.log(`${ui.okTag()} model param dimatikan — payload bakal di-kirim tanpa field model.`);
+    return;
+  }
+  if (next === 'enable') {
+    ctx.config = config.update({ modelDisabled: false });
+    console.log(`${ui.okTag()} model param dinyalain lagi — sekarang pake ${ui.chalk.cyan(ctx.config.model)}.`);
+    return;
+  }
   if (!next) {
-    console.log(`${ui.infoTag()} model sekarang: ${ui.chalk.cyan(ctx.config.model)} ${ui.chalk.gray('— pilihan: opus, sonnet, haiku')}`);
+    const status = ctx.config.modelDisabled ? ui.chalk.gray('(disabled)') : '';
+    console.log(`${ui.infoTag()} model: ${ui.chalk.cyan(ctx.config.model)} ${status} ${ui.chalk.gray('— pilihan: opus, sonnet, haiku · /model:disable buat matiin')}`);
     return;
   }
   if (!['opus', 'sonnet', 'haiku'].includes(next)) {
     console.log(`${ui.errorTag()} model gak dikenal. Pilih: opus | sonnet | haiku`);
     return;
   }
-  ctx.config = config.update({ model: next });
+  ctx.config = config.update({ model: next, modelDisabled: false });
   console.log(`${ui.okTag()} model diganti ke ${ui.chalk.cyan(next)}`);
 }
 
@@ -183,15 +218,41 @@ async function cmdEndpoint(ctx, args) {
 
 async function cmdSystem(ctx, args) {
   const next = (args || '').trim();
+  if (next === 'disable') {
+    ctx.config = config.update({ systemDisabled: true });
+    console.log(`${ui.okTag()} system prompt dimatikan — payload bakal di-kirim tanpa field system.`);
+    return;
+  }
+  if (next === 'enable') {
+    ctx.config = config.update({ systemDisabled: false });
+    console.log(`${ui.okTag()} system prompt dinyalain lagi.`);
+    return;
+  }
   if (!next) {
-    console.log(`${ui.infoTag()} system prompt saat ini:`);
+    const status = ctx.config.systemDisabled ? ui.chalk.gray('(disabled)') : '';
+    console.log(`${ui.infoTag()} system prompt ${status}:`);
     console.log(ui.chalk.gray('  ' + (ctx.config.system || '(kosong)')));
     return;
   }
-  ctx.config = config.update({ system: next });
+  ctx.config = config.update({ system: next, systemDisabled: false });
   console.log(`${ui.okTag()} system prompt updated.`);
 }
 
+async function cmdTheme(ctx, args) {
+  const next = (args || '').trim().toLowerCase();
+  if (!next) {
+    const cur = themeMod.current().name;
+    console.log(`${ui.infoTag()} theme sekarang: ${ui.chalk.cyan(cur)} ${ui.chalk.gray('— pilihan: ' + themeMod.list().join(', '))}`);
+    return;
+  }
+  if (!themeMod.setTheme(next)) {
+    console.log(`${ui.errorTag()} theme "${next}" gak dikenal. Pilih: ${themeMod.list().join(' | ')}`);
+    return;
+  }
+  ctx.config = config.update({ theme: next });
+  console.log(`${ui.okTag()} theme diganti ke ${ui.chalk.cyan(next)} ${ui.chalk.gray('— ' + themeMod.describe(next))}`);
+}
+
 async function cmdNew(ctx) {
   ctx.history = [];
   ctx.sessionId = null;
@@ -249,7 +310,6 @@ function resolveSessionRef(ctx, ref) {
   if (!ref) return null;
   const trimmed = ref.trim();
   if (!trimmed) return null;
-  // Number → from last listing
   if (/^\d+$/.test(trimmed)) {
     const idx = parseInt(trimmed, 10) - 1;
     const rows = ctx._lastSessionsList || session.list();
@@ -357,11 +417,12 @@ async function cmdConfig(ctx) {
   console.log(ui.kv('path', config.configPath()));
   console.log(ui.kv('sessionDir', session.sessionDir()));
   console.log(ui.kv('apiKey', ctx.config.apiKey ? maskKey(ctx.config.apiKey) : '(belum di-set)'));
-  console.log(ui.kv('model', ctx.config.model));
+  console.log(ui.kv('theme', ctx.config.theme || 'dark'));
+  console.log(ui.kv('model', ctx.config.modelDisabled ? '(disabled)' : ctx.config.model));
   console.log(ui.kv('endpoint', ctx.config.endpoint));
   console.log(ui.kv('baseUrl', ctx.config.baseUrl));
   console.log(ui.kv('session', ctx.sessionId || '(belum ada)'));
-  console.log(ui.kv('system', truncate(ctx.config.system || '', 60)));
+  console.log(ui.kv('system', ctx.config.systemDisabled ? '(disabled)' : truncate(ctx.config.system || '', 60)));
   console.log(ui.hr());
 }
 
@@ -371,10 +432,154 @@ async function cmdClear() {
 
 async function cmdExit(ctx) {
   console.log(`${ui.infoTag()} bye! 👋`);
+  if (ctx.connectors) {
+    for (const c of Object.values(ctx.connectors)) {
+      try { c.child && c.child.kill(); } catch {}
+    }
+  }
   if (ctx.rl) ctx.rl.close();
   process.exit(0);
 }
 
+/* ----- /update ----- */
+
+async function cmdUpdate(ctx) {
+  console.log(`${ui.infoTag()} ngecek versi terbaru di npm…`);
+  const latest = await versionMod.getLatest();
+  const cur = require('../package.json').version;
+  if (!latest) {
+    console.log(`${ui.warnTag()} gak bisa ngambil versi terbaru — coba cek koneksi.`);
+    return;
+  }
+  if (!versionMod.isBehind(cur, latest)) {
+    console.log(`${ui.okTag()} kamu udah pakai versi terbaru: ${ui.chalk.green.bold('v' + cur)}.`);
+    return;
+  }
+  console.log(`${ui.infoTag()} update ${ui.chalk.gray('v' + cur)} → ${ui.chalk.green.bold('v' + latest)}`);
+  console.log(ui.chalk.gray('  running: npm i -g zelai-cli@latest'));
+  console.log('');
+  const result = await versionMod.runUpdate((line) => {
+    if (line) console.log(ui.chalk.gray('  ' + line));
+  });
+  console.log('');
+  if (result.ok) {
+    console.log(`${ui.okTag()} update selesai. Restart ${ui.chalk.yellow('zelai')} buat pake versi baru.`);
+  } else {
+    console.log(`${ui.errorTag()} update gagal (exit ${result.code}). Coba manual: ${ui.chalk.yellow('npm i -g zelai-cli@latest')}`);
+  }
+}
+
+/* ----- connectors (in-process spawn) ----- */
+
+async function cmdTelegram(ctx, args) {
+  // args = "<token> [chatid]" — sebelumnya colon-form udah di-flatten parser.
+  const parts = (args || '').trim().split(/\s+/).filter(Boolean);
+  const token = parts[0];
+  const chatId = parts[1];
+  if (!token || !token.includes(':')) {
+    console.log(`${ui.errorTag()} format: ${ui.chalk.yellow('/telegram:<BOT_TOKEN> [chat_id]')}`);
+    console.log(ui.chalk.gray('  contoh: /telegram:1234567:AAAA…token 987654321'));
+    return;
+  }
+  if (!ctx.config.apiKey) {
+    console.log(`${ui.errorTag()} login dulu (/login zel_…)`);
+    return;
+  }
+  if (!ctx.connectors) ctx.connectors = {};
+  if (ctx.connectors.telegram && !ctx.connectors.telegram.child.killed) {
+    console.log(`${ui.warnTag()} connector Telegram udah jalan — pakai /disconnect dulu.`);
+    return;
+  }
+
+  const { spawn } = require('child_process');
+  const path = require('path');
+  const env = {
+    ...process.env,
+    ZELAPI_KEY: ctx.config.apiKey,
+    TELEGRAM_TOKEN: token,
+    ZELAI_MODEL: ctx.config.modelDisabled ? '' : ctx.config.model,
+    ZELAI_ENDPOINT: ctx.config.endpoint,
+    ZELAI_SYSTEM: ctx.config.systemDisabled ? '' : ctx.config.system,
+  };
+  if (chatId) env.TELEGRAM_ALLOW = chatId;
+
+  const script = path.join(__dirname, '..', 'connector', 'telegram.js');
+  const child = spawn(process.execPath, [script], { env, stdio: ['ignore', 'pipe', 'pipe'] });
+  ctx.connectors.telegram = { child, token: maskKey(token), chatId };
+
+  console.log(`${ui.infoTag()} starting Telegram connector ${ui.chalk.gray('pid=' + child.pid)} ${ui.chalk.gray('token=' + maskKey(token))}${chatId ? ui.chalk.gray(' allow=' + chatId) : ''}`);
+
+  const prefix = ui.chalk.magenta('[telegram] ');
+  child.stdout.on('data', (b) => process.stdout.write(prefix + b.toString().replace(/\n(?!$)/g, '\n' + prefix)));
+  child.stderr.on('data', (b) => process.stdout.write(prefix + ui.chalk.red(b.toString()).replace(/\n(?!$)/g, '\n' + prefix)));
+  child.on('close', (code) => {
+    console.log(`${ui.infoTag()} Telegram connector exit (code ${code})`);
+    if (ctx.connectors) delete ctx.connectors.telegram;
+  });
+}
+
+async function cmdDiscord(ctx, args) {
+  const parts = (args || '').trim().split(/\s+/).filter(Boolean);
+  const token = parts[0];
+  if (!token) {
+    console.log(`${ui.errorTag()} format: ${ui.chalk.yellow('/discord:<BOT_TOKEN>')}`);
+    return;
+  }
+  if (!ctx.config.apiKey) {
+    console.log(`${ui.errorTag()} login dulu (/login zel_…)`);
+    return;
+  }
+  if (!ctx.connectors) ctx.connectors = {};
+  if (ctx.connectors.discord && !ctx.connectors.discord.child.killed) {
+    console.log(`${ui.warnTag()} connector Discord udah jalan — pakai /disconnect dulu.`);
+    return;
+  }
+
+  const { spawn } = require('child_process');
+  const path = require('path');
+  const env = {
+    ...process.env,
+    ZELAPI_KEY: ctx.config.apiKey,
+    DISCORD_TOKEN: token,
+    ZELAI_MODEL: ctx.config.modelDisabled ? '' : ctx.config.model,
+    ZELAI_ENDPOINT: ctx.config.endpoint,
+    ZELAI_SYSTEM: ctx.config.systemDisabled ? '' : ctx.config.system,
+  };
+  const script = path.join(__dirname, '..', 'connector', 'discord.js');
+  const child = spawn(process.execPath, [script], { env, stdio: ['ignore', 'pipe', 'pipe'] });
+  ctx.connectors.discord = { child, token: maskKey(token) };
+
+  console.log(`${ui.infoTag()} starting Discord connector ${ui.chalk.gray('pid=' + child.pid)} ${ui.chalk.gray('token=' + maskKey(token))}`);
+
+  const prefix = ui.chalk.cyan('[discord] ');
+  child.stdout.on('data', (b) => process.stdout.write(prefix + b.toString().replace(/\n(?!$)/g, '\n' + prefix)));
+  child.stderr.on('data', (b) => process.stdout.write(prefix + ui.chalk.red(b.toString()).replace(/\n(?!$)/g, '\n' + prefix)));
+  child.on('close', (code) => {
+    console.log(`${ui.infoTag()} Discord connector exit (code ${code})`);
+    if (ctx.connectors) delete ctx.connectors.discord;
+  });
+}
+
+async function cmdDisconnect(ctx, args) {
+  const target = (args || '').trim().toLowerCase();
+  if (!ctx.connectors || Object.keys(ctx.connectors).length === 0) {
+    console.log(`${ui.infoTag()} gak ada connector yang aktif.`);
+    return;
+  }
+  let killed = 0;
+  for (const [name, info] of Object.entries(ctx.connectors)) {
+    if (target && target !== name) continue;
+    try { info.child.kill(); killed++; } catch {}
+  }
+  if (killed === 0) {
+    console.log(`${ui.warnTag()} gak ada yang dimatiin ${target ? `(target "${target}")` : ''}.`);
+  } else {
+    console.log(`${ui.okTag()} ${killed} connector dimatiin.`);
+  }
+}
+
+/* ----- registry ----- */
+
 const REGISTRY = {
   '/help': cmdHelp,
   '/?': cmdHelp,
@@ -386,6 +591,7 @@ const REGISTRY = {
   '/model': cmdModel,
   '/endpoint': cmdEndpoint,
   '/system': cmdSystem,
+  '/theme': cmdTheme,
   '/new': cmdNew,
   '/reset': cmdNew,
   '/session': cmdSession,
@@ -394,6 +600,10 @@ const REGISTRY = {
   '/load': cmdLoad,
   '/forget': cmdForget,
   '/save': cmdSave,
+  '/telegram': cmdTelegram,
+  '/discord': cmdDiscord,
+  '/disconnect': cmdDisconnect,
+  '/update': cmdUpdate,
   '/login': cmdLogin,
   '/logout': cmdLogout,
   '/config': cmdConfig,
@@ -404,13 +614,28 @@ const REGISTRY = {
   '/q': cmdExit,
 };
 
+/**
+ * Parse a slash command.
+ *
+ *   /cmd                      → { name: '/cmd', args: '' }
+ *   /cmd foo bar              → { name: '/cmd', args: 'foo bar' }
+ *   /cmd:foo                  → { name: '/cmd', args: 'foo' }
+ *   /cmd:foo:bar              → { name: '/cmd', args: 'foo:bar' }
+ *   /cmd:foo:bar baz qux      → { name: '/cmd', args: 'foo:bar baz qux' }
+ */
 function parse(line) {
   const trimmed = line.trim();
   if (!trimmed.startsWith('/')) return null;
+  // /word:rest...   → split di colon pertama
+  const m = trimmed.match(/^\/([a-z?][a-z0-9?_-]*):(.*)$/i);
+  if (m) {
+    return { name: '/' + m[1].toLowerCase(), args: m[2].trim() };
+  }
+  // /cmd args
   const space = trimmed.indexOf(' ');
-  const name = space === -1 ? trimmed : trimmed.slice(0, space);
+  const name = (space === -1 ? trimmed : trimmed.slice(0, space)).toLowerCase();
   const args = space === -1 ? '' : trimmed.slice(space + 1);
-  return { name: name.toLowerCase(), args };
+  return { name, args };
 }
 
 async function dispatch(ctx, line, helpers) {
@@ -421,10 +646,16 @@ async function dispatch(ctx, line, helpers) {
     console.log(`${ui.errorTag()} command gak dikenal: ${parsed.name} — coba ${ui.chalk.yellow('/help')}`);
     return true;
   }
-  await handler(ctx, parsed.args, helpers || {});
+  try {
+    await handler(ctx, parsed.args, helpers || {});
+  } catch (err) {
+    showError(err);
+  }
   return true;
 }
 
+/* ----- shared helpers ----- */
+
 function renderListy(data, preferredKeys) {
   const items = Array.isArray(data)
     ? data
@@ -467,7 +698,7 @@ function showError(err) {
     console.log(ui.limitWarning(err.info || {}));
     return;
   }
-  console.log(`${ui.errorTag()} ${err.message}`);
+  console.log(`${ui.errorTag()} ${err.message || err}`);
 }
 
 function formatVal(v) {
@@ -493,9 +724,4 @@ function maskKey(key) {
   return key.slice(0, 6) + '…' + key.slice(-4);
 }
 
-function indent(s, n) {
-  const pad = ' '.repeat(n);
-  return s.split('\n').map((l) => pad + l).join('\n');
-}
-
 module.exports = { dispatch, parse, REGISTRY };

package/src/config.js

@@ -13,13 +13,20 @@ const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
 
 const DEFAULTS = {
   apiKey: null,
-  baseUrl: 'https://api.zelapioffciall.dpdns.org',
+  baseUrl: 'https://zelapioffciall.dpdns.org',
   statusUrl: 'https://zelapioffciall.dpdns.org/api/status',
   userBaseUrl: 'https://zelapioffciall.dpdns.org',
   model: 'haiku',
   endpoint: '/ai/claila',
   system: 'You are Zelai, a helpful and concise assistant. Reply in the same language as the user.',
+  // Toggle flag — kalau true, field gak dikirim ke payload meskipun ada value-nya.
+  modelDisabled: false,
+  systemDisabled: false,
   lastSession: null,
+  theme: 'dark',
+  // Soft cache buat version-check supaya gak hit registry setiap startup.
+  lastVersionCheck: 0,
+  latestKnownVersion: null,
 };
 
 function ensureDir() {
@@ -34,6 +41,10 @@ function load() {
   try {
     const raw = fs.readFileSync(CONFIG_FILE, 'utf8');
     const parsed = JSON.parse(raw);
+    // Migrate baseUrl yang ngarah ke subdomain `api.` lama → root.
+    if (parsed.baseUrl === 'https://api.zelapioffciall.dpdns.org') {
+      parsed.baseUrl = 'https://zelapioffciall.dpdns.org';
+    }
     return { ...DEFAULTS, ...parsed };
   } catch {
     return { ...DEFAULTS };

package/src/theme.js

@@ -0,0 +1,71 @@
+/**
+ * Theme palette buat terminal — dipakai di seluruh UI helpers.
+ *
+ * Tiap theme nge-define palette warna untuk:
+ *   primary, accent, dim, user, assistant, system, error, warn, ok, link
+ *
+ * Active theme dipilih lewat config (`theme: 'dark' | 'night'`).
+ */
+'use strict';
+
+const chalk = require('chalk');
+
+const THEMES = {
+  dark: {
+    name: 'dark',
+    label: 'Dark — magenta neon, classic Zelapi',
+    primary: chalk.magentaBright.bold,
+    accent: chalk.cyan,
+    dim: chalk.gray,
+    user: chalk.cyan.bold,
+    assistant: chalk.magentaBright.bold,
+    system: chalk.yellow.bold,
+    error: chalk.red.bold,
+    warn: chalk.yellow.bold,
+    ok: chalk.green.bold,
+    info: chalk.blueBright.bold,
+    link: chalk.cyan.underline,
+    box: chalk.magentaBright,
+    boxAccent: chalk.cyan,
+  },
+  night: {
+    name: 'night',
+    label: 'Night — soft blue & purple, easy on eyes',
+    primary: chalk.blueBright.bold,
+    accent: chalk.magenta,
+    dim: chalk.gray,
+    user: chalk.blueBright.bold,
+    assistant: chalk.magenta.bold,
+    system: chalk.cyan.bold,
+    error: chalk.red.bold,
+    warn: chalk.yellow,
+    ok: chalk.green,
+    info: chalk.cyan.bold,
+    link: chalk.blueBright.underline,
+    box: chalk.blue,
+    boxAccent: chalk.magenta,
+  },
+};
+
+let CURRENT = THEMES.dark;
+
+function setTheme(name) {
+  const next = THEMES[name];
+  if (!next) return false;
+  CURRENT = next;
+  return true;
+}
+
+function current() {
+  return CURRENT;
+}
+
+function list() {
+  return Object.keys(THEMES);
+}
+
+function describe(name) {
+  return THEMES[name] ? THEMES[name].label : null;
+}
+
+module.exports = { setTheme, current, list, describe, THEMES };

package/src/ui.js

@@ -1,10 +1,14 @@
 /**
- * UI helpers — banner, prompt, markdown renderer untuk terminal.
+ * UI helpers — banner, prompt, markdown renderer, chat box untuk terminal.
+ *
+ * Semua warna ngambil dari src/theme.js — jadi `dark`/`night` keubah secara
+ * konsisten di seluruh UI.
  */
 'use strict';
 
 const chalk = require('chalk');
 const { marked } = require('marked');
+const theme = require('./theme');
 
 let TerminalRenderer;
 try {
@@ -32,29 +36,33 @@ if (TerminalRenderer) {
       }),
     });
   } catch {
-    // ignored — falls back to plain text
+    // ignored — fall back to plain text
   }
 }
 
 const VERSION = require('../package.json').version;
 
+function termWidth() {
+  return Math.min(process.stdout.columns || 80, 100);
+}
+
 function banner() {
-  const c = chalk.magentaBright;
-  const accent = chalk.cyan;
-  const dim = chalk.gray;
+  const t = theme.current();
+  const c = t.primary;
+  const accent = t.accent;
+  const dim = t.dim;
   const yellow = chalk.yellow;
 
-  // ASCII ZELAI — block style. "by ZELAPI" subtitle on the side.
   const lines = [
     '',
-    c.bold('  ███████╗███████╗██╗      █████╗ ██╗  '),
-    c.bold('  ╚══███╔╝██╔════╝██║     ██╔══██╗██║  '),
-    c.bold('    ███╔╝ █████╗  ██║     ███████║██║  ') + dim('   by ') + chalk.magenta.bold('ZELAPI'),
-    c.bold('   ███╔╝  ██╔══╝  ██║     ██╔══██║██║  ') + dim('   v') + dim(VERSION),
-    c.bold('  ███████╗███████╗███████╗██║  ██║██║  ') + dim('   Protocol V1'),
-    c.bold('  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  '),
+    c('  ███████╗███████╗██╗      █████╗ ██╗  '),
+    c('  ╚══███╔╝██╔════╝██║     ██╔══██╗██║  '),
+    c('    ███╔╝ █████╗  ██║     ███████║██║  ') + dim('   by ') + t.accent.bold('ZELAPI'),
+    c('   ███╔╝  ██╔══╝  ██║     ██╔══██║██║  ') + dim('   v') + dim(VERSION),
+    c('  ███████╗███████╗███████╗██║  ██║██║  ') + dim('   Protocol V1'),
+    c('  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  '),
     '',
-    '  ' + accent.bold('● ') + accent.bold('Zelai Agent CLI') + dim('  •  ') + chalk.green('online') + dim('  •  ') + accent.underline('zelapioffciall.dpdns.org'),
+    '  ' + accent.bold('● ') + accent.bold('Zelai Agent CLI') + dim('  •  ') + chalk.green('online') + dim('  •  ') + t.link('zelapioffciall.dpdns.org'),
     '  ' + dim('Ketik ') + yellow('/help') + dim(' buat lihat command. ') + yellow('/exit') + dim(' buat keluar. ') + yellow('Ctrl+D') + dim(' juga bisa.'),
     '',
   ];
@@ -62,9 +70,8 @@ function banner() {
 }
 
 function smallBanner() {
-  const c = chalk.magentaBright;
-  const dim = chalk.gray;
-  return c.bold('zelai') + dim(' by ZELAPI · v' + VERSION);
+  const t = theme.current();
+  return t.primary('zelai') + t.dim(' by ZELAPI · v' + VERSION);
 }
 
 function renderMarkdown(text) {
@@ -77,42 +84,98 @@ function renderMarkdown(text) {
   }
 }
 
-function userPrompt(model) {
-  const m = chalk.gray(`(${model})`);
-  return `${chalk.cyan.bold('you')} ${m} ${chalk.gray('›')} `;
+/* ----- chat box ----- */
+
+/**
+ * Top of an input box. Render duluan sebelum readline prompt.
+ *   ╭─[ you (haiku) ]──────────────────────
+ *   │ »
+ */
+function userBoxOpen(model, opts = {}) {
+  const t = theme.current();
+  const w = termWidth();
+  const label = ` you (${opts.model || model || 'haiku'}) `;
+  const filler = Math.max(w - label.length - 4, 0);
+  const top = t.boxAccent('╭─[') + t.user(label) + t.boxAccent(']' + '─'.repeat(filler));
+  return top;
+}
+
+function userPrompt(model, opts = {}) {
+  const t = theme.current();
+  const arrow = opts.disabledHint ? t.warn('»') : t.user('»');
+  return `${t.boxAccent('│')} ${arrow} `;
+}
+
+/**
+ * Open of an assistant bubble.
+ *   ╭─[ zelai (haiku) ]──────────────────────
+ *   │ markdown content here
+ *   │ ...
+ *   ╰──────────────────────────────────────
+ */
+function assistantBoxOpen(model) {
+  const t = theme.current();
+  const w = termWidth();
+  const label = ` zelai (${model}) `;
+  const filler = Math.max(w - label.length - 4, 0);
+  return t.box('╭─[') + t.assistant(label) + t.box(']' + '─'.repeat(filler));
+}
+
+function assistantBoxClose() {
+  const t = theme.current();
+  return t.box('╰' + '─'.repeat(Math.max(termWidth() - 1, 0)));
+}
+
+/**
+ * Indent each non-empty line with the "│ " gutter.
+ */
+function gutterIndent(text) {
+  const t = theme.current();
+  const g = t.box('│') + ' ';
+  if (!text) return g;
+  return text.split('\n').map((l) => g + l).join('\n');
 }
 
+/* ----- tags / hints ----- */
+
 function assistantTag(model) {
-  return chalk.magentaBright.bold('zelai') + chalk.gray(`(${model})`) + chalk.gray(' ›');
+  const t = theme.current();
+  return t.assistant('zelai') + t.dim(`(${model})`) + t.dim(' ›');
 }
 
 function systemTag() {
-  return chalk.yellow.bold('system') + chalk.gray(' ›');
+  const t = theme.current();
+  return t.system('system') + t.dim(' ›');
 }
 
 function errorTag() {
-  return chalk.red.bold('error') + chalk.gray(' ›');
+  const t = theme.current();
+  return t.error('error') + t.dim(' ›');
 }
 
 function warnTag() {
-  return chalk.yellow.bold('⚠ warning') + chalk.gray(' ›');
+  const t = theme.current();
+  return t.warn('⚠ warning') + t.dim(' ›');
 }
 
 function infoTag() {
-  return chalk.blueBright.bold('info') + chalk.gray(' ›');
+  const t = theme.current();
+  return t.info('info') + t.dim(' ›');
 }
 
 function okTag() {
-  return chalk.green.bold('✓') + chalk.gray(' ›');
+  const t = theme.current();
+  return t.ok('✓') + t.dim(' ›');
 }
 
 function hr() {
-  const w = Math.min(process.stdout.columns || 80, 100);
-  return chalk.gray('─'.repeat(w));
+  const t = theme.current();
+  return t.dim('─'.repeat(termWidth()));
 }
 
 function kv(key, value) {
-  return `${chalk.gray(key.padEnd(14))} ${chalk.white(value)}`;
+  const t = theme.current();
+  return `${t.dim(key.padEnd(14))} ${chalk.white(value)}`;
 }
 
 function pretty(obj) {
@@ -123,38 +186,68 @@ function pretty(obj) {
   }
 }
 
-/**
- * Render a clean "limit hit" box.
- */
+/* ----- limit warning ----- */
+
 function limitWarning(info) {
-  const dim = chalk.gray;
-  const red = chalk.red.bold;
+  const t = theme.current();
+  const red = t.error;
   const top = red('┏━━ LIMIT EXCEEDED ' + '━'.repeat(40));
   const bot = red('┗' + '━'.repeat(58));
-  const lines = [
-    '',
-    top,
-    red('┃ ') + chalk.yellow('Kuota API kamu udah habis 🚫'),
-    red('┃ '),
-  ];
+  const lines = ['', top, red('┃ ') + chalk.yellow('Kuota API kamu udah habis 🚫'), red('┃ ')];
   if (info && typeof info === 'object') {
-    if (info.used !== undefined) lines.push(red('┃ ') + dim('used   : ') + chalk.white(String(info.used)));
-    if (info.limit !== undefined) lines.push(red('┃ ') + dim('limit  : ') + chalk.white(String(info.limit)));
-    if (info.resetAt) lines.push(red('┃ ') + dim('reset  : ') + chalk.white(String(info.resetAt)));
-    if (info.plan) lines.push(red('┃ ') + dim('plan   : ') + chalk.white(String(info.plan)));
+    if (info.used !== undefined) lines.push(red('┃ ') + t.dim('used   : ') + chalk.white(String(info.used)));
+    if (info.limit !== undefined) lines.push(red('┃ ') + t.dim('limit  : ') + chalk.white(String(info.limit)));
+    if (info.resetAt) lines.push(red('┃ ') + t.dim('reset  : ') + chalk.white(String(info.resetAt)));
+    if (info.plan) lines.push(red('┃ ') + t.dim('plan   : ') + chalk.white(String(info.plan)));
   }
   lines.push(red('┃ '));
-  lines.push(red('┃ ') + dim('Upgrade plan di ') + chalk.cyan.underline('https://zelapioffciall.dpdns.org/pricing'));
+  lines.push(red('┃ ') + t.dim('Upgrade plan di ') + t.link('https://zelapioffciall.dpdns.org/pricing'));
   lines.push(bot);
   lines.push('');
   return lines.join('\n');
 }
 
+/* ----- version vulnerable warning ----- */
+
+function vulnerableWarning(current, latest) {
+  const t = theme.current();
+  const yellow = chalk.yellow.bold;
+  const dim = t.dim;
+  const top = yellow('┏━━ ⚠ UPDATE AVAILABLE ' + '━'.repeat(35));
+  const bot = yellow('┗' + '━'.repeat(58));
+  return [
+    '',
+    top,
+    yellow('┃ ') + chalk.white('Your version is too vulnerable to problems,'),
+    yellow('┃ ') + chalk.white('please update by typing ') + chalk.cyan.bold('/update'),
+    yellow('┃ '),
+    yellow('┃ ') + dim('current : ') + chalk.white(current),
+    yellow('┃ ') + dim('latest  : ') + chalk.green.bold(latest),
+    bot,
+    '',
+  ].join('\n');
+}
+
+/* ----- generic box ----- */
+
+function box(title, body) {
+  const t = theme.current();
+  const w = termWidth();
+  const label = ` ${title} `;
+  const filler = Math.max(w - label.length - 4, 0);
+  const top = t.boxAccent('╭─[') + t.user(label) + t.boxAccent(']' + '─'.repeat(filler));
+  const bot = t.boxAccent('╰' + '─'.repeat(Math.max(w - 1, 0)));
+  return [top, gutterIndent(body || ''), bot].join('\n');
+}
+
 module.exports = {
   banner,
   smallBanner,
   renderMarkdown,
+  userBoxOpen,
   userPrompt,
+  assistantBoxOpen,
+  assistantBoxClose,
   assistantTag,
   systemTag,
   errorTag,
@@ -165,5 +258,10 @@ module.exports = {
   kv,
   pretty,
   limitWarning,
+  vulnerableWarning,
+  box,
+  gutterIndent,
+  termWidth,
   chalk,
+  theme,
 };

package/src/version.js

@@ -0,0 +1,85 @@
+/**
+ * Version check + /update helper.
+ *
+ * - getLatest()      → ngambil versi terbaru dari npm registry (zelai-cli)
+ * - isBehind(a, b)   → true kalau a (current) < b (latest)
+ * - runUpdate()      → spawn `npm i -g zelai-cli@latest`, stream output ke stdout
+ */
+'use strict';
+
+const axios = require('axios');
+const { spawn } = require('child_process');
+
+const REGISTRY = 'https://registry.npmjs.org';
+const PKG = 'zelai-cli';
+
+async function getLatest(timeoutMs = 4000) {
+  try {
+    const res = await axios.get(`${REGISTRY}/${PKG}/latest`, { timeout: timeoutMs });
+    if (res.status >= 200 && res.status < 300 && res.data && res.data.version) {
+      return String(res.data.version);
+    }
+  } catch {
+    // Diem aja — version check itu best effort.
+  }
+  return null;
+}
+
+function parseSemver(v) {
+  const m = String(v || '').replace(/^v/, '').match(/^(\d+)\.(\d+)\.(\d+)/);
+  if (!m) return null;
+  return [parseInt(m[1], 10), parseInt(m[2], 10), parseInt(m[3], 10)];
+}
+
+function compareSemver(a, b) {
+  const av = parseSemver(a);
+  const bv = parseSemver(b);
+  if (!av || !bv) return 0;
+  for (let i = 0; i < 3; i++) {
+    if (av[i] < bv[i]) return -1;
+    if (av[i] > bv[i]) return 1;
+  }
+  return 0;
+}
+
+function isBehind(current, latest) {
+  if (!current || !latest) return false;
+  return compareSemver(current, latest) < 0;
+}
+
+/**
+ * Jalanin `npm i -g zelai-cli@latest`. Stream stdout/stderr live ke onLine,
+ * supaya CLI bisa render pesan progress (warnaan).
+ *
+ * Returns Promise<{ ok, code }>.
+ */
+function runUpdate(onLine) {
+  return new Promise((resolve) => {
+    const args = ['i', '-g', `${PKG}@latest`];
+    const child = spawn('npm', args, { stdio: ['ignore', 'pipe', 'pipe'] });
+
+    let buf = '';
+    const onData = (chunk) => {
+      buf += chunk.toString('utf8');
+      let nl;
+      while ((nl = buf.indexOf('\n')) !== -1) {
+        const line = buf.slice(0, nl);
+        buf = buf.slice(nl + 1);
+        if (typeof onLine === 'function') onLine(line);
+      }
+    };
+    child.stdout.on('data', onData);
+    child.stderr.on('data', onData);
+
+    child.on('close', (code) => {
+      if (buf && typeof onLine === 'function') onLine(buf);
+      resolve({ ok: code === 0, code });
+    });
+    child.on('error', (err) => {
+      if (typeof onLine === 'function') onLine('error: ' + err.message);
+      resolve({ ok: false, code: -1 });
+    });
+  });
+}
+
+module.exports = { getLatest, isBehind, compareSemver, parseSemver, runUpdate, PKG };