kafox-cli 0.10.3 → 0.10.4

package/README.md

@@ -85,6 +85,22 @@ conversa, com o texto por cima. Aceita **PNG** e **JPG**; a imagem e escurecida
 para nao atrapalhar a leitura e se ajusta sozinha ao tamanho do terminal.
 `/background off` remove, e a escolha fica em `~/.kafox/config.json`.
 
+## Colar imagem (Ctrl+V)
+
+Copie um print ou um recorte e aperte **Ctrl+V** na interface: a imagem entra
+como anexo do proximo turno, com preview dentro da caixa de texto, e vai junto
+com a mensagem para qualquer modelo com visao. Vale o mesmo limite do `/image`
+(3 por mensagem) — clique no ✕ do preview para tirar uma.
+
+A leitura usa o que existe na maquina: PowerShell no Windows, `pngpaste` (ou
+`osascript`) no macOS, `wl-paste` no Wayland e `xclip` no X11. Se nenhum estiver
+instalado, a CLI avisa e o `/image <arquivo>` continua funcionando.
+
+Alguns terminais consomem o Ctrl+V antes da CLI ver (o paste deles e
+`Ctrl+Shift+V`). Nesse caso use **`/paste`**, que le a area de transferencia do
+mesmo jeito. Sem imagem copiada, o Ctrl+V/`/paste` cola o texto, como um paste
+comum.
+
 ## Agentes e subagentes
 
 O agente tem a ferramenta `spawn_subagent`: ele lança subagentes com objetivo
@@ -106,7 +122,8 @@ Na interface: digite `/` para o menu (↑/↓ navega, Tab completa, Enter execut
 `/model` abre o seletor de modelo e `/theme` o de tema (↑/↓, clique do mouse,
 Enter aplica, Esc cancela). A resposta chega em streaming, com bloco `Thinking`
 quando o modelo manda o raciocinio. PgUp/PgDn ou a roda do mouse rolam a conversa;
-Ctrl+Y copia a ultima resposta e F2 solta o mouse para selecionar texto.
+Ctrl+Y copia a ultima resposta, Ctrl+V cola uma imagem copiada e F2 solta o
+mouse para selecionar texto.
 
 Enquanto o modelo trabalha a caixa de texto mostra `trabalhando...` com os
 pontinhos correndo, e o nome do modelo aparece fora dela, na linha de baixo.
@@ -122,8 +139,8 @@ o segundo interrompe o passo em andamento e guarda na conversa o que ja tinha
 chegado.
 
 Demais comandos: `/help`, `/models`, `/balance`, `/pricing`, `/key`, `/login`,
-`/logout`, `/whoami`, `/mcp`, `/allow`, `/theme`, `/background`, `/clear`,
-`/compact`, `/status`, `/exit`.
+`/logout`, `/whoami`, `/mcp`, `/allow`, `/theme`, `/background`, `/image`,
+`/paste`, `/clear`, `/compact`, `/status`, `/exit`.
 
 O `/theme` traz 29 temas (default, dark, light, brutalist, neon, paper,
 dracula, nord, gruvbox, monokai, tokyo-night, catppuccin, solarized, midnight,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kafox-cli",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "Kafox CLI: TUI com streaming, thinking, edit com diff, agent tools (files/shell), MCP e temas",
   "repository": {
     "type": "git",

package/src/cli.js

@@ -110,6 +110,7 @@ async function handleCommand(line) {
       console.log(`  ${chalk.bold("Esc Esc")}  ${chalk.dim("para a IA na hora (o primeiro Esc avisa)")}`);
       console.log(`  ${chalk.bold("PgUp/PgDn")}  ${chalk.dim("ou a roda do mouse rola a conversa")}`);
       console.log(`  ${chalk.bold("Ctrl+Y")}  ${chalk.dim("copia a ultima resposta para a area de transferencia")}`);
+      console.log(`  ${chalk.bold("Ctrl+V")}  ${chalk.dim("cola uma imagem copiada (ou o texto) no proximo turno")}`);
       console.log(`  ${chalk.bold("F2")}  ${chalk.dim("solta o mouse para selecionar texto com o terminal")}`);
       console.log(`  ${chalk.bold("Ctrl+C")}  ${chalk.dim("sai")}`);
       console.log("");
@@ -239,8 +240,11 @@ async function handleCommand(line) {
 }
 
 async function clearContext() {
-  history = [];
+  // Guarda a conversa atual e comeca outra: manter o mesmo codigo fazia o
+  // que viesse depois do /clear cair no chat antigo (e ser sobrescrito por ele).
   savePlainSession();
+  history = [];
+  plainSession = { id: sessions.newId(), startedAt: new Date().toISOString() };
   console.log(chalk.green("Context cleared."));
 }
 
@@ -438,7 +442,13 @@ async function runREPL(options = {}) {
   }
 
   return runTUI({
-    commands: COMMANDS,
+    // /image e /paste so valem na interface: e ela que desenha o preview e
+    // manda a imagem junto da mensagem. O REPL sem TTY continua so texto.
+    commands: {
+      ...COMMANDS,
+      "/image": "anexa imagem ao proximo turno (/image <arquivo>; clear limpa)",
+      "/paste": "cola a imagem da area de transferencia (atalho: Ctrl+V)",
+    },
     onCommand: handleCommand,
     // /theme e /background rodam dentro da TUI; os demais abrem prompt no terminal.
     interactiveCommands: new Set(["/login", "/key"]),

package/src/clipboard.js

@@ -0,0 +1,183 @@
+/**
+ * Area de transferencia: colar imagem no chat.
+ *
+ * O Ctrl+V do terminal so entrega texto. A imagem que voce copiou de um print
+ * (Win+Shift+S no Windows, Ctrl+Shift+Cmd+4 no macOS, "Copiar imagem" no Linux)
+ * nao passa por esse caminho, entao a CLI le a area de transferencia do sistema
+ * pelos utilitarios de sempre:
+ *
+ * - Windows: PowerShell (System.Windows.Forms.Clipboard)
+ * - macOS: `pngpaste` se estiver instalado, senao `osascript` com «class PNGf»
+ * - Linux: `wl-paste` (Wayland) e `xclip` (X11)
+ *
+ * Nada aqui lanca: sem utilitario instalado, a TUI recebe `{ ok: false }` com
+ * uma mensagem que diz o que instalar, e o `/image <arquivo>` continua valendo.
+ */
+const { spawnSync } = require("child_process");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { sniffMime } = require("./images");
+
+// Ordem de preferencia: PNG e o formato que todos os provedores aceitam e o
+// unico que o preview desenha sem depender de dependencia opcional.
+const IMAGE_TYPES = ["image/png", "image/jpeg", "image/gif", "image/webp"];
+
+function run(command, args, options = {}) {
+  try {
+    const result = spawnSync(command, args, {
+      timeout: options.timeout || 6000,
+      windowsHide: true,
+      maxBuffer: 32 * 1024 * 1024,
+      input: options.input,
+    });
+    if (result.error) return { ok: false, reason: result.error.code || result.error.message };
+    if (result.status !== 0) return { ok: false, reason: `exit ${result.status ?? "?"}` };
+    const buffer = Buffer.isBuffer(result.stdout) ? result.stdout : Buffer.from(result.stdout || "");
+    if (!buffer.length) return { ok: false, reason: "vazio" };
+    return { ok: true, buffer };
+  } catch (error) {
+    return { ok: false, reason: error.message };
+  }
+}
+
+/**
+ * Escolhe o tipo de imagem na lista que o gerenciador de clipboard publica
+ * (`xclip -t TARGETS -o`, `wl-paste --list-types`). Uma imagem e anunciada por
+ * varios tipos; PNG ganha dos outros para a colagem sair igual em todo modelo.
+ */
+function pickMime(list) {
+  const text = String(list || "");
+  for (const mime of IMAGE_TYPES) {
+    if (text.includes(mime)) return mime;
+  }
+  return null;
+}
+
+function fromWayland() {
+  const types = run("wl-paste", ["--list-types"]);
+  if (!types.ok) return null;
+  const mime = pickMime(types.buffer.toString("utf8"));
+  if (!mime) return null;
+  const data = run("wl-paste", ["--no-newline", "--type", mime]);
+  if (!data.ok) return null;
+  return { buffer: data.buffer, mime };
+}
+
+function fromX11() {
+  const targets = run("xclip", ["-selection", "clipboard", "-t", "TARGETS", "-o"]);
+  if (!targets.ok) return null;
+  const mime = pickMime(targets.buffer.toString("utf8"));
+  if (!mime) return null;
+  const data = run("xclip", ["-selection", "clipboard", "-t", mime, "-o"]);
+  if (!data.ok) return null;
+  return { buffer: data.buffer, mime };
+}
+
+function fromMac() {
+  const png = run("pngpaste", ["-"]);
+  if (png.ok && sniffMime(png.buffer)) return { buffer: png.buffer, mime: sniffMime(png.buffer) };
+
+  const file = path.join(os.tmpdir(), `kafox-paste-${process.pid}-${Date.now()}.png`);
+  const script = [
+    "set pngData to the clipboard as «class PNGf»",
+    `set f to open for access POSIX file "${file}" with write permission`,
+    "set eof f to 0",
+    "write pngData to f",
+    "close access f",
+  ];
+  const args = [];
+  for (const line of script) args.push("-e", line);
+
+  try {
+    if (!run("osascript", args).ok) return null;
+    const buffer = fs.readFileSync(file);
+    return buffer.length ? { buffer, mime: sniffMime(buffer) || "image/png" } : null;
+  } catch {
+    return null;
+  } finally {
+    try {
+      fs.unlinkSync(file);
+    } catch {}
+  }
+}
+
+function fromWindows() {
+  const file = path.join(os.tmpdir(), `kafox-paste-${process.pid}-${Date.now()}.png`);
+  const script =
+    "Add-Type -AssemblyName System.Windows.Forms;" +
+    "Add-Type -AssemblyName System.Drawing;" +
+    "$img = [System.Windows.Forms.Clipboard]::GetImage();" +
+    "if ($img -eq $null) { exit 3 };" +
+    `$img.Save('${file.replace(/'/g, "''")}', [System.Drawing.Imaging.ImageFormat]::Png);`;
+
+  try {
+    if (!run("powershell", ["-NoProfile", "-NonInteractive", "-STA", "-Command", script]).ok) return null;
+    const buffer = fs.readFileSync(file);
+    return buffer.length ? { buffer, mime: sniffMime(buffer) || "image/png" } : null;
+  } catch {
+    return null;
+  } finally {
+    try {
+      fs.unlinkSync(file);
+    } catch {}
+  }
+}
+
+function missingImageHint() {
+  if (process.platform === "darwin") {
+    return "nenhuma imagem copiada (copie um print com Ctrl+Shift+Cmd+4, ou use /image <arquivo>)";
+  }
+  if (process.platform === "win32") {
+    return "nenhuma imagem copiada (copie com Win+Shift+S, ou use /image <arquivo>)";
+  }
+  return "nenhuma imagem copiada (no Linux precisa de wl-clipboard ou xclip; /image <arquivo> sempre funciona)";
+}
+
+/**
+ * Le a imagem da area de transferencia.
+ * Retorna `{ ok: true, buffer, mime }` ou `{ ok: false, error }`.
+ */
+function readImage() {
+  const attempts =
+    process.platform === "win32"
+      ? [fromWindows]
+      : process.platform === "darwin"
+        ? [fromMac]
+        : [fromWayland, fromX11];
+
+  for (const attempt of attempts) {
+    let found = null;
+    try {
+      found = attempt();
+    } catch {
+      found = null;
+    }
+    if (found?.buffer?.length) {
+      return { ok: true, buffer: found.buffer, mime: sniffMime(found.buffer) || found.mime };
+    }
+  }
+
+  return { ok: false, error: missingImageHint() };
+}
+
+/** Le o texto da area de transferencia (fallback do Ctrl+V sem imagem). */
+function readText() {
+  const attempts =
+    process.platform === "win32"
+      ? [["powershell", ["-NoProfile", "-NonInteractive", "-Command", "Get-Clipboard -Raw"]]]
+      : process.platform === "darwin"
+        ? [["pbpaste", []]]
+        : [
+            ["wl-paste", ["--no-newline"]],
+            ["xclip", ["-selection", "clipboard", "-o"]],
+          ];
+
+  for (const [command, args] of attempts) {
+    const result = run(command, args);
+    if (result.ok) return result.buffer.toString("utf8");
+  }
+  return "";
+}
+
+module.exports = { IMAGE_TYPES, pickMime, readImage, readText };

package/src/sessions.js

@@ -57,6 +57,23 @@ function dayMonth(value) {
   return `${day}/${month}`;
 }
 
+/**
+ * A conversa tem pelo menos uma fala do usuario ou da IA?
+ *
+ * Sessao sem nenhuma fala e so um codigo reservado: gravar isso criava
+ * dezenas de "conversa sem titulo" iguais no `history`.
+ */
+function hasConversation(messages, context) {
+  const speaks = (item) => {
+    if (item?.role !== "user" && item?.role !== "assistant") return false;
+    if (Array.isArray(item.content)) {
+      return item.content.some((part) => part?.type === "text" && String(part.text || "").trim());
+    }
+    return Boolean(String(item?.text ?? item?.content ?? "").trim());
+  };
+  return [messages, context].some((list) => (Array.isArray(list) ? list : []).some(speaks));
+}
+
 /** Titulo curto: primeira mensagem do usuario, em uma linha. */
 function titleFrom(messages, fallback = "") {
   const first = (messages || []).find(
@@ -94,9 +111,13 @@ function contextFromMessages(messages) {
 
 function save({ id, cwd, model, theme, allowAll, messages, context, startedAt, title }) {
   if (!id) return null;
+  const list = Array.isArray(messages) ? messages : [];
+  // Conversa vazia nao vira arquivo: `/clear` e sessoes abertas sem pergunta
+  // enchiam o `history` de "conversa sem titulo" iguais.
+  if (!hasConversation(list, context)) return null;
+  const existed = fs.existsSync(fileFor(id));
   ensureDir();
   const now = new Date().toISOString();
-  const list = Array.isArray(messages) ? messages : [];
   const data = {
     id,
     title: title || titleFrom(list),
@@ -113,7 +134,8 @@ function save({ id, cwd, model, theme, allowAll, messages, context, startedAt, t
   const tmp = `${fileFor(id)}.tmp`;
   fs.writeFileSync(tmp, JSON.stringify(data), { mode: 0o600 });
   fs.renameSync(tmp, fileFor(id));
-  prune();
+  // A poda varre e le a pasta inteira: so vale quando o arquivo e novo.
+  if (!existed) prune();
   return data;
 }
 
@@ -130,7 +152,8 @@ function load(id) {
   }
 }
 
-function list() {
+/** Tudo o que esta no disco, inclusive as sessoes sem nenhuma fala. */
+function entries() {
   let names = [];
   try {
     names = fs.readdirSync(chatsDir()).filter((name) => name.endsWith(".json"));
@@ -142,17 +165,30 @@ function list() {
     const id = name.replace(/\.json$/, "");
     const data = load(id);
     if (!data) continue;
-    chats.push({
-      id,
-      title: data.title || titleFrom(data.messages),
-      cwd: data.cwd,
-      model: data.model,
-      allowAll: Boolean(data.allowAll),
-      updatedAt: data.updatedAt,
-      messages: (data.messages || []).length,
-    });
+    chats.push({ id, data });
   }
-  return chats.sort((a, b) => String(b.updatedAt).localeCompare(String(a.updatedAt)));
+  return chats;
+}
+
+function summarize({ id, data }) {
+  return {
+    id,
+    title: data.title || titleFrom(data.messages),
+    cwd: data.cwd,
+    model: data.model,
+    allowAll: Boolean(data.allowAll),
+    updatedAt: data.updatedAt,
+    messages: (data.messages || []).length,
+  };
+}
+
+const byNewest = (a, b) => String(b.updatedAt).localeCompare(String(a.updatedAt));
+
+function list() {
+  return entries()
+    .filter(({ data }) => hasConversation(data.messages, data.context))
+    .map(summarize)
+    .sort(byNewest);
 }
 
 function latest() {
@@ -174,11 +210,24 @@ function find(value) {
 }
 
 function prune() {
-  for (const chat of list().slice(MAX_SESSIONS)) {
+  const all = entries();
+  const chats = all
+    .filter(({ data }) => hasConversation(data.messages, data.context))
+    .map(summarize)
+    .sort(byNewest);
+  for (const chat of chats.slice(MAX_SESSIONS)) {
     try {
       fs.unlinkSync(fileFor(chat.id));
     } catch {}
   }
+  // Arquivos sem nenhuma fala sao lixo de versoes antigas: nao aparecem no
+  // `history` e, fora daqui, nunca seriam podados.
+  for (const { id, data } of all) {
+    if (hasConversation(data.messages, data.context)) continue;
+    try {
+      fs.unlinkSync(fileFor(id));
+    } catch {}
+  }
 }
 
 module.exports = {
@@ -187,6 +236,7 @@ module.exports = {
   chatsDir,
   newId,
   titleFrom,
+  hasConversation,
   normalizeId,
   dayMonth,
   contextFromMessages,

package/src/tui.js

@@ -28,7 +28,8 @@ const sessions = require("./sessions");
 const promptHistory = require("./prompt-history");
 const wallpaper = require("./wallpaper");
 const { listProviders } = require("./providers");
-const { MAX_IMAGES, loadImage, humanSize } = require("./images");
+const { MAX_IMAGES, loadImage, buildAttachment, humanSize } = require("./images");
+const clipboard = require("./clipboard");
 
 const ANSI = /\x1b\[[0-9;]*m/g;
 const stripAnsi = (value) => String(value).replace(ANSI, "");
@@ -501,6 +502,8 @@ const CONTROL_KEYS = {
   12: { name: "l", ctrl: true },
   13: { name: "return" },
   21: { name: "u", ctrl: true },
+  // Ctrl+V: cola o que esta na area de transferencia (imagem vira anexo).
+  22: { name: "v", ctrl: true },
   // Ctrl+R: atualiza saldo da conta e dos provedores externos agora.
   18: { name: "r", ctrl: true },
   // Ctrl+Q: desiste das mensagens que estao na fila (nao cancela a atual).
@@ -1478,7 +1481,9 @@ function inputBlock(state, width, { hero = false, tight = false } = {}) {
 
   lines.push(edge("┌" + "─".repeat(inner) + "┐"));
 
-  const previews = hero ? [] : imagePreviewLines(state, inner);
+  // Na tela inicial o preview tambem aparece: colar uma imagem antes da
+  // primeira pergunta precisa de retorno visual na caixa.
+  const previews = hero && !(state.images || []).length ? [] : imagePreviewLines(state, inner);
   for (const preview of previews) lines.push(preview);
 
   const prompt = hero ? "  " : "› ";
@@ -2321,6 +2326,46 @@ async function runTUI({
     return render();
   }
 
+  // Cola o que esta na area de transferencia: imagem entra como anexo do
+  // proximo turno (Ctrl+V ou /paste) e texto sem imagem vai para a caixa de
+  // escrita, como um paste comum. E isso que faz `Ctrl+V` de um print
+  // funcionar mesmo o terminal entregando so texto.
+  async function pasteFromClipboard() {
+    const items = state.images || (state.images = []);
+    if (items.length >= MAX_IMAGES) {
+      state.imageError = `limite de ${MAX_IMAGES} imagens por mensagem`;
+      return render();
+    }
+
+    const shot = clipboard.readImage();
+    if (shot.ok) {
+      const result = buildAttachment(shot.buffer, {
+        name: shot.mime === "image/jpeg" ? "colagem.jpg" : "colagem.png",
+        mime: shot.mime,
+      });
+      if (!result.ok) {
+        state.imageError = `colagem: ${result.error}`;
+        return render();
+      }
+      items.push(result.attachment);
+      state.imageError = null;
+      return render();
+    }
+
+    const text = String(clipboard.readText() || "")
+      .replace(/[\r\n]+/g, " ")
+      .replace(/[\x00-\x1f\x7f]/g, "");
+    if (text.trim()) {
+      return setInput(
+        state.input.slice(0, state.cursor) + text + state.input.slice(state.cursor),
+        state.cursor + text.length
+      );
+    }
+
+    state.imageError = shot.error;
+    return render();
+  }
+
   async function runCommand(line) {
     const parts = line.trim().split(/\s+/);
     const name = parts[0];
@@ -2329,6 +2374,12 @@ async function runTUI({
     // /models e /model sem argumento abrem o mesmo seletor navegavel.
     if ((name === "/model" || name === "/models") && !parts[1]) return openModelPicker();
 
+    // /paste (atalho Ctrl+V) cola a imagem copiada; sem imagem, cola o texto.
+    // Serve tambem para terminais que consomem o Ctrl+V antes da CLI.
+    if (name === "/paste" || name === "/colar" || name === "/clipboard") {
+      return pasteFromClipboard();
+    }
+
     // /image <arquivo> anexa uma imagem ao proximo turno (ate MAX_IMAGES).
     // /image (sem argumento) lista o que esta anexado; /image clear limpa tudo.
     if (name === "/image" || name === "/images" || name === "/anexar") {
@@ -2411,11 +2462,21 @@ async function runTUI({
     }
 
     if (name === "/clear") {
+      // Limpar o contexto e comecar outra conversa, nao continuar a mesma: com
+      // o codigo antigo tudo o que vinha depois do /clear era gravado no mesmo
+      // arquivo, entao conversas diferentes apareciam como uma so no history.
       state.messages = [];
       state.context = [];
       state.streaming = null;
+      state.streamedText = "";
       state.files = [];
+      state.images = [];
+      state.imageError = null;
+      state.retry = null;
+      state.tokens = 0;
       state.scroll = 0;
+      state.sessionId = sessions.newId();
+      state.sessionStartedAt = new Date().toISOString();
       return render();
     }
     if (name === "/compact") {
@@ -3006,6 +3067,8 @@ async function runTUI({
     if (key.name === "f2") return toggleMouse();
     if (key.ctrl && key.name === "y") return copyLastAnswer();
     if (key.ctrl && key.name === "r") return refreshBalance();
+    // Ctrl+V cola imagem (ou texto) da area de transferencia.
+    if (key.ctrl && key.name === "v") return pasteFromClipboard();
 
     // Modal de texto: qualquer tecla fecha — e se for texto, ele vai para o
     // input em vez de ser engolido (quem digita nao perde o que escreveu).