@ziamana/bruine 0.1.3 → 0.1.4

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.4-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/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() {
   }
 };

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 {
@@ -4734,6 +4783,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 +5019,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 +5235,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 +5349,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 +5544,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 +5563,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 +6394,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.4",
   "description": "Interactive terminal coding agent that runs your own models, local or OpenAI-compatible",
   "type": "module",
   "license": "MIT",