kafox-cli 0.9.0 → 0.9.5

package/README.md

@@ -12,7 +12,7 @@ npm install -g kafox-cli
 O comando instalado e `kafox`. Alternativa sem npm:
 
 ```bash
-npm install -g https://kafox.pypag.com/static/downloads/kafox-cli-0.8.0.tgz
+npm install -g https://kafox.dev/static/downloads/kafox-cli-0.9.5.tgz
 ```
 
 Requisito: Node.js 22.5+.
@@ -24,7 +24,7 @@ kafox login
 ```
 
 O terminal vira uma tela de login (arte grande em cima, link no centro): abra a
-URL `https://kafox.pypag.com/cli?code=...`, entre na sua conta e clique em
+URL `https://kafox.dev/cli?code=...`, entre na sua conta e clique em
 **Autorizar**. A sessao fica em `~/.kafox/token.json` (permissao 600). No primeiro
 `kafox` sem sessao ele pergunta se quer entrar e abre a mesma tela.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kafox-cli",
-  "version": "0.9.0",
+  "version": "0.9.5",
   "description": "Kafox CLI: TUI com streaming, thinking, edit com diff, agent tools (files/shell), MCP e temas",
   "bin": {
     "kafox": "bin/kafox.js"

package/src/auth.js

@@ -35,7 +35,8 @@ async function login() {
     return;
   }
 
-  const url = `${storage.getApiUrl()}/cli?code=${data.user_code}`;
+  // A pagina de autorizacao fica no site, nao no host da API.
+  const url = `${storage.getWebUrl()}/cli?code=${data.user_code}`;
 
   if (process.stdout.isTTY && process.stdin.isTTY) {
     return loginWithScreen({ url, data });

package/src/gateway.js

@@ -2,6 +2,14 @@ const chalk = require("chalk");
 const storage = require("./storage");
 const { ensureSession, fetchApi } = require("./auth");
 
+/**
+ * Modelo do free tier: o nome carrega o sufixo " (free)" (ou ":free"). Esses
+ * modelos gastam a cota diaria, nao o saldo, entao funcionam com saldo zero.
+ */
+function isFreeModel(model) {
+  return /(^free$|\s\(free\)$|:free$)/i.test(String(model || "").trim());
+}
+
 /**
  * Garante sessao, saldo, modelo e chave antes de qualquer chamada.
  * A chave `kafox_live_...` e da propria conta: o gateway cobra por ela.
@@ -18,13 +26,6 @@ async function ensureReady(options = {}) {
   }
   const account = await boot.json().catch(() => null);
   const balance = Number(account?.user?.balance_micros || 0);
-  if (balance <= 0) {
-    return {
-      ok: false,
-      code: "no_balance",
-      error: "Sem saldo para responder. Recarregue em https://kafox.pypag.com/dashboard",
-    };
-  }
 
   let model = options.model || storage.getConfig().model;
   if (!model) {
@@ -35,6 +36,17 @@ async function ensureReady(options = {}) {
     if (!model) return { ok: false, error: "Could not load model catalog." };
   }
 
+  // Free tier nao desconta saldo: com a conta zerada o modelo (free) responde.
+  if (balance <= 0 && !isFreeModel(model)) {
+    return {
+      ok: false,
+      code: "no_balance",
+      error:
+        `Sem saldo para responder. Recarregue em ${storage.getWebUrl()}/dashboard ` +
+        "ou use um modelo (free): `kafox model`.",
+    };
+  }
+
   let keyCreated = false;
   let apiKey = storage.getConfig().api_key;
   if (!apiKey) {
@@ -235,7 +247,6 @@ async function attemptChat({ messages, model, tools, onDelta, onReasoning, signa
     ms: Date.now() - started,
     model: ready.model,
     keyCreated: ready.keyCreated,
-    provider: response.headers?.get?.("x-kafox-provider") || "",
   };
 }
 
@@ -307,6 +318,7 @@ module.exports = {
   askModel,
   chat,
   ensureReady,
+  isFreeModel,
   mergeToolCalls,
   backoffMs,
   RETRY_MAX,

package/src/storage.js

@@ -28,7 +28,12 @@ function writeJSON(file, data) {
 
 function getApiUrl() {
   const cfg = readJSON(CONFIG_FILE, {});
-  return cfg.api_url || process.env.KAFOX_API_URL || "https://kafox.pypag.com";
+  return cfg.api_url || process.env.KAFOX_API_URL || "https://backend.kafox.dev";
+}
+
+/** Endereco do site (painel, login, documentacao) — a API mora em outro host. */
+function getWebUrl() {
+  return process.env.KAFOX_WEB_URL || "https://kafox.dev";
 }
 
 function getToken() {
@@ -87,6 +92,6 @@ function parseCookies(headers) {
 module.exports = {
   DIR, TOKEN_FILE, CONFIG_FILE,
   ensureDir, readJSON, writeJSON,
-  getApiUrl, getToken, setToken, clearToken,
+  getApiUrl, getWebUrl, getToken, setToken, clearToken,
   getConfig, setConfig, getAuthHeaders, parseCookies,
 };

package/src/tui.js

@@ -817,10 +817,10 @@ function messageLines(state, width) {
     } else if (message.role === "assistant") {
       lines.push("");
       lines.push(...markdownLines(message.text, width - 2, state.theme));
+      // Só latência: a rota usada por trás é da Kafox, não do cliente.
       const meta = [];
       if (message.interrupted) meta.push("interrompido");
       if (message.ms) meta.push(`${(message.ms / 1000).toFixed(1)}s`);
-      if (message.provider) meta.push(message.provider);
       if (meta.length) lines.push("");
       if (meta.length) lines.push(indent(2) + chalk.dim(meta.join(" · ")));
     } else if (message.role === "thinking") {
@@ -975,9 +975,6 @@ function modelLine(state, width) {
   let label = `${model} · kafox v${state.version}`;
   if (state.escArmed) {
     label = `${model} · Esc de novo para parar`;
-  } else if (state.retry) {
-    const left = Math.max(1, Math.ceil(((state.retry.endsAt || 0) - Date.now()) / 1000));
-    label = `${model} · reconectando em ${left}s (tentativa ${state.retry.attempt}/${state.retry.maxAttempts})`;
   }
   return paintPanel(
     state.theme,
@@ -994,14 +991,8 @@ function inputBlock(state, width, { hero = false, tight = false } = {}) {
   const shown = state.input.slice(start, start + available);
 
   const prompt = chalk.cyan("▌ ");
-  let body;
-  if (state.input) {
-    body = prompt + shown;
-  } else {
-    // Enquanto a IA trabalha os pontinhos correm; parada, a caixa fica limpa.
-    const placeholder = state.busy ? `trabalhando${".".repeat(state.frame % 4)}` : "";
-    body = prompt + chalk.dim(truncate(placeholder, available));
-  }
+  // A caixa fica sempre limpa: o "trabalhando" ja aparece na conversa, acima.
+  const body = state.input ? prompt + shown : prompt;
 
   const lines = [
     rule(state, width),
@@ -1029,16 +1020,27 @@ function statusLines(state, width, { bare = false } = {}) {
   return [left + gap + right];
 }
 
+/**
+ * Linha de status do rodape. A lista fixa de atalhos saiu: agora o espaco e
+ * usado para avisar problema de conexao (em vermelho) e posicao da rolagem.
+ */
 function hintsLines(state, width, { bare = false } = {}) {
   if (bare) return [];
-  const parts = [];
-  if (state.scroll > 0) parts.push(`↑ ${state.scroll} linhas`);
-  if (state.busy) parts.push("Enter enfileira · Esc 2× para parar");
-  parts.push("PgUp/PgDn rola");
-  parts.push("Ctrl+Y copia");
-  parts.push(`F2 ${state.mouse ? "seleção" : "mouse"}`);
-  parts.push("/ comandos");
-  return [chalk.dim(truncate(parts.join("  ·  "), width))];
+
+  if (state.retry) {
+    const left = Math.max(1, Math.ceil(((state.retry.endsAt || 0) - Date.now()) / 1000));
+    const attempt = state.retry.maxAttempts
+      ? ` (tentativa ${state.retry.attempt}/${state.retry.maxAttempts})`
+      : "";
+    const label = truncate(`⚠ ${state.retry.error || "fetch failed"} · reconectando em ${left}s${attempt}`, width);
+    return [chalk.red(label)];
+  }
+
+  if (state.scroll > 0) {
+    return [chalk.dim(truncate(`↑ ${state.scroll} linhas`, width))];
+  }
+
+  return [];
 }
 
 /* ------------------------------------------------------------------ overlay */
@@ -1466,7 +1468,12 @@ async function runTUI({
     const rows = Math.max(14, stdout.rows || 24);
     const frame = buildFrame(state, cols, rows, commands);
     const grid = wallpaperGrid(cols, rows);
-    if (grid) frame.lines = wallpaper.paint(frame.lines, grid);
+    if (grid) {
+      // A tela inteira vem pintada com o bg do tema; so essa cor e tratada como
+      // area livre para a foto. Paineis e caixas (outra cor) continuam solidos.
+      const base = wallpaper.hexToRgb(themeColors(state.theme).bg);
+      frame.lines = wallpaper.paint(frame.lines, grid, { base });
+    }
     paintFrame(frame, { cols, rows });
   }
 
@@ -1477,17 +1484,18 @@ async function runTUI({
   function wallpaperGrid(cols, rows) {
     const bg = state.wallpaper;
     if (!bg?.image) return null;
-    if (!bg.grid || bg.cols !== cols || bg.rows !== rows) {
+    if (!bg.grid || bg.cols !== cols || bg.rows !== rows || bg.theme !== state.theme) {
       const base = wallpaper.hexToRgb(themeColors(state.theme).bg) || [12, 12, 16];
       bg.grid = wallpaper.buildGrid(bg.image, cols, rows, { dim: 0.45, base });
       bg.cols = cols;
       bg.rows = rows;
+      bg.theme = state.theme;
     }
     return bg.grid;
   }
 
   /** `/background <arquivo|url>` desenha a foto atras da conversa. */
-  async function setBackground(source) {
+  async function setBackground(source, { quiet = false } = {}) {
     const value = String(source || "").trim();
     if (!value || ["off", "none", "0", "limpar"].includes(value.toLowerCase())) {
       state.wallpaper = null;
@@ -1505,7 +1513,11 @@ async function runTUI({
       storage.setConfig({ background: value });
     } catch (error) {
       state.wallpaper = null;
-      state.modal = { title: "Fundo", text: `Nao consegui carregar ${value}.\n${error.message}` };
+      // No inicio da sessao o fundo salvo pode falhar (offline, arquivo movido):
+      // nao vale abrir um modal por isso, so avisa quando o usuario pediu.
+      if (!quiet) {
+        state.modal = { title: "Fundo", text: `Nao consegui carregar ${value}.\n${error.message}` };
+      }
     }
     return render();
   }
@@ -1943,7 +1955,6 @@ async function runTUI({
           role: "assistant",
           text,
           ms: result.ms,
-          provider: result.provider || "",
         });
       }
       if (result.messages) state.context = result.messages;
@@ -2345,7 +2356,7 @@ async function runTUI({
   if (resumePick) openChatPicker();
   connectMcp().catch(() => {});
   const savedBackground = storage.getConfig().background;
-  if (savedBackground) setBackground(savedBackground).catch(() => {});
+  if (savedBackground) setBackground(savedBackground, { quiet: true }).catch(() => {});
 
   spinner = setInterval(() => {
     if (!state.busy || closed) return;

package/src/wallpaper.js

@@ -312,11 +312,39 @@ function trackStyle(sequence, style) {
   }
 }
 
-function backgroundActive(style) {
-  return style.some((part) => {
+/**
+ * Cor de fundo ativa no momento. O tema pinta a tela inteira com o proprio bg,
+ * entao essa cor conta como "fundo livre": a imagem pode entrar no lugar dela.
+ * Caixas e paineis usam outra cor e ficam intactos.
+ */
+function activeBackground(style) {
+  let bg = null;
+  for (let index = 0; index < style.length; index += 1) {
+    const part = style[index];
+    if (part === "48" && style[index + 1] === "2") {
+      bg = [Number(style[index + 2]), Number(style[index + 3]), Number(style[index + 4])];
+      index += 4;
+      continue;
+    }
+    if (part === "48") {
+      // 48;5;n (paleta) ou 48;... qualquer outra variante: nao e o bg do tema.
+      bg = "outro";
+      index += 1;
+      continue;
+    }
     const code = Number(part);
-    return (code >= 40 && code <= 47) || (code >= 100 && code <= 107) || code === 48;
-  });
+    if ((code >= 40 && code <= 47) || (code >= 100 && code <= 107)) bg = "outro";
+  }
+  return bg;
+}
+
+/** Aceita o espaco quando nao ha fundo ou quando o fundo e o bg do tema. */
+function backgroundFree(style, base) {
+  const bg = activeBackground(style);
+  if (!bg) return true;
+  if (bg === "outro") return false;
+  if (!base) return false;
+  return bg[0] === base[0] && bg[1] === base[1] && bg[2] === base[2];
 }
 
 function cellEscape({ top, bottom }) {
@@ -327,7 +355,7 @@ function cellEscape({ top, bottom }) {
  * Troca os espacos vazios do frame pelas celulas da imagem. Texto e celulas com
  * fundo proprio (caixas, paineis) ficam como estao.
  */
-function paint(lines, grid) {
+function paint(lines, grid, { base = null } = {}) {
   if (!grid?.cells?.length) return lines;
 
   return lines.map((line, row) => {
@@ -353,7 +381,7 @@ function paint(lines, grid) {
 
       const char = line[index];
       const cell = cells[col];
-      if (char === " " && cell && !backgroundActive(style)) {
+      if (char === " " && cell && backgroundFree(style, base)) {
         const restore = style.length ? `\x1b[${style.join(";")}m` : "";
         out += `\x1b[0m${cellEscape(cell)}${HALF_BLOCK}${restore}`;
       } else {
@@ -373,6 +401,7 @@ module.exports = {
   decodePng,
   buildGrid,
   paint,
+  activeBackground,
   coverRegion,
   hexToRgb,
   HALF_BLOCK,