kiosapi 0.1.0 → 0.1.2

package/dist/api.js

@@ -21,6 +21,31 @@ export async function fetchModels() {
     const body = (await res.json());
     return body.data ?? [];
 }
+/** Latest published version of the CLI on npm (best-effort; null on failure/offline). */
+export async function fetchLatestVersion(timeoutMs = 2500) {
+    try {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+        const res = await fetch('https://registry.npmjs.org/kiosapi/latest', { signal: ctrl.signal });
+        clearTimeout(timer);
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        return body.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Best-effort: does a model support tool calling? Defaults to true if unknown/offline. */
+export async function modelSupportsTools(id) {
+    try {
+        return (await fetchModels()).find((m) => m.id === id)?.tools !== false;
+    }
+    catch {
+        return true;
+    }
+}
 /** Pick the model to use: explicit flag → configured default → first free text model. */
 export async function resolveModel(flag) {
     if (flag)

package/dist/commands.js

@@ -5,9 +5,10 @@ import { createInterface } from 'node:readline/promises';
 import { parseArgs } from 'node:util';
 import { runAgent } from './agent/run.js';
 import { runTeam } from './agent/team.js';
-import { createTopup, fetchBytesAuthed, fetchModels, fetchPemakaian, fetchSaldo, generateImage, pollJob, resolveMediaModel, resolveModel, streamChat, streamVision, submitVideo, } from './api.js';
+import { createTopup, fetchBytesAuthed, fetchLatestVersion, fetchModels, fetchPemakaian, fetchSaldo, generateImage, modelSupportsTools, pollJob, resolveMediaModel, resolveModel, streamChat, streamVision, submitVideo, } from './api.js';
 import { clearKey, fileConfig, loadConfig, saveConfig } from './config.js';
-import { bold, cyan, dim, green, idn, promptHidden, readStdin, red, rupiah, sleep, thinking, yellow, } from './ui.js';
+import { VERSION } from './help.js';
+import { bold, cyan, dim, green, idn, prompt, promptHidden, readStdin, red, rupiah, sleep, thinking, yellow, } from './ui.js';
 const IMAGE_MIME = {
     '.png': 'image/png',
     '.jpg': 'image/jpeg',
@@ -48,19 +49,77 @@ export async function cmdPeriksa() {
     catch {
         console.log(red('tidak terhubung'));
     }
+    const latest = await fetchLatestVersion();
+    const upd = latest && isNewerVersion(latest, VERSION)
+        ? yellow(`  → versi ${latest} tersedia (kiosapi perbarui)`)
+        : latest
+            ? green('  ✓ terbaru')
+            : '';
+    console.log(`  Versi        : ${VERSION}${upd}`);
 }
-/** model — list available models (optionally filtered). */
+/** Compare two dotted versions; true if `latest` is strictly newer than `current`. */
+function isNewerVersion(latest, current) {
+    const a = latest.split('.').map((n) => Number(n) || 0);
+    const b = current.split('.').map((n) => Number(n) || 0);
+    for (let i = 0; i < 3; i++) {
+        if ((a[i] ?? 0) !== (b[i] ?? 0))
+            return (a[i] ?? 0) > (b[i] ?? 0);
+    }
+    return false;
+}
+/** perbarui — update the CLI to the latest npm version (or print the manual command). */
+export async function cmdPerbarui() {
+    const latest = await fetchLatestVersion();
+    if (!latest) {
+        console.log(dim('Tak bisa cek versi terbaru (offline?).'));
+        console.log(`Update manual: ${cyan('npm i -g kiosapi@latest')}`);
+        return;
+    }
+    if (!isNewerVersion(latest, VERSION)) {
+        console.log(green(`✓ Sudah versi terbaru (${VERSION}).`));
+        return;
+    }
+    console.log(`Versi baru ${green(latest)} (sekarang ${VERSION}). Memperbarui…`);
+    const res = spawnSync('npm', ['i', '-g', `kiosapi@${latest}`], {
+        stdio: 'inherit',
+        shell: process.platform === 'win32',
+    });
+    if (res.status === 0) {
+        console.log(green(`✓ Terpasang kiosapi ${latest}.`));
+    }
+    else {
+        console.log(yellow('Gagal update otomatis. Jalankan manual:'));
+        console.log(`  ${cyan('npm i -g kiosapi@latest')}`);
+    }
+}
+/** Once-a-day best-effort "versi baru tersedia" nudge (TTY only; cached in config). */
+export async function maybeNotifyUpdate() {
+    if (!process.stdout.isTTY)
+        return;
+    const cfg = fileConfig();
+    const now = Date.now();
+    const DAY = 24 * 3_600_000;
+    let latest = cfg.latestVersion;
+    if (!cfg.updateCheckedAt || now - cfg.updateCheckedAt > DAY) {
+        latest = (await fetchLatestVersion(1500)) ?? undefined;
+        saveConfig({ updateCheckedAt: now, latestVersion: latest });
+    }
+    if (latest && isNewerVersion(latest, VERSION)) {
+        console.log(yellow(`Versi baru kiosapi ${latest} tersedia (sekarang ${VERSION}). Jalankan: kiosapi perbarui`));
+    }
+}
+/** model — list available models. `--cari q` filters; `--tools` shows only tool-capable models. */
 export async function cmdModel(args) {
     const { values } = parseArgs({
         args,
-        options: { cari: { type: 'string', short: 'c' } },
+        options: { cari: { type: 'string', short: 'c' }, tools: { type: 'boolean' } },
         allowPositionals: true,
     });
     const q = (values.cari ?? '').toLowerCase();
     const models = await fetchModels();
-    const rows = q
-        ? models.filter((m) => m.id.toLowerCase().includes(q) || (m.provider ?? '').toLowerCase().includes(q))
-        : models;
+    const rows = models
+        .filter((m) => !values.tools || m.tools)
+        .filter((m) => !q || m.id.toLowerCase().includes(q) || (m.provider ?? '').toLowerCase().includes(q));
     if (rows.length === 0) {
         console.log(dim('Tidak ada model yang cocok.'));
         return;
@@ -69,9 +128,16 @@ export async function cmdModel(args) {
     for (const m of rows) {
         const tier = (m.tier ?? '').padEnd(5);
         const kind = (m.kind ?? 'text').padEnd(5);
-        console.log(`${m.id.padEnd(width)}  ${dim(tier)} ${kind} ${dim(m.provider ?? '')}`);
+        const wrench = m.tools ? '🔧' : '  ';
+        console.log(`${wrench} ${m.id.padEnd(width)}  ${dim(tier)} ${kind} ${dim(m.provider ?? '')}`);
+    }
+    console.log(dim(`\n${rows.length} model. 🔧 = mendukung tool calling (untuk agen).`));
+}
+/** Warn (best-effort) if the chosen model likely can't drive the agent's tools. */
+export async function warnIfNoTools(model) {
+    if (!(await modelSupportsTools(model))) {
+        console.error(yellow(`⚠ Model "${model}" mungkin tak mendukung tool calling — agen bisa tak bekerja. Pilih model 🔧 (lihat: kiosapi model --tools), mis. anthropic/claude-sonnet-4-6.`));
     }
-    console.log(dim(`\n${rows.length} model.`));
 }
 /** tanya — one-shot streaming question (also reads piped stdin as context). */
 export async function cmdTanya(args) {
@@ -164,23 +230,58 @@ export async function cmdNgobrol(args) {
         rl.close();
     }
 }
-/** setel — read/write persisted settings. */
-export function cmdSetel(args) {
+/**
+ * Interactive model picker: list text models (optionally filtered), choose by number. Returns the
+ * chosen id, or null if cancelled. Shared by `/model` (session) and `kiosapi setel model`.
+ */
+export async function pickModel(filter, current) {
+    const q = (filter ?? '').toLowerCase();
+    const models = (await fetchModels())
+        .filter((m) => (m.kind ?? 'text') === 'text')
+        .filter((m) => !q || m.id.toLowerCase().includes(q) || (m.provider ?? '').toLowerCase().includes(q));
+    if (models.length === 0) {
+        console.log(dim(q ? `Tidak ada model cocok "${filter}".` : 'Tidak ada model.'));
+        return null;
+    }
+    models.forEach((m, i) => {
+        const mark = m.id === current ? green('●') : ' ';
+        const wrench = m.tools ? '🔧' : '  ';
+        console.log(`  ${String(i + 1).padStart(2)}. ${mark} ${wrench} ${m.id} ${dim(m.tier ?? '')}`);
+    });
+    const ans = (await prompt('Pilih nomor (Enter = batal): ')).trim();
+    if (!ans)
+        return null;
+    const pick = models[Number(ans) - 1];
+    if (!pick) {
+        console.log(red('Nomor tidak valid.'));
+        return null;
+    }
+    return pick.id;
+}
+/** setel — read/write persisted settings. `setel model` with no value opens the picker. */
+export async function cmdSetel(args) {
     const [key, ...rest] = args;
     if (!key) {
         console.log(JSON.stringify(fileConfig(), null, 2));
         return;
     }
     const value = rest.join(' ').trim();
-    if (!value)
-        throw new Error('Beri nilai. Contoh: kiosapi setel model deepseek/deepseek-v3');
-    if (key === 'model' || key === 'model-default')
-        saveConfig({ defaultModel: value });
-    else if (key === 'base-url' || key === 'url')
+    if (key === 'model' || key === 'model-default') {
+        const chosen = value || (await pickModel(undefined, fileConfig().defaultModel));
+        if (!chosen)
+            return;
+        saveConfig({ defaultModel: chosen });
+        console.log(green(`✓ model = ${chosen}`));
+        return;
+    }
+    if (key === 'base-url' || key === 'url') {
+        if (!value)
+            throw new Error('Beri nilai. Contoh: kiosapi setel base-url https://api.kiosapi.id');
         saveConfig({ baseUrl: value });
-    else
-        throw new Error(`Kunci tidak dikenal: ${key} (gunakan: model | base-url)`);
-    console.log(green(`✓ ${key} = ${value}`));
+        console.log(green(`✓ base-url = ${value}`));
+        return;
+    }
+    throw new Error(`Kunci tidak dikenal: ${key} (gunakan: model | base-url)`);
 }
 /** Shared driver for the agent modes (rencana/edit/buat). */
 async function runAgentCommand(args, mode) {
@@ -193,6 +294,7 @@ async function runAgentCommand(args, mode) {
     if (!task)
         throw new Error('Beri tugas. Contoh: kiosapi buat "bikin REST API Express + tes"');
     const model = await resolveModel(values.model);
+    await warnIfNoTools(model);
     await runAgent(task, mode, { model, otomatis: Boolean(values.otomatis) });
 }
 /** rencana — read-only: explore the codebase and produce a plan. */
@@ -313,6 +415,7 @@ export async function cmdTim(args) {
     if (!task)
         throw new Error('Beri tugas. Contoh: kiosapi tim "bikin endpoint /health + tes"');
     const model = await resolveModel(values.model);
+    await warnIfNoTools(model);
     await runTeam(task, { model, otomatis: Boolean(values.otomatis) });
 }
 /** saldo — show own balance, bonus tokens, and month-to-date spend. */

package/dist/help.js

@@ -1,5 +1,5 @@
 import { bold, dim } from './ui.js';
-export const VERSION = '0.1.0';
+export const VERSION = '0.1.2';
 export function printVersion() {
     console.log(`kiosapi ${VERSION}`);
 }
@@ -12,8 +12,9 @@ ${bold('Penggunaan:')} kiosapi [perintah] [opsi]
 ${bold('Perintah:')}
   masuk             Simpan API key (kios_live_…)
   keluar            Hapus API key tersimpan
-  periksa           Cek konektivitas, key, & setelan
-  model [--cari q]  Daftar model yang tersedia
+  periksa           Cek konektivitas, key, versi & setelan
+  perbarui          Update CLI ke versi npm terbaru
+  model [--cari q]  Daftar model (--tools = hanya yang mendukung tool/agen; 🔧)
   tanya "…"         Tanya sekali (streaming); dukung pipe stdin
   ngobrol           Mode percakapan interaktif (REPL)
   setel <k> <v>     Atur setelan (model | base-url)

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { cmdBuat, cmdEdit, cmdGambar, cmdIsi, cmdKeluar, cmdLihat, cmdMasuk, cmdModel, cmdNgobrol, cmdPakai, cmdPeriksa, cmdRencana, cmdSaldo, cmdSambung, cmdSetel, cmdTanya, cmdTim, cmdVideo, } from './commands.js';
+import { cmdBuat, cmdEdit, cmdGambar, cmdIsi, cmdKeluar, cmdLihat, cmdMasuk, cmdModel, cmdNgobrol, cmdPakai, cmdPerbarui, cmdPeriksa, cmdRencana, cmdSaldo, cmdSambung, cmdSetel, cmdTanya, cmdTim, cmdVideo, } from './commands.js';
 import { printHelp, printVersion } from './help.js';
 import { startSession } from './session.js';
 import { red } from './ui.js';
@@ -11,6 +11,8 @@ const COMMANDS = {
     logout: cmdKeluar,
     periksa: cmdPeriksa,
     doctor: cmdPeriksa,
+    perbarui: cmdPerbarui,
+    update: cmdPerbarui,
     model: cmdModel,
     models: cmdModel,
     tanya: cmdTanya,

package/dist/session.js

@@ -2,7 +2,7 @@ import { createInterface } from 'node:readline/promises';
 import { newSession, resetSession, runTurn } from './agent/run.js';
 import { runTeam } from './agent/team.js';
 import { resolveModel } from './api.js';
-import { cmdGambar, cmdIsi, cmdLihat, cmdMasuk, cmdPakai, cmdSaldo, cmdVideo } from './commands.js';
+import { cmdGambar, cmdIsi, cmdLihat, cmdMasuk, cmdPakai, cmdSaldo, cmdVideo, maybeNotifyUpdate, pickModel, warnIfNoTools, } from './commands.js';
 import { loadConfig } from './config.js';
 import { bold, cyan, dim, green, red } from './ui.js';
 const MODES = ['rencana', 'edit', 'buat'];
@@ -24,7 +24,7 @@ function slashHelp() {
   /video <prompt>             Buat video → file
   /lihat <file> <pertanyaan>  Tanya model vision tentang gambar
   /mode [rencana|edit|buat]   Lihat/ubah mode agen
-  /model [id]                 Lihat/ubah model
+  /model [id|filter]          Pilih model (tanpa argumen = daftar bernomor)
   /otomatis                   Hidup/matikan auto-approve (lewati konfirmasi)
   /bersih                     Bersihkan riwayat percakapan
   /saldo                      Lihat saldo
@@ -64,14 +64,17 @@ async function runSlash(line, s) {
                 return false;
             }
             case 'model': {
-                const id = rest[0];
-                if (id) {
-                    s.model = id;
-                    console.log(dim(`Model: ${s.model}`));
+                const arg = rest.join(' ').trim();
+                // A full id (has "/") is set directly; otherwise open the numbered picker (filtered by arg).
+                if (arg.includes('/')) {
+                    s.model = arg;
                 }
                 else {
-                    console.log(dim(`Model: ${s.model}`));
+                    const picked = await pickModel(arg || undefined, s.model);
+                    if (picked)
+                        s.model = picked;
                 }
+                console.log(dim(`Model: ${s.model}`));
                 return false;
             }
             case 'otomatis':
@@ -131,9 +134,11 @@ export async function startSession() {
         if (!loadConfig().apiKey)
             return;
     }
+    await maybeNotifyUpdate();
     const model = await resolveModel(undefined);
     const s = newSession(model, 'buat', false);
     banner(s);
+    await warnIfNoTools(model);
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     try {
         while (true) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiosapi",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "description": "CLI Kiosapi.id berbahasa Indonesia — bangun aplikasimu pakai API key Kiosapi (agen + multimodal).",
   "keywords": [