zelai-cli 1.1.0

package/src/client.js

@@ -0,0 +1,171 @@
+/**
+ * HTTP client untuk Zelapi.
+ * Wrapper tipis di atas axios — semua endpoint AI / status / user di-route lewat sini.
+ */
+'use strict';
+
+const axios = require('axios');
+
+const USER_AGENT = `zelai-cli/${require('../package.json').version} (+https://github.com/zelapi/zelai)`;
+
+class LimitExceededError extends Error {
+  constructor(message, info) {
+    super(message || 'Limit terlampaui.');
+    this.name = 'LimitExceededError';
+    this.status = 429;
+    this.info = info || {};
+  }
+}
+
+class ApiError extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.name = 'ApiError';
+    this.status = status;
+    this.body = body;
+  }
+}
+
+function makeClient(config) {
+  const http = axios.create({
+    timeout: 120000,
+    headers: { 'User-Agent': USER_AGENT },
+    validateStatus: () => true,
+  });
+
+  function authHeaders() {
+    if (!config.apiKey) {
+      const err = new Error('API key belum di-set. Jalanin /login dulu di dalam chat, atau set env ZELAPI_KEY.');
+      err.code = 'NO_API_KEY';
+      throw err;
+    }
+    return {
+      Authorization: `Bearer ${config.apiKey}`,
+      'Content-Type': 'application/json',
+    };
+  }
+
+  function unwrap(res, endpoint) {
+    if (res.status >= 200 && res.status < 300) return res.data;
+
+    const body = res.data;
+    const text = JSON.stringify(body || '').toLowerCase();
+    const looksLikeLimit =
+      res.status === 429 ||
+      /limit (exceed|reach|hit)|quota|exhaust|too many request|rate.?limit/.test(text);
+
+    if (looksLikeLimit) {
+      const info = {
+        used: body && (body.used ?? (body.data && body.data.used)),
+        limit: body && (body.limit ?? (body.data && body.data.limit)),
+        resetAt: body && (body.reset || body.resetAt || (body.data && (body.data.reset || body.data.resetAt))),
+        plan: body && (body.plan || (body.data && body.data.plan)),
+      };
+      const msg = (body && (body.message || body.error || body.detail)) || 'Kuota API kamu udah habis.';
+      throw new LimitExceededError(msg, info);
+    }
+
+    const msg =
+      (body && (body.message || body.error || body.detail)) ||
+      `HTTP ${res.status} dari ${endpoint}`;
+    throw new ApiError(msg, res.status, body);
+  }
+
+  /**
+   * Kirim pesan ke Agent API.
+   * Returns: { reply, sessionId, raw }
+   */
+  async function sendAgent({ messages, model, endpoint, system, sessionId }) {
+    const url = `${config.baseUrl.replace(/\/$/, '')}/api/v1/agent`;
+
+    // Sesuai docs: `session` di-attach ke item message terakhir.
+    const msgs = messages.map((m, i) => {
+      if (i === messages.length - 1 && sessionId) {
+        return { ...m, session: sessionId };
+      }
+      return m;
+    });
+
+    const payload = {
+      endpoint: endpoint || '/ai/claila',
+      messages: msgs,
+    };
+    if (model) payload.model = model;
+    if (system) payload.system = system;
+
+    const res = await http.post(url, payload, { headers: authHeaders() });
+    const data = unwrap(res, '/api/v1/agent');
+
+    const reply = pickReply(data);
+    const session = pickSession(data) || sessionId || null;
+    return { reply, sessionId: session, raw: data };
+  }
+
+  async function getStatus() {
+    const url = config.statusUrl;
+    const res = await http.get(url);
+    return unwrap(res, '/api/status');
+  }
+
+  async function getActivityLogs(apiKey) {
+    const key = apiKey || config.apiKey;
+    if (!key) throw new Error('API key dibutuhkan buat ngambil activity logs.');
+    const url = `${config.userBaseUrl.replace(/\/$/, '')}/api/user/activity-logs`;
+    const res = await http.get(url, { params: { apikey: key } });
+    return unwrap(res, '/api/user/activity-logs');
+  }
+
+  async function getUsage(apiKey) {
+    const key = apiKey || config.apiKey;
+    if (!key) throw new Error('API key dibutuhkan buat ngambil usage.');
+    const url = `${config.userBaseUrl.replace(/\/$/, '')}/api/user/usage`;
+    const res = await http.get(url, { params: { apikey: key } });
+    return unwrap(res, '/api/user/usage');
+  }
+
+  return { sendAgent, getStatus, getActivityLogs, getUsage };
+}
+
+function pickReply(data) {
+  if (data == null) return '';
+  if (typeof data === 'string') return data;
+
+  const candidates = [
+    data.reply,
+    data.response,
+    data.message,
+    data.answer,
+    data.content,
+    data.result,
+    data.text,
+    data.output,
+    data.data && data.data.reply,
+    data.data && data.data.response,
+    data.data && data.data.message,
+    data.data && data.data.content,
+    data.data && data.data.text,
+    data.choices && data.choices[0] && data.choices[0].message && data.choices[0].message.content,
+    data.choices && data.choices[0] && data.choices[0].text,
+  ];
+  for (const c of candidates) {
+    if (typeof c === 'string' && c.trim()) return c;
+  }
+  try {
+    return '```json\n' + JSON.stringify(data, null, 2) + '\n```';
+  } catch {
+    return String(data);
+  }
+}
+
+function pickSession(data) {
+  if (!data || typeof data !== 'object') return null;
+  return (
+    data.session ||
+    data.sessionId ||
+    data.session_id ||
+    (data.data && (data.data.session || data.data.sessionId || data.data.session_id)) ||
+    null
+  );
+}
+
+module.exports = { makeClient, LimitExceededError, ApiError };

package/src/commands.js

@@ -0,0 +1,501 @@
+/**
+ * Slash command registry.
+ * Setiap handler dipanggil dengan (ctx, args, helpers) — ctx = session state dari cli.js.
+ */
+'use strict';
+
+const ora = require('ora');
+const ui = require('./ui');
+const config = require('./config');
+const session = require('./session');
+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)'],
+];
+
+async function cmdHelp() {
+  console.log('');
+  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('');
+  console.log(ui.chalk.gray('  Tip: ketik biasa tanpa "/" buat ngobrol sama AI.'));
+  console.log('');
+}
+
+async function cmdStatus(ctx) {
+  const spinner = ora({ text: 'ngecek status server…', color: 'cyan' }).start();
+  try {
+    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('');
+    if (typeof data === 'object' && data !== null) {
+      const known = ['status', 'state', 'health', 'uptime', 'version', 'region', 'latency', 'node', 'env'];
+      const root = data.data && typeof data.data === 'object' ? data.data : data;
+      let printed = 0;
+      for (const k of known) {
+        if (root[k] !== undefined) {
+          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)))
+            : String(v);
+          console.log('  ' + ui.kv(k, value));
+          printed++;
+        }
+      }
+      if (printed === 0) {
+        console.log(ui.chalk.gray(ui.pretty(data)));
+      } else {
+        console.log('');
+        console.log(ui.chalk.gray('  raw:'));
+        console.log(ui.chalk.gray(indent(ui.pretty(data), 2)));
+      }
+    } else {
+      console.log(String(data));
+    }
+    console.log(ui.hr());
+  } catch (err) {
+    spinner.stop();
+    showError(err);
+  }
+}
+
+async function cmdActivity(ctx, args) {
+  const key = (args && args.trim()) || ctx.config.apiKey;
+  if (!key) {
+    console.log(`${ui.errorTag()} API key kosong. /login dulu.`);
+    return;
+  }
+  const spinner = ora({ text: 'narik activity logs…', color: 'cyan' }).start();
+  try {
+    const data = await ctx.client.getActivityLogs(key);
+    spinner.stop();
+    console.log(ui.hr());
+    console.log(ui.chalk.bold('Activity Logs') + ui.chalk.gray(`  ·  apikey=${maskKey(key)}`));
+    renderListy(data, ['timestamp', 'time', 'date', 'action', 'event', 'endpoint', 'ip', 'status']);
+    console.log(ui.hr());
+  } catch (err) {
+    spinner.stop();
+    showError(err);
+  }
+}
+
+async function cmdUsage(ctx, args) {
+  const key = (args && args.trim()) || ctx.config.apiKey;
+  if (!key) {
+    console.log(`${ui.errorTag()} API key kosong. /login dulu.`);
+    return;
+  }
+  const spinner = ora({ text: 'narik usage…', color: 'cyan' }).start();
+  try {
+    const data = await ctx.client.getUsage(key);
+    spinner.stop();
+    console.log(ui.hr());
+    console.log(ui.chalk.bold('Usage') + ui.chalk.gray(`  ·  apikey=${maskKey(key)}`));
+    if (typeof data === 'object' && data !== null && !Array.isArray(data)) {
+      const flat = data.data && typeof data.data === 'object' ? data.data : data;
+      for (const [k, v] of Object.entries(flat)) {
+        if (typeof v === 'object' && v !== null) {
+          console.log(ui.chalk.gray(`\n${k}:`));
+          for (const [k2, v2] of Object.entries(v)) {
+            console.log('  ' + ui.kv(k2, formatVal(v2)));
+          }
+        } else {
+          console.log(ui.kv(k, formatVal(v)));
+        }
+      }
+      maybeShowQuotaBar(flat);
+    } else {
+      renderListy(data, ['endpoint', 'count', 'tokens', 'requests']);
+    }
+    console.log(ui.hr());
+  } catch (err) {
+    spinner.stop();
+    showError(err);
+  }
+}
+
+function maybeShowQuotaBar(flat) {
+  const used = num(flat.used) ?? num(flat.usage) ?? num(flat.count) ?? num(flat.requests);
+  const limit = num(flat.limit) ?? num(flat.quota) ?? num(flat.max);
+  if (used === undefined || limit === undefined || limit <= 0) return;
+  const ratio = Math.min(used / limit, 1);
+  const width = 30;
+  const filled = Math.round(ratio * width);
+  const bar = '█'.repeat(filled) + '░'.repeat(width - filled);
+  const color = ratio >= 1 ? ui.chalk.red : ratio >= 0.9 ? ui.chalk.yellow : ui.chalk.green;
+  console.log('');
+  console.log('  ' + color(bar) + '  ' + color(`${used}/${limit}`) + ui.chalk.gray(`  (${(ratio * 100).toFixed(1)}%)`));
+  if (ratio >= 1) {
+    console.log(ui.limitWarning({ used, limit, plan: flat.plan, resetAt: flat.reset || flat.resetAt }));
+  }
+}
+
+async function cmdModel(ctx, args) {
+  const next = (args || '').trim().toLowerCase();
+  if (!next) {
+    console.log(`${ui.infoTag()} model sekarang: ${ui.chalk.cyan(ctx.config.model)} ${ui.chalk.gray('— pilihan: opus, sonnet, haiku')}`);
+    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 });
+  console.log(`${ui.okTag()} model diganti ke ${ui.chalk.cyan(next)}`);
+}
+
+async function cmdEndpoint(ctx, args) {
+  const next = (args || '').trim();
+  if (!next) {
+    console.log(`${ui.infoTag()} endpoint sekarang: ${ui.chalk.cyan(ctx.config.endpoint)}`);
+    return;
+  }
+  if (!next.startsWith('/')) {
+    console.log(`${ui.errorTag()} endpoint harus diawali ${ui.chalk.yellow('/')} — contoh: /ai/claila`);
+    return;
+  }
+  ctx.config = config.update({ endpoint: next });
+  console.log(`${ui.okTag()} endpoint diganti ke ${ui.chalk.cyan(next)}`);
+}
+
+async function cmdSystem(ctx, args) {
+  const next = (args || '').trim();
+  if (!next) {
+    console.log(`${ui.infoTag()} system prompt saat ini:`);
+    console.log(ui.chalk.gray('  ' + (ctx.config.system || '(kosong)')));
+    return;
+  }
+  ctx.config = config.update({ system: next });
+  console.log(`${ui.okTag()} system prompt updated.`);
+}
+
+async function cmdNew(ctx) {
+  ctx.history = [];
+  ctx.sessionId = null;
+  config.update({ lastSession: null });
+  console.log(`${ui.okTag()} sesi baru dimulai — history & session ID di-reset.`);
+}
+
+async function cmdSession(ctx, args) {
+  const next = (args || '').trim();
+  if (!next) {
+    console.log(`${ui.infoTag()} session ID sekarang: ${ui.chalk.cyan(ctx.sessionId || '(belum ada)')}`);
+    return;
+  }
+  ctx.sessionId = next;
+  const rec = session.load(next);
+  if (rec && Array.isArray(rec.history)) {
+    ctx.history = rec.history.map(({ role, content }) => ({ role, content }));
+    console.log(`${ui.okTag()} session ID di-set ke ${ui.chalk.cyan(next)} ${ui.chalk.gray(`(${rec.history.length} pesan dimuat)`)}`);
+  } else {
+    console.log(`${ui.okTag()} session ID di-set ke ${ui.chalk.cyan(next)}`);
+  }
+  config.update({ lastSession: next });
+}
+
+async function cmdSessions(ctx) {
+  const rows = session.list();
+  ctx._lastSessionsList = rows;
+  console.log(ui.hr());
+  console.log(ui.chalk.bold('Sessions tersimpan') + ui.chalk.gray('  ·  ' + session.sessionDir()));
+  if (rows.length === 0) {
+    console.log(ui.chalk.gray('(belum ada sesi)'));
+    console.log(ui.hr());
+    return;
+  }
+  rows.forEach((r, i) => {
+    const when = r.updatedAt ? new Date(r.updatedAt).toISOString().replace('T', ' ').slice(0, 19) : '—';
+    const isCurrent = r.id === ctx.sessionId;
+    const marker = isCurrent ? ui.chalk.green.bold('● ') : ui.chalk.gray('  ');
+    console.log(
+      marker +
+      ui.chalk.gray(`#${String(i + 1).padStart(2)} `) +
+      ui.chalk.cyan(r.id.padEnd(28)) +
+      ui.chalk.gray(' · ') +
+      ui.chalk.gray(`${String(r.turns).padStart(3)} turns`) +
+      ui.chalk.gray(' · ') +
+      ui.chalk.gray(when) +
+      (r.preview ? ui.chalk.gray('  — ' + r.preview) : '')
+    );
+  });
+  console.log(ui.chalk.gray('\n  /load <nomor|id>  ·  /forget <nomor|id|all>'));
+  console.log(ui.hr());
+}
+
+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();
+    return rows[idx] ? rows[idx].id : null;
+  }
+  return trimmed;
+}
+
+async function cmdLoad(ctx, args) {
+  const ref = (args || '').trim();
+  if (!ref) {
+    console.log(`${ui.errorTag()} kasih session ID atau nomor — contoh: /load 1`);
+    return;
+  }
+  const id = resolveSessionRef(ctx, ref);
+  if (!id) {
+    console.log(`${ui.errorTag()} session "${ref}" gak ketemu. Coba /sessions dulu.`);
+    return;
+  }
+  const rec = session.load(id);
+  if (!rec) {
+    console.log(`${ui.errorTag()} sesi ${id} gak ada di folder ./session.`);
+    return;
+  }
+  ctx.sessionId = id;
+  ctx.history = (rec.history || []).map(({ role, content }) => ({ role, content }));
+  if (rec.model) ctx.config = config.update({ model: rec.model });
+  if (rec.endpoint) ctx.config = config.update({ endpoint: rec.endpoint });
+  if (rec.system) ctx.config = config.update({ system: rec.system });
+  config.update({ lastSession: id });
+  console.log(`${ui.okTag()} di-load sesi ${ui.chalk.cyan(id)} ${ui.chalk.gray(`(${ctx.history.length} pesan)`)}`);
+}
+
+async function cmdForget(ctx, args) {
+  const ref = (args || '').trim();
+  if (!ref) {
+    console.log(`${ui.errorTag()} kasih session ID, nomor, atau "all" — contoh: /forget 2`);
+    return;
+  }
+  if (ref.toLowerCase() === 'all') {
+    const rows = session.list();
+    let n = 0;
+    for (const r of rows) if (session.remove(r.id)) n++;
+    if (ctx.sessionId) ctx.sessionId = null;
+    if (ctx.history) ctx.history = [];
+    config.update({ lastSession: null });
+    console.log(`${ui.okTag()} dihapus ${n} sesi.`);
+    return;
+  }
+  const id = resolveSessionRef(ctx, ref);
+  if (!id) {
+    console.log(`${ui.errorTag()} session "${ref}" gak ketemu.`);
+    return;
+  }
+  const ok = session.remove(id);
+  if (!ok) {
+    console.log(`${ui.errorTag()} gagal hapus sesi ${id}.`);
+    return;
+  }
+  if (ctx.sessionId === id) {
+    ctx.sessionId = null;
+    ctx.history = [];
+    config.update({ lastSession: null });
+  }
+  console.log(`${ui.okTag()} sesi ${ui.chalk.cyan(id)} dihapus.`);
+}
+
+async function cmdSave(ctx) {
+  const id = ctx.sessionId || session.localId();
+  ctx.sessionId = id;
+  const rec = session.load(id) || session.create({
+    id, model: ctx.config.model, endpoint: ctx.config.endpoint, system: ctx.config.system,
+  });
+  rec.history = (ctx.history || []).map(({ role, content }) => ({ role, content, ts: Date.now() }));
+  rec.model = ctx.config.model;
+  rec.endpoint = ctx.config.endpoint;
+  rec.system = ctx.config.system;
+  session.save(rec);
+  config.update({ lastSession: id });
+  console.log(`${ui.okTag()} sesi disimpan: ${ui.chalk.cyan(id)} ${ui.chalk.gray(`(${rec.history.length} pesan)`)}`);
+}
+
+async function cmdLogin(ctx, args, { ask }) {
+  let key = (args || '').trim();
+  if (!key) {
+    key = await ask(`${ui.systemTag()} masukin API key (zel_…): `, { mask: true });
+  }
+  key = key.trim();
+  if (!key) {
+    console.log(`${ui.errorTag()} API key kosong, dibatalin.`);
+    return;
+  }
+  ctx.config = config.update({ apiKey: key });
+  console.log(`${ui.okTag()} API key kesimpan di ${ui.chalk.gray(config.configPath())}`);
+}
+
+async function cmdLogout(ctx) {
+  ctx.config = config.update({ apiKey: null });
+  console.log(`${ui.okTag()} API key dihapus dari config.`);
+}
+
+async function cmdConfig(ctx) {
+  console.log(ui.hr());
+  console.log(ui.chalk.bold('Config'));
+  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('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.hr());
+}
+
+async function cmdClear() {
+  process.stdout.write('\x1Bc');
+}
+
+async function cmdExit(ctx) {
+  console.log(`${ui.infoTag()} bye! 👋`);
+  if (ctx.rl) ctx.rl.close();
+  process.exit(0);
+}
+
+const REGISTRY = {
+  '/help': cmdHelp,
+  '/?': cmdHelp,
+  '/status': cmdStatus,
+  '/activity': cmdActivity,
+  '/logs': cmdActivity,
+  '/usage': cmdUsage,
+  '/quota': cmdUsage,
+  '/model': cmdModel,
+  '/endpoint': cmdEndpoint,
+  '/system': cmdSystem,
+  '/new': cmdNew,
+  '/reset': cmdNew,
+  '/session': cmdSession,
+  '/sessions': cmdSessions,
+  '/ls': cmdSessions,
+  '/load': cmdLoad,
+  '/forget': cmdForget,
+  '/save': cmdSave,
+  '/login': cmdLogin,
+  '/logout': cmdLogout,
+  '/config': cmdConfig,
+  '/clear': cmdClear,
+  '/cls': cmdClear,
+  '/exit': cmdExit,
+  '/quit': cmdExit,
+  '/q': cmdExit,
+};
+
+function parse(line) {
+  const trimmed = line.trim();
+  if (!trimmed.startsWith('/')) return null;
+  const space = trimmed.indexOf(' ');
+  const name = space === -1 ? trimmed : trimmed.slice(0, space);
+  const args = space === -1 ? '' : trimmed.slice(space + 1);
+  return { name: name.toLowerCase(), args };
+}
+
+async function dispatch(ctx, line, helpers) {
+  const parsed = parse(line);
+  if (!parsed) return false;
+  const handler = REGISTRY[parsed.name];
+  if (!handler) {
+    console.log(`${ui.errorTag()} command gak dikenal: ${parsed.name} — coba ${ui.chalk.yellow('/help')}`);
+    return true;
+  }
+  await handler(ctx, parsed.args, helpers || {});
+  return true;
+}
+
+function renderListy(data, preferredKeys) {
+  const items = Array.isArray(data)
+    ? data
+    : (data && Array.isArray(data.data) ? data.data
+      : (data && Array.isArray(data.logs) ? data.logs
+        : (data && Array.isArray(data.activities) ? data.activities : null)));
+  if (items && items.length === 0) {
+    console.log(ui.chalk.gray('(kosong)'));
+    return;
+  }
+  if (items) {
+    items.slice(0, 50).forEach((it, idx) => {
+      console.log(ui.chalk.gray(`\n#${idx + 1}`));
+      if (typeof it !== 'object' || it === null) {
+        console.log('  ' + String(it));
+        return;
+      }
+      const keys = preferredKeys.filter((k) => k in it).concat(
+        Object.keys(it).filter((k) => !preferredKeys.includes(k))
+      );
+      for (const k of keys) {
+        const v = it[k];
+        if (typeof v === 'object' && v !== null) {
+          console.log('  ' + ui.kv(k, JSON.stringify(v)));
+        } else {
+          console.log('  ' + ui.kv(k, formatVal(v)));
+        }
+      }
+    });
+    if (items.length > 50) {
+      console.log(ui.chalk.gray(`\n…dan ${items.length - 50} entri lagi (di-truncate).`));
+    }
+    return;
+  }
+  console.log(ui.chalk.gray(ui.pretty(data)));
+}
+
+function showError(err) {
+  if (err instanceof LimitExceededError) {
+    console.log(ui.limitWarning(err.info || {}));
+    return;
+  }
+  console.log(`${ui.errorTag()} ${err.message}`);
+}
+
+function formatVal(v) {
+  if (v === null || v === undefined) return ui.chalk.gray('—');
+  if (typeof v === 'boolean') return v ? ui.chalk.green('true') : ui.chalk.red('false');
+  return String(v);
+}
+
+function num(v) {
+  if (v === undefined || v === null || v === '') return undefined;
+  const n = typeof v === 'number' ? v : parseFloat(v);
+  return Number.isFinite(n) ? n : undefined;
+}
+
+function truncate(s, n) {
+  if (!s) return '';
+  return s.length > n ? s.slice(0, n - 1) + '…' : s;
+}
+
+function maskKey(key) {
+  if (!key) return '';
+  if (key.length <= 10) return key.slice(0, 3) + '…' + key.slice(-2);
+  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 };