aria-code 0.118.0__tar.gz → 0.119.0__tar.gz

{aria_code-0.118.0/src/aria_code.egg-info → aria_code-0.119.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aria-code
-Version: 0.118.0
+Version: 0.119.0
 Summary: Open-source AI agent for coding, financial analysis and logistics operations: numbers you can check, client data kept apart, actions a person approves
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/artheras/aria-code
@@ -172,7 +172,7 @@ Numbers you can check, client data kept apart, actions a person approves.</p>
 <p align="center">
   <a href="https://www.npmjs.com/package/@artheras/aria-code"><img src="https://img.shields.io/npm/v/@artheras/aria-code/latest?style=flat-square&logo=npm&label=npm" alt="npm version"></a>
   <!-- Release automation pins PyPI: the default endpoint still selects legacy 4.x. -->
-  <a href="https://pypi.org/project/aria-code/0.118.0/"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Faria-code%2F0.118.0%2Fjson&amp;query=%24.info.version&amp;prefix=v&amp;style=flat-square&amp;logo=pypi&amp;label=PyPI&amp;color=blue&amp;cacheSeconds=300" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/aria-code/0.119.0/"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Faria-code%2F0.119.0%2Fjson&amp;query=%24.info.version&amp;prefix=v&amp;style=flat-square&amp;logo=pypi&amp;label=PyPI&amp;color=blue&amp;cacheSeconds=300" alt="PyPI version"></a>
   <a href="https://github.com/artheras/aria-code/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/artheras/aria-code/ci.yml?branch=main&style=flat-square&logo=githubactions&label=CI" alt="CI status"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-64748b?style=flat-square" alt="Apache License 2.0"></a>
 </p>

{aria_code-0.118.0 → aria_code-0.119.0}/README.md

@@ -15,7 +15,7 @@ Numbers you can check, client data kept apart, actions a person approves.</p>
 <p align="center">
   <a href="https://www.npmjs.com/package/@artheras/aria-code"><img src="https://img.shields.io/npm/v/@artheras/aria-code/latest?style=flat-square&logo=npm&label=npm" alt="npm version"></a>
   <!-- Release automation pins PyPI: the default endpoint still selects legacy 4.x. -->
-  <a href="https://pypi.org/project/aria-code/0.118.0/"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Faria-code%2F0.118.0%2Fjson&amp;query=%24.info.version&amp;prefix=v&amp;style=flat-square&amp;logo=pypi&amp;label=PyPI&amp;color=blue&amp;cacheSeconds=300" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/aria-code/0.119.0/"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Faria-code%2F0.119.0%2Fjson&amp;query=%24.info.version&amp;prefix=v&amp;style=flat-square&amp;logo=pypi&amp;label=PyPI&amp;color=blue&amp;cacheSeconds=300" alt="PyPI version"></a>
   <a href="https://github.com/artheras/aria-code/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/artheras/aria-code/ci.yml?branch=main&style=flat-square&logo=githubactions&label=CI" alt="CI status"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-64748b?style=flat-square" alt="Apache License 2.0"></a>
 </p>

{aria_code-0.118.0 → aria_code-0.119.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "aria-code"
-version = "0.118.0"
+version = "0.119.0"
 description = "Open-source AI agent for coding, financial analysis and logistics operations: numbers you can check, client data kept apart, actions a person approves"
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -276,7 +276,6 @@ include = ["aria_code*"]
 
 [tool.setuptools.package-data]
 "*" = ["*.yaml", "*.json", "*.md", "*.txt", "*.sh"]
-"aria_code.ui" = ["assets/*.png"]
 
 # ── Ruff linting ───────────────────────────────────────────────────────────────
 [tool.ruff]

{aria_code-0.118.0 → aria_code-0.119.0}/src/aria_code/_version.py

@@ -17,4 +17,4 @@ from __future__ import annotations
 
 __all__ = ["__version__"]
 
-__version__ = "0.118.0"
+__version__ = "0.119.0"

{aria_code-0.118.0 → aria_code-0.119.0}/src/aria_code/ui/banner.py

@@ -19,8 +19,6 @@ from __future__ import annotations
 
 import os
 import shutil
-from functools import lru_cache
-from pathlib import Path
 from typing import Optional
 
 from .startup_dashboard import StartupDashboardViewModel
@@ -207,61 +205,16 @@ def _robot_text():
     return face
 
 
-@lru_cache(maxsize=2)
-def _artwork_pixels(theme: str = "dark"):
-    """The robot's pixel map as Rich half-blocks: two flat pixels per cell."""
-    from rich.text import Text
-    from .robot_pixels import GRID, HEIGHT, PALETTES, SEAM_ROW, WIDTH
-
-    colours = PALETTES[theme]
-    face = Text()
-    for y in range(0, HEIGHT, 2):
-        for x in range(WIDTH):
-            top, bottom = GRID[y][x], GRID[y + 1][x]
-            if top == bottom == ".":
-                face.append(" ")
-            elif bottom == ".":
-                face.append("▀", style=colours[top])
-            elif top == ".":
-                face.append("▄", style=colours[bottom])
-            elif y + 1 == SEAM_ROW and top == bottom == "B":
-                face.append("▁", style=f"{colours['seam']} on {colours['B']}")
-            else:
-                face.append("▀", style=f"{colours[top]} on {colours[bottom]}")
-        if y + 2 < HEIGHT:
-            face.append("\n")
-    return face
-
+def _mascot(console):
+    """Return (renderable, columns): the compact robot, or nothing.
 
-def _mascot(console, width: int):
-    """Return (renderable, columns, rows, optional native image sequence).
-
-    Inline graphics go only to a real TTY. Rich's text parser strips OSC/APC
-    escapes, so the PNG is written separately after reserving its cells.
+    ARIA_ROBOT_RENDER=off leaves the four summary lines without a robot.
     """
     from rich.text import Text
-    from .robot_pixels import BOUNDS, HEIGHT, IMAGE_COLUMNS, IMAGE_ROWS, WIDTH
-    mode = os.getenv("ARIA_ROBOT_RENDER", "auto").strip().lower()
-    tty = bool(console.is_terminal and getattr(console.file, "isatty", lambda: False)())
-    if mode == "off":
-        return Text(), 0, 4, None
-    if console.no_color or console.color_system is None:
-        # Uncoloured half-blocks are a solid rectangle, not a robot.
-        return _robot_text(), 9, 4, None
-    if mode == "compact" or width < 60 or (not tty and mode not in ("pixels", "image")):
-        return _robot_text(), 9, 4, None
-    if mode != "pixels" and tty:
-        from .image_render import best_method, render_image
-        method = best_method()
-        if method in ("iterm", "kitty"):
-            asset = Path(__file__).parent / "assets" / "aria-robot.png"
-            sequence = render_image(str(asset), IMAGE_COLUMNS, method, crop=BOUNDS,
-                                    cells_high=IMAGE_ROWS)
-            if sequence and sequence.startswith(("\x1b]1337;", "\x1b_G")):
-                blank = Text("\n".join([" " * IMAGE_COLUMNS] * IMAGE_ROWS))
-                return blank, IMAGE_COLUMNS, IMAGE_ROWS, sequence
-    theme = "light" if _is_light_theme() else "dark"
-    return _artwork_pixels(theme).copy(), WIDTH, HEIGHT // 2, None
+
+    if os.getenv("ARIA_ROBOT_RENDER", "").strip().lower() == "off":
+        return Text(), 0
+    return _robot_text(), 9
 
 
 def _summary_lines(view: StartupDashboardViewModel) -> list[str]:
@@ -316,7 +269,7 @@ def render_startup_dashboard(
     terminal_width: Optional[int] = None,
     terminal_height: Optional[int] = None,
 ) -> None:
-    """The original mascot beside the model/workspace summary, then notes."""
+    """The robot beside the model/workspace summary, then notes."""
     del rich_box, terminal_height
     from .robot import ROBOT_ROW_COUNT, get_robot_row
 
@@ -335,18 +288,13 @@ def render_startup_dashboard(
     from rich.text import Text
 
     width = terminal_width or _console_width(console)
-    face, columns, rows, sequence = _mascot(console, width)
+    face, columns = _mascot(console)
     block = Table.grid(padding=(0, 2))
     block.add_column(no_wrap=True, width=columns or None)
     # One line per row, cut rather than wrapped, so the block keeps its height.
     block.add_column(no_wrap=True, overflow="ellipsis", max_width=max(10, width - columns - 3))
     block.add_row(face, Text.from_markup("\n".join(_summary_lines(view)), overflow="ellipsis"))
     console.print(block)
-    if sequence:
-        # Reserve the rows first (also handles scrolling), draw at their top,
-        # then restore the cursor before the notes and prompt are printed.
-        console.file.write(f"\x1b7\x1b[{rows}A\r{sequence}\x1b8")
-        console.file.flush()
     for note in _notes(view):
         console.print(Text.from_markup("  " + note, overflow="ellipsis"), no_wrap=True)
 

{aria_code-0.118.0 → aria_code-0.119.0}/src/aria_code/ui/robot.py

@@ -10,8 +10,10 @@ screen, base, feet), each unit one sub-pixel across and half a sub-pixel down
 — which, with terminal cells twice as tall as wide, keeps the units square.
 The eye is two quadrants (a square), the dash a lower-quarter block (2:1),
 the cap corners ▛ ▜, the ears ▌ ▐, the four feet ▀. Colours are sampled from
-the artwork; only the body is deepened on light terminals, where the
-artwork's cream would vanish against a white background.
+the artwork (docs/assets/aria-robot.png) on this grid; only the light-theme
+greys and body are deepened, where the artwork's would vanish against a
+white background. The orange seam between body and base is left out: at
+this size it would share a cell with two other colours, and a cell has two.
 
 Runtime state is shown by the compact status dot, not by the mascot.
 """
@@ -88,22 +90,22 @@ _STATUS = {
 # resolves to a Rich style ("<fg> on <bg>").
 _COLOURS = {
     "dark": {
-        "body":   "#F3EEE9",   # cream shell
-        "screen": "#0B0A09",   # black screen
-        "eye":    "#F1EDE9",   # square eye
-        "dash":   "#EDBC7F",   # orange dash
-        "ear":    "#989088",   # grey ear nub
-        "base":   "#CDAD8F",   # tan underside with the orange seam
-        "leg":    "#B4AEA6",   # grey feet
+        "body":   "#F4EBE4",   # cream shell
+        "screen": "#0E0E0E",   # black screen
+        "eye":    "#FFFDF5",   # square eye, brighter than the shell
+        "dash":   "#F9B467",   # orange dash
+        "ear":    "#B6ADA4",   # grey ear nub
+        "base":   "#B6ADA4",   # grey underside
+        "leg":    "#D5CCC3",   # light grey feet
     },
     "light": {
         "body":   "#E6DDD0",   # deeper cream: the artwork's would vanish on white
-        "screen": "#0B0A09",
-        "eye":    "#F6F2EA",
-        "dash":   "#EDBC7F",
-        "ear":    "#8C847B",
-        "base":   "#C9A57F",
-        "leg":    "#A39C93",
+        "screen": "#0E0E0E",
+        "eye":    "#FFFDF5",
+        "dash":   "#F9B467",
+        "ear":    "#9C948B",
+        "base":   "#9C948B",
+        "leg":    "#B8AFA6",
     },
 }
 

{aria_code-0.118.0 → aria_code-0.119.0/src/aria_code.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aria-code
-Version: 0.118.0
+Version: 0.119.0
 Summary: Open-source AI agent for coding, financial analysis and logistics operations: numbers you can check, client data kept apart, actions a person approves
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/artheras/aria-code
@@ -172,7 +172,7 @@ Numbers you can check, client data kept apart, actions a person approves.</p>
 <p align="center">
   <a href="https://www.npmjs.com/package/@artheras/aria-code"><img src="https://img.shields.io/npm/v/@artheras/aria-code/latest?style=flat-square&logo=npm&label=npm" alt="npm version"></a>
   <!-- Release automation pins PyPI: the default endpoint still selects legacy 4.x. -->
-  <a href="https://pypi.org/project/aria-code/0.118.0/"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Faria-code%2F0.118.0%2Fjson&amp;query=%24.info.version&amp;prefix=v&amp;style=flat-square&amp;logo=pypi&amp;label=PyPI&amp;color=blue&amp;cacheSeconds=300" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/aria-code/0.119.0/"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Faria-code%2F0.119.0%2Fjson&amp;query=%24.info.version&amp;prefix=v&amp;style=flat-square&amp;logo=pypi&amp;label=PyPI&amp;color=blue&amp;cacheSeconds=300" alt="PyPI version"></a>
   <a href="https://github.com/artheras/aria-code/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/artheras/aria-code/ci.yml?branch=main&style=flat-square&logo=githubactions&label=CI" alt="CI status"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-64748b?style=flat-square" alt="Apache License 2.0"></a>
 </p>

{aria_code-0.118.0 → aria_code-0.119.0}/src/aria_code.egg-info/SOURCES.txt

@@ -496,14 +496,11 @@ src/aria_code/ui/__init__.py
 src/aria_code/ui/banner.py
 src/aria_code/ui/completer.py
 src/aria_code/ui/console.py
-src/aria_code/ui/image_render.py
 src/aria_code/ui/input_box.py
 src/aria_code/ui/mentions.py
 src/aria_code/ui/picker.py
 src/aria_code/ui/robot.py
-src/aria_code/ui/robot_pixels.py
 src/aria_code/ui/startup_dashboard.py
-src/aria_code/ui/assets/aria-robot.png
 src/aria_code/ui/render/__init__.py
 src/aria_code/ui/render/finance.py
 src/aria_code/ui/render/market.py

aria_code-0.119.0/tests/test_robot_artwork.py

@@ -0,0 +1,50 @@
+"""The startup robot is always the compact 9 × 4 one, as in Claude Code.
+
+A larger rendition (inline PNG, or the PNG resampled to half-blocks) took
+18 columns × 8 rows or more beside four lines of text.
+"""
+
+import io
+import re
+
+from rich.console import Console
+
+from aria_code.ui import banner
+
+
+def _console(stream=None, **kwargs):
+    return Console(file=stream or io.StringIO(), width=100, force_terminal=True,
+                   color_system="truecolor", **kwargs)
+
+
+def test_the_robot_is_compact_in_a_wide_colour_terminal(monkeypatch):
+    monkeypatch.delenv("ARIA_ROBOT_RENDER", raising=False)
+    face, columns = banner._mascot(_console())
+    assert columns == 9
+    assert [len(row) for row in face.plain.splitlines()] == [9, 9, 9, 9]
+
+
+def test_off_hides_the_robot(monkeypatch):
+    monkeypatch.setenv("ARIA_ROBOT_RENDER", "off")
+    face, columns = banner._mascot(_console())
+    assert columns == 0 and face.plain == ""
+
+
+def test_no_inline_image_is_written_even_in_iterm(monkeypatch):
+    from aria_code.ui.startup_dashboard import StartupDashboardViewModel
+
+    class Terminal(io.StringIO):
+        def isatty(self):
+            return True
+
+    monkeypatch.setenv("TERM_PROGRAM", "iTerm.app")
+    monkeypatch.delenv("ARIA_ROBOT_RENDER", raising=False)
+    stream = Terminal()
+    view = StartupDashboardViewModel(version="1", runtime_label="Google Cloud", cwd="~/project",
+                                     control_status="workspace-write · network on", health_status="ready",
+                                     tool_count=90, skill_count=14, update_notice="Update available: aria update")
+    banner.render_startup_dashboard(view, console=_console(stream), has_rich=True)
+    output = stream.getvalue()
+    assert "\x1b]1337;" not in output and "\x1b_G" not in output
+    text = re.sub(r"\x1b\[[0-9;]*m", "", output)
+    assert "▗▛▀▀▀▀▀▜▖" in text and "Update available" in text

{aria_code-0.118.0 → aria_code-0.119.0}/tests/test_ui_robot_banner.py

@@ -34,13 +34,14 @@ class RobotBannerTests(unittest.TestCase):
         ])
 
     def test_robot_uses_the_artworks_colours(self):
+        # Sampled from docs/assets/aria-robot.png on the robot's 18×8 grid.
         styles = [style for row in range(ROBOT_ROW_COUNT) for style, _ in get_robot_row(2, row)]
 
-        self.assertIn("#F3EEE9 on #0B0A09", styles)   # cream shell around the black screen
-        self.assertIn("#F1EDE9 on #0B0A09", styles)   # square eye
-        self.assertIn("#EDBC7F on #0B0A09", styles)   # orange dash
-        self.assertIn("#989088 on #F3EEE9", styles)   # grey ear nub on the shell
-        self.assertIn("#CDAD8F on #B4AEA6", styles)   # tan base over a grey foot
+        self.assertIn("#F4EBE4 on #0E0E0E", styles)   # cream shell around the black screen
+        self.assertIn("#FFFDF5 on #0E0E0E", styles)   # square eye, brighter than the shell
+        self.assertIn("#F9B467 on #0E0E0E", styles)   # orange dash
+        self.assertIn("#B6ADA4 on #F4EBE4", styles)   # grey ear nub on the shell
+        self.assertIn("#B6ADA4 on #D5CCC3", styles)   # grey base over a light foot
 
     def test_robot_palette_follows_theme(self):
         robot._theme_cache = "light"
@@ -49,10 +50,10 @@ class RobotBannerTests(unittest.TestCase):
         dark = [s for row in range(ROBOT_ROW_COUNT) for s, _ in get_robot_row(2, row)]
 
         self.assertNotEqual(light, dark)
-        # Only the shell is deepened on a light terminal, where the artwork's
-        # cream would vanish; the screen and the orange dash stay as drawn.
-        self.assertIn("#E6DDD0 on #0B0A09", light)
-        self.assertIn("#EDBC7F on #0B0A09", light)
+        # The shell and greys are deepened on a light terminal, where the
+        # artwork's would vanish; the screen, eye and dash stay as drawn.
+        self.assertIn("#E6DDD0 on #0E0E0E", light)
+        self.assertIn("#F9B467 on #0E0E0E", light)
 
     def test_idle_status_dot_does_not_blink_to_dim_dot(self):
         set_robot_state(RobotState.IDLE)

{aria_code-0.118.0 → aria_code-0.119.0}/tests/test_wheel_is_installable.py

@@ -95,8 +95,7 @@ class BuiltWheel(unittest.TestCase):
 
     def test_it_contains_the_modules_the_entry_point_needs(self):
         for needed in ("aria_code/aria_cli.py", "aria_code/apps/cli/main.py",
-                       "aria_code/doctor.py", "aria_code/ui/assets/aria-robot.png",
-                       "aria_code/ui/robot_pixels.py"):
+                       "aria_code/doctor.py"):
             with self.subTest(module=needed):
                 self.assertIn(needed, self.names)
 

aria_code-0.118.0/src/aria_code/ui/image_render.py

@@ -1,239 +0,0 @@
-"""Terminal image rendering — show a real PNG in the terminal, with fallback.
-
-Three layered techniques, best-first (exactly what chafa/viu/timg do):
-
-  1. iTerm2 inline images  (OSC 1337)         — iTerm2, WezTerm, ghostty
-  2. Kitty graphics protocol                   — kitty, ghostty
-  3. Half-block + truecolor downscale (``▀``)   — any 24-bit colour terminal
-
-Layer 3 is the universal floor: it resizes the image and prints one ``▀`` per
-cell, packing two vertical pixels into each character (foreground = top pixel,
-background = bottom pixel). Pixel-art sources render almost perfectly this way.
-
-Used for the startup mascot banner, and reusable for ``/vision`` previews,
-``/screenshot`` echoes, and inline quant charts.
-
-CLI:  python3 -m ui.image_render <path> [width] [--half|--iterm|--kitty]
-"""
-
-from __future__ import annotations
-
-import base64
-import os
-import sys
-
-try:
-    from PIL import Image
-    _HAS_PIL = True
-except Exception:  # pragma: no cover - PIL is a hard dep for this module
-    _HAS_PIL = False
-
-
-# ── Terminal capability detection ────────────────────────────────────────────
-def _in_tmux() -> bool:
-    # Image protocols need passthrough wrapping inside tmux; play safe and fall
-    # back to half-blocks rather than spraying escape bytes the pane won't eat.
-    return bool(os.environ.get("TMUX"))
-
-
-def supports_iterm() -> bool:
-    if _in_tmux():
-        return False
-    if os.environ.get("TERM_PROGRAM") in ("iTerm.app", "WezTerm", "ghostty"):
-        return True
-    return bool(os.environ.get("ITERM_SESSION_ID"))
-
-
-def supports_kitty() -> bool:
-    if _in_tmux():
-        return False
-    if os.environ.get("KITTY_WINDOW_ID") or os.environ.get("TERM_PROGRAM") == "ghostty":
-        return True
-    return os.environ.get("TERM") == "xterm-kitty"
-
-
-def supports_truecolor() -> bool:
-    if os.environ.get("COLORTERM") in ("truecolor", "24bit"):
-        return True
-    # Most modern terminals are truecolor even without advertising it; only the
-    # genuinely ancient (TERM=dumb / linux console) are not.
-    return os.environ.get("TERM", "") not in ("", "dumb", "linux")
-
-
-def best_method() -> str:
-    """Return the best available render method for the current terminal."""
-    if supports_kitty():
-        return "kitty"
-    if supports_iterm():
-        return "iterm"
-    if supports_truecolor():
-        return "half"
-    return "none"
-
-
-# ── Protocol emitters ────────────────────────────────────────────────────────
-def _iterm_sequence(png_bytes: bytes, cells_wide: int, cells_high: int | None = None) -> str:
-    """iTerm2 OSC 1337 inline image. Width in character cells, height auto."""
-    b64 = base64.b64encode(png_bytes).decode()
-    return (
-        f"\x1b]1337;File=inline=1;width={cells_wide};"
-        + (f"height={cells_high};" if cells_high else "")
-        + f"preserveAspectRatio=1:{b64}\x07"
-    )
-
-
-def _kitty_sequence(png_bytes: bytes, cells_wide: int, cells_high: int | None = None) -> str:
-    """Kitty graphics protocol, PNG payload (f=100), chunked at 4096 bytes."""
-    b64 = base64.b64encode(png_bytes).decode()
-    chunk = 4096
-    parts: list[str] = []
-    i = 0
-    first = True
-    while i < len(b64):
-        piece = b64[i : i + chunk]
-        i += chunk
-        more = 1 if i < len(b64) else 0
-        if first:
-            # a=T transmit+display, f=100 PNG, c=columns to scale into
-            ctrl = f"a=T,f=100,c={cells_wide},m={more}"
-            if cells_high:
-                ctrl += f",r={cells_high},C=1"
-            first = False
-        else:
-            ctrl = f"m={more}"
-        parts.append(f"\x1b_G{ctrl};{piece}\x1b\\")
-    return "".join(parts)
-
-
-# ── Half-block fallback (universal) ──────────────────────────────────────────
-_UPPER = "▀"  # ▀ upper half block
-
-
-def autocrop(img: "Image.Image", tol: int = 18, pad: int = 1) -> "Image.Image":
-    """Trim a uniform border (e.g. the robot's black canvas) so the subject
-    fills the frame. Background colour is sampled from the top-left pixel;
-    pixels within ``tol`` of it are treated as border. Falls back to the
-    original image if nothing distinct is found.
-    """
-    from PIL import ImageChops, Image as _I
-
-    rgb = img.convert("RGB")
-    bg = _I.new("RGB", rgb.size, rgb.getpixel((0, 0)))
-    diff = ImageChops.difference(rgb, bg).convert("L")
-    box = diff.point(lambda p: 255 if p > tol else 0).getbbox()
-    if not box:
-        return img
-    l, t, r, b = box
-    l, t = max(0, l - pad), max(0, t - pad)
-    r, b = min(img.width, r + pad), min(img.height, b + pad)
-    return img.crop((l, t, r, b))
-
-
-def half_block_render(img: "Image.Image", cells_wide: int = 36) -> str:
-    """Render a PIL image as ``▀`` half-blocks with 24-bit colour.
-
-    Each character is 1 pixel wide and 2 pixels tall, so a square source maps to
-    ``cells_wide`` columns × ``cells_wide // 2`` rows. Foreground paints the top
-    pixel, background the bottom one.
-    """
-    img = img.convert("RGB")
-    w, h = img.size
-    # Sample at cells_wide × (2 px per row). Rows chosen to preserve aspect once
-    # the 1:2 cell shape is accounted for, so on-screen proportions match.
-    px_w = max(1, cells_wide)
-    px_h = max(2, round(px_w * h / w))
-    if px_h % 2:
-        px_h += 1  # even rows so every cell has a top+bottom pixel
-    small = img.resize((px_w, px_h), Image.LANCZOS)
-    px = small.load()
-
-    lines: list[str] = []
-    for row in range(0, px_h, 2):
-        cells: list[str] = []
-        for x in range(px_w):
-            tr, tg, tb = px[x, row]
-            br, bg, bb = px[x, row + 1]
-            cells.append(
-                f"\x1b[38;2;{tr};{tg};{tb};48;2;{br};{bg};{bb}m{_UPPER}"
-            )
-        cells.append("\x1b[0m")
-        lines.append("".join(cells))
-    return "\n".join(lines)
-
-
-# ── Public entry point ───────────────────────────────────────────────────────
-def render_image(
-    path: str,
-    cells_wide: int = 36,
-    method: str | None = None,
-    crop: bool | tuple[int, int, int, int] = True,
-    cells_high: int | None = None,
-) -> str | None:
-    """Return a printable string that draws ``path`` in the terminal.
-
-    ``method`` forces one of ``iterm`` / ``kitty`` / ``half``; default auto-detects.
-    ``crop`` trims a uniform border first so the subject fills the frame.
-    Returns ``None`` if the image can't be loaded or no method is usable.
-    """
-    chosen = method or best_method()
-
-    # Protocol path (iTerm2/Kitty) only needs the raw PNG bytes — the terminal
-    # scales them. PIL is optional here: with it we autocrop so the subject
-    # fills the frame; without it we send the file as-is. This means the real
-    # image still shows even when Pillow isn't installed in the venv.
-    if chosen in ("iterm", "kitty"):
-        try:
-            if _HAS_PIL:
-                import io
-
-                with Image.open(path) as source:
-                    img = source.crop(crop) if isinstance(crop, tuple) else (autocrop(source) if crop else source)
-                    buf = io.BytesIO()
-                    img.convert("RGB").save(buf, format="PNG")
-                data = buf.getvalue()
-            else:
-                with open(path, "rb") as fh:
-                    data = fh.read()
-            if chosen == "iterm":
-                return _iterm_sequence(data, cells_wide, cells_high)
-            return _kitty_sequence(data, cells_wide, cells_high)
-        except Exception:
-            chosen = "half"  # fall through to the universal path
-
-    # Half-block fallback needs PIL to resize.
-    if chosen == "half" and _HAS_PIL:
-        try:
-            with Image.open(path) as source:
-                img = source.crop(crop) if isinstance(crop, tuple) else (autocrop(source) if crop else source)
-                return half_block_render(img, cells_wide)
-        except Exception:
-            return None
-    return None
-
-
-def _main(argv: list[str]) -> int:
-    args = [a for a in argv if not a.startswith("--")]
-    flags = {a for a in argv if a.startswith("--")}
-    if not args:
-        print("usage: python3 -m ui.image_render <image> [width] [--half|--iterm|--kitty]")
-        return 2
-    path = args[0]
-    width = int(args[1]) if len(args) > 1 and args[1].isdigit() else 36
-    method = None
-    if "--half" in flags:
-        method = "half"
-    elif "--iterm" in flags:
-        method = "iterm"
-    elif "--kitty" in flags:
-        method = "kitty"
-    out = render_image(path, width, method)
-    if out is None:
-        print(f"(cannot render {path}; method={method or best_method()})")
-        return 1
-    sys.stdout.write(out + "\n")
-    sys.stdout.flush()
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(_main(sys.argv[1:]))