@zenera/cli 1.1.25 → 1.1.27

package/dist/scaffold.d.ts

@@ -1,6 +1,4 @@
 export declare const TEMPLATES: string;
-/** How to use the memory graph: a house rules file, landing under `agents/`. */
-export declare const MEMORY_RULES: string;
 /**
  * The project files that are ours rather than the project's.
  *
@@ -32,13 +30,14 @@ export interface CopyOptions {
 /**
  * Copies one template directory into `dir` at `rel`, depth first, sorted so the
  * list it returns is the same on every machine. Only a `.tmpl` is read as text;
- * everything else is copied byte for byte.
+ * everything else is copied byte for byte. A file already holding those bytes
+ * is left alone and not listed.
  */
 export declare function copyTree(from: string, dir: string, rel: string, opts: CopyOptions): string[];
 /**
  * Replaces every file in a project that nobody is meant to be maintaining:
  * `SHARED_RULES` in the project tree, and the editor tree whole. Returns the
- * relative paths written, project files first.
+ * relative paths that actually changed, project files first.
  *
  * This is the other half of `keep: true`. A scaffold never overwrites, which is
  * right for the files a project goes on to make its own and wrong for the ones

package/dist/scaffold.js

@@ -1,4 +1,4 @@
-import { chmodSync, copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from 'node:fs';
 import { dirname, join, sep } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { editorFiles } from "./meta/editor.js";
@@ -19,7 +19,6 @@ import { editorFiles } from "./meta/editor.js";
 //
 // The trees are copied whole and nothing enumerates them, so adding a file to
 // a new project is adding a file to `templates/project/` and nothing else.
-// `MEMORY_RULES` is the single exception, and it is named below.
 //
 // What is there is deliberately close to empty: a template full of
 // commented-out options is a template nobody reads and everybody deletes. The
@@ -37,7 +36,7 @@ const TEMPLATE = '.tmpl';
 /** How to use file tools: a house rules file, landing under `agents/`. */
 const FILE_RULES = join('agents', 'files-instructions.md');
 /** How to use the memory graph: a house rules file, landing under `agents/`. */
-export const MEMORY_RULES = join('agents', 'memory-instructions.md');
+const MEMORY_RULES = join('agents', 'memory-instructions.md');
 /** How tools are called: the same, and equally not the project's to maintain. */
 const TOOL_RULES = join('agents', 'tools-instructions.md');
 /** How forking behaves: the same again, reaching only agents that declare `fork:`. */
@@ -143,10 +142,20 @@ function target(name) {
     }
     return DOTFILES[name] ?? name;
 }
+/** Writes `body` to `path` unless those are already its bytes; true if it wrote. */
+function writeIfChanged(path, body) {
+    const bytes = typeof body === 'string' ? Buffer.from(body) : body;
+    if (existsSync(path) && readFileSync(path).equals(bytes)) {
+        return false;
+    }
+    writeFileSync(path, bytes);
+    return true;
+}
 /**
  * Copies one template directory into `dir` at `rel`, depth first, sorted so the
  * list it returns is the same on every machine. Only a `.tmpl` is read as text;
- * everything else is copied byte for byte.
+ * everything else is copied byte for byte. A file already holding those bytes
+ * is left alone and not listed.
  */
 export function copyTree(from, dir, rel, opts) {
     const written = [];
@@ -166,19 +175,21 @@ export function copyTree(from, dir, rel, opts) {
         const body = entry.name.endsWith(TEMPLATE)
             ? render(readFileSync(source, 'utf8'), opts.vars ?? {})
             : readFileSync(source);
-        writeFileSync(join(dir, child), body);
+        const changed = writeIfChanged(join(dir, child), body);
         // The bytes are copied, not the file, so a script arrives unrunnable.
         if (child.endsWith('.sh') || child.endsWith('.mjs')) {
             chmodSync(join(dir, child), 0o755);
         }
-        written.push(child);
+        if (changed) {
+            written.push(child);
+        }
     }
     return written;
 }
 /**
  * Replaces every file in a project that nobody is meant to be maintaining:
  * `SHARED_RULES` in the project tree, and the editor tree whole. Returns the
- * relative paths written, project files first.
+ * relative paths that actually changed, project files first.
  *
  * This is the other half of `keep: true`. A scaffold never overwrites, which is
  * right for the files a project goes on to make its own and wrong for the ones
@@ -190,8 +201,9 @@ export function refreshShared(dir) {
     for (const rel of SHARED_RULES) {
         const path = join(dir, rel);
         mkdirSync(dirname(path), { recursive: true });
-        copyFileSync(join(TEMPLATES, 'project', rel), path);
-        written.push(rel);
+        if (writeIfChanged(path, readFileSync(join(TEMPLATES, 'project', rel)))) {
+            written.push(rel);
+        }
     }
     written.push(...editorFiles(dir));
     return written;

package/dist/trace.d.ts

@@ -81,4 +81,9 @@ export interface NodeDetail {
  */
 export declare function parseNodeIds(words: readonly string[], known: Map<string, unknown>): string[];
 export declare function nodeDetail(trace: Trace, ids: readonly string[], payloads: PayloadResolver): Promise<NodeDetail[]>;
+/**
+ * The two questions a recorded request is usually opened for, answered without
+ * printing it: which tools the call was offered, and what conversation it saw.
+ */
+export declare function requestParts(json: string): NodePart[];
 //# sourceMappingURL=trace.d.ts.map

package/dist/trace.js

@@ -1,4 +1,4 @@
-import { coveredIds, totalUsage, } from '@zenera/neo';
+import { contentToText, coveredIds, totalUsage, } from '@zenera/neo';
 import { format } from "./narrate.js";
 import { describeCall, summarise } from "./tui/wrap.js";
 // ---------------------------------------------------------------------------
@@ -719,12 +719,61 @@ export async function nodeDetail(trace, ids, payloads) {
         ts: e.node.ts,
         label: labelOf(e.node, {}),
         facts: factsOf(e.node),
-        parts: (named.get(e) ?? []).map((part) => ({
-            name: part.name,
-            text: part.literal ?? blobs.get(part.payload?.sha256 ?? '') ?? '(unresolved)',
-        })),
+        parts: (named.get(e) ?? []).flatMap((part) => {
+            const text = part.literal ?? blobs.get(part.payload?.sha256 ?? '') ?? '(unresolved)';
+            return part.name === 'request'
+                ? [{ name: part.name, text }, ...requestParts(text)]
+                : [{ name: part.name, text }];
+        }),
     }));
 }
+/** Longest a message or a tool result runs in `messages` before it is clipped. */
+const MESSAGE_CLIP = 400;
+const clip = (s, n = MESSAGE_CLIP) => {
+    const flat = s.replace(/\s+/g, ' ').trim();
+    return flat.length <= n ? flat : `${flat.slice(0, n)} … (+${flat.length - n} chars)`;
+};
+/**
+ * The two questions a recorded request is usually opened for, answered without
+ * printing it: which tools the call was offered, and what conversation it saw.
+ */
+export function requestParts(json) {
+    let req;
+    try {
+        req = JSON.parse(json);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    if (Array.isArray(req.messages)) {
+        const lines = req.messages.map((m) => {
+            switch (m.role) {
+                case 'system':
+                    return `[system] ${clip(m.content, 200)}`;
+                case 'user':
+                    return `[user] ${clip(contentToText(m.content))}`;
+                case 'assistant':
+                    return [
+                        `[assistant${m.agent ? ` @${m.agent}` : ''}] ${clip(m.content) || '(no text)'}`,
+                        ...(m.toolCalls ?? []).map((c) => `    -> ${c.name} ${clip(c.args, 300)} #${c.id}`),
+                    ].join('\n');
+                case 'tool':
+                    return `[tool ${m.name} #${m.callId}${m.isError ? ' ERROR' : ''}] ${clip(m.content)}`;
+                default:
+                    return `[${m.role ?? '?'}]`;
+            }
+        });
+        out.push({ name: 'messages', text: lines.join('\n') });
+    }
+    if (Array.isArray(req.tools)) {
+        const names = req.tools
+            .map((t) => t?.name)
+            .filter((n) => typeof n === 'string');
+        out.push({ name: 'tools', text: names.join('\n') });
+    }
+    return out;
+}
 const GONE = '(the blob is not in this session’s store; only the preview survives)';
 async function resolve(payloads, p) {
     try {

package/dist/tui/app.js

@@ -9,6 +9,7 @@ import { History } from "../history.js";
 import { format } from "../narrate.js";
 import { display } from "../session.js";
 import { CliError } from "../term.js";
+import { hostUrls, hyperlink, hyperlinks, linkBlock, mountsOf } from "./links.js";
 import { resolveTheme, THEMES } from "./theme.js";
 import { ACTIVITY_ROWS, answerWidth, blocksOf, BOX_CHROME, boxWidth, BRANCH_ROWS, branchRows, budgetOf, CHROME_ROWS, clip, describeCall, gistOf, gridOf, summarise, THINKING_ROWS, TIME_COL, unmarked, windowOf, } from "./wrap.js";
 const BANNER = { key: 'banner' };
@@ -30,6 +31,9 @@ const FRAME_MS = 100;
 // A context rather than props only because every part of the view wants it.
 const ThemeContext = React.createContext(THEMES.dark);
 const useTheme = () => useContext(ThemeContext);
+const LinksContext = React.createContext(undefined);
+/** Without hyperlinks the only way to reach the file is to print where it is. */
+const shownText = (text, links) => links && !links.osc8 ? hostUrls(text, links.mounts) : text;
 function Row({ line }) {
     const theme = useTheme();
     const style = theme.line[line.kind];
@@ -87,7 +91,10 @@ function Call({ line }) {
  */
 function Spans({ spans }) {
     const theme = useTheme();
-    return (_jsx(_Fragment, { children: spans.map((s, i) => (_jsx(Text, { bold: s.bold === true, italic: s.italic === true, underline: s.href !== undefined && s.href !== '', ...(s.code ? { color: theme.code.color } : {}), children: s.text }, i))) }));
+    const links = useContext(LinksContext);
+    return (_jsx(_Fragment, { children: spans.map((s, i) => (_jsx(Text, { bold: s.bold === true, italic: s.italic === true, underline: s.href !== undefined && s.href !== '', ...(s.code ? { color: theme.code.color } : {}), children: links?.osc8 && s.href?.startsWith('file:')
+                ? hyperlink(s.href, s.text)
+                : s.text }, i))) }));
 }
 /**
  * One block of an answer.
@@ -128,11 +135,13 @@ function BlockView({ block, gap, width, }) {
  * answer and boxing each of them turns the transcript into a stack of frames;
  * the box means *this is the answer*, and it only means that if it is rare.
  */
-function Answer({ text, boxed }) {
+function Answer({ text: said, boxed }) {
     const theme = useTheme();
+    const links = useContext(LinksContext);
     const { stdout } = useStdout();
+    const text = shownText(said, links);
     const width = boxWidth(text, stdout?.columns ?? 80);
-    const blocks = blocksOf(text);
+    const blocks = blocksOf(text).map((b) => (links?.osc8 ? linkBlock(b, links.mounts) : b));
     const inner = width - (boxed ? 4 : GUTTER);
     const body = blocks.map((block, i) => (
     // Items of one list are one thing; a blank row between them is two
@@ -145,6 +154,10 @@ function Answer({ text, boxed }) {
 function App({ engine, options, theme }) {
     const { exit } = useApp();
     const { stdout } = useStdout();
+    const [links] = useState(() => ({
+        mounts: mountsOf(engine.files),
+        osc8: hyperlinks(),
+    }));
     const [lines, setLines] = useState([]);
     const [live, setLive] = useState('');
     const [thinking, setThinking] = useState('');
@@ -651,7 +664,7 @@ function App({ engine, options, theme }) {
             recall(1);
         }
     });
-    return (_jsx(ThemeContext.Provider, { value: theme, children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: [BANNER, ...lines], children: (item) => isBanner(item) ? (_jsx(Header, { engine: engine, readOnly: options.readOnly, started: options.started }, item.key)) : (_jsx(Row, { line: item }, item.key)) }), _jsxs(Box, { flexDirection: "column", justifyContent: "flex-end", height: busy ? grown.current : undefined, overflow: "hidden", children: [_jsx(Branches, { boxes: fitted.boxes, spin: spin, frame: frame, columns: columns }), streaming && budget.thinking ? (_jsx(Reasoning, { text: thinking, columns: columns, frame: frame, live: musing })) : null, _jsx(Activity, { rows: fitted.trunk, hidden: fitted.hidden, frame: frame }), live ? _jsx(Streaming, { text: live, columns: columns, rows: textRows }) : null] }), _jsx(Footer, { agent: agent, busy: busy, spin: spin, frame: frame, running: mine, forked: branches.current.size, step: step, model: model, stats: stats, inflight: inflight, reasoning: musing && streaming }), busy ? null : (_jsxs(Box, { children: [_jsx(Text, { color: theme.accent, children: "\u203A " }), _jsx(TextInput, { defaultValue: draft, placeholder: "Ask something\u2026 (\u2191 for history, /help for commands)", onChange: remember, onSubmit: submit }, generation)] }))] }) }));
+    return (_jsx(ThemeContext.Provider, { value: theme, children: _jsx(LinksContext.Provider, { value: links, children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: [BANNER, ...lines], children: (item) => isBanner(item) ? (_jsx(Header, { engine: engine, readOnly: options.readOnly, started: options.started }, item.key)) : (_jsx(Row, { line: item }, item.key)) }), _jsxs(Box, { flexDirection: "column", justifyContent: "flex-end", height: busy ? grown.current : undefined, overflow: "hidden", children: [_jsx(Branches, { boxes: fitted.boxes, spin: spin, frame: frame, columns: columns }), streaming && budget.thinking ? (_jsx(Reasoning, { text: thinking, columns: columns, frame: frame, live: musing })) : null, _jsx(Activity, { rows: fitted.trunk, hidden: fitted.hidden, frame: frame }), live ? _jsx(Streaming, { text: live, columns: columns, rows: textRows }) : null] }), _jsx(Footer, { agent: agent, busy: busy, spin: spin, frame: frame, running: mine, forked: branches.current.size, step: step, model: model, stats: stats, inflight: inflight, reasoning: musing && streaming }), busy ? null : (_jsxs(Box, { children: [_jsx(Text, { color: theme.accent, children: "\u203A " }), _jsx(TextInput, { defaultValue: draft, placeholder: "Ask something\u2026 (\u2191 for history, /help for commands)", onChange: remember, onSubmit: submit }, generation)] }))] }) }) }));
 }
 function Header({ engine, readOnly, started, }) {
     const theme = useTheme();
@@ -952,7 +965,8 @@ function Reasoning({ text, columns, frame, live, }) {
     const gist = gistOf(text, columns - GUTTER - 2);
     return (_jsx(Box, { height: 1, paddingLeft: GUTTER, overflow: "hidden", children: _jsx(Text, { wrap: "truncate-end", children: live ? (_jsx(Shimmer, { text: gist, frame: frame, color: theme.thinking.color })) : (_jsx(Text, { color: theme.thinking.color, children: gist })) }) }));
 }
-function Streaming({ text, columns, rows }) {
+function Streaming({ text: said, columns, rows }) {
+    const text = shownText(said, useContext(LinksContext));
     // The same width the finished answer will take, so landing it reflows
     // nothing: what is on screen is what stays there.
     //

package/dist/tui/links.d.ts

@@ -0,0 +1,27 @@
+import type { Workspace } from '@zenera/neo';
+import type { Block, Span } from './wrap.ts';
+export interface Mounts {
+    /** every name a tree is reached by, longest first */
+    names: readonly string[];
+    /** the host path an agent path names, or nothing when it is in no tree */
+    resolve(path: string): string | undefined;
+}
+/** Exactly the trees the file tools reach, under the same containment rule. */
+export declare function mountsOf(files: Workspace): Mounts;
+/** The host `file:` url a mounted path names, or nothing. */
+export declare function mountUrl(token: string, mounts: Mounts): string | undefined;
+/**
+ * The same spans with the same text, mounted paths carrying a host `href`.
+ *
+ * Only `href` changes, so every width measured from `span.text` still holds.
+ */
+export declare function linkSpans(spans: readonly Span[], mounts: Mounts): Span[];
+/** A block whose prose and cells link their mounted paths; a fence is left alone. */
+export declare function linkBlock(block: Block, mounts: Mounts): Block;
+/** For a terminal with no hyperlinks: every `file:///<mount>/…` url, rewritten to the host. */
+export declare function hostUrls(text: string, mounts: Mounts): string;
+/** `text` as an OSC 8 hyperlink to `href`. */
+export declare function hyperlink(href: string, text: string): string;
+/** Whether this terminal turns OSC 8 into a link; an unknown one is assumed not to. */
+export declare function hyperlinks(env?: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=links.d.ts.map

package/dist/tui/links.js

@@ -0,0 +1,142 @@
+import { pathToFileURL } from 'node:url';
+/** Exactly the trees the file tools reach, under the same containment rule. */
+export function mountsOf(files) {
+    const names = [...(files.mount ? [files.mount] : []), ...files.mounts.map((m) => m.at)];
+    return {
+        names: names.sort((a, b) => b.length - a.length),
+        resolve: (path) => {
+            try {
+                return files.within(path);
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+const FILE = 'file://';
+/** Prose punctuation that ends a sentence, not a path. */
+const TRAILING = /[.,;:!?'"]+$/;
+/** The host `file:` url a mounted path names, or nothing. */
+export function mountUrl(token, mounts) {
+    let path = token;
+    let fragment = '';
+    if (path.startsWith(FILE)) {
+        path = path.slice(FILE.length);
+        const cut = path.search(/[?#]/);
+        if (cut >= 0) {
+            fragment = path.slice(cut);
+            path = path.slice(0, cut);
+        }
+        try {
+            path = decodeURIComponent(path);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // `within` also takes relative paths and `/`; only a mount name counts here.
+    if (!mounts.names.some((n) => path === n || path.startsWith(`${n}/`))) {
+        return undefined;
+    }
+    const host = mounts.resolve(path);
+    return host ? pathToFileURL(host).href + fragment : undefined;
+}
+const escaped = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, (c) => `\\${c}`);
+/** Every spelling of a mounted path in running text. */
+function pattern(mounts) {
+    const names = mounts.names.map(escaped).join('|');
+    return new RegExp(`(?<![\\w/.:-])(?:${FILE})?(?:${names})(?![\\w-]|\\.\\w)(?:/[^\\s<>"'\`()[\\]{}|\\\\^]*)?`, 'g');
+}
+/** Each mounted path in `text`, without the punctuation that follows it. */
+function* matches(text, mounts) {
+    if (mounts.names.length === 0) {
+        return;
+    }
+    for (const m of text.matchAll(pattern(mounts))) {
+        const token = m[0].replace(TRAILING, '');
+        if (token) {
+            yield { at: m.index, token };
+        }
+    }
+}
+/**
+ * The same spans with the same text, mounted paths carrying a host `href`.
+ *
+ * Only `href` changes, so every width measured from `span.text` still holds.
+ */
+export function linkSpans(spans, mounts) {
+    const out = [];
+    for (const span of spans) {
+        if (span.href) {
+            const url = mountUrl(span.href, mounts);
+            out.push(url ? { ...span, href: url } : span);
+            continue;
+        }
+        let from = 0;
+        for (const { at, token } of matches(span.text, mounts)) {
+            const url = mountUrl(token, mounts);
+            if (!url) {
+                continue;
+            }
+            if (at > from) {
+                out.push({ ...span, text: span.text.slice(from, at) });
+            }
+            out.push({ ...span, text: token, href: url });
+            from = at + token.length;
+        }
+        if (from === 0) {
+            out.push(span);
+        }
+        else if (from < span.text.length) {
+            out.push({ ...span, text: span.text.slice(from) });
+        }
+    }
+    return out;
+}
+/** A block whose prose and cells link their mounted paths; a fence is left alone. */
+export function linkBlock(block, mounts) {
+    return {
+        ...block,
+        ...(block.spans ? { spans: linkSpans(block.spans, mounts) } : {}),
+        ...(block.cells
+            ? { cells: block.cells.map((row) => row.map((cell) => linkSpans(cell, mounts))) }
+            : {}),
+    };
+}
+/** For a terminal with no hyperlinks: every `file:///<mount>/…` url, rewritten to the host. */
+export function hostUrls(text, mounts) {
+    let out = '';
+    let from = 0;
+    for (const { at, token } of matches(text, mounts)) {
+        const url = token.startsWith(FILE) ? mountUrl(token, mounts) : undefined;
+        if (!url) {
+            continue;
+        }
+        out += text.slice(from, at) + url;
+        from = at + token.length;
+    }
+    return out + text.slice(from);
+}
+/** `text` as an OSC 8 hyperlink to `href`. */
+export function hyperlink(href, text) {
+    return `\u001b]8;;${href}\u001b\\${text}\u001b]8;;\u001b\\`;
+}
+/** Whether this terminal turns OSC 8 into a link; an unknown one is assumed not to. */
+export function hyperlinks(env = process.env) {
+    const forced = env.FORCE_HYPERLINK;
+    if (forced !== undefined && forced !== '') {
+        return forced !== '0' && forced !== 'false';
+    }
+    if (env.WT_SESSION || env.KITTY_WINDOW_ID || env.KONSOLE_VERSION) {
+        return true;
+    }
+    if (['iTerm.app', 'vscode', 'WezTerm', 'ghostty'].includes(env.TERM_PROGRAM ?? '')) {
+        return true;
+    }
+    if (env.TERM === 'xterm-kitty' || env.TERM === 'xterm-ghostty') {
+        return true;
+    }
+    return Number(env.VTE_VERSION ?? 0) >= 5000;
+}
+//# sourceMappingURL=links.js.map

package/dist/tui/models.d.ts

@@ -1,4 +1,4 @@
-import { type Catalog, type CatalogEntry } from '../catalog.ts';
+import { type Balance, type Catalog, type CatalogEntry } from '../catalog.ts';
 import type { Provider } from '../keys.ts';
 export interface ProviderRow {
     provider: Provider;
@@ -23,6 +23,8 @@ export interface BrowseOptions {
     initial?: Provider;
     theme?: string;
     load(provider: Provider, refresh: boolean): Promise<Catalog>;
+    /** what the account has left to spend, for providers that say */
+    balance?(provider: Provider): Promise<Balance | undefined>;
     test(entry: CatalogEntry): Promise<Verdict>;
 }
 /**

package/dist/tui/models.js

@@ -17,7 +17,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 // ---------------------------------------------------------------------------
 import { Box, render, Text, useApp, useInput, useStdout } from 'ink';
 import React, { useEffect, useMemo, useRef, useState } from 'react';
-import { byGroup, isPartner, matches, } from "../catalog.js";
+import { byGroup, isPartner, matches, perMillion, } from "../catalog.js";
 import { ago } from "../term.js";
 import { resolveTheme } from "./theme.js";
 import { clip, scrollTop, wrap } from "./wrap.js";
@@ -25,6 +25,25 @@ const ROLES = ['chat', 'embedding', 'image', 'audio'];
 const message = (err) => (err instanceof Error ? err.message : String(err));
 const thousands = (n) => n === undefined ? '' : n >= 1000 ? `${Math.round(n / 1000)}k` : String(n);
 const ms = (n) => (n < 1000 ? `${n}ms` : `${(n / 1000).toFixed(1)}s`);
+const money = (n) => {
+    const abs = Math.abs(n);
+    return `${n < 0 ? '-' : ''}$${abs !== 0 && abs < 0.01 ? abs.toFixed(4) : abs.toFixed(2)}`;
+};
+/** The balance as one line; `short` for the providers screen. */
+function account(b, short) {
+    const parts = [];
+    if (b.credits !== undefined) {
+        parts.push(`balance ${money(b.credits)}`);
+    }
+    if (b.cap && !short) {
+        const reset = b.cap.reset ? ` ${b.cap.reset}` : '';
+        parts.push(`key cap ${money(b.cap.remaining)} left of ${money(b.cap.limit)}${reset}`);
+    }
+    if (b.free && !short) {
+        parts.push(`free ${b.free.remaining}/${b.free.limit} requests left today`);
+    }
+    return parts.join(' · ');
+}
 function freshness(origin, fetchedAt) {
     switch (origin) {
         case 'curated':
@@ -87,6 +106,7 @@ function Browser({ options, theme, onPick }) {
     const [role, setRole] = useState(0);
     const [selected, setSelected] = useState(0);
     const [verdicts, setVerdicts] = useState(new Map());
+    const [balances, setBalances] = useState(new Map());
     const [closing, setClosing] = useState(false);
     const top = useRef(0);
     const provider = options.providers[at].provider;
@@ -102,10 +122,18 @@ function Browser({ options, theme, onPick }) {
             setLoading((now) => (now === p ? undefined : now));
         });
     };
+    const fetchBalance = (p) => {
+        options.balance?.(p).then((b) => b && setBalances((prev) => new Map(prev).set(p, b)), (err) => setBalances((prev) => new Map(prev).set(p, message(err))));
+    };
     useEffect(() => {
         if (start >= 0) {
             load(provider, false);
         }
+        for (const p of options.providers) {
+            if (p.credential) {
+                fetchBalance(p.provider);
+            }
+        }
         // Once, for `zen models browse <provider>`; every later open is a key.
     }, []);
     useEffect(() => {
@@ -153,7 +181,14 @@ function Browser({ options, theme, onPick }) {
     // what is left. A row is kept in hand: a frame as tall as the viewport is
     // the one Ink cannot erase (see tui/app.tsx).
     const problem = catalog?.problem;
-    const chrome = 6 + (problem ? 1 : 0);
+    const balance = balances.get(provider);
+    const funds = balance === undefined
+        ? []
+        : wrap(typeof balance === 'string'
+            ? `balance could not be read: ${balance}`
+            : account(balance, false) || 'balance: nothing reported', Math.max(20, size.columns - 1));
+    const short = typeof balance === 'string' || (balance?.credits !== undefined && balance.credits <= 0);
+    const chrome = 7 + (problem ? 1 : 0) + funds.length;
     const height = Math.max(3, size.rows - 1 - chrome);
     top.current = scrollTop(index, top.current, height, rows.length);
     useInput((input, key) => {
@@ -266,6 +301,7 @@ function Browser({ options, theme, onPick }) {
         }
         else if (input === 'r') {
             load(provider, true);
+            fetchBalance(provider);
         }
         else if (key.escape && query) {
             setQuery('');
@@ -293,7 +329,8 @@ function Browser({ options, theme, onPick }) {
                     const fresh = cat
                         ? freshness(cat.origin, cat.fetchedAt)
                         : freshness(p.origin, p.fetchedAt);
-                    return (_jsxs(Row, { children: [_jsxs(Text, { color: here ? theme.accent : undefined, bold: here, children: [here ? '› ' : '  ', p.provider.padEnd(nameW)] }), p.credential ? (_jsx(Text, { color: theme.code.color, children: p.credential.padEnd(15) })) : (_jsx(Text, { color: theme.line.error.color, children: 'no credential'.padEnd(15) })), _jsxs(Text, { color: theme.chrome.color, children: [`${count} model${count === 1 ? '' : 's'}`.padEnd(13), p.credential ? fresh : `zen key add ${p.provider}`] })] }, p.provider));
+                    const b = balances.get(p.provider);
+                    return (_jsxs(Row, { children: [_jsxs(Text, { color: here ? theme.accent : undefined, bold: here, children: [here ? '› ' : '  ', p.provider.padEnd(nameW)] }), p.credential ? (_jsx(Text, { color: theme.code.color, children: p.credential.padEnd(15) })) : (_jsx(Text, { color: theme.line.error.color, children: 'no credential'.padEnd(15) })), _jsxs(Text, { color: theme.chrome.color, children: [`${count} model${count === 1 ? '' : 's'}`.padEnd(13), p.credential ? fresh : `zen key add ${p.provider}`] }), b && typeof b !== 'string' ? (_jsx(Text, { color: theme.code.color, children: `   ${account(b, true)}` })) : null] }, p.provider));
                 }), _jsx(Text, { children: " " }), _jsx(Keys, { theme: theme, text: "\u2191\u2193 move \u00B7 enter open \u00B7 q quit" })] }));
     }
     if (screen === 'detail' && current) {
@@ -302,9 +339,24 @@ function Browser({ options, theme, onPick }) {
     const header = catalog
         ? `${provider} · ${catalog.entries.length} models · ${freshness(catalog.origin, catalog.fetchedAt)}`
         : provider;
-    const idW = Math.min(44, Math.max(8, ...rows.map((e) => e.id.length))) + 2;
+    const withMaker = rows.some((e) => e.publisher);
+    const priced = rows.some((e) => e.pricing);
+    const ROLE_W = Math.max(4, ...rows.map((e) => e.roles.join('+').length)) + 2;
+    const CTX_W = 9;
+    const PRICE_W = 10;
+    const fixed = (withMaker ? 12 : 0) + ROLE_W + CTX_W + (priced ? PRICE_W * 2 : 0) + 'test'.length + 2;
+    const idW = Math.max(10, Math.min(46, Math.max(8, ...rows.map((e) => e.id.length)) + 2, width - fixed));
     const shown = rows.slice(top.current, top.current + height);
     const filter = typing ? `/${query}▌` : query ? `/${query}` : '';
+    const columns = [
+        `  ${'model'.padEnd(idW)}`,
+        withMaker ? 'maker'.padEnd(12) : '',
+        'role'.padEnd(ROLE_W),
+        'context'.padStart(CTX_W - 2).padEnd(CTX_W),
+        priced ? 'in $/1M'.padStart(PRICE_W - 2).padEnd(PRICE_W) : '',
+        priced ? 'out $/1M'.padStart(PRICE_W - 2).padEnd(PRICE_W) : '',
+        'test',
+    ].join('');
     let body;
     if (failure) {
         body = _jsx(Row, { color: theme.line.error.color, children: failure });
@@ -319,11 +371,17 @@ function Browser({ options, theme, onPick }) {
         body = (_jsx(_Fragment, { children: shown.map((e, i) => {
                 const here = top.current + i === index;
                 const v = said(verdicts.get(e.ref), theme);
-                return (_jsxs(Row, { children: [_jsxs(Text, { color: here ? theme.accent : undefined, bold: here, children: [here ? '› ' : '  ', clip(e.id, idW - 2).padEnd(idW)] }), e.publisher ? (_jsx(Text, { color: isPartner(e) ? theme.warn : theme.code.color, children: clip(e.publisher, 11).padEnd(12) })) : null, _jsxs(Text, { color: theme.chrome.color, children: [e.roles.join('+').padEnd(16), thousands(e.contextLength).padStart(6), (e.pricing?.free ? '  free' : '').padEnd(7)] }), v ? _jsx(Text, { color: v.color, children: v.text }) : null] }, e.ref));
+                return (_jsxs(Row, { children: [_jsxs(Text, { color: here ? theme.accent : undefined, bold: here, children: [here ? '› ' : '  ', clip(e.id, idW - 2).padEnd(idW)] }), withMaker ? (_jsx(Text, { color: isPartner(e) ? theme.warn : theme.code.color, children: clip(e.publisher ?? '', 11).padEnd(12) })) : null, _jsxs(Text, { color: theme.chrome.color, children: [e.roles.join('+').padEnd(ROLE_W), thousands(e.contextLength)
+                                    .padStart(CTX_W - 2)
+                                    .padEnd(CTX_W)] }), priced ? (_jsxs(Text, { color: e.pricing?.free ? theme.code.color : undefined, children: [perMillion(e.pricing?.prompt)
+                                    .padStart(PRICE_W - 2)
+                                    .padEnd(PRICE_W), (e.pricing?.free ? '' : perMillion(e.pricing?.completion))
+                                    .padStart(PRICE_W - 2)
+                                    .padEnd(PRICE_W)] })) : null, v ? _jsx(Text, { color: v.color, children: v.text }) : null] }, e.ref));
             }) }));
     }
     const preview = current ? [current.name, current.description].filter(Boolean).join(' — ') : '';
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Row, { children: [_jsx(Text, { bold: true, color: theme.accent, children: header }), _jsxs(Text, { color: theme.chrome.color, children: ['   role: ', only ?? 'all', filter ? '   ' : ''] }), _jsx(Text, { color: theme.code.color, children: filter })] }), problem ? (_jsxs(Row, { color: theme.warn, children: ["could not be listed: ", problem.detail ?? 'no reason given'] })) : null, _jsx(Text, { children: " " }), _jsx(Box, { flexDirection: "column", height: height, children: body }), _jsx(Row, { color: theme.chrome.color, children: clip(preview, width) || ' ' }), _jsx(Row, { color: theme.chrome.color, children: rows.length === 0
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Row, { children: [_jsx(Text, { bold: true, color: theme.accent, children: header }), _jsxs(Text, { color: theme.chrome.color, children: ['   role: ', only ?? 'all', filter ? '   ' : ''] }), _jsx(Text, { color: theme.code.color, children: filter })] }), problem ? (_jsxs(Row, { color: theme.warn, children: ["could not be listed: ", problem.detail ?? 'no reason given'] })) : null, funds.map((line, i) => (_jsx(Row, { color: short ? theme.warn : theme.code.color, children: line }, `funds${i}`))), _jsx(Text, { children: " " }), _jsx(Row, { bold: true, color: theme.chrome.color, children: columns }), _jsx(Box, { flexDirection: "column", height: height, children: body }), _jsx(Row, { color: theme.chrome.color, children: clip(preview, width) || ' ' }), _jsx(Row, { color: theme.chrome.color, children: rows.length === 0
                     ? ' '
                     : `${index + 1} of ${rows.length}${rows.length < (catalog?.entries.length ?? 0) ? ` (${catalog.entries.length} in all)` : ''}` }), _jsx(Keys, { theme: theme, text: typing
                     ? 'type to filter · enter keep · esc clear · ↑↓ move'
@@ -350,7 +408,7 @@ function Detail({ entry, catalog, verdict, theme, width, rows }) {
     add('pricing', entry.pricing?.free
         ? 'free'
         : entry.pricing?.prompt
-            ? `$${entry.pricing.prompt}/token in, $${entry.pricing.completion ?? '?'}/token out`
+            ? `${perMillion(entry.pricing.prompt)} per 1M input tokens, ${perMillion(entry.pricing.completion) || '?'} per 1M output tokens`
             : undefined);
     add('released', entry.created);
     add('source', entry.source === 'live' && catalog

package/dist/tui/sandbox.d.ts

@@ -0,0 +1,10 @@
+import { type ResourceSampler } from '../resources.ts';
+export interface WatchOptions {
+    sampler: ResourceSampler;
+    intervalMs: number;
+    explain: boolean;
+    theme?: string;
+}
+/** Runs the live screen until the person leaves it. */
+export declare function watch(options: WatchOptions): Promise<void>;
+//# sourceMappingURL=sandbox.d.ts.map