zelai-cli 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zelapi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,181 @@
+# Zelai
+
+> Official CLI & SDK buat **Zelapi Agent API** — chat sama AI langsung dari terminal kamu, atau jalanin sebagai bot di Discord & Telegram.
+
+```
+  ███████╗███████╗██╗      █████╗ ██╗     by ZELAPI
+  ╚══███╔╝██╔════╝██║     ██╔══██╗██║
+    ███╔╝ █████╗  ██║     ███████║██║
+   ███╔╝  ██╔══╝  ██║     ██╔══██║██║
+  ███████╗███████╗███████╗██║  ██║██║
+  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝
+```
+
+`zelai` adalah CLI bergaya Claude/Gemini CLI: tinggal panggil `zelai` di terminal, masuk chat REPL, ngobrol sama model AI Zelapi (`opus`, `sonnet`, `haiku`) lewat satu unified endpoint `/api/v1/agent`. Session persistent (otomatis disimpan di folder `./session`), ada slash command (`/status`, `/usage`, `/activity`, dll), warning kalau quota habis, plus connector Discord & Telegram di folder `connector/`.
+
+## Install
+
+Lewat npm (paling gampang):
+
+```bash
+npm install -g zelai-cli
+zelai --version
+```
+
+Setelah install, command `zelai` langsung available di terminal lo.
+
+Atau clone dari source:
+
+```bash
+git clone https://github.com/zelapi/zelai.git
+cd zelai
+npm install
+npm link        # bikin command `zelai` global
+```
+
+Atau jalanin tanpa link:
+
+```bash
+node bin/zelai.js
+```
+
+## Quickstart
+
+```bash
+zelai login        # masukin API key zel_…
+zelai              # masuk chat REPL
+```
+
+Chat REPL look:
+
+```
+zelai by ZELAPI · v1.0.0
+● Zelai Agent CLI  •  online  •  zelapioffciall.dpdns.org
+  Ketik /help buat lihat command. /exit buat keluar.
+
+you (haiku) › halo!
+zelai(haiku) ›
+hai juga! ada yang bisa aku bantu?
+
+you (haiku) › /status
+─────────────────────────────────────────
+Server Status  ·  https://zelapioffciall.dpdns.org/api/status
+  status     OK
+  uptime     34h12m
+  version    1.0.0
+─────────────────────────────────────────
+```
+
+## One-shot mode
+
+```bash
+zelai -p "ringkasin paper attention is all you need dalam 3 poin"
+```
+
+## Slash commands
+
+| Command            | Fungsi                                              |
+| ------------------ | --------------------------------------------------- |
+| `/help`            | Tampilin daftar command                             |
+| `/status`          | Cek `https://zelapioffciall.dpdns.org/api/status`   |
+| `/usage`           | Cek pemakaian + kuota API key                       |
+| `/activity`        | Activity logs akun                                  |
+| `/model <name>`    | Ganti model: `opus`, `sonnet`, `haiku`              |
+| `/endpoint <path>` | Ganti AI endpoint (mis. `/ai/claila`, `/ai/spawn`)  |
+| `/system <prompt>` | Set system prompt                                   |
+| `/new`             | Mulai sesi baru                                     |
+| `/session <id>`    | Set / lihat session ID manual                       |
+| `/sessions`        | List semua sesi tersimpan di `./session`            |
+| `/load <id│nomor>` | Load sesi tersimpan                                 |
+| `/forget <id│all>` | Hapus sesi tersimpan                                |
+| `/save`            | Paksa simpan sesi sekarang                          |
+| `/login`           | Set / ganti API key                                 |
+| `/logout`          | Hapus API key                                       |
+| `/config`          | Tampilin path & isi config                          |
+| `/clear`           | Bersihin layar                                      |
+| `/exit`            | Keluar (alias: `/quit`, `/q`)                       |
+
+## Session persistence
+
+Folder `./session` **otomatis dibikin** pas pertama kali `zelai` jalan, di working directory tempat kamu nge-run. Setiap sesi disimpan sebagai `./session/<session-id>.json` — turn history, model, endpoint, system prompt semuanya lengkap.
+
+Reload sesi otomatis: kalau kamu jalanin `zelai` lagi, last session di-resume dari file, jadi context tetap kebawa.
+
+```bash
+zelai --session zelapi-026391vehak07   # langsung load sesi tertentu
+zelai sessions                          # list semua sesi tersimpan
+zelai resume zelapi-026391vehak07       # lanjutin sesi spesifik
+zelai resume 1                          # lanjutin sesi nomor 1 dari `zelai sessions`
+zelai resume                            # lanjutin sesi paling baru (default)
+```
+
+## Warning ketika limit habis
+
+Kalau API key kamu kena rate limit / quota habis (HTTP 429 atau body yang nyebut `limit`/`quota`/`exhausted`), Zelai bakal nge-render box warning merah dengan info `used`, `limit`, `plan`, dan link upgrade. Plus, di awal sesi interaktif, Zelai cek soft kalau pemakaian udah ≥ 90% — ngasih heads-up.
+
+## Programmatic SDK
+
+```js
+const { Zelai } = require('zelai');
+
+const z = new Zelai({ apiKey: process.env.ZELAPI_KEY });
+
+const { reply, sessionId } = await z.chat('halo!');
+console.log(reply);
+
+// Lanjutan sesi:
+const next = await z.chat('lanjutin obrolannya', { sessionId });
+console.log(next.reply);
+
+// User endpoints:
+console.log(await z.status());
+console.log(await z.usage());
+console.log(await z.activityLogs());
+```
+
+## Connectors (Discord + Telegram)
+
+Lihat `connector/README.md`. Singkatnya:
+
+```bash
+# Discord
+npm install discord.js
+ZELAPI_KEY=… DISCORD_TOKEN=… node connector/discord.js
+
+# Telegram (zero extra deps)
+ZELAPI_KEY=… TELEGRAM_TOKEN=… node connector/telegram.js
+```
+
+Session map antar-channel disimpan di `./session/_connector-map.json` — chat di bot Discord tetap nyambung kalau sebelumnya lo udah ngobrol via CLI.
+
+## API spec ringkas
+
+| Field                | Type     | Notes                                       |
+| -------------------- | -------- | ------------------------------------------- |
+| `endpoint`           | string   | **wajib** — mis. `/ai/claila`               |
+| `model`              | string   | opsional — `opus`/`sonnet`/`haiku`          |
+| `system`             | string   | opsional — system prompt                    |
+| `messages`           | array    | **wajib** — `[{role, content, session?}]`   |
+| `messages[].session` | string   | opsional — lanjutin sesi sebelumnya         |
+
+Auth: `Authorization: Bearer zel_xxxxxxx`.
+
+Docs lengkap: <https://zelapioffciall.dpdns.org>
+
+## Env vars
+
+| Variable           | Fungsi                                       |
+| ------------------ | -------------------------------------------- |
+| `ZELAPI_KEY`       | Default API key                              |
+| `ZELAI_MODEL`      | Default model untuk connectors               |
+| `ZELAI_ENDPOINT`   | Default AI endpoint untuk connectors         |
+| `ZELAI_SYSTEM`     | Default system prompt untuk connectors       |
+| `ZELAI_DEBUG`      | Print stack trace kalau error                |
+| `DISCORD_TOKEN`    | Token bot Discord                            |
+| `DISCORD_PREFIX`   | Prefix command Discord (default `!zelai`)    |
+| `TELEGRAM_TOKEN`   | Token bot Telegram                           |
+| `TELEGRAM_ALLOW`   | Comma-separated chat/user IDs (whitelist)    |
+
+## License
+
+MIT © Zelapi

package/bin/zelai.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Zelai CLI — Entry point
+ * Official command-line client for the Zelapi Agent API.
+ */
+'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);
+  process.stderr.write(`${tag} ${msg}\n`);
+  if (process.env.ZELAI_DEBUG && err && err.stack) {
+    process.stderr.write(err.stack + '\n');
+  }
+  process.exit(1);
+});

package/connector/README.md

@@ -0,0 +1,51 @@
+# Zelai Connectors
+
+Connector ini bikin Zelai bisa nongol di luar terminal — jadi bot beneran di Discord & Telegram. Semua connector pake SDK yang sama (`require('zelai')` / `require('../src')`), session disimpan di folder `./session` yang sama, jadi `/sessions` di CLI bakal kelihatan juga sesi dari bot.
+
+## Discord
+
+```bash
+npm install discord.js
+export ZELAPI_KEY=zel_xxxxxxxx
+export DISCORD_TOKEN=...
+# optional
+export DISCORD_PREFIX="!zelai"
+export ZELAI_MODEL=haiku
+
+node connector/discord.js
+```
+
+Bot bakal respons kalau:
+- Di-mention (`@YourBot`)
+- Pesan diawali prefix (default `!zelai`)
+- DM langsung ke bot
+
+Slash command yang di-support: `/help`, `/status`, `/usage`, `/activity`, `/new`, `/model`.
+
+Bot intents yang dibutuhin di Discord Developer Portal:
+- `MESSAGE CONTENT INTENT` ✅
+- `SERVER MEMBERS INTENT` (opsional)
+
+## Telegram
+
+```bash
+export ZELAPI_KEY=zel_xxxxxxxx
+export TELEGRAM_TOKEN=123456:ABC...
+# optional — whitelist chat / user IDs (koma)
+export TELEGRAM_ALLOW="123456789,987654321"
+
+node connector/telegram.js
+```
+
+Telegram connector pake **HTTP long polling** langsung — gak butuh dependency tambahan, cuma `axios` (yang udah ada). Cocok buat self-host di VPS.
+
+Di group, bot cuma respons kalau:
+- Di-mention (`@your_bot`)
+- Reply ke pesan bot
+- Pesan diawali `/`
+
+Di DM, semua pesan diproses.
+
+## Bagaimana session bekerja?
+
+Tiap channel/DM punya **session key**, di-mapping ke session ID Zelapi di file `./session/_connector-map.json`. Begitu user balasan dari bot, server udah inget context-nya — Discord dan Telegram dapet experience yang persistent. Reset pakai `/new`.

package/connector/discord.js

@@ -0,0 +1,155 @@
+/**
+ * Zelai — Discord connector.
+ *
+ *   ENV:
+ *     ZELAPI_KEY          API key Zelai
+ *     DISCORD_TOKEN       Discord bot token
+ *     DISCORD_PREFIX      (opsional) prefix selain mention. Default: "!zelai"
+ *     ZELAI_MODEL         (opsional) opus|sonnet|haiku
+ *     ZELAI_ENDPOINT      (opsional) default /ai/claila
+ *
+ *   Run:
+ *     node connector/discord.js
+ *
+ *   Bot harus punya intents: Guilds, GuildMessages, MessageContent, DirectMessages.
+ */
+'use strict';
+
+const ui = require('../src/ui');
+const { makeSdk, handleSlash, runChat, logBanner } = require('./shared');
+
+const PREFIX = process.env.DISCORD_PREFIX || '!zelai';
+
+function requireDiscord() {
+  try {
+    return require('discord.js');
+  } catch {
+    console.log(ui.errorTag() + ' module `discord.js` belum ke-install. Jalanin:');
+    console.log('  ' + ui.chalk.cyan('npm install discord.js'));
+    process.exit(1);
+  }
+}
+
+function shouldHandle(client, message) {
+  if (message.author.bot) return false;
+
+  // DM → selalu handle
+  if (!message.guild) return true;
+
+  // Mention bot → handle
+  if (client.user && message.mentions && message.mentions.has(client.user)) return true;
+
+  // Prefix → handle
+  if (message.content && message.content.startsWith(PREFIX)) return true;
+
+  return false;
+}
+
+function stripTrigger(client, message) {
+  let text = message.content || '';
+  if (client.user) {
+    const re = new RegExp(`<@!?${client.user.id}>`, 'g');
+    text = text.replace(re, '');
+  }
+  if (text.startsWith(PREFIX)) text = text.slice(PREFIX.length);
+  return text.trim();
+}
+
+function channelKeyFor(message) {
+  if (message.guild) {
+    return `discord:guild:${message.guild.id}:channel:${message.channelId}`;
+  }
+  return `discord:dm:${message.author.id}`;
+}
+
+async function main() {
+  const token = process.env.DISCORD_TOKEN;
+  if (!token) {
+    console.log(ui.errorTag() + ' DISCORD_TOKEN env wajib di-set.');
+    process.exit(1);
+  }
+  const sdk = makeSdk();
+  logBanner('discord');
+
+  const Discord = requireDiscord();
+  const { Client, GatewayIntentBits, Partials, Events } = Discord;
+
+  const client = new Client({
+    intents: [
+      GatewayIntentBits.Guilds,
+      GatewayIntentBits.GuildMessages,
+      GatewayIntentBits.MessageContent,
+      GatewayIntentBits.DirectMessages,
+    ],
+    partials: [Partials.Channel, Partials.Message],
+  });
+
+  client.once(Events.ClientReady, (c) => {
+    console.log(`${ui.okTag()} login as ${ui.chalk.cyan.bold(c.user.tag)}`);
+    console.log(`${ui.infoTag()} mention bot atau pakai prefix ${ui.chalk.yellow(PREFIX)} buat ngobrol.`);
+  });
+
+  client.on(Events.MessageCreate, async (message) => {
+    try {
+      if (!shouldHandle(client, message)) return;
+
+      const text = stripTrigger(client, message);
+      if (!text) {
+        await message.reply('halo! ketik pesan kamu setelah mention atau prefix. `/help` buat lihat command.');
+        return;
+      }
+
+      const channelKey = channelKeyFor(message);
+
+      // Typing indicator (best effort)
+      try { message.channel.sendTyping && message.channel.sendTyping(); } catch {}
+
+      const slash = await handleSlash(sdk, channelKey, text).catch((err) => {
+        return { handled: true, text: '❌ ' + (err.message || 'error') };
+      });
+      if (slash.handled) {
+        await safeReply(message, slash.text);
+        return;
+      }
+
+      const reply = await runChat(sdk, channelKey, text);
+      await safeReply(message, reply);
+    } catch (err) {
+      try { await message.reply('❌ error: ' + (err.message || err)); } catch {}
+    }
+  });
+
+  await client.login(token);
+}
+
+async function safeReply(message, text) {
+  if (!text) text = '(empty)';
+  // Discord max message length = 2000. Split kalau panjang.
+  const MAX = 1900;
+  if (text.length <= MAX) {
+    await message.reply(text);
+    return;
+  }
+  const chunks = [];
+  let buf = text;
+  while (buf.length > MAX) {
+    let cut = buf.lastIndexOf('\n', MAX);
+    if (cut < MAX / 2) cut = MAX;
+    chunks.push(buf.slice(0, cut));
+    buf = buf.slice(cut);
+  }
+  chunks.push(buf);
+  for (let i = 0; i < chunks.length; i++) {
+    if (i === 0) await message.reply(chunks[i]);
+    else await message.channel.send(chunks[i]);
+  }
+}
+
+if (require.main === module) {
+  main().catch((err) => {
+    console.log(ui.errorTag() + ' ' + (err.message || err));
+    process.exit(1);
+  });
+}
+
+module.exports = { main };

package/connector/shared.js

@@ -0,0 +1,189 @@
+/**
+ * Helpers yang dipakai bareng sama Discord & Telegram connector.
+ * Tiap platform punya state per-channel/per-user, jadi kita mapping channelKey → session id.
+ */
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const { Zelai } = require('../src');
+const session = require('../src/session');
+const ui = require('../src/ui');
+
+const STATE_FILE = path.join(session.sessionDir(), '_connector-map.json');
+
+function loadMap() {
+  if (!fs.existsSync(STATE_FILE)) return {};
+  try {
+    return JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+function saveMap(map) {
+  session.ensureDir();
+  fs.writeFileSync(STATE_FILE, JSON.stringify(map, null, 2));
+}
+
+function getSessionFor(channelKey) {
+  const map = loadMap();
+  return map[channelKey] || null;
+}
+
+function setSessionFor(channelKey, sessionId) {
+  const map = loadMap();
+  map[channelKey] = sessionId;
+  saveMap(map);
+}
+
+function resetSessionFor(channelKey) {
+  const map = loadMap();
+  delete map[channelKey];
+  saveMap(map);
+}
+
+function makeSdk(opts = {}) {
+  const apiKey = opts.apiKey || process.env.ZELAPI_KEY;
+  if (!apiKey) {
+    throw new Error('ZELAPI_KEY env wajib di-set buat connector.');
+  }
+  return new Zelai({
+    apiKey,
+    model: opts.model || process.env.ZELAI_MODEL || 'haiku',
+    endpoint: opts.endpoint || process.env.ZELAI_ENDPOINT || '/ai/claila',
+    system: opts.system || process.env.ZELAI_SYSTEM
+      || 'You are Zelai, a helpful assistant. Reply in the same language as the user. Keep replies concise for chat.',
+  });
+}
+
+/**
+ * Universal command handler — dipakai sebelum kita kirim ke LLM.
+ * Return { handled: true, text } kalau command direspons, else { handled: false }.
+ *
+ * Pendekatan: setiap connector kirim msg ke handler ini dulu. Kalau handled,
+ * platform tinggal kirim teksnya. Kalau gak, terus ke runChat().
+ */
+async function handleSlash(sdk, channelKey, raw) {
+  const text = (raw || '').trim();
+  if (!text.startsWith('/')) return { handled: false };
+
+  const space = text.indexOf(' ');
+  const name = (space === -1 ? text : text.slice(0, space)).toLowerCase();
+  const args = space === -1 ? '' : text.slice(space + 1).trim();
+
+  if (name === '/help' || name === '/?') {
+    return {
+      handled: true,
+      text:
+        '**Zelai Bot — slash commands**\n' +
+        '`/status` cek status server\n' +
+        '`/usage` cek pemakaian API key\n' +
+        '`/activity` activity logs terakhir\n' +
+        '`/new` mulai sesi baru di channel ini\n' +
+        '`/model opus|sonnet|haiku` ganti model\n' +
+        '`/help` tampilin pesan ini',
+    };
+  }
+
+  if (name === '/status') {
+    const data = await sdk.status();
+    const root = (data && data.data) || data || {};
+    const fields = ['status', 'state', 'uptime', 'version', 'region'];
+    const lines = ['**Server status**'];
+    let found = 0;
+    for (const k of fields) {
+      if (root[k] !== undefined) { lines.push(`• \`${k}\`: ${root[k]}`); found++; }
+    }
+    if (!found) lines.push('```json\n' + JSON.stringify(root, null, 2).slice(0, 1500) + '\n```');
+    return { handled: true, text: lines.join('\n') };
+  }
+
+  if (name === '/usage' || name === '/quota') {
+    try {
+      const data = await sdk.usage();
+      return { handled: true, text: '**Usage**\n```json\n' + JSON.stringify(data, null, 2).slice(0, 1500) + '\n```' };
+    } catch (err) {
+      if (err && err.name === 'LimitExceededError') {
+        return { handled: true, text: '⚠️ **Limit habis** — kuota API key kamu udah penuh.' };
+      }
+      throw err;
+    }
+  }
+
+  if (name === '/activity' || name === '/logs') {
+    const data = await sdk.activityLogs();
+    return { handled: true, text: '**Activity logs**\n```json\n' + JSON.stringify(data, null, 2).slice(0, 1500) + '\n```' };
+  }
+
+  if (name === '/new' || name === '/reset') {
+    resetSessionFor(channelKey);
+    return { handled: true, text: '🧹 sesi di-reset buat channel ini.' };
+  }
+
+  if (name === '/model') {
+    const next = args.toLowerCase();
+    if (!['opus', 'sonnet', 'haiku'].includes(next)) {
+      return { handled: true, text: 'pilih: `opus`, `sonnet`, atau `haiku`.' };
+    }
+    sdk.config.model = next;
+    return { handled: true, text: `✅ model diganti ke \`${next}\` buat sesi runtime ini.` };
+  }
+
+  return { handled: true, text: `command \`${name}\` belum dikenal — coba \`/help\`.` };
+}
+
+/**
+ * Jalanin chat AI buat satu pesan dari platform.
+ *   sdk         : Zelai SDK instance
+ *   channelKey  : unique key per channel/DM (e.g. "discord:guild:123:user:456")
+ *   userText    : pesan dari user
+ */
+async function runChat(sdk, channelKey, userText) {
+  const sessionId = getSessionFor(channelKey);
+
+  let res;
+  try {
+    res = await sdk.chat(userText, { sessionId });
+  } catch (err) {
+    if (err && err.name === 'LimitExceededError') {
+      return '⚠️ **Limit habis** — kuota API key kamu udah penuh. Upgrade di https://zelapioffciall.dpdns.org/pricing';
+    }
+    throw err;
+  }
+
+  if (res.sessionId && res.sessionId !== sessionId) {
+    setSessionFor(channelKey, res.sessionId);
+  }
+
+  // Persist ke folder ./session juga biar kelihatan di `zelai sessions`.
+  const sid = res.sessionId || sessionId || session.localId();
+  try {
+    session.append(sid, { role: 'user', content: userText }, {
+      model: sdk.config.model, endpoint: sdk.config.endpoint, system: sdk.config.system,
+    });
+    session.append(sid, { role: 'assistant', content: res.reply || '' });
+    if (!getSessionFor(channelKey)) setSessionFor(channelKey, sid);
+  } catch {
+    // best-effort — kalau gagal nulis disk, tetap reply
+  }
+
+  return res.reply || '(gak ada balasan)';
+}
+
+function logBanner(name) {
+  console.log(ui.banner());
+  console.log(ui.chalk.gray('  connector: ') + ui.chalk.cyan.bold(name));
+  console.log('');
+}
+
+module.exports = {
+  makeSdk,
+  handleSlash,
+  runChat,
+  getSessionFor,
+  setSessionFor,
+  resetSessionFor,
+  logBanner,
+};