lql-cli 0.4.0__tar.gz → 0.6.0__tar.gz

lql_cli-0.4.0/README.md → lql_cli-0.6.0/PKG-INFO

@@ -1,8 +1,24 @@
+Metadata-Version: 2.4
+Name: lql-cli
+Version: 0.6.0
+Summary: lql — CLI for the Liquid DataViewer platform
+Project-URL: Homepage, https://github.com/Liquid4All/lql
+Author: Liquid AI
+License: MIT
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27
+Requires-Dist: huggingface-hub>=0.24
+Requires-Dist: rich>=13.0
+Requires-Dist: textual-image>=0.7
+Requires-Dist: textual>=0.50
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
 # lql — Liquid Query Language CLI
 
 Scriptable CLI for the [Liquid DataViewer](https://dataviewer.liquid.ai) platform. Designed for both humans and AI agents (Claude Code, Codex, etc.) to automate datasets, eval analysis, spec docs, annotations, and more.
 
-A Python package (Python ≥ 3.9), published on PyPI as **[`lql-cli`](https://pypi.org/project/lql-cli/)** — the installed command is `lql`.
+A Python package (Python ≥ 3.12), published on PyPI as **[`lql-cli`](https://pypi.org/project/lql-cli/)** — the installed command is `lql`.
 
 ## Quick start
 
@@ -14,7 +30,7 @@ lql skills install                    # teach Claude Code + Codex how to use lql
 
 ## Install
 
-`lql` is a Python package (requires Python ≥ 3.9), distributed on PyPI as **`lql-cli`** (the
+`lql` is a Python package (requires Python ≥ 3.12), distributed on PyPI as **`lql-cli`** (the
 command it installs is `lql`). Install it as a standalone CLI tool with
 [uv](https://docs.astral.sh/uv/):
 
@@ -84,6 +100,13 @@ lql logout
 
 ## Command reference
 
+Running a group with no subcommand (e.g. `lql datasets`) lists its subcommands.
+For faster typing, **aliases** and **unique prefixes** resolve everywhere:
+group aliases (`ds`, `ws`, `ev`, `ann`, `hl`, `rep`, `bkt`, `iss`), verb aliases
+(`ls`=list, `rm`/`del`=delete, `new`/`mk`=create, `info`=show), and prefixes
+(`lql datasets l` → `list`). So `lql ds ls --workspace <id>` ≡ `lql datasets list
+--workspace <id>`. The canonical names below always work (use those in scripts).
+
 ### Auth
 
 ```
@@ -95,7 +118,7 @@ lql whoami                       Show current user
 ### Workspaces
 
 ```
-lql workspaces list                              List all workspaces
+lql workspaces list [--search <text>]            List workspaces (--search filters by name/slug)
 lql workspaces create <name>                     Create a workspace
 lql workspaces show <id>                         Show workspace details
 lql workspaces update <id> --name <n>            Rename a workspace
@@ -108,7 +131,7 @@ lql workspaces members remove <id> <uid>         Remove member by user ID
 ### Datasets
 
 ```
-lql datasets list [--workspace <id>]             List datasets
+lql datasets list [--workspace <id>] [--search <text>]   List datasets (--search filters by name/HF repo)
 lql datasets show <id>                           Show dataset details
 lql datasets create --workspace <id> --hf-repo <repo> [--name <n>] [--split <s>]
 lql datasets create --workspace <id> --hf-bucket <org/bucket> --key <path-or-glob> [--name <n>]
@@ -158,11 +181,20 @@ lql preview tatsu-lab/alpaca --hf
 lql preview org/name --hf --split validation --workspace <id>
 ```
 
-**Navigation** — two modes, toggle with `m` / `Tab`:
+**Media.** Images render **inline** in terminals that support an image protocol
+(Kitty/Ghostty, iTerm2, Sixel; falls back to a compact `🖼 …` placeholder
+elsewhere) — both multimodal `image_url`/data-URI segments and image-mode
+columns. Audio can't play inline in a terminal, so each clip shows a `♪` line
+and **`p` plays** the current sample's audio via the system player (`afplay`/
+`open`). Images render inline in pager mode (one sample at a time); scroll mode
+shows placeholders to avoid decoding the whole buffer.
+
+**Navigation** — two modes, toggle with `m`:
 
 - **pager** (default): one sample at a time · `←/→` or `n`/`b` switch samples · `↑/↓`/`j`/`k`/PgUp-Dn scroll
 - **scroll**: all samples in one buffer · `n`/`b` jump between samples · arrows scroll
-- `q` quits
+- **copy**: `Tab`/`Shift+Tab` move a highlight between blocks · `c` copies the focused message/field · `Y` copies the whole sample as JSON (via OSC 52 — reaches your **local** clipboard over SSH where the terminal supports it, e.g. Ghostty/iTerm2; not macOS Terminal)
+- `p` play audio · `q` quits
 
 ```
 lql preview examples/agent-traces.jsonl     # 20-sample file of agent-trace/tool-use formats

lql_cli-0.4.0/PKG-INFO → lql_cli-0.6.0/README.md

@@ -1,23 +1,8 @@
-Metadata-Version: 2.4
-Name: lql-cli
-Version: 0.4.0
-Summary: lql — CLI for the Liquid DataViewer platform
-Project-URL: Homepage, https://github.com/Liquid4All/lql
-Author: Liquid AI
-License: MIT
-Requires-Python: >=3.9
-Requires-Dist: httpx>=0.27
-Requires-Dist: huggingface-hub>=0.24
-Requires-Dist: rich>=13.0
-Requires-Dist: textual>=0.50
-Requires-Dist: typer>=0.12
-Description-Content-Type: text/markdown
-
 # lql — Liquid Query Language CLI
 
 Scriptable CLI for the [Liquid DataViewer](https://dataviewer.liquid.ai) platform. Designed for both humans and AI agents (Claude Code, Codex, etc.) to automate datasets, eval analysis, spec docs, annotations, and more.
 
-A Python package (Python ≥ 3.9), published on PyPI as **[`lql-cli`](https://pypi.org/project/lql-cli/)** — the installed command is `lql`.
+A Python package (Python ≥ 3.12), published on PyPI as **[`lql-cli`](https://pypi.org/project/lql-cli/)** — the installed command is `lql`.
 
 ## Quick start
 
@@ -29,7 +14,7 @@ lql skills install                    # teach Claude Code + Codex how to use lql
 
 ## Install
 
-`lql` is a Python package (requires Python ≥ 3.9), distributed on PyPI as **`lql-cli`** (the
+`lql` is a Python package (requires Python ≥ 3.12), distributed on PyPI as **`lql-cli`** (the
 command it installs is `lql`). Install it as a standalone CLI tool with
 [uv](https://docs.astral.sh/uv/):
 
@@ -99,6 +84,13 @@ lql logout
 
 ## Command reference
 
+Running a group with no subcommand (e.g. `lql datasets`) lists its subcommands.
+For faster typing, **aliases** and **unique prefixes** resolve everywhere:
+group aliases (`ds`, `ws`, `ev`, `ann`, `hl`, `rep`, `bkt`, `iss`), verb aliases
+(`ls`=list, `rm`/`del`=delete, `new`/`mk`=create, `info`=show), and prefixes
+(`lql datasets l` → `list`). So `lql ds ls --workspace <id>` ≡ `lql datasets list
+--workspace <id>`. The canonical names below always work (use those in scripts).
+
 ### Auth
 
 ```
@@ -110,7 +102,7 @@ lql whoami                       Show current user
 ### Workspaces
 
 ```
-lql workspaces list                              List all workspaces
+lql workspaces list [--search <text>]            List workspaces (--search filters by name/slug)
 lql workspaces create <name>                     Create a workspace
 lql workspaces show <id>                         Show workspace details
 lql workspaces update <id> --name <n>            Rename a workspace
@@ -123,7 +115,7 @@ lql workspaces members remove <id> <uid>         Remove member by user ID
 ### Datasets
 
 ```
-lql datasets list [--workspace <id>]             List datasets
+lql datasets list [--workspace <id>] [--search <text>]   List datasets (--search filters by name/HF repo)
 lql datasets show <id>                           Show dataset details
 lql datasets create --workspace <id> --hf-repo <repo> [--name <n>] [--split <s>]
 lql datasets create --workspace <id> --hf-bucket <org/bucket> --key <path-or-glob> [--name <n>]
@@ -173,11 +165,20 @@ lql preview tatsu-lab/alpaca --hf
 lql preview org/name --hf --split validation --workspace <id>
 ```
 
-**Navigation** — two modes, toggle with `m` / `Tab`:
+**Media.** Images render **inline** in terminals that support an image protocol
+(Kitty/Ghostty, iTerm2, Sixel; falls back to a compact `🖼 …` placeholder
+elsewhere) — both multimodal `image_url`/data-URI segments and image-mode
+columns. Audio can't play inline in a terminal, so each clip shows a `♪` line
+and **`p` plays** the current sample's audio via the system player (`afplay`/
+`open`). Images render inline in pager mode (one sample at a time); scroll mode
+shows placeholders to avoid decoding the whole buffer.
+
+**Navigation** — two modes, toggle with `m`:
 
 - **pager** (default): one sample at a time · `←/→` or `n`/`b` switch samples · `↑/↓`/`j`/`k`/PgUp-Dn scroll
 - **scroll**: all samples in one buffer · `n`/`b` jump between samples · arrows scroll
-- `q` quits
+- **copy**: `Tab`/`Shift+Tab` move a highlight between blocks · `c` copies the focused message/field · `Y` copies the whole sample as JSON (via OSC 52 — reaches your **local** clipboard over SSH where the terminal supports it, e.g. Ghostty/iTerm2; not macOS Terminal)
+- `p` play audio · `q` quits
 
 ```
 lql preview examples/agent-traces.jsonl     # 20-sample file of agent-trace/tool-use formats

{lql_cli-0.4.0 → lql_cli-0.6.0}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "lql-cli"
-version = "0.4.0"
+version = "0.6.0"
 description = "lql — CLI for the Liquid DataViewer platform"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.12"
 license = { text = "MIT" }
 authors = [{ name = "Liquid AI" }]
 dependencies = [
@@ -16,6 +16,7 @@ dependencies = [
     "rich>=13.0",
     "huggingface-hub>=0.24",
     "textual>=0.50",
+    "textual-image>=0.7",
 ]
 
 [project.scripts]

lql_cli-0.6.0/src/lql/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.6.0"

lql_cli-0.6.0/src/lql/_group.py

@@ -0,0 +1,50 @@
+"""A Typer/Click group that adds two conveniences to every command group:
+
+  * short aliases  — `ds`→`datasets`, `ws`→`workspaces`, `ls`→`list`, …
+  * unique-prefix matching — `lql datasets l` resolves to `list`
+
+Both are purely additive: the canonical command names always work, and
+`lql instructions` documents the canonical forms, so agents are unaffected —
+these are conveniences for humans typing at a prompt.
+"""
+
+from typer.core import TyperGroup
+
+# alias -> canonical. Kept intentionally small and unambiguous.
+ALIASES = {
+    # command groups
+    "ds": "datasets",
+    "ws": "workspaces",
+    "ev": "eval",
+    "evals": "eval",
+    "ann": "annotations",
+    "hl": "highlights",
+    "rep": "reports",
+    "bkt": "buckets",
+    "iss": "issues",
+    # verbs
+    "ls": "list",
+    "rm": "delete",
+    "del": "delete",
+    "new": "create",
+    "mk": "create",
+    "info": "show",
+}
+
+
+class AliasGroup(TyperGroup):
+    def get_command(self, ctx, name):
+        # Exact name first so a real command is never shadowed by an alias;
+        # then explicit alias; then an unambiguous prefix.
+        cmd = super().get_command(ctx, name)
+        if cmd is not None:
+            return cmd
+        alias = ALIASES.get(name)
+        if alias is not None:
+            cmd = super().get_command(ctx, alias)
+            if cmd is not None:
+                return cmd
+        matches = [c for c in self.list_commands(ctx) if c.startswith(name)]
+        if len(matches) == 1:
+            return super().get_command(ctx, matches[0])
+        return None

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/cli.py

@@ -3,6 +3,8 @@ from typing import Annotated, Optional
 
 import typer
 
+from ._group import AliasGroup
+
 from . import __version__
 from .output import print_error
 from .commands import (
@@ -32,6 +34,7 @@ app = typer.Typer(
     ),
     no_args_is_help=True,
     add_completion=False,
+    cls=AliasGroup,
 )
 
 

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/annotations.py

@@ -3,13 +3,15 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_json, print_table
 from ..sessions import resolve_session_id
 from ..util import q
 
-app = typer.Typer(help="Manage annotations")
+app = typer.Typer(help="Manage annotations", cls=AliasGroup, no_args_is_help=True)
 
 SessionOpt = Annotated[Optional[str], typer.Option("--session", help="Target a specific review session (advanced)")]
 

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/auth.py

@@ -7,6 +7,8 @@ from typing import Annotated, Optional
 import httpx
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..config import get_api_url, read_config, validate_api_url, write_config
@@ -148,7 +150,7 @@ def whoami(
         )
 
 
-auth_app = typer.Typer(help="Authentication commands")
+auth_app = typer.Typer(help="Authentication commands", cls=AliasGroup, no_args_is_help=True)
 auth_app.command("login")(login)
 auth_app.command("logout")(logout)
 auth_app.command("whoami")(whoami)

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/buckets.py

@@ -4,12 +4,14 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_json, print_table
 from ..util import q
 
-app = typer.Typer(help="Manage S3 and Hugging Face buckets")
+app = typer.Typer(help="Manage S3 and Hugging Face buckets", cls=AliasGroup, no_args_is_help=True)
 
 
 @app.command("list")

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/datasets.py

@@ -6,12 +6,14 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_error, print_json, print_table
 from ..util import q
 
-app = typer.Typer(help="Manage datasets")
+app = typer.Typer(help="Manage datasets", cls=AliasGroup, no_args_is_help=True)
 
 
 def _truncate(v: object, n: int = 80) -> str:
@@ -22,6 +24,10 @@ def _truncate(v: object, n: int = 80) -> str:
 @app.command("list")
 def list_datasets(
     workspace: Annotated[Optional[str], typer.Option("--workspace", help="Filter by workspace ID")] = None,
+    search: Annotated[
+        Optional[str],
+        typer.Option("--search", "-s", help="Filter by case-insensitive substring of name / HF repo"),
+    ] = None,
     json_out: JsonOpt = False,
     profile: ProfileOpt = None,
     api_url: ApiUrlOpt = None,
@@ -32,6 +38,15 @@ def list_datasets(
     if workspace:
         params["workspace_id"] = workspace
     items = client.get("/v1/datasets", params=params).json()
+    if search:
+        s = search.lower()
+        items = [
+            d
+            for d in items
+            if s in (d.get("display_name") or "").lower()
+            or s in (d.get("name") or "").lower()
+            or s in (d.get("hf_repo_id") or "").lower()
+        ]
     print_table(
         ["ID", "Name", "Workspace", "Rows"],
         [

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/edits.py

@@ -4,12 +4,14 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_error, print_json, print_table
 from ..util import q
 
-app = typer.Typer(help="Manage row edits")
+app = typer.Typer(help="Manage row edits", cls=AliasGroup, no_args_is_help=True)
 
 
 @app.command("list")

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/evals.py

@@ -6,12 +6,14 @@ from typing import Annotated, List, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_error, print_json, print_table
 from ..util import q
 
-app = typer.Typer(help="Inspect and analyze eval datasets (accuracy, failure modes, samples)")
+app = typer.Typer(help="Inspect and analyze eval datasets (accuracy, failure modes, samples)", cls=AliasGroup, no_args_is_help=True)
 
 # Mirrors front/src/lib/eval-dataset.ts so `eval samples --search` searches the
 # same prompt/response columns the eval views do.

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/highlights.py

@@ -3,13 +3,15 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_error, print_json, print_table
 from ..sessions import resolve_session_id
 from ..util import q
 
-app = typer.Typer(help="Manage highlights")
+app = typer.Typer(help="Manage highlights", cls=AliasGroup, no_args_is_help=True)
 
 SessionOpt = Annotated[Optional[str], typer.Option("--session", help="Target a specific review session (advanced)")]
 

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/instructions.py

@@ -8,6 +8,15 @@ INSTRUCTIONS = r"""
 CLI for the DataViewer platform. Gives agents and humans complete scriptable
 control over workspaces, datasets, spec docs, annotations, and S3.
 
+Running a group with no subcommand (e.g. `lql datasets`) lists its subcommands.
+
+Shortcuts (for humans typing): group aliases (`ds`=datasets, `ws`=workspaces,
+`ev`=eval, `ann`=annotations, `hl`=highlights, `rep`=reports, `bkt`=buckets,
+`iss`=issues), verb aliases (`ls`=list, `rm`/`del`=delete, `new`/`mk`=create,
+`info`=show), and unique prefixes (`lql datasets l` → list) all resolve.
+AGENTS: use the full canonical names shown throughout this reference — they are
+the stable contract; the aliases are conveniences layered on top.
+
 ## Authentication
 
   lql login                   # Open browser → click Authorize → token stored automatically
@@ -43,7 +52,7 @@ Pagination: --limit N --offset N on list commands.
 
 A workspace is the top-level container for datasets, spec docs, and members.
 
-  lql workspaces list
+  lql workspaces list [--search <text>]            # --search filters by name / slug substring
   lql workspaces create <name>
   lql workspaces show <id>
   lql workspaces update <id> --name <new-name>
@@ -54,7 +63,7 @@ A workspace is the top-level container for datasets, spec docs, and members.
 
 ## Datasets
 
-  lql datasets list [--workspace <id>]
+  lql datasets list [--workspace <id>] [--search <text>]   # --search filters by name / HF repo substring
   lql datasets show <id>
   lql datasets create --workspace <id> --hf-repo <org/repo> [--name <display>] [--split <split>]
   lql datasets create --workspace <id> --hf-bucket <org/bucket> --key <path-or-glob> [--name <display>]
@@ -94,10 +103,20 @@ Options: -c/--column (field(s) to treat as conversations; default auto-detect,
 repeatable), -n/--limit (page size when paging a platform dataset), --offset
 (start row index), --title, --hf, --split, --workspace, --profile, --api-url.
 
-Navigation: two modes toggled with m/Tab — pager (one sample at a time; ←/→ or
+Navigation: two modes toggled with m — pager (one sample at a time; ←/→ or
 n/b switch samples, ↑/↓/j/k scroll) and scroll (all samples; n/b jump between
 them). q quits. Works over plain SSH with no browser or port-forward.
 
+Media: images render inline in image-capable terminals (Kitty/Ghostty, iTerm2,
+Sixel; placeholder otherwise) for both multimodal image segments and image-mode
+columns; audio shows a ♪ line and `p` plays the current sample's clip via the
+system player (afplay/open).
+
+Copy: Tab/Shift+Tab move a highlight between blocks, `c` copies the focused
+message/field, `Y` copies the whole sample as JSON — via OSC 52, reaching the
+local clipboard over SSH where the terminal supports it (e.g. Ghostty/iTerm2;
+not macOS Terminal).
+
 ## Evals
 
 Eval datasets (evaluation-run output: each row a sample with a model 'response'
@@ -220,7 +239,9 @@ never goes stale.
 
 ### Discover workspaces and datasets
   lql workspaces list --json
+  lql workspaces list --search <name> --json        # find a workspace by name
   lql datasets list --workspace <id> --json
+  lql datasets list --search <name> --json           # find a dataset by name / HF repo
 
 ### Read dataset contents
   lql datasets schema <id> --json

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/issues.py

@@ -3,12 +3,14 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_json, print_table
 from ..util import q
 
-app = typer.Typer(help="Manage issues")
+app = typer.Typer(help="Manage issues", cls=AliasGroup, no_args_is_help=True)
 
 
 @app.command("list")

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/preview.py

@@ -35,6 +35,9 @@ _KNOWN_ROLES = {"user", "assistant", "system", "tool"}
 _AUDIO_EXT_RE = re.compile(r"\.(wav|mp3|ogg|flac|m4a|aac|opus|webm)(\?|$)", re.I)
 _AUDIO_KEYS = ["audio", "audio_url", "audio_data", "input_audio", "src", "url"]
 
+_IMAGE_EXT_RE = re.compile(r"\.(png|jpe?g|gif|webp|bmp|svg)(\?|$)", re.I)
+_IMAGE_KEYS = ["image", "image_url", "image_data", "img", "src", "url"]
+
 
 def _as_audio_url(v: object, key_hint: Optional[str] = None) -> Optional[str]:
     if isinstance(v, str) and v:
@@ -74,6 +77,58 @@ def _segment_audio_url(seg: dict) -> Optional[str]:
     return None
 
 
+def _as_image_url(v: object, key_hint: Optional[str] = None) -> Optional[str]:
+    """Mirror of _as_audio_url for images. Returns a data: URI or http(s) image
+    URL. Also handles HF Image structs ({bytes,path}) and {url}/{src} wrappers."""
+    if isinstance(v, str) and v:
+        if v.startswith("data:image/"):
+            return v
+        is_http = bool(re.match(r"^https?://", v, re.I))
+        if is_http and _IMAGE_EXT_RE.search(v):
+            return v
+        # Under an explicitly image-named key, accept an extensionless URL too
+        # (signed S3/HF/CDN links often have no .png/.jpg suffix).
+        if key_hint and "image" in key_hint.lower():
+            if is_http:
+                return v
+            if re.fullmatch(r"[A-Za-z0-9+/=\n]{100,}", v):
+                return f"data:image/png;base64,{v}"
+        return None
+    if isinstance(v, dict):
+        url = (v.get("url") if isinstance(v.get("url"), str) else None) or (
+            v.get("src") if isinstance(v.get("src"), str) else None
+        )
+        if url:
+            resolved = _as_image_url(url, key_hint)  # keep the hint so {image_url:{url}} resolves
+            if resolved:
+                return resolved
+        # HF datasets Image struct: {"bytes": <base64-or-bytes>, "path": ...}
+        b = v.get("bytes")
+        if isinstance(b, str) and b:
+            return b if b.startswith("data:") else f"data:image/png;base64,{b}"
+    return None
+
+
+def _segment_image_url(seg: dict) -> Optional[str]:
+    for key in _IMAGE_KEYS:
+        got = _as_image_url(seg.get(key), key)
+        if got:
+            return got
+    t = seg.get("type") if isinstance(seg.get("type"), str) else ""
+    if "image" in t.lower():
+        for v in seg.values():
+            got = _as_image_url(v, "image")
+            if got:
+                return got
+    return None
+
+
+def _is_image_string(s: object) -> bool:
+    """True for a plain value that is itself an image (data: URI or image URL) —
+    used to render top-level image-mode columns instead of a giant text blob."""
+    return isinstance(s, str) and (s.startswith("data:image/") or bool(re.match(r"^https?://", s, re.I) and _IMAGE_EXT_RE.search(s)))
+
+
 def _is_structured_content(val: object) -> bool:
     # Anchor recognizes text + audio segments; we also accept any explicitly
     # typed segment (e.g. {type:"image_url", ...}) so vision traces render too.
@@ -128,8 +183,8 @@ def _is_conversation(val: object) -> bool:
 def _flatten_structured(segs: List[dict]) -> str:
     parts = []
     for seg in segs:
-        if _segment_audio_url(seg):
-            continue  # surfaced separately as an <audio> player
+        if _segment_audio_url(seg) or _segment_image_url(seg):
+            continue  # surfaced separately (audio player / inline image)
         text = seg.get("text") if isinstance(seg.get("text"), str) else ""
         t = seg.get("type")
         if t and t != "text":
@@ -147,6 +202,7 @@ def _parse_messages(raw: List[dict]) -> List[dict]:
     for msg in raw:
         shape = _message_shape(msg)
         audio = None
+        images = None
         tool_calls = None
         if shape == "from-value":
             role, content = str(msg.get("from") or ""), str(msg.get("value") or "")
@@ -154,14 +210,16 @@ def _parse_messages(raw: List[dict]) -> List[dict]:
             role = str(msg.get("role") or "")
             segs = msg.get("content") or []
             content = _flatten_structured(segs)
-            urls = [u for u in (_segment_audio_url(s) for s in segs) if u]
-            audio = urls or None
+            audio = [u for u in (_segment_audio_url(s) for s in segs) if u] or None
+            images = [u for u in (_segment_image_url(s) for s in segs) if u] or None
         else:
             role, content = str(msg.get("role") or ""), str(msg.get("content") or "")
         if isinstance(msg.get("tool_calls"), list) and msg["tool_calls"]:
             tool_calls = _normalize_tool_calls(msg["tool_calls"])
         extras = {k: v for k, v in msg.items() if k not in _CONV_BASE_KEYS and v not in (None, "")}
-        out.append({"role": role, "content": content, "audio": audio, "tool_calls": tool_calls, "extras": extras or None})
+        out.append(
+            {"role": role, "content": content, "audio": audio, "images": images, "tool_calls": tool_calls, "extras": extras or None}
+        )
     return out
 
 

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/reports.py

@@ -3,13 +3,15 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_json, print_table
 from ..sessions import resolve_session_id
 from ..util import q
 
-app = typer.Typer(help="Manage reports")
+app = typer.Typer(help="Manage reports", cls=AliasGroup, no_args_is_help=True)
 
 SessionOpt = Annotated[Optional[str], typer.Option("--session", help="Target a specific review session (advanced)")]
 

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/skills.py

@@ -5,10 +5,12 @@ from typing import Annotated, List, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import JsonOpt
 from ..output import print_error, print_json
 
-app = typer.Typer(help="Install the lql agent skill into Claude Code and Codex")
+app = typer.Typer(help="Install the lql agent skill into Claude Code and Codex", cls=AliasGroup, no_args_is_help=True)
 
 # Thin pointer skill. The body deliberately does NOT embed the full reference —
 # it tells the agent to run `lql instructions`, which is always in sync with the

{lql_cli-0.4.0 → lql_cli-0.6.0}/src/lql/commands/spec.py

@@ -4,12 +4,14 @@ from typing import Annotated, Optional
 
 import typer
 
+from .._group import AliasGroup
+
 from .._opts import ApiUrlOpt, JsonOpt, ProfileOpt
 from ..api import ApiClient
 from ..output import print_error, print_json
 from ..util import q
 
-app = typer.Typer(help="Manage workspace spec docs")
+app = typer.Typer(help="Manage workspace spec docs", cls=AliasGroup, no_args_is_help=True)
 
 WorkspaceOpt = Annotated[str, typer.Option("--workspace", help="Workspace ID")]