dsh-ssh-tui 0.8.1 → 0.8.2

package/lib/types/footer-format.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Presentation formatting: a value in, text out.
+ *
+ * Pure functions that know nothing about rows or widths, and exist as their own
+ * module because the *same* reading is painted in several places (the status row,
+ * the workspace row, `/status`, a transcript chip) and those call sites must not
+ * each grow their own spelling of it.
+ *
+ * It also owns the context-pressure reading — parsing DSH's `contextPressure`,
+ * its bands, and its alert text. That is a deliberate exception to "formatting
+ * only": the chip, the status line and the thresholds are one decision about one
+ * number, and splitting them would let the painted level drift from the level
+ * compaction acts on.
+ *
+ * @module dsh-ssh-tui/footer-format
+ */
+import { type QuotaPeriod, type QuotaSource } from './quota.js';
+/** Compact token count, matching the web stats line (517 / 12.2K / 1.2M). */
+export declare function formatTokens(n: number): string;
+/**
+ * Prompt occupancy of the next request, from DSH `contextPressure`.
+ * Provider-agnostic: uses the routed model's advertised window, not a
+ * hardcoded xAI size. Compaction-basic still owns in-turn pressure at 80%.
+ */
+export declare const CONTEXT_PRESSURE_WARN_RATIO = 0.8;
+export declare const CONTEXT_PRESSURE_DANGER_RATIO = 0.95;
+/** Idle auto-compact starts here so recovery finishes before the 80% in-turn trigger. */
+export declare const CONTEXT_IDLE_COMPACT_RATIO = 0.72;
+export interface ContextPressureSample {
+    usedTokens: number;
+    contextWindow: number;
+}
+export interface ContextPressureView {
+    usedTokens: number;
+    contextWindow: number;
+    percent: number;
+    level: 'ok' | 'warn' | 'danger';
+}
+/** Prompt-side occupancy of one usage sample: uncached input plus cache traffic. */
+export declare function promptPressureTokens(usage: {
+    inputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}): number;
+/** Prefer the next-request projection; fall back to last-request pressure. */
+export declare function contextPressureUsedTokens(pressure: {
+    projectedTokens?: number;
+    pressureTokens?: number;
+} | undefined): number | undefined;
+export declare function parseContextPressure(value: unknown): ContextPressureSample | undefined;
+export declare function contextPressureView(sample: ContextPressureSample): ContextPressureView;
+/**
+ * 8-segment Braille ring. Empty `⣀`; full `⣿`. Width is always 1 cell.
+ * Index is `ceil(percent / 12.5)` clamped to 0..8.
+ */
+export declare const CONTEXT_RING_EMPTY = "\u28C0";
+export declare const CONTEXT_RING_SEGMENTS: readonly ["⣀", "⠉", "⠋", "⠛", "⠞", "⠟", "⠿", "⡿", "⣿"];
+/** The full cell of the same Braille family, for bars built like the ring. */
+export declare const CONTEXT_RING_FULL = "\u28FF";
+export declare function formatContextPressureRing(percent: number): string;
+export declare function contextPressureRingColor(level: ContextPressureView['level']): string;
+export declare function formatContextPressureChip(view: ContextPressureView, color?: boolean): string;
+export declare function formatContextPressureStatusLine(view: ContextPressureView | undefined): string;
+export declare function contextPressureAlertText(view: ContextPressureView): string;
+export declare function shouldIdleAutoCompact(view: ContextPressureView | undefined): boolean;
+/**
+ * Compact elapsed time for the activity chip: `28s`, `3m12s`, `1h04m`.
+ *
+ * Distinct from {@link formatDuration} on purpose: that one is a session
+ * statistic (`45.2s`), where a decimal is informative, while this one ticks
+ * every second beside a spinner and should move in whole units.
+ */
+export declare function formatElapsedShort(ms: number): string;
+/** Compact duration, matching the web stats line (45.2s / 2m42s). */
+export declare function formatDuration(ms: number): string;
+/**
+ * @deprecated Legacy surface, removed in 0.9.
+ *
+ * The default row stopped using this when the footer became the status row
+ * (`docs/plans/footer-debt.md`, D-7): what is left of it is the previous
+ * generation's fitting and formatting, kept exported so 0.8.x does not break an
+ * importer. New callers want the budget module's `runtimeStrip`, the meters, or
+ * `formatStatusReport` for the spelled-out numbers.
+ */
+export declare function formatTokensPerSecond(tokensPerSecond: number): string;
+export declare function providerShortCode(provider: string): string;
+/** Short remaining-quota bar: 8 pips, filled from the left. */
+export declare function formatQuotaBar(remainingPercent: number, width?: number): string;
+/**
+ * `sub:<model>` chip for the identity row: `sub:grok-4.5`, or
+ * `sub:grok-4.5(xhigh)` when an explicit `/subeffort` is set.
+ *
+ * It shows the model name only, like the parent's own chip, unless `/submodel`
+ * pinned a different provider — then `sub:xai/grok-4.5` so the foreign route
+ * is visible on the identity row as well as the recolored chip.
+ */
+export declare function subagentRouteLabel(model: string, provider?: string, effort?: string): string;
+/**
+ * The model as the footer shows it: the model's own name, without a
+ * `provider/model` route prefix.
+ *
+ * Some providers carry the vendor in the model id (`xai/grok-4.6`,
+ * `deepseek-official/deepseek-v4-flash`). The route is worth a row in the header
+ * and in `/status`; in the status line it spent cells on something the reader
+ * already knows, and it pushed the quota badge towards the drop edge.
+ * `sub:` routes keep their provider on purpose — that is a *different* route
+ * from the parent's, and hiding it would make the two indistinguishable.
+ */
+export declare function shortModelName(model: string): string;
+/**
+ * `SuperGrok 5Hr ███████░ 82%` — short plan badge, the window the number belongs
+ * to, then the bar.
+ *
+ * The tags are fixed technical labels (`5Hr` / `1Wk` / `1Mo`) rather than
+ * localized words: they sit in a footer that is already fighting for cells, and
+ * a window tag that changes with the locale would be unreadable in a screenshot
+ * or a bug report. Everything else about the window (label, reset time, detail)
+ * stays in `/quota`.
+ */
+/**
+ * @deprecated Legacy surface, removed in 0.9.
+ *
+ * The default row stopped using this when the footer became the status row
+ * (`docs/plans/footer-debt.md`, D-7): what is left of it is the previous
+ * generation's fitting and formatting, kept exported so 0.8.x does not break an
+ * importer. New callers want the budget module's `runtimeStrip`, the meters, or
+ * `formatStatusReport` for the spelled-out numbers.
+ */
+export declare function formatFooterQuota(percent: number, code?: string, period?: QuotaPeriod): string;
+/**
+ * The quota widget before the first reading arrives, or while the provider
+ * cannot be reached: an empty bar and a question mark.
+ *
+ * Deliberately not `0%`: an unreachable quota API is not a used-up quota, and a
+ * number the footer cannot back up is worse than no number. The bar is there
+ * from the first frame so the row does not jump when the reading lands.
+ */
+/**
+ * @deprecated Legacy surface, removed in 0.9.
+ *
+ * The default row stopped using this when the footer became the status row
+ * (`docs/plans/footer-debt.md`, D-7): what is left of it is the previous
+ * generation's fitting and formatting, kept exported so 0.8.x does not break an
+ * importer. New callers want the budget module's `runtimeStrip`, the meters, or
+ * `formatStatusReport` for the spelled-out numbers.
+ */
+export declare function formatQuotaUnknown(): string;
+/** Fixed-width tag for the window a footer quota number belongs to. */
+export declare function quotaWindowTag(period: QuotaPeriod | undefined): string;
+/**
+ * The window tag as an out-of-room row spells it: `5Hr` → `5h`, `1Wk` → `1w`.
+ *
+ * Deliberately not `toLowerCase()`: the tag encodes two facts in three cells
+ * (how many, and which unit), and the unit letter is the one worth keeping —
+ * `5hr` costs a cell to repeat that it is hours, which the `h` already said.
+ */
+export declare function quotaWindowTagShort(period: QuotaPeriod | undefined): string;
+/**
+ * The badge the footer shows instead of the billing plan's own label:
+ * `SuperGrok`, `OC·GO` (OpenCode Go), `CC·GOAT` (Command Code Goat).
+ *
+ * The long names live in `/quota`; this one has to survive next to a model id.
+ * Without a `source` (a hand-built snapshot) the plan label is matched instead,
+ * so old callers and tests keep a sensible badge.
+ */
+export declare function shortQuotaPlanName(snapshot: {
+    plan: string;
+    source?: QuotaSource;
+}): string;
+/**
+ * The subscription a session is running on, spelled out for the footer's last
+ * part: `OpenCode-GO`, `CommandCode-GOAT`.
+ *
+ * Only the two generations that carry a *named subscription* get one. SuperGrok
+ * already says so in its quota chip's window tag, and DeepSeek is metered (its
+ * balance line is the reading), so neither claims a badge here. The spelling is
+ * longer than the identity row's old `OC·GO` / `CC·GOAT` on purpose: this one sits
+ * at the very end of the row where the least load-bearing part goes, and a reader
+ * who still has it on screen reads a plan name rather than an abbreviation.
+ *
+ * The provider id alone is enough for the Go route; Command Code's *tier* comes
+ * from the billing reply, so before the first reading lands the badge names the
+ * vendor without claiming a tier it has not seen.
+ * @param provider - the live route's provider id.
+ * @param snapshot - the quota reading, when it belongs to that provider.
+ * @returns the badge, or undefined when this route has none.
+ */
+export declare function planRouteBadge(provider: string, snapshot?: {
+    plan: string;
+    source?: QuotaSource;
+}): string | undefined;
+/**
+ * Drop the Go / SuperGrok plan name from a quota identity part, keeping the
+ * remaining-percent bar. Returns true when a part was rewritten.
+ */
+/**
+ * @deprecated Legacy surface, removed in 0.9.
+ *
+ * The default row stopped using this when the footer became the status row
+ * (`docs/plans/footer-debt.md`, D-7): what is left of it is the previous
+ * generation's fitting and formatting, kept exported so 0.8.x does not break an
+ * importer. New callers want the budget module's `runtimeStrip`, the meters, or
+ * `formatStatusReport` for the spelled-out numbers.
+ */
+export declare function dropFooterQuotaPlanName(parts: string[]): boolean;
+/** Human-facing kind for a live LLM route. */
+export declare function describeProviderRoute(provider: string): {
+    kind: string;
+    short: string;
+};
+/** Routes that authenticate without a harness API-key credential. */
+export declare function providerUsesLocalOAuth(provider: string): boolean;
+/**
+ * Whether a provider has a quota surface at all, without asking it.
+ *
+ * The footer paints a quota widget from the first frame — an empty bar and `?%`
+ * until a reading arrives — so it needs to tell "this provider will have one"
+ * from "this provider reports a balance instead" (DeepSeek) or nothing at all.
+ * Every branch is a synchronous settings read, so a repaint never does IO.
+ */
+export declare function providerHasQuotaSurface(provider: string, llmPiAiSection: unknown): boolean;

package/lib/types/footer-layout.d.ts

@@ -0,0 +1,292 @@
+/**
+ * Footer layout: the two chrome rows, and the `/status` report that spells the
+ * first one out.
+ *
+ * Layout assembles chips and rows; it does not decide how a chip degrades (that
+ * is `footer-budget.ts`) and does not spell a reading (that is
+ * `footer-format.ts`). The contract it does own is *where a signal lives*: the
+ * status row carries health, activity, speed, quota and context, the workspace
+ * row carries metadata, and the counters the status row gave up are answered by
+ * {@link formatStatusReport}.
+ *
+ * @module dsh-ssh-tui/footer-layout
+ */
+import { type ColorDepth } from './color-depth.js';
+import { type QuotaPeriod, type QuotaSnapshot } from './quota.js';
+import { type ThroughputView } from './throughput.js';
+import { type SessionStatsRow } from './stats.js';
+import type { DisconnectPolicyName } from './transcript-types.js';
+import { type ContextPressureView } from './footer-format.js';
+import type { FooterActivityKind } from './footer-budget.js';
+export declare const WAIT_INDICATOR_MS = 8000;
+export interface FooterStatsInput {
+    turns: number;
+    steps: number;
+    llmMs: number;
+    toolMs: number;
+    ttftMs: number;
+    ttftSteps: number;
+    decodeMs: number;
+    decodeTokens: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+}
+/** Stats groups in drop order (last is dropped first when the row is too wide). */
+/**
+ * @deprecated Legacy surface, removed in 0.9.
+ *
+ * The status row shows one session total and `/status` prints the counters; this
+ * group list was the previous footer's first row, and the only thing still
+ * composing it is `statsText()` (itself test-only). Kept exported for 0.8.x.
+ */
+export declare function footerStatsGroups(stats: FooterStatsInput): string[];
+/**
+ * One group in the status strip, with the graphic-only form a narrow terminal
+ * keeps. `priority` orders the losses: 0 is the last thing to go.
+ */
+/**
+ * @deprecated Legacy surface, removed in 0.9.
+ *
+ * The default row stopped using this when the footer became the status row
+ * (`docs/plans/footer-debt.md`, D-7): what is left of it is the previous
+ * generation's fitting and formatting, kept exported so 0.8.x does not break an
+ * importer. New callers want the budget module's `runtimeStrip`, the meters, or
+ * `formatStatusReport` for the spelled-out numbers.
+ */
+export interface FooterChip {
+    id: string;
+    /** Glyph plus text: what a wide terminal shows. */
+    long: string;
+    /** Glyph only, or `''` for a group that is pure text. */
+    short: string;
+    priority: number;
+}
+/**
+ * Fit an ordered strip into `width` cells, losing text before graphics.
+ *
+ * The old fitter dropped whole groups from the end, so a narrow terminal lost
+ * the ⚠ and the context ring — the two signals that say something is wrong —
+ * while keeping long numeric groups. Two passes now: every chip trades its text
+ * for its glyph in reverse priority order, and only then do whole groups go,
+ * again lowest priority first. The result never exceeds the width.
+ *
+ * Chips may carry SGR accents (the link pips, the ⚠) and the caller may pass a
+ * styled separator, so both the measurement and the final cut are ANSI-aware:
+ * feeding styled text to a plain-text truncator strips the accent's `ESC` and
+ * leaves its `[32m` body on the grid.
+ */
+/**
+ * @deprecated Legacy surface, removed in 0.9.
+ *
+ * The default row stopped using this when the footer became the status row
+ * (`docs/plans/footer-debt.md`, D-7): what is left of it is the previous
+ * generation's fitting and formatting, kept exported so 0.8.x does not break an
+ * importer. New callers want the budget module's `runtimeStrip`, the meters, or
+ * `formatStatusReport` for the spelled-out numbers.
+ */
+export declare function fitFooterChips(chips: readonly FooterChip[], width: number, separator?: string): string;
+/**
+ * The roster's health as a chip: absent means `/mode` cannot switch presets and
+ * the preset-owned tools are missing. It leads the status row and keeps its glyph
+ * longest, because it is the one group that reports a broken install.
+ */
+export declare function footerHealthChip(missing: boolean, color?: boolean, 
+/** Which rows are missing: the 0.1.5 roster, or the 0.1.7 agent plane. */
+kind?: 'roster' | 'agent-plane'): FooterChip | undefined;
+/**
+ * @deprecated Legacy surface, removed in 0.9.
+ *
+ * The default row stopped using this when the footer became the status row
+ * (`docs/plans/footer-debt.md`, D-7): what is left of it is the previous
+ * generation's fitting and formatting, kept exported so 0.8.x does not break an
+ * importer. New callers want the budget module's `runtimeStrip`, the meters, or
+ * `formatStatusReport` for the spelled-out numbers.
+ */
+export declare function fitFooterStatsLine(chip: string, groups: readonly string[], width: number): string;
+export interface FooterStatusInput {
+    running: boolean;
+    /**
+     * What the running tools are: the tool's own short name (`edit`, `terminal`,
+     * `search`), the way the transcript's card titles spell it, or a count when
+     * several are open at once.
+     */
+    toolLabel?: string;
+    planReview: boolean;
+    waitingQuestion: boolean;
+    /** A tool call is stopped on a human yes/no. */
+    waitingApproval: boolean;
+    compacting: boolean;
+    retry?: {
+        retry: number;
+        maxRetries: number;
+    };
+    subagents: number;
+    tools: number;
+    planLeftOpen: boolean;
+    planPending: boolean;
+    planActive: boolean;
+    goalPhase?: 'active' | 'paused' | 'blocked';
+    idleMs: number;
+    /** Reasoning deltas have arrived for the step in flight. */
+    streamingReasoning?: boolean;
+    /** Visible text has started arriving for the step in flight. */
+    streamingText?: boolean;
+    /**
+     * Wall clock the current activity began — the open tool call, the running
+     * subagents, the compaction, the step's first delta. The row prints it as
+     * `· 28s`; without one the chip shows the verb alone rather than borrowing a
+     * number that measures something else.
+     */
+    activityStartedAt?: number;
+    model: string;
+    effort?: string;
+    preset?: string;
+    provider: string;
+    parentModel: string;
+    subModel: string;
+    /** Explicit `/submodel` provider override; undefined means "inherit parent". */
+    subProvider?: string;
+    /** Explicit `/subeffort` override for subagent children. */
+    subEffort?: string;
+    quotaCode?: string;
+    quotaPercent?: number;
+    /** Which rolling window `quotaPercent` belongs to: tagged `5Hr`/`1Wk`/`1Mo`. */
+    quotaPeriod?: QuotaPeriod;
+    /** The provider has a quota surface but no reading yet: paint `░░░░░░░░ ?%`. */
+    quotaUnknown?: boolean;
+    contextChip?: string;
+    balanceText?: string;
+    /**
+     * The subscription badge for the row's last part (`OpenCode-GO`,
+     * `CommandCode-GOAT`), for the routes that have one. See `planRouteBadge`.
+     */
+    planBadge?: string;
+    search?: {
+        index: number;
+        total: number;
+    };
+    foldedInput: boolean;
+    multiLineInput: boolean;
+    queued: number;
+    cwdLabel?: string;
+    compactView?: boolean;
+}
+export declare function footerActivity(input: FooterStatusInput): {
+    kind: FooterActivityKind;
+    text: string;
+};
+/**
+ * Paint the `sub:` chip on an otherwise muted status line.
+ *
+ * Only a *foreign* route is accented: cyan when `/submodel` pinned a supplier
+ * the parent is not on. A child that follows the parent (or that was pinned
+ * back onto the parent's own provider) keeps the identity row's mute — the
+ * accent means "this route is not your parent's", and spending it on every
+ * child made the following case look pinned.
+ *
+ * The mute (`90`) is reopened after the chip so the rest of the identity row
+ * stays dim.
+ */
+export declare function paintFooterSubagentChip(line: string, chip: string, foreign: boolean, muteSgr?: string, depth?: ColorDepth, identitySgr?: string): string;
+export declare function footerSubagentForeign(input: Pick<FooterStatusInput, 'provider' | 'subProvider'>): boolean;
+/**
+ * The workspace row is **ordered by priority**, and the fitter drops from the
+ * right - one mechanism, not two.
+ *
+ * The row used to be ordered by what a footer has always shown (preset, cwd,
+ * route) while the fitter cut the right-most part, so a narrow terminal deleted a
+ * queue count while keeping a preset the header already prints. Sorting the parts
+ * by how much they are worth puts both rules in one order:
+ *
+ * 1. `[compact]` - the view mode, the one marker nothing else repeats;
+ * 2. `dir:...` - where this session is working, which the header never says;
+ * 3. `bal ...` - a reading the row must not lose: on a balance-only provider
+ *    (DeepSeek) it is the only one, so it outlives the configuration behind it;
+ * 4. `search i/n`, the input's shape, `queued n` - *state*: what the session is
+ *    doing right now, which is what the reader needs mid-turn;
+ * 5. `sub:...` - configuration, inherited by every child and changed only by
+ *    `/submodel`, so it sits after the state; and
+ * 6. the subscription badge (`OpenCode-GO`, `CommandCode-GOAT`) - context rather
+ *    than action, so it closes the row and is the first part a narrow row gives
+ *    up. Losing the last part reads as "the row got shorter", never as a hole in
+ *    the middle of it.
+ *
+ * The preset is deliberately absent: the header prints it permanently.
+ */
+/** Options for {@link footerIdentityParts}. */
+export interface FooterIdentityOptions {
+    /**
+     * Leave the provider/model/effort out.
+     *
+     * The header paints the live route permanently, so on the workspace row the
+     * parent model is the one piece of information the reader already has — and
+     * the piece that used to push the `sub:` chip off a 100-column row.
+     */
+    omitModel?: boolean;
+}
+/**
+ * The workspace row: what this session is, not what it is doing.
+ *
+ * Quota and context used to live here and now own capacity meters on the row
+ * above, so they are deliberately absent: a number painted twice is a number the
+ * reader has to check twice. What is left is the configuration the header does
+ * not carry — the preset, the working directory, the child route, and the
+ * input's own transient state.
+ */
+export declare function footerIdentityParts(input: FooterStatusInput, options?: FooterIdentityOptions): string[];
+/**
+ * Fit the workspace row under `width`.
+ *
+ * The metadata is secondary by construction: it follows the activity label at a
+ * dimmer intensity and is dropped from the right, one part at a time, rather
+ * than being allowed to wrap into the status row above it.
+ */
+export declare function fitFooterStatusLine(activity: string, identity: readonly string[], width: number): string;
+export interface StatusReportInput {
+    sessionId: string;
+    pluginVersion: string;
+    provider: string;
+    model: string;
+    effort?: string;
+    agentStatus: string;
+    preset: string;
+    activeSubagents: number;
+    plan: 'off' | 'pending' | 'on';
+    paint: string;
+    disconnect?: DisconnectPolicyName;
+    waitingQuestions: number;
+    quota?: QuotaSnapshot;
+    context?: ContextPressureView;
+    parentModel?: string;
+    subProvider?: string;
+    subModel: string;
+    cwd?: string;
+    /** Session counters: the block the default row gave up (B-footer pass). */
+    stats?: SessionStatsRow;
+    /** Throughput accounting: exact rate and the running estimate. */
+    throughput?: ThroughputView;
+}
+/**
+ * Lines printed by `/status` — SSH first-boot diagnostics, no extra command.
+ *
+ * This is where the status row's removed telemetry lives. Turns, steps, model
+ * time, tool time, cache hit and the input/output breakdown are session
+ * analytics: they answer no question a live operator is asking, which is why
+ * they left the default row, and their disappearance would be information loss —
+ * so `/status` prints all of them, plus the throughput accounting, in the shapes
+ * the row used to use.
+ */
+export declare function formatStatusReport(input: StatusReportInput): string[];
+/**
+ * The stats block `/status` prints: everything the default row gave up.
+ *
+ * `tokens/sec` here is the exact per-step rate (`decodeTokens / decodeMs`), not
+ * the running estimate, and the line says which span it covers: the last step
+ * and the session so far are different questions and only one of them is a
+ * benchmark.
+ */
+export declare function formatStatusStats(stats: SessionStatsRow): string[];
+/** One line: what the throughput number means, and which span it covers. */
+export declare function formatStatusThroughput(throughput: ThroughputView): string;

package/lib/types/footer-meters.d.ts

@@ -0,0 +1,151 @@
+/**
+ * The three meter primitives the status row is built from.
+ *
+ * One component per kind of question, because a health question and a capacity
+ * question do not look alike:
+ *
+ * - {@link healthMeter} — "is this healthy?" Discrete levels, no bar. This is the
+ *   SSH chip's four pips, generalised.
+ * - {@link capacityMeter} — "how much is left / how much is used?" A bar and a
+ *   percent. The *direction* is a parameter, which is what lets quota (remaining)
+ *   and context (used) share one implementation.
+ * - {@link performanceValue} — "how fast is it going?" A bare number, neutral,
+ *   with a mark for the estimate and a dimmer form for a finished step.
+ *
+ * Nothing here knows what a row is, how wide it is, or in what order chips go:
+ * that is `footer-budget.ts`, and keeping the two apart is what stops a meter
+ * from growing a layout opinion.
+ *
+ * @module dsh-ssh-tui/footer-meters
+ */
+import { type ThresholdLevel } from './theme.js';
+import { type ColorDepth } from './color-depth.js';
+import { type ThroughputView } from './throughput.js';
+/**
+ * The row's visual vocabulary, as reusable primitives.
+ *
+ * Three components, because the row answers three different kinds of question:
+ *
+ * - {@link healthMeter} — "is this healthy?" Discrete levels, no bar. This is
+ *   the SSH chip's four pips, generalised; nothing else on the row copies it,
+ *   because a health question and a capacity question do not look alike.
+ * - {@link capacityMeter} — "how much is left / how much is used?" A bar with a
+ *   percent. The *direction* is a parameter, which is what lets quota (remaining)
+ *   and context (used) share one implementation.
+ * - {@link performanceValue} — "how fast is it going?" A bare number, neutral,
+ *   with a mark for the estimate and a dimmer form for a finished step.
+ *
+ * All three take `ascii` and answer with the project's own fallback glyphs, and
+ * none of them reach for a threshold colour on their own: the caller decides
+ * whether the number it is drawing has bands at all.
+ */
+/** How many level marks a health meter has: the four pips the SSH chip always had. */
+export declare const HEALTH_METER_LEVELS = 4;
+/** Full and empty level marks. The empty one is the same cell, hollow. */
+export declare const HEALTH_MARK_FILLED = "\u25CF";
+export declare const HEALTH_MARK_EMPTY = "\u25CB";
+/** ASCII fallback for the same four levels, from the project's own glyph table. */
+export declare const HEALTH_ASCII_FILLED = "*";
+export declare const HEALTH_ASCII_EMPTY = "o";
+/** Filled and empty cells of a capacity meter, matching the existing quota bar. */
+export declare const CAPACITY_CELL_FILLED = "\u2588";
+export declare const CAPACITY_CELL_EMPTY = "\u2591";
+/** ASCII fallback for the capacity meter, from the project's own glyph table. */
+export declare const CAPACITY_ASCII_FILLED = "#";
+export declare const CAPACITY_ASCII_EMPTY = ".";
+/** Segment counts by row budget. Three is the smallest bar that still reads. */
+export declare const CAPACITY_SEGMENTS_WIDE = 8;
+export declare const CAPACITY_SEGMENTS_MEDIUM = 5;
+export declare const CAPACITY_SEGMENTS_NARROW = 3;
+/** Which way a capacity meter reads. */
+export type CapacityBasis = 'used' | 'remaining';
+/** Options for one capacity meter; everything but the percent is optional. */
+export interface CapacityMeterOptions {
+    /** Segment count when the row has room. */
+    segments?: number;
+    /** `used` reads left to right as usage, `remaining` as what is left. */
+    basis?: CapacityBasis;
+    /** Leading label, e.g. `5Hr` / `CTX`. */
+    label?: string;
+    /** Trailing text after the percent, e.g. `720K/1M`. */
+    detail?: string;
+    /** Drop the bar entirely, keeping `CTX 72%`. */
+    percentOnly?: boolean;
+    /** Quota bands (50 / 25 remaining) instead of context bands (80 / 95 used). */
+    quota?: boolean;
+    /** Glyphs the terminal can actually draw; defaults to the terminal's own state. */
+    ascii?: boolean;
+    /** Paint the filled run and the percent with the band's accent. */
+    color?: boolean;
+    /** Colour depth the accent is downgraded for. */
+    depth?: ColorDepth;
+}
+/**
+ * Colours for a capacity meter's filled portion.
+ *
+ * Context and quota answer different questions and have different runways, so
+ * they get different bands — but each one reuses a threshold the session already
+ * enforces, so the meter can never disagree with the alert beside it:
+ * context reuses the pressure levels `contextPressureView` uses (warn at 80%,
+ * danger at 95%, the same numbers that drive the compaction prompt), and quota
+ * reuses the first two of `QUOTA_ALERT_THRESHOLDS` (50 / 25 remaining), which is
+ * where the session starts telling the user about it.
+ */
+export declare const CONTEXT_METER_WARN_PERCENT: number;
+export declare const CONTEXT_METER_DANGER_PERCENT: number;
+/** First two entries of `quota.ts`'s `QUOTA_ALERT_THRESHOLDS`, in remaining percent. */
+export declare const QUOTA_METER_WARN_PERCENT = 50;
+export declare const QUOTA_METER_DANGER_PERCENT = 25;
+/** Which band a capacity reading falls in, given what the number means. */
+export declare function capacityLevel(percent: number, basis?: CapacityBasis, quota?: boolean): ThresholdLevel;
+/**
+ * One capacity meter: `CTX ███████░░░ 61%`.
+ *
+ * An unusable percent paints a hollow bar with a question mark rather than `0%`:
+ * a reading nobody took is not a reading of zero, and `?%` is the same claim the
+ * quota chip has always made before its first reading lands.
+ *
+ * Colour, when asked for, lands only on the cells that carry the meaning — the
+ * filled run and the percent. Tinting the label and the empty cells would make
+ * the whole chip one colour and lose the hierarchy it exists to create.
+ */
+export declare function capacityMeter(percent: number | undefined, options?: CapacityMeterOptions): {
+    text: string;
+    level: ThresholdLevel;
+};
+/**
+ * One health meter: `●●●●`.
+ *
+ * Discrete levels, never a bar: a link is one of five states, and four pips say
+ * which at a glance. This is the component the SSH chip has always been — it
+ * simply became reusable when the quota and context meters arrived, so that the
+ * two things that *are* capacities stopped being drawn as pips.
+ */
+export declare function healthMeter(level: number, options?: {
+    levels?: number;
+    ascii?: boolean;
+}): string;
+/** Options for {@link performanceValue}. */
+export interface PerformanceValueOptions {
+    /** `live` is the streaming estimate, `settled` the last completed step. */
+    state: 'live' | 'settled' | 'unavailable';
+    /** `tok/s` in full, `t/s` when the row is out of room. */
+    short?: boolean;
+    /** Paint the live value at the row's primary intensity. */
+    color?: boolean;
+}
+/** Which form of the throughput number can be painted at all. */
+export declare function performanceValueState(throughput: ThroughputView | undefined, running: boolean): PerformanceValueOptions['state'];
+/**
+ * The performance value: `160 tok/s`, `~160 tok/s`, `— tok/s`.
+ *
+ * Tokens per second is neutral telemetry, so this component never reaches for a
+ * threshold colour: the harness publishes no performance classification, and the
+ * same number means different things on a reasoning model, a small fast one, and
+ * a long-context request. `~` marks the live estimate — characters per second
+ * scaled by this session's own tokens-per-character — and the settled value has
+ * no mark because it is exact. A live value is lifted out of the row's muted
+ * style because it is the one number on the row that is *moving*; every theme
+ * understands "default intensity", and the mono theme keeps the distinction.
+ */
+export declare function performanceValue(throughput: ThroughputView | undefined, running: boolean, options?: Partial<PerformanceValueOptions>): string;