@chispear/vibekit 0.1.0 → 0.1.1

package/README.md

@@ -15,11 +15,13 @@
 ## Instalasi
 
 ```bash
-npm install -g vibekit      # npm
-pnpm add -g vibekit         # pnpm
-npx vibekit ask "halo"      # tanpa install, langsung coba
+npm install -g @chispear/vibekit      # npm
+pnpm add -g @chispear/vibekit         # pnpm
+npx @chispear/vibekit ask "halo"      # tanpa install, langsung coba
 ```
 
+Setelah install global, perintahnya tetap `vibekit` (nama package-nya saja yang scoped).
+
 Butuh Node.js >= 18.
 
 ## Mulai Cepat
@@ -34,7 +36,7 @@ Perintah ini membuat `~/.vibekit/config.json`:
 {
   "providers": [
     { "nama": "gpt",      "baseUrl": "https://api.openai.com/v1",                              "apiKey": "", "model": "gpt-4o-mini",     "anggaranHarian": 500000, "jedaCooldownMenit": 15 },
-    { "nama": "gemini",   "baseUrl": "https://generativelanguage.googleapis.com/v1beta/openai/", "apiKey": "", "model": "gemini-2.5-flash", "jedaCooldownMenit": 15 },
+    { "nama": "gemini",   "baseUrl": "https://generativelanguage.googleapis.com/v1beta/openai/", "apiKey": "", "model": "gemini-3.8-flash", "jedaCooldownMenit": 15 },
     { "nama": "deepseek", "baseUrl": "https://api.deepseek.com/v1",                            "apiKey": "", "model": "deepseek-chat",    "jedaCooldownMenit": 15 }
   ],
   "gaya": { "jawaban": "poin-penting", "maksTokenJawaban": 800 }
@@ -68,7 +70,7 @@ vibekit status
 
 1. Sebelum memanggil, router memeriksa state lokal (`~/.vibekit/state.json`): penyedia yang masih **cooldown** atau sudah mencapai **anggaran harian** dilewati tanpa dipanggil.
 2. Saat memanggil, permintaan berisi system prompt hemat sesuai `gaya.jawaban` dan `max_tokens` = `gaya.maksTokenJawaban`. Objek `extraBody` per penyedia (bila ada) digabung ke body — berguna untuk kenop khas model, mis. menekan penalaran.
-3. Bila respons menandakan kuota habis — HTTP **429/402** atau pola error `insufficient_quota` / `RESOURCE_EXHAUSTED` / saldo — penyedia ditandai **cooldown sampai akhir hari lokal** dan permintaan yang sama diulangi ke penyedia berikutnya. Rate-limit singkat (429 tanpa pola kuota) → cooldown `jedaCooldownMenit` (bawaan 15 menit).
+3. Bila respons menandakan kuota habis — HTTP **429/402** atau pola error `insufficient_quota` / `RESOURCE_EXHAUSTED` / saldo — penyedia ditandai **cooldown sampai akhir hari lokal** dan permintaan yang sama diulangi ke penyedia berikutnya. Rate-limit singkat (429 tanpa pola kuota) → cooldown `jedaCooldownMenit` (bawaan 15 menit). Khusus HTTP 503 (server penyedia sedang sibuk/penuh sesaat), penyedia yang sama dicoba ulang dulu sampai 2 kali dengan jeda 3 dan 8 detik, dan 503 tidak memicu cooldown.
 4. Error lain (401 kunci salah, 400, jaringan) **tidak** dianggap kuota habis: dicatat apa adanya dan router tetap mencoba penyedia berikutnya.
 5. Token terpakai dicatat dari field `usage` respons (atau estimasi tokenizer bila tidak ada). Bila semua penyedia gagal/habis, Anda menerima ringkasan status tiap penyedia dan jam paling awal untuk mencoba lagi.
 
@@ -91,7 +93,7 @@ Keputusan repo: `dist/` masuk `.gitignore` dan dibangun saat publish (`prepublis
 
 ## Status Nama di npm
 
-Nama paket **`vibekit` di npm sudah terpakai** oleh proyek lain (per Oktober 2026). Sebelum publish, nama perlu diganti — mis. scoped package `@username/vibekit` atau nama turunan — keputusan ada pada pemilik repo. Nama perintah CLI tetap `vibekit`.
+Package ini terbit di npm sebagai **`@chispear/vibekit`** (v0.1.0, 25 Oktober 2026) karena nama tak-scoped `vibekit` sudah dipakai proyek lain. Nama perintah CLI tetap `vibekit`.
 
 ## Lisensi
 

package/dist/config.js

@@ -34,7 +34,7 @@ export const TEMPLATE_CONFIG = {
             nama: "gemini",
             baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai/",
             apiKey: "",
-            model: "gemini-2.5-flash",
+            model: "gemini-3.8-flash",
             jedaCooldownMenit: 15,
         },
         {

package/dist/router.js

@@ -12,6 +12,9 @@ export function klasifikasiError(status, bodyTeks) {
     if (status === 429) {
         return { jenis: "rate-limit", ringkas: `terkena rate-limit (HTTP 429) ${potongan}`.trim() };
     }
+    if (status === 503) {
+        return { jenis: "lainnya", ringkas: `server penyedia sedang sibuk/penuh (HTTP 503) ${potongan}`.trim() };
+    }
     return { jenis: "lainnya", ringkas: `HTTP ${status} ${potongan}`.trim() };
 }
 /**
@@ -20,12 +23,17 @@ export function klasifikasiError(status, bodyTeks) {
  * - Kuota habis (429/402/pola kuota) → cooldown sampai akhir hari lokal, lalu permintaan
  *   yang sama diulangi ke penyedia berikutnya secara transparan.
  * - Rate-limit singkat → cooldown jedaCooldownMenit (bawaan 15).
+ * - HTTP 503 (server penyedia sibuk sesaat) → penyedia yang sama dicoba ulang sampai
+ *   2 kali dengan jeda (3 dtk, 8 dtk) sebelum menyerah ke penyedia berikutnya;
+ *   503 tidak memicu cooldown.
  * - Error lain (401, 400, jaringan) tidak dianggap kuota habis; dicatat dan lanjut ke berikutnya.
  */
 export async function tanyaRouter(opsi) {
     const fetchImpl = opsi.fetchImpl ?? fetch;
     const sekarang = opsi.sekarang ?? new Date();
     const timeoutMs = opsi.timeoutMs ?? 90_000;
+    const jedaRetry503 = opsi.jedaRetry503Ms ?? [3000, 8000];
+    const tunggu = opsi.tungguImpl ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
     const state = muatState(opsi.lokasiState);
     const catatan = [];
     const system = { role: "system", content: systemPromptHemat(opsi.config.gaya) };
@@ -80,32 +88,49 @@ export async function tanyaRouter(opsi) {
             ...(provider.extraBody ?? {}),
         };
         let respons;
-        try {
-            const kontroler = new AbortController();
-            const pengatur = setTimeout(() => kontroler.abort(), timeoutMs);
+        let teks = "";
+        let gagalJaringan = null;
+        let percobaan503 = 0;
+        for (;;) {
             try {
-                respons = await fetchImpl(url, {
-                    method: "POST",
-                    headers: {
-                        "Content-Type": "application/json",
-                        Authorization: `Bearer ${apiKey}`,
-                    },
-                    body: JSON.stringify(body),
-                    signal: kontroler.signal,
-                });
+                const kontroler = new AbortController();
+                const pengatur = setTimeout(() => kontroler.abort(), timeoutMs);
+                try {
+                    respons = await fetchImpl(url, {
+                        method: "POST",
+                        headers: {
+                            "Content-Type": "application/json",
+                            Authorization: `Bearer ${apiKey}`,
+                        },
+                        body: JSON.stringify(body),
+                        signal: kontroler.signal,
+                    });
+                }
+                finally {
+                    clearTimeout(pengatur);
+                }
+            }
+            catch (e) {
+                gagalJaringan = `gagal jaringan: ${e.message}`;
+                break;
             }
-            finally {
-                clearTimeout(pengatur);
+            teks = await respons.text();
+            // 503 = server penyedia sedang penuh sesaat: coba ulang penyedia yang sama
+            // dengan jeda sebelum menyerah ke penyedia berikutnya.
+            if (respons.status === 503 && percobaan503 < jedaRetry503.length) {
+                await tunggu(jedaRetry503[percobaan503]);
+                percobaan503++;
+                continue;
             }
+            break;
         }
-        catch (e) {
-            const alasan = `gagal jaringan: ${e.message}`;
+        if (gagalJaringan !== null || !respons) {
+            const alasan = gagalJaringan ?? "gagal jaringan";
             entri.alasanTerakhir = alasan;
             simpanState(opsi.lokasiState, state);
             catatan.push({ nama: provider.nama, model: provider.model, status: "gagal", alasan });
             continue;
         }
-        const teks = await respons.text();
         if (!respons.ok) {
             const { jenis, ringkas } = klasifikasiError(respons.status, teks);
             entri.alasanTerakhir = ringkas;

package/examples/vibekit.config.json

@@ -1 +1 @@
-{"gaya":{"jawaban":"poin-penting","maksTokenJawaban":800},"providers":[{"anggaranHarian":500000,"apiKey":"","baseUrl":"https://api.openai.com/v1","jedaCooldownMenit":15,"model":"gpt-4o-mini","nama":"gpt"},{"apiKey":"env:GEMINI_API_KEY","baseUrl":"https://generativelanguage.googleapis.com/v1beta/openai/","jedaCooldownMenit":15,"model":"gemini-2.5-flash","nama":"gemini"},{"apiKey":"env:DEEPSEEK_API_KEY","baseUrl":"https://api.deepseek.com/v1","extraBody":{},"jedaCooldownMenit":15,"model":"deepseek-chat","nama":"deepseek"},{"apiKey":"env:OPENROUTER_API_KEY","baseUrl":"https://openrouter.ai/api/v1","model":"openai/gpt-4o-mini","nama":"openrouter"},{"apiKey":"ollama","baseUrl":"http://localhost:11434/v1","model":"llama3.1","nama":"ollama-lokal"}]}
+{"gaya":{"jawaban":"poin-penting","maksTokenJawaban":800},"providers":[{"anggaranHarian":500000,"apiKey":"","baseUrl":"https://api.openai.com/v1","jedaCooldownMenit":15,"model":"gpt-4o-mini","nama":"gpt"},{"apiKey":"env:GEMINI_API_KEY","baseUrl":"https://generativelanguage.googleapis.com/v1beta/openai/","jedaCooldownMenit":15,"model":"gemini-3.8-flash","nama":"gemini"},{"apiKey":"env:DEEPSEEK_API_KEY","baseUrl":"https://api.deepseek.com/v1","extraBody":{},"jedaCooldownMenit":15,"model":"deepseek-chat","nama":"deepseek"},{"apiKey":"env:OPENROUTER_API_KEY","baseUrl":"https://openrouter.ai/api/v1","model":"openai/gpt-4o-mini","nama":"openrouter"},{"apiKey":"ollama","baseUrl":"http://localhost:11434/v1","model":"llama3.1","nama":"ollama-lokal"}]}

package/package.json

@@ -28,7 +28,7 @@
     "test": "npm run build && node --test test/*.test.mjs"
   },
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "publishConfig": {
     "access": "public"
   }