@linxiraos/pi-wire 1.2.1 → 1.3.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 ## [Unreleased]
 
+## [1.3.1] - 2026-10-19
+
+- 版本线推进至 1.3.1；本版无独立用户可见变化。
+
+## [1.3.0] - 2026-10-18
+
+### Added
+
+- Added `TspPickerMark.icon`: an icon a picker mark draws instead of its initials when the terminal has it (`provider:<id>` names a model provider's logo)
+
 ## [1.2.0] - 2026-10-12
 
 ### Added

package/THIRD-PARTY-NOTICES.txt

@@ -8,8 +8,8 @@ no rights in third-party code, fonts, data, or marks identified below.
 PYTHON DEPENDENCY DISTRIBUTION ROLE
 ===================================
 
-omp-rpc has no third-party runtime dependencies. robomp declares FastAPI,
-Uvicorn, HTTPX, Pydantic, pydantic-settings, python-dotenv, Click, and omp-rpc
+zeta-rpc has no third-party runtime dependencies. robomp declares FastAPI,
+Uvicorn, HTTPX, Pydantic, pydantic-settings, python-dotenv, Click, and zeta-rpc
 as ordinary installer-resolved dependencies. The Python wheels do not vendor
 those projects; each dependency remains a separately installed distribution
 carrying its own license metadata and files. Container/system assemblers must
@@ -79,9 +79,9 @@ uutils coreutils (https://github.com/uutils/coreutils), MIT
 --------------------------------------------------------------------------------
 Covers: base32, base64, basename, cat, cksum (shared checksum machinery),
 b2sum, md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum, comm, cp,
-cut, date, dirname, head, hostname, ln, ls, mkdir, mktemp, mv, nproc, paste,
-printenv, readlink, realpath, rm, seq, sort, stat, tac, tail, tee, touch, tr,
-truncate, uname, uniq, wc, whoami, yes.
+cut, date, dirname, head, hostname, ln, ls, mkdir, mktemp, mv, nl, nproc,
+paste, printenv, readlink, realpath, rm, seq, sort, stat, tac, tail, tee,
+touch, tr, truncate, uname, uniq, wc, whoami, yes.
 
   Copyright (c) uutils developers
 
@@ -824,6 +824,56 @@ public licenses.
 
 Creative Commons may be contacted at creativecommons.org.
 
+-------------------------------------------------------------------------------
+scripts/brand/fonts/ANSI Shadow.flf, scripts/brand/fonts/mini.flf
+
+Two FIGlet font files from the standard FIGlet font distribution — the
+figlet.org font set shipped by figlet.js
+(https://github.com/patorjk/figlet.js/tree/master/fonts), fetched from
+figlet.js 1.8.0 — vendored so the welcome/splash brand art
+(`packages/tui/src/prompt/welcome.ts`) is generated reproducibly and offline
+by `bun scripts/brand/generate-logo-art.ts`. Both files are unmodified and
+retain their original FIGlet headers. They are build-time inputs only: no font
+file or font data is compiled into, or shipped with, a Zeta release artifact.
+The fonts' own headers carry their terms:
+
+- `ANSI Shadow.flf` — "ANSI Shadow". Author unknown ("Font Author: ?" in the
+  header); a TheDraw-archive font converted with the FIGlet font editor
+  (http://patorjk.com/figfont-editor). Distributed under the FIGlet font
+  license as carried by the standard FIGlet font set: free to use and
+  redistribute with the header intact.
+- `mini.flf` — "mini" by Glenn Chappell (4/93), from figlet release 2.1
+  (12 Aug 1994), "Includes ISO Latin-1"; modified by Paul Burton
+  <solution@earthlink.net> 12/96. Header grant: "Permission is hereby given to
+  modify this font, as long as the modifier's name is placed on a comment
+  line."
+
+FIGlet renderer — `figlet` 1.8.0 (https://github.com/patorjk/figlet.js), a
+root devDependency used only to generate the art at build time; it is not
+imported by any runtime bundle or shipped artifact.
+
+  MIT License
+
+  Copyright (C) 2014-present Patrick Gillespie and other contributors
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in
+  all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+
 BUN / NPM DEPENDENCY INVENTORY
 ==============================
 This inventory is traversed from bun.lock, not from the host node_modules tree.

package/dist/types/skillshare.d.ts

@@ -1,7 +1,11 @@
 /**
- * Wire contract for Skillshare (`skills.omp.sh`): an npm-style registry for
- * zetacode skills. Shared by the omp CLI (`zetacode skill …`), the Go server
- * (`stencil/apps/skills`), and its web UI (which mirrors this file).
+ * Wire contract for Skillshare: an npm-style registry for zetacode skills.
+ * Shared by the omp CLI (`zetacode skill …`) and a registry server.
+ *
+ * Zeta ships no registry: extra skills come from the npm package
+ * `@linxiraos/linxira-skills` (`npm i -g @linxiraos/linxira-skills`), and the
+ * registry commands only work after the user configures `skills.registryUrl`.
+ * See {@link SKILLS_REGISTRY_UNAVAILABLE}.
  *
  * Packages are scoped: `@scope/name`. A scope is a Stencil username claimed on
  * first publish and bound to the account's immutable `sub` forever (usernames
@@ -13,8 +17,17 @@
  * `metadata.version` (semver, required to publish), `metadata.keywords`
  * (comma-separated), `metadata.repository`, `metadata.homepage`.
  */
-/** Default registry; `skills.registryUrl` overrides it. */
-export declare const DEFAULT_SKILLS_URL = "https://skills.omp.sh";
+/**
+ * No skill registry ships with Zeta. Extra skills come from the npm package
+ * `@linxiraos/linxira-skills` (`npm i -g @linxiraos/linxira-skills`); the
+ * registry commands work against a user-configured `skills.registryUrl`.
+ */
+export declare const SKILLS_REGISTRY_UNAVAILABLE = "no skill registry ships with Zeta; extra skills come from the npm package @linxiraos/linxira-skills (npm i -g @linxiraos/linxira-skills), or set skills.registryUrl to your own registry";
+/**
+ * Default value of `skills.registryUrl`. Empty: no registry ships by default
+ * (see {@link SKILLS_REGISTRY_UNAVAILABLE}).
+ */
+export declare const DEFAULT_SKILLS_URL = "";
 /** Scopes are Stencil usernames (or registry orgs): lowercase letters, digits, underscores; 3–32 chars. */
 export declare const SKILL_SCOPE_RE: RegExp;
 /** Registry skill names: ASCII kebab-case, 1–64 chars, no leading/trailing/double hyphens. */
@@ -54,8 +67,12 @@ export declare const SKILL_HEADERS: {
     /** Optional GitHub Actions OIDC token (audience {@link SKILLS_OIDC_AUDIENCE}); verified server-side. */
     readonly githubOidc: "X-Skill-GitHub-OIDC";
 };
-/** Audience CI must request for GitHub Actions OIDC tokens. */
-export declare const SKILLS_OIDC_AUDIENCE = "skills.omp.sh";
+/**
+ * Audience CI requests for GitHub Actions OIDC tokens. No default ships: a
+ * self-hosted registry issues tokens for its own audience, so the value comes
+ * from the registry's configuration.
+ */
+export declare const SKILLS_OIDC_AUDIENCE = "";
 /** Env var holding a registry publish token for CI (`sks_…`); wins over the Stencil login. */
 export declare const SKILLS_TOKEN_ENV = "SKILLS_TOKEN";
 /** Public identity of an account: current username + avatar seed (hash of the immutable sub). */

package/dist/types/stream.d.ts

@@ -1,6 +1,9 @@
 /**
- * Wire types for `zetacode stream`: Twitch-style live screen sharing at
- * `live.omp.sh/<username>`.
+ * Wire types for `zetacode stream`: Twitch-style live screen sharing.
+ *
+ * Zeta ships no stream server, so there is no default host: `zetacode stream`
+ * and clip uploads only work against a compatible server the user configures
+ * in `stream.serverUrl`. See {@link STREAM_HOSTING_UNAVAILABLE}.
  *
  * Independent from collab. A publisher (`zetacode stream`) sends plaintext JSON
  * screen deltas for one or more panes (one pane per omp session attached in
@@ -12,8 +15,18 @@
  * strips every other sequence, truncates to the pane width, and redacts
  * secrets before a row leaves the session process.
  */
-/** Default stream server; its host route derives the channel from the bearer identity. */
-export declare const DEFAULT_STREAM_URL = "https://live.omp.sh";
+/**
+ * No stream or clip hosting ships with Zeta. `stream.serverUrl` has no
+ * default; point it at a compatible server you run yourself to enable
+ * `zetacode stream` (the server derives the channel from the bearer identity).
+ */
+export declare const STREAM_HOSTING_UNAVAILABLE = "no stream server ships with Zeta; set stream.serverUrl to a compatible server";
+/**
+ * Default value of `stream.serverUrl`. Empty: Zeta ships no stream hosting, so
+ * users must point the setting at their own compatible server (see
+ * {@link STREAM_HOSTING_UNAVAILABLE}).
+ */
+export declare const DEFAULT_STREAM_URL = "";
 /** Protocol version carried in `hello`/`snapshot`; the server rejects mismatches. */
 export declare const STREAM_PROTO = 1;
 /** Channel names are Stencil usernames: lowercase letters, numbers, and underscores; 3–32 chars. */
@@ -191,7 +204,7 @@ export interface ClipUploadResponse {
     /** Public clip page, `<server>/c/<id>`. */
     url: string;
 }
-/** HTTP/WS route layout of the stream server, relative to `DEFAULT_STREAM_URL`. */
+/** HTTP/WS route layout of the stream server, relative to the configured `stream.serverUrl`. */
 export declare const STREAM_ROUTES: {
     readonly channels: "/api/channels";
     readonly channel: (name: string) => string;

package/dist/types/tsp.d.ts

@@ -28,7 +28,7 @@ export declare const TSP_DEFAULT_CREDITS = 2;
 /** One-letter message verb. */
 export type TspVerb = "q" | "o" | "f" | "b" | "t" | "x" | "r" | "e";
 /** Every component kind in the v1 vocabulary. */
-export declare const TSP_KINDS: readonly ["col", "row", "card", "section", "rule", "spacer", "text", "md", "code", "diff", "ansi", "math", "image", "kv", "table", "tree", "badge", "kbd", "icon", "spinner", "shimmer", "elapsed", "progress", "rate", "list", "item", "tabs", "editor", "input", "status", "seg", "overlay", "toast", "rows", "picker", "prefs", "tool", "checklist", "agent", "chart", "meter", "effort"];
+export declare const TSP_KINDS: readonly ["col", "row", "card", "section", "rule", "spacer", "text", "md", "code", "diff", "ansi", "math", "image", "media", "kv", "table", "tree", "badge", "kbd", "icon", "spinner", "shimmer", "elapsed", "progress", "rate", "list", "item", "tabs", "editor", "input", "status", "seg", "overlay", "toast", "rows", "picker", "prefs", "tool", "checklist", "agent", "chart", "meter", "effort"];
 export type TspKind = (typeof TSP_KINDS)[number];
 /** Semantic colour of a node's chrome. */
 export type TspTone = "neutral" | "accent" | "info" | "success" | "warning" | "error" | "pending" | "muted" | "user";
@@ -114,7 +114,7 @@ export interface TspColProps {
 }
 export interface TspRowProps {
     gap?: TspSpace;
-    align?: "start" | "center" | "baseline" | "end";
+    align?: "start" | "center" | "baseline" | "end" | "stretch";
     justify?: "start" | "between" | "end";
     wrap?: boolean;
 }
@@ -161,7 +161,9 @@ export interface TspMarkdownProps {
 }
 export interface TspCodeProps {
     text?: string;
+    /** The language of text that is no file's (`bash`, `json`); wins over `path`. */
     lang?: string;
+    /** The file the text comes from: the terminal picks the grammar from it (and heads a block outside a tool card with it). */
     path?: string;
     start?: number;
     numbers?: boolean;
@@ -182,7 +184,9 @@ export interface TspDiffProps {
     /** Unified diff text (or give `hunks`). */
     text?: string;
     hunks?: readonly TspDiffHunk[];
+    /** The file the diff changes: the terminal picks the grammar from it. Not drawn. */
     path?: string;
+    /** A language overriding the one `path` gives. */
     lang?: string;
     mode?: "unified" | "split" | "auto";
 }
@@ -214,6 +218,23 @@ export interface TspImageProps {
         h?: TspExtent;
     };
 }
+/**
+ * A file the terminal loads by path and shows in its media viewer (pictures, SVG, 3D models,
+ * PDF/video/audio, else a card). Programs check `cx.supports("media")` first.
+ */
+export interface TspMediaProps {
+    /** The file: absolute, or relative to the pane's working directory. */
+    path: string;
+    /** Git revision to read instead of the disk file: a commit-ish (`HEAD`, a sha) or `:0` for the index. */
+    rev?: string;
+    /** `media` nodes of one surface sharing this name pan and zoom together (before/after compare). */
+    link?: string;
+    /** Size cap; the node otherwise fills its container. */
+    max?: {
+        w?: TspExtent;
+        h?: TspExtent;
+    };
+}
 export interface TspKvProps {
     items: readonly {
         k: TspText;
@@ -385,10 +406,7 @@ export interface TspPickerItem {
     detail?: TspText;
     /** Leading visual: a named icon, a provider/avatar mark, or a status dot. */
     icon?: string;
-    mark?: {
-        text: string;
-        seed?: string;
-    };
+    mark?: TspPickerMark;
     dot?: TspTone;
     /** Label is a machine string (model id, path): mono, dim prefix and strong tail by the `/`. */
     mono?: boolean;
@@ -419,6 +437,16 @@ export interface TspPickerItem {
     role?: string;
     title?: string;
 }
+/**
+ * A picker avatar: the `icon` when the terminal has it (`provider:<id>` names a
+ * model provider's logo by its id), else up to two initials of `text` on a
+ * gradient picked by `seed` (default `text`).
+ */
+export interface TspPickerMark {
+    text: string;
+    seed?: string;
+    icon?: string;
+}
 /** A right-aligned fact column in a picker. */
 export interface TspPickerColumn {
     id: string;
@@ -435,10 +463,7 @@ export interface TspPickerScope {
     id: string;
     label: TspText;
     icon?: string;
-    mark?: {
-        text: string;
-        seed?: string;
-    };
+    mark?: TspPickerMark;
     count?: number;
     /** Group heading this scope sits under (consecutive scopes with the same group share a head). */
     group?: string;
@@ -844,6 +869,7 @@ export interface TspPropsByKind {
     ansi: TspAnsiProps;
     math: TspMathProps;
     image: TspImageProps;
+    media: TspMediaProps;
     kv: TspKvProps;
     table: TspTableProps;
     tree: TspTreeProps;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-wire",
-	"version": "1.2.1",
+	"version": "1.3.1",
 	"description": "Shared wire protocol types for omp packages",
 	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Can Boluk",
@@ -24,7 +24,7 @@
 	"types": "./dist/types/index.d.ts",
 	"scripts": {
 		"check": "oxlint . && oxfmt --check --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts' && bun run check:types",
-		"check:types": "tsgo -p tsconfig.json --noEmit",
+		"check:types": "tsc -p tsconfig.json --noEmit",
 		"lint": "oxlint .",
 		"fix": "oxlint --fix --fix-suggestions . && bun run fmt",
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"

package/src/skillshare.ts

@@ -1,7 +1,11 @@
 /**
- * Wire contract for Skillshare (`skills.omp.sh`): an npm-style registry for
- * zetacode skills. Shared by the omp CLI (`zetacode skill …`), the Go server
- * (`stencil/apps/skills`), and its web UI (which mirrors this file).
+ * Wire contract for Skillshare: an npm-style registry for zetacode skills.
+ * Shared by the omp CLI (`zetacode skill …`) and a registry server.
+ *
+ * Zeta ships no registry: extra skills come from the npm package
+ * `@linxiraos/linxira-skills` (`npm i -g @linxiraos/linxira-skills`), and the
+ * registry commands only work after the user configures `skills.registryUrl`.
+ * See {@link SKILLS_REGISTRY_UNAVAILABLE}.
  *
  * Packages are scoped: `@scope/name`. A scope is a Stencil username claimed on
  * first publish and bound to the account's immutable `sub` forever (usernames
@@ -14,8 +18,19 @@
  * (comma-separated), `metadata.repository`, `metadata.homepage`.
  */
 
-/** Default registry; `skills.registryUrl` overrides it. */
-export const DEFAULT_SKILLS_URL = "https://skills.omp.sh";
+/**
+ * No skill registry ships with Zeta. Extra skills come from the npm package
+ * `@linxiraos/linxira-skills` (`npm i -g @linxiraos/linxira-skills`); the
+ * registry commands work against a user-configured `skills.registryUrl`.
+ */
+export const SKILLS_REGISTRY_UNAVAILABLE =
+	"no skill registry ships with Zeta; extra skills come from the npm package @linxiraos/linxira-skills (npm i -g @linxiraos/linxira-skills), or set skills.registryUrl to your own registry";
+
+/**
+ * Default value of `skills.registryUrl`. Empty: no registry ships by default
+ * (see {@link SKILLS_REGISTRY_UNAVAILABLE}).
+ */
+export const DEFAULT_SKILLS_URL = "";
 
 /** Scopes are Stencil usernames (or registry orgs): lowercase letters, digits, underscores; 3–32 chars. */
 export const SKILL_SCOPE_RE = /^[a-z0-9][a-z0-9_]{2,31}$/;
@@ -68,8 +83,12 @@ export const SKILL_HEADERS = {
 	githubOidc: "X-Skill-GitHub-OIDC",
 } as const;
 
-/** Audience CI must request for GitHub Actions OIDC tokens. */
-export const SKILLS_OIDC_AUDIENCE = "skills.omp.sh";
+/**
+ * Audience CI requests for GitHub Actions OIDC tokens. No default ships: a
+ * self-hosted registry issues tokens for its own audience, so the value comes
+ * from the registry's configuration.
+ */
+export const SKILLS_OIDC_AUDIENCE = "";
 
 /** Env var holding a registry publish token for CI (`sks_…`); wins over the Stencil login. */
 export const SKILLS_TOKEN_ENV = "SKILLS_TOKEN";

package/src/stream.ts

@@ -1,6 +1,9 @@
 /**
- * Wire types for `zetacode stream`: Twitch-style live screen sharing at
- * `live.omp.sh/<username>`.
+ * Wire types for `zetacode stream`: Twitch-style live screen sharing.
+ *
+ * Zeta ships no stream server, so there is no default host: `zetacode stream`
+ * and clip uploads only work against a compatible server the user configures
+ * in `stream.serverUrl`. See {@link STREAM_HOSTING_UNAVAILABLE}.
  *
  * Independent from collab. A publisher (`zetacode stream`) sends plaintext JSON
  * screen deltas for one or more panes (one pane per omp session attached in
@@ -13,8 +16,20 @@
  * secrets before a row leaves the session process.
  */
 
-/** Default stream server; its host route derives the channel from the bearer identity. */
-export const DEFAULT_STREAM_URL = "https://live.omp.sh";
+/**
+ * No stream or clip hosting ships with Zeta. `stream.serverUrl` has no
+ * default; point it at a compatible server you run yourself to enable
+ * `zetacode stream` (the server derives the channel from the bearer identity).
+ */
+export const STREAM_HOSTING_UNAVAILABLE =
+	"no stream server ships with Zeta; set stream.serverUrl to a compatible server";
+
+/**
+ * Default value of `stream.serverUrl`. Empty: Zeta ships no stream hosting, so
+ * users must point the setting at their own compatible server (see
+ * {@link STREAM_HOSTING_UNAVAILABLE}).
+ */
+export const DEFAULT_STREAM_URL = "";
 
 /** Protocol version carried in `hello`/`snapshot`; the server rejects mismatches. */
 export const STREAM_PROTO = 1;
@@ -155,7 +170,7 @@ export interface ClipUploadResponse {
 	url: string;
 }
 
-/** HTTP/WS route layout of the stream server, relative to `DEFAULT_STREAM_URL`. */
+/** HTTP/WS route layout of the stream server, relative to the configured `stream.serverUrl`. */
 export const STREAM_ROUTES = {
 	channels: "/api/channels",
 	channel: (name: string) => `/api/channels/${name}`,

package/src/tsp.ts

@@ -49,6 +49,7 @@ export const TSP_KINDS = [
 	"ansi",
 	"math",
 	"image",
+	"media",
 	"kv",
 	"table",
 	"tree",
@@ -164,7 +165,7 @@ export interface TspColProps {
 }
 export interface TspRowProps {
 	gap?: TspSpace;
-	align?: "start" | "center" | "baseline" | "end";
+	align?: "start" | "center" | "baseline" | "end" | "stretch";
 	justify?: "start" | "between" | "end";
 	wrap?: boolean;
 }
@@ -211,7 +212,9 @@ export interface TspMarkdownProps {
 }
 export interface TspCodeProps {
 	text?: string;
+	/** The language of text that is no file's (`bash`, `json`); wins over `path`. */
 	lang?: string;
+	/** The file the text comes from: the terminal picks the grammar from it (and heads a block outside a tool card with it). */
 	path?: string;
 	start?: number;
 	numbers?: boolean;
@@ -229,7 +232,9 @@ export interface TspDiffProps {
 	/** Unified diff text (or give `hunks`). */
 	text?: string;
 	hunks?: readonly TspDiffHunk[];
+	/** The file the diff changes: the terminal picks the grammar from it. Not drawn. */
 	path?: string;
+	/** A language overriding the one `path` gives. */
 	lang?: string;
 	mode?: "unified" | "split" | "auto";
 }
@@ -258,6 +263,20 @@ export interface TspImageProps {
 	h?: number;
 	max?: { w?: TspExtent; h?: TspExtent };
 }
+/**
+ * A file the terminal loads by path and shows in its media viewer (pictures, SVG, 3D models,
+ * PDF/video/audio, else a card). Programs check `cx.supports("media")` first.
+ */
+export interface TspMediaProps {
+	/** The file: absolute, or relative to the pane's working directory. */
+	path: string;
+	/** Git revision to read instead of the disk file: a commit-ish (`HEAD`, a sha) or `:0` for the index. */
+	rev?: string;
+	/** `media` nodes of one surface sharing this name pan and zoom together (before/after compare). */
+	link?: string;
+	/** Size cap; the node otherwise fills its container. */
+	max?: { w?: TspExtent; h?: TspExtent };
+}
 export interface TspKvProps {
 	items: readonly { k: TspText; v: TspText }[];
 	layout?: "grid" | "inline";
@@ -414,7 +433,7 @@ export interface TspPickerItem {
 	detail?: TspText;
 	/** Leading visual: a named icon, a provider/avatar mark, or a status dot. */
 	icon?: string;
-	mark?: { text: string; seed?: string };
+	mark?: TspPickerMark;
 	dot?: TspTone;
 	/** Label is a machine string (model id, path): mono, dim prefix and strong tail by the `/`. */
 	mono?: boolean;
@@ -437,6 +456,17 @@ export interface TspPickerItem {
 	title?: string;
 }
 
+/**
+ * A picker avatar: the `icon` when the terminal has it (`provider:<id>` names a
+ * model provider's logo by its id), else up to two initials of `text` on a
+ * gradient picked by `seed` (default `text`).
+ */
+export interface TspPickerMark {
+	text: string;
+	seed?: string;
+	icon?: string;
+}
+
 /** A right-aligned fact column in a picker. */
 export interface TspPickerColumn {
 	id: string;
@@ -454,7 +484,7 @@ export interface TspPickerScope {
 	id: string;
 	label: TspText;
 	icon?: string;
-	mark?: { text: string; seed?: string };
+	mark?: TspPickerMark;
 	count?: number;
 	/** Group heading this scope sits under (consecutive scopes with the same group share a head). */
 	group?: string;
@@ -803,6 +833,7 @@ export interface TspPropsByKind {
 	ansi: TspAnsiProps;
 	math: TspMathProps;
 	image: TspImageProps;
+	media: TspMediaProps;
 	kv: TspKvProps;
 	table: TspTableProps;
 	tree: TspTreeProps;