@ziamana/bruine 0.1.3 → 0.1.5

package/README.md

@@ -12,7 +12,7 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-b4a7ff)](LICENSE)
 [![Node 22+](https://img.shields.io/badge/node-22%2B-7dcfff)](https://nodejs.org)
 ![Linux tested · macOS and Windows in progress](https://img.shields.io/badge/Linux-tested-8fe3a3) ![macOS · Windows](https://img.shields.io/badge/macOS%20%C2%B7%20Windows-in%20progress-f5c97a)
-[![Changelog](https://img.shields.io/badge/version-0.1.3-ff9ed2)](CHANGELOG.md)
+[![Changelog](https://img.shields.io/badge/version-0.1.5-ff9ed2)](CHANGELOG.md)
 
 <a href="docs/media/bruine-film.mp4"><img src="docs/media/hero.webp" alt="The bruine film: the word bruine becomes the logo in the rain, then the effort climbs from low to max and the rain turns into a storm" width="100%"></a>
 

package/dist/bin.js

@@ -1559,7 +1559,7 @@ var init_theme = __esm({
 
 // src/update.ts
 import { spawn } from "child_process";
-import { realpathSync } from "fs";
+import { realpathSync as realpathSync2 } from "fs";
 import { mkdir as mkdir4, readFile as readFile5, rename as rename4, writeFile as writeFile4 } from "fs/promises";
 import path5 from "path";
 function updateCachePath(dshHome, pathMod = path5) {
@@ -4783,7 +4783,7 @@ var init_approve = __esm({
 // src/bin.ts
 init_compat();
 import { spawn as spawn2, spawnSync as spawnSync3 } from "child_process";
-import { existsSync as existsSync8, readFileSync as readFileSync7, realpathSync as realpathSync2 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync7, realpathSync as realpathSync3 } from "fs";
 import { createInterface } from "readline";
 import os from "os";
 import { dirname as dirname5, join as join8, resolve as resolve2 } from "path";
@@ -4855,7 +4855,7 @@ function flagMode(argv) {
 // src/profile.ts
 import { createRequire as createRequire2 } from "module";
 import { mkdir, readFile, rename, rm, stat, writeFile } from "fs/promises";
-import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync2, rmSync, symlinkSync } from "fs";
+import { existsSync as existsSync3, lstatSync, mkdirSync, readFileSync as readFileSync2, realpathSync, rmSync, symlinkSync } from "fs";
 import path3 from "path";
 import { parse as parseYaml } from "yaml";
 var require3 = createRequire2(import.meta.url);
@@ -5003,6 +5003,19 @@ function linkProfileBundles(profileDir, own, dshBaseDir) {
     return false;
   }
 }
+function bundleIsCurrent(profileDir, name, own) {
+  const at = path3.join(profileDir, "node_modules", name);
+  const marker = path3.join(at, "package.json");
+  if (!existsSync3(marker)) return false;
+  if (own.root === void 0) return true;
+  try {
+    if (realpathSync(at) === realpathSync(own.root)) return true;
+    if (lstatSync(at).isSymbolicLink()) return false;
+    return JSON.parse(readFileSync2(marker, "utf8")).version === own.version;
+  } catch {
+    return false;
+  }
+}
 function resolveDshBaseDir() {
   try {
     const dshRequire = createRequire2(require3.resolve("@deepseek-ai/dsh/package.json"));
@@ -5136,9 +5149,8 @@ function selfPackageRoot() {
   }
 }
 function ensureBundleInstalled(profileDir, dshEntry, env, headless = false) {
-  const marker = join8(profileDir, "node_modules", pkg2.name, "package.json");
-  if (existsSync8(marker)) return;
   const root = selfPackageRoot();
+  if (bundleIsCurrent(profileDir, pkg2.name, { root, version: pkg2.version })) return;
   if (!headless) console.log("Setting up bruine (one time)\u2026");
   const dshBase = resolveDshBaseDir();
   if (root !== void 0 && dshBase !== void 0 && linkProfileBundles(profileDir, { name: pkg2.name, root }, dshBase)) {
@@ -5189,7 +5201,7 @@ async function runUpdate() {
   const entry = process.argv[1] ?? fileURLToPath2(import.meta.url);
   let real = entry;
   try {
-    real = realpathSync2(entry);
+    real = realpathSync3(entry);
   } catch {
   }
   const cmd = updateCommand(detectInstallKind(real));

package/dist/plugins/render.js

@@ -826,6 +826,7 @@ var ReasoningComponent = class {
 };
 
 // src/ui/tool-call-component.ts
+import { Image } from "@earendil-works/pi-tui";
 import stringWidth4 from "string-width";
 import { isAbsolute as isAbsolute2, relative, resolve as resolve2 } from "path";
 
@@ -1092,7 +1093,7 @@ function readableToolSummary(tool, args) {
 // src/ui/image-preview.ts
 import { readFileSync as readFileSync3, statSync } from "fs";
 import { createRequire } from "module";
-import { inflateSync } from "zlib";
+import { crc32, deflateSync, inflateSync } from "zlib";
 var MAX_PREVIEW_BYTES = 16 * 1024 * 1024;
 var MAX_PREVIEW_PIXELS = 4e7;
 var PNG_SIGNATURE = [137, 80, 78, 71, 13, 10, 26, 10];
@@ -1308,12 +1309,85 @@ function previewImageFile(path7, cols, rows) {
     return void 0;
   }
 }
+function encodePng(img) {
+  const chunk = (type, data) => {
+    const out = Buffer.alloc(12 + data.length);
+    out.writeUInt32BE(data.length, 0);
+    out.write(type, 4, "ascii");
+    Buffer.from(data).copy(out, 8);
+    out.writeUInt32BE(crc32(Buffer.concat([Buffer.from(type, "ascii"), Buffer.from(data)])), 8 + data.length);
+    return out;
+  };
+  const header = Buffer.alloc(13);
+  header.writeUInt32BE(img.width, 0);
+  header.writeUInt32BE(img.height, 4);
+  header[8] = 8;
+  header[9] = 6;
+  const stride = img.width * 4;
+  const raw = Buffer.alloc((stride + 1) * img.height);
+  for (let y = 0; y < img.height; y += 1) Buffer.from(img.data.buffer, img.data.byteOffset + y * stride, stride).copy(raw, y * (stride + 1) + 1);
+  return new Uint8Array(Buffer.concat([Buffer.from(PNG_SIGNATURE), chunk("IHDR", header), chunk("IDAT", deflateSync(raw)), chunk("IEND", new Uint8Array())]));
+}
+function shrink(img, max) {
+  const scale = Math.min(1, max / Math.max(img.width, img.height));
+  if (scale >= 1) return img;
+  const width = Math.max(1, Math.round(img.width * scale));
+  const height = Math.max(1, Math.round(img.height * scale));
+  const data = new Uint8Array(width * height * 4);
+  const sx = img.width / width;
+  const sy = img.height / height;
+  for (let y = 0; y < height; y += 1) {
+    for (let x = 0; x < width; x += 1) {
+      const sum = [0, 0, 0, 0];
+      let n = 0;
+      for (let yy = Math.floor(y * sy); yy < Math.min(img.height, Math.ceil((y + 1) * sy)); yy += 1) {
+        for (let xx = Math.floor(x * sx); xx < Math.min(img.width, Math.ceil((x + 1) * sx)); xx += 1) {
+          const o = (yy * img.width + xx) * 4;
+          for (let c2 = 0; c2 < 4; c2 += 1) sum[c2] += img.data[o + c2];
+          n += 1;
+        }
+      }
+      for (let c2 = 0; c2 < 4; c2 += 1) data[(y * width + x) * 4 + c2] = Math.round(sum[c2] / Math.max(1, n));
+    }
+  }
+  return { width, height, data };
+}
+var SEND_MAX_BYTES = 2 * 1024 * 1024;
+var SEND_MAX_SIDE = 1600;
+function terminalImageFile(path7, protocol) {
+  try {
+    if (statSync(path7).size > MAX_PREVIEW_BYTES) return void 0;
+    const bytes = new Uint8Array(readFileSync3(path7));
+    const mimeType = sniffImage(bytes);
+    const size = imageSize(bytes);
+    if (mimeType === void 0 || size === void 0) return void 0;
+    const description = describeImage(bytes);
+    const tooBig = bytes.length > SEND_MAX_BYTES || Math.max(size.width, size.height) > SEND_MAX_SIDE;
+    if (!tooBig && (protocol === "iterm2" || mimeType === "image/png")) {
+      return { base64: Buffer.from(bytes).toString("base64"), mimeType, widthPx: size.width, heightPx: size.height, description };
+    }
+    const img = decodeImage(bytes);
+    if (img === void 0) return void 0;
+    const sent = shrink(img, SEND_MAX_SIDE);
+    return { base64: Buffer.from(encodePng(sent)).toString("base64"), mimeType: "image/png", widthPx: sent.width, heightPx: sent.height, description };
+  } catch {
+    return void 0;
+  }
+}
+
+// src/ui/term-images.ts
+import { getCapabilities, setCapabilityOverrides } from "@earendil-works/pi-tui";
+function imageProtocol() {
+  return getCapabilities().images;
+}
 
 // src/ui/tool-call-component.ts
 var IMAGE_TOOLS = /* @__PURE__ */ new Set(["read_image", "view_image"]);
 var IMAGE_FILE = /\.(png|jpe?g|gif|webp)$/i;
 var IMAGE_PREVIEW_COLS = 64;
 var IMAGE_PREVIEW_ROWS = 16;
+var IMAGE_PICTURE_COLS = 72;
+var IMAGE_PICTURE_ROWS = 20;
 var SUMMARY_KEYS2 = ["command", "cmd", "path", "file_path", "url", "query", "pattern", "name"];
 var WRITE_TOOLS = /* @__PURE__ */ new Set(["write", "edit", "multi_edit", "notebook_edit"]);
 var MAX_OUTPUT_LINES2 = 5;
@@ -1355,6 +1429,8 @@ var ToolCallComponent = class {
   #diff;
   /** The image file a successful image read showed the model. */
   #image;
+  /** That image, prepared once for the terminal's graphics protocol (null: it could not be). */
+  #picture;
   #readableSummaries;
   get active() {
     return this.#done === void 0;
@@ -1548,6 +1624,12 @@ var ToolCallComponent = class {
       return out;
     }
     if (this.#image !== void 0) {
+      const picture = this.#pictureLines(width);
+      if (picture !== void 0) {
+        out.push(...picture.lines.map((l) => `    ${l}`));
+        out.push(ansi.gray(clipCells(`    ${picture.description}${dur === void 0 ? "" : ` ${this.icons.think === "*" ? "-" : "\xB7"} ${dur}`}`, width)));
+        return out;
+      }
       const preview = previewImageFile(this.#image, Math.min(IMAGE_PREVIEW_COLS, Math.max(1, width - 6)), IMAGE_PREVIEW_ROWS);
       if (preview !== void 0) {
         if (preview.lines !== void 0) out.push(...preview.lines.map((l) => `    ${l}`));
@@ -1561,6 +1643,26 @@ var ToolCallComponent = class {
     if (dur !== void 0) out.push(ansi.gray(clipCells(`Took ${dur}`, width)));
     return out;
   }
+  /**
+   * The image itself, through the terminal's graphics protocol, when it has one: Kitty, Ghostty,
+   * WezTerm, Warp, iTerm2, Konsole. pi-tui places it and keeps its rows; the half-block sketch
+   * stays for every other terminal.
+   */
+  #pictureLines(width) {
+    const protocol = imageProtocol();
+    if (protocol === null || this.#image === void 0) return void 0;
+    const key = `${protocol}:${this.#image}`;
+    if (this.#picture === void 0 || this.#picture !== null && this.#picture.key !== key) {
+      const file = terminalImageFile(this.#image, protocol);
+      this.#picture = file === void 0 ? null : {
+        key,
+        description: file.description,
+        image: new Image(file.base64, file.mimeType, { fallbackColor: ansi.gray }, { maxWidthCells: IMAGE_PICTURE_COLS, maxHeightCells: IMAGE_PICTURE_ROWS }, { widthPx: file.widthPx, heightPx: file.heightPx })
+      };
+    }
+    if (this.#picture === null) return void 0;
+    return { lines: this.#picture.image.render(Math.max(3, Math.min(IMAGE_PICTURE_COLS + 2, width - 4))), description: this.#picture.description };
+  }
   invalidate() {
   }
 };
@@ -3163,6 +3265,21 @@ function attachTui(ctx, agent, ui, service, getAgent) {
     const reading = silence?.reading(id === void 0 ? void 0 : String(id));
     return reading === void 0 ? void 0 : { quietMs: Date.now() - reading.quietSince, budgetMs: reading.budget };
   });
+  let backgroundTaskCount = 0;
+  const jobs = ctx.get("jobs");
+  const refreshBackgroundTasks = () => {
+    let count = 0;
+    try {
+      count = (jobs?.list(liveAgent()) ?? []).filter((job) => job.kind !== "subagent" && (job.status === "running" || job.status === "stopping")).length;
+    } catch {
+    }
+    if (count === backgroundTaskCount) return;
+    backgroundTaskCount = count;
+    ui.footer.set({ backgroundTasks: count });
+    ui.requestRender();
+  };
+  const offJobsChanged = jobs?.onJobsChanged?.(refreshBackgroundTasks);
+  refreshBackgroundTasks();
   let subagentCount = 0;
   const refreshSubagents = () => {
     const registry = ctx.get("agents");
@@ -3322,6 +3439,7 @@ function attachTui(ctx, agent, ui, service, getAgent) {
       }
       case "turn/start":
         refreshSubagents();
+        refreshBackgroundTasks();
         tps.reset();
         ui.footer.set({ tps: 0, tpsEstimated: false, pp: void 0, cachePct: void 0, cacheFirst: false });
         turnStartWall = Date.now();
@@ -3543,6 +3661,11 @@ function attachTui(ctx, agent, ui, service, getAgent) {
     offAgentCreated();
     offAgentStatus();
     offAgentDisposed();
+    offJobsChanged?.();
+    if (backgroundTaskCount > 0) {
+      ui.footer.set({ backgroundTasks: 0 });
+      ui.requestRender();
+    }
     if (subagentCount > 0) {
       ui.footer.set({ subagents: 0 });
       ui.requestRender();

package/dist/plugins/repl.js

@@ -942,6 +942,45 @@ import { readFileSync } from "fs";
 import { randomUUID } from "crypto";
 import { visibleWidth as visibleWidth2 } from "@earendil-works/pi-tui";
 
+// src/ui/term-images.ts
+import { getCapabilities, setCapabilityOverrides } from "@earendil-works/pi-tui";
+function imageProtocolFor(env = process.env) {
+  const asked = env.BRUINE_IMAGES?.trim().toLowerCase();
+  if (asked === "kitty" || asked === "iterm2") return asked;
+  if (asked === "blocks" || asked === "off" || asked === "none" || asked === "0") return null;
+  if (env.TMUX !== void 0 || (env.TERM ?? "").startsWith("tmux") || (env.TERM ?? "").startsWith("screen")) return void 0;
+  const konsole = Number.parseInt(env.KONSOLE_VERSION ?? "", 10);
+  if (Number.isFinite(konsole) && konsole >= 220400) return "iterm2";
+  return void 0;
+}
+function applyImageProtocol(env = process.env) {
+  const protocol = imageProtocolFor(env);
+  if (protocol !== void 0) setCapabilityOverrides({ images: protocol });
+}
+function imageProtocol() {
+  return getCapabilities().images;
+}
+function imageRows(lines) {
+  const rows = /* @__PURE__ */ new Set();
+  lines.forEach((line, at) => {
+    if (line.includes("\x1B_G")) {
+      const tall = Number.parseInt(/[;,]r=(\d+)/.exec(line)?.[1] ?? "1", 10);
+      for (let i = 0; i < Math.max(1, tall); i += 1) rows.add(at + i);
+    } else if (line.includes("\x1B]1337;File=")) {
+      const up = Number.parseInt(/\x1b\[(\d+)A\x1b\]1337;File=/.exec(line)?.[1] ?? "0", 10);
+      for (let i = 0; i <= up; i += 1) rows.add(at - i);
+    }
+  });
+  return rows;
+}
+function splitImageLine(line) {
+  const kitty = line.indexOf("\x1B_G");
+  const iterm = /(?:\x1b\[\d+A)?\x1b\]1337;File=/.exec(line);
+  const at = kitty >= 0 ? kitty : iterm?.index ?? -1;
+  if (at < 0) return void 0;
+  return { before: line.slice(0, at), sequence: line.slice(at) };
+}
+
 // src/ui/logo-motion.ts
 var LOGO = [
   "\u250F\u2513 \u250F\u2501\u2513\u257B \u257B\u257B\u250F\u2513\u257B\u250F\u2501\u2578",
@@ -1070,9 +1109,11 @@ var WeatherBackdrop = class {
     }
     const ink = storm2 || this.#weather.level >= 0.85 ? STORM_INK : QUIET_INK;
     const out = [...lines];
+    const pictures = imageRows(lines);
     for (let y = 0; y < height; y += 1) {
       const row = from + y;
       if (row >= controlsFrom && row < content.length) continue;
+      if (pictures.has(row)) continue;
       const line = lines[from + y];
       if (hasBackground(line)) continue;
       const padded = line + " ".repeat(Math.max(0, width - visibleWidth2(line)));
@@ -1329,6 +1370,14 @@ var ChatTranscript = class extends Container {
         }
         for (const [i, line] of block.entries()) {
           const clean = child.transcriptStyle === "reasoning" ? reasoningStyle(withoutEmoji(line)) : withoutEmoji(line);
+          const picture = splitImageLine(clean);
+          if (picture !== void 0) {
+            const lead = rail === void 0 ? `  ${picture.before}` : `${showRail ? railPaint(rail, railChar, (i + 1) / railSpan) : " "} ${picture.before}`;
+            const row = rail === void 0 ? lead : card(role, lead);
+            const back = rail === void 0 ? 0 : cardCells - visibleWidth3(lead);
+            piece2.push(`${row}${back > 0 ? `\x1B[${String(back)}D` : ""}${picture.sequence}`);
+            continue;
+          }
           if (rail === void 0) {
             piece2.push(truncateToWidth(`  ${clean}`, width - 2));
           } else {
@@ -1585,7 +1634,11 @@ var FooterComponent = class {
     const turn = this.#turnRow(w);
     const rows = [place, turn.line];
     const count = this.state.subagents ?? 0;
-    const agents = count > 0 ? this.#ink("sky")(`subagents ${Math.floor(count)}`) : "";
+    const tasks = this.state.backgroundTasks ?? 0;
+    const agents = [
+      tasks > 0 ? this.#ink("sky")(`task ${Math.floor(tasks)}`) : "",
+      count > 0 ? this.#ink("sky")(`subagents ${Math.floor(count)}`) : ""
+    ].filter(Boolean).join("  ");
     const firstRoom = agents ? Math.max(1, w - visibleWidth4(agents) - GAP) : w;
     const speeds = this.#speedRows(w, firstRoom);
     if (agents) {
@@ -4734,6 +4787,7 @@ function fileLink(text, absolutePath) {
 }
 
 // src/ui/tool-call-component.ts
+import { Image } from "@earendil-works/pi-tui";
 import stringWidth7 from "string-width";
 import { isAbsolute as isAbsolute4, relative as relative2, resolve as resolve2 } from "path";
 
@@ -4969,7 +5023,7 @@ function readableToolSummary(tool, args) {
 // src/ui/image-preview.ts
 import { readFileSync as readFileSync7, statSync as statSync2 } from "fs";
 import { createRequire } from "module";
-import { inflateSync } from "zlib";
+import { crc32, deflateSync, inflateSync } from "zlib";
 var MAX_PREVIEW_BYTES = 16 * 1024 * 1024;
 var MAX_PREVIEW_PIXELS = 4e7;
 var PNG_SIGNATURE = [137, 80, 78, 71, 13, 10, 26, 10];
@@ -5185,12 +5239,79 @@ function previewImageFile(path8, cols, rows) {
     return void 0;
   }
 }
+function encodePng(img) {
+  const chunk = (type, data) => {
+    const out = Buffer.alloc(12 + data.length);
+    out.writeUInt32BE(data.length, 0);
+    out.write(type, 4, "ascii");
+    Buffer.from(data).copy(out, 8);
+    out.writeUInt32BE(crc32(Buffer.concat([Buffer.from(type, "ascii"), Buffer.from(data)])), 8 + data.length);
+    return out;
+  };
+  const header = Buffer.alloc(13);
+  header.writeUInt32BE(img.width, 0);
+  header.writeUInt32BE(img.height, 4);
+  header[8] = 8;
+  header[9] = 6;
+  const stride = img.width * 4;
+  const raw = Buffer.alloc((stride + 1) * img.height);
+  for (let y = 0; y < img.height; y += 1) Buffer.from(img.data.buffer, img.data.byteOffset + y * stride, stride).copy(raw, y * (stride + 1) + 1);
+  return new Uint8Array(Buffer.concat([Buffer.from(PNG_SIGNATURE), chunk("IHDR", header), chunk("IDAT", deflateSync(raw)), chunk("IEND", new Uint8Array())]));
+}
+function shrink(img, max) {
+  const scale = Math.min(1, max / Math.max(img.width, img.height));
+  if (scale >= 1) return img;
+  const width = Math.max(1, Math.round(img.width * scale));
+  const height = Math.max(1, Math.round(img.height * scale));
+  const data = new Uint8Array(width * height * 4);
+  const sx = img.width / width;
+  const sy = img.height / height;
+  for (let y = 0; y < height; y += 1) {
+    for (let x = 0; x < width; x += 1) {
+      const sum = [0, 0, 0, 0];
+      let n = 0;
+      for (let yy = Math.floor(y * sy); yy < Math.min(img.height, Math.ceil((y + 1) * sy)); yy += 1) {
+        for (let xx = Math.floor(x * sx); xx < Math.min(img.width, Math.ceil((x + 1) * sx)); xx += 1) {
+          const o = (yy * img.width + xx) * 4;
+          for (let c2 = 0; c2 < 4; c2 += 1) sum[c2] += img.data[o + c2];
+          n += 1;
+        }
+      }
+      for (let c2 = 0; c2 < 4; c2 += 1) data[(y * width + x) * 4 + c2] = Math.round(sum[c2] / Math.max(1, n));
+    }
+  }
+  return { width, height, data };
+}
+var SEND_MAX_BYTES = 2 * 1024 * 1024;
+var SEND_MAX_SIDE = 1600;
+function terminalImageFile(path8, protocol) {
+  try {
+    if (statSync2(path8).size > MAX_PREVIEW_BYTES) return void 0;
+    const bytes = new Uint8Array(readFileSync7(path8));
+    const mimeType = sniffImage(bytes);
+    const size = imageSize(bytes);
+    if (mimeType === void 0 || size === void 0) return void 0;
+    const description = describeImage(bytes);
+    const tooBig = bytes.length > SEND_MAX_BYTES || Math.max(size.width, size.height) > SEND_MAX_SIDE;
+    if (!tooBig && (protocol === "iterm2" || mimeType === "image/png")) {
+      return { base64: Buffer.from(bytes).toString("base64"), mimeType, widthPx: size.width, heightPx: size.height, description };
+    }
+    const img = decodeImage(bytes);
+    if (img === void 0) return void 0;
+    const sent = shrink(img, SEND_MAX_SIDE);
+    return { base64: Buffer.from(encodePng(sent)).toString("base64"), mimeType: "image/png", widthPx: sent.width, heightPx: sent.height, description };
+  } catch {
+    return void 0;
+  }
+}
 
 // src/ui/tool-call-component.ts
 var IMAGE_TOOLS = /* @__PURE__ */ new Set(["read_image", "view_image"]);
 var IMAGE_FILE = /\.(png|jpe?g|gif|webp)$/i;
 var IMAGE_PREVIEW_COLS = 64;
 var IMAGE_PREVIEW_ROWS = 16;
+var IMAGE_PICTURE_COLS = 72;
+var IMAGE_PICTURE_ROWS = 20;
 var SUMMARY_KEYS = ["command", "cmd", "path", "file_path", "url", "query", "pattern", "name"];
 var WRITE_TOOLS = /* @__PURE__ */ new Set(["write", "edit", "multi_edit", "notebook_edit"]);
 var MAX_OUTPUT_LINES = 5;
@@ -5232,6 +5353,8 @@ var ToolCallComponent = class {
   #diff;
   /** The image file a successful image read showed the model. */
   #image;
+  /** That image, prepared once for the terminal's graphics protocol (null: it could not be). */
+  #picture;
   #readableSummaries;
   get active() {
     return this.#done === void 0;
@@ -5425,6 +5548,12 @@ var ToolCallComponent = class {
       return out;
     }
     if (this.#image !== void 0) {
+      const picture = this.#pictureLines(width);
+      if (picture !== void 0) {
+        out.push(...picture.lines.map((l) => `    ${l}`));
+        out.push(ansi.gray(clipCells(`    ${picture.description}${dur === void 0 ? "" : ` ${this.icons.think === "*" ? "-" : "\xB7"} ${dur}`}`, width)));
+        return out;
+      }
       const preview = previewImageFile(this.#image, Math.min(IMAGE_PREVIEW_COLS, Math.max(1, width - 6)), IMAGE_PREVIEW_ROWS);
       if (preview !== void 0) {
         if (preview.lines !== void 0) out.push(...preview.lines.map((l) => `    ${l}`));
@@ -5438,6 +5567,26 @@ var ToolCallComponent = class {
     if (dur !== void 0) out.push(ansi.gray(clipCells(`Took ${dur}`, width)));
     return out;
   }
+  /**
+   * The image itself, through the terminal's graphics protocol, when it has one: Kitty, Ghostty,
+   * WezTerm, Warp, iTerm2, Konsole. pi-tui places it and keeps its rows; the half-block sketch
+   * stays for every other terminal.
+   */
+  #pictureLines(width) {
+    const protocol = imageProtocol();
+    if (protocol === null || this.#image === void 0) return void 0;
+    const key = `${protocol}:${this.#image}`;
+    if (this.#picture === void 0 || this.#picture !== null && this.#picture.key !== key) {
+      const file = terminalImageFile(this.#image, protocol);
+      this.#picture = file === void 0 ? null : {
+        key,
+        description: file.description,
+        image: new Image(file.base64, file.mimeType, { fallbackColor: ansi.gray }, { maxWidthCells: IMAGE_PICTURE_COLS, maxHeightCells: IMAGE_PICTURE_ROWS }, { widthPx: file.widthPx, heightPx: file.heightPx })
+      };
+    }
+    if (this.#picture === null) return void 0;
+    return { lines: this.#picture.image.render(Math.max(3, Math.min(IMAGE_PICTURE_COLS + 2, width - 4))), description: this.#picture.description };
+  }
   invalidate() {
   }
 };
@@ -6249,6 +6398,7 @@ var BruineUi = class {
     if (process.stdout.isTTY === true && process.env.CI !== "1" && appEnv("NO_CLEAR") !== "1") {
       this.terminal.clearScreen();
     }
+    applyImageProtocol();
     this.tui.start();
     this.mouse.start();
     void this.probeBackdrop();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziamana/bruine",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Interactive terminal coding agent that runs your own models, local or OpenAI-compatible",
   "type": "module",
   "license": "MIT",