zidane-ui/chat

Provides a ChatHost and optional label overrides to the chat components below it.

Renders the daemon status orb for the given health and activity counts. It ripples once when the state changes or a run ends.

Renders the daemon orb inside an icon-button-sized button. The caller supplies the label (for example aria-label) and the click handler.

A fixed glyph in the header's icon column.

A host's name and connection as a badge, a button when onOpen is given.

A host's connection status as a dot, labelled with the status word (and the last error, in its tooltip).

Renders a session's transcript from the ChatHost in context, with loading, earlier-messages, and row actions wired to the host.

Renders a PDF in a frame showing the browser's PDF viewer.

The time a run has left, counting down (~11m), in the info tint; almost done once the estimate is spent, dimmed while the run waits on the user, and over in the warning tint once the run is past its estimate. A run the host could not estimate, for a reason that will not go away by itself (a rejected request, missing credentials), shows a muted warning mark whose tooltip says why.

Hands the app's run estimates to what shows them (a subagent's header in the transcript). Without it, nothing shows an estimate.

Renders the faders button and the dropdown menu of session list filters. Each axis is a row that opens a submenu of choices.

Renders a group heading in a session list. The label is a button that toggles collapse; the caret shows on hover or focus and stays visible once collapsed.

A host's header row (an <li>) in a session list grouped by host.

Renders the session list for the ChatHost in context: grouped and sorted rows with rename, archive, and delete when the host supports them.

Renders one session in a list: status dot, title with inline rename, badges, meta, an optional second line, and an actions menu behind a 3-dots trigger and right-click.

Provides one session streams to the hooks below it.

Ends a capped group: reveals the rest of it. Aligned under the rows' titles.

Renders a session's state as a small dot, with a motion cue for states that need attention.

The kit's text preview, the default TextPreview slot: the text highlighted for its language (a plain <pre> for plain text, while the highlighter loads, or when it fails).

The busy indicator: a row of glyphs cycling through the theme's throbber gradient, then an ellipsis.

Renders a session's events as transcript rows: messages, tool calls grouped by the display options, subagent blocks, notices, and the select-turn cursor. Rows mount lazily as they near the viewport.

The dot for a session's plain status, when a host has nothing richer.

Maps daemon health and activity counts to an OrbState. A disconnected daemon is down and a connecting one is connecting; otherwise waiting sessions win over running ones, and no activity is idle.

The media stand-ins of a result's text, in order, and the text without them.

Text / border color.

The hue (0 to 359) for a provider key: the pinned hue of a well-known provider whose name the key starts with, else a hash of the key.

Soft tinted fill for chips / badges.

The text behind src: a data: URL decodes at once, any other URL is fetched.

Captures the run-state version; the returned check says whether it still holds. A signal or runtime switch invalidates snapshots fetched before it.

Returns the ChatHost from the nearest ChatProvider. Throws when called outside one.

Returns the chat UI strings: the defaults merged with any overrides given to ChatProvider or LabelsProvider.

Whether the store holds any record for the session (re-renders when that changes).

The host's session list (empty when the host has none).

Whether the session's transcript is hydrated (re-renders when that changes).

Returns the ChatHost from the nearest ChatProvider, or null outside one (a surface that works without a host, its extras hidden).

Reads a session's run-start sequence without subscribing. Stable.

Reads a session's current events without subscribing (for event handlers). Stable.

Reads whether a session's run is in flight without subscribing. Stable.

The estimate of a session's own run, or of its subagent label, while one is known; undefined otherwise.

The session's events that carry a file edit, as a stable list: a reader re-renders when an edit lands, not on every streamed token.

The session's events.

A value derived from the session's events, recomputed only when the events change. select should be stable (module-level or memoised) and return a stable reference for unchanged input.

The fallback model the session's run switched to, null when none.

The session's scrollback state: whether older turns exist, whether a page is loading.

The provider retry the session's run is in, null when none.

Whether a run is in flight for the session.

The streams' bound writes (stable): dispatching never subscribes the caller.

The streams themselves (stable).

The session's SYSTEM.md override (it replaces the built-in doctrine), null when none.

Picks the transcript's options out of values (only those set: the transcript keeps zidane's defaults for the rest). The result keeps its identity while those settings do, so a change to any other setting leaves the transcript alone.

zidane's defaults for those settings.

Past this size a text attachment is listed, not previewed.

The settings a transcript reads, in one order.

Props for ChatProvider.

Props for DaemonOrbButton: the orb's health, running, and attention plus the attributes of a button (without children).

Props for DaemonOrb.

Props for GroupGlyph.

Props for HostBadge.

Props for HostStatusDot.

Props for HostTranscript: the TranscriptProps minus the ones the host supplies (events, streaming, sessionId), plus sessionId and onOpenSession.

Props for PdfPreview.

Props of RunEstimateChip.

Props of RunEstimatesProvider.

A row that does something and closes the menu (Save view as space).

One axis: its value, the choices in menu order (default: the app's), and the change handler.

Props for SessionFilterMenu. Each axis shows only when its prop is set.

Props for SessionGroupHeader.

Props for SessionHostHeader.

Props for SessionList.

Props for SessionListRow. Every app-specific part is a slot (status, titleDisplay, badges, meta, sub) or data (menuItems).

The project axis: null is every project; options are the project names.

Props of SessionStreamsProvider.

Props for ShowMoreRow.

Props for StatusDot.

Props for TextPreview: the TextPreviewSlotProps plus the root's class and style.

Props for Throbber.

One media block of a tool result, as parsed from its text stand-in.

Props for Transcript.

Select-turn mode, driven by the app (its keys move selected).

What a text preview shows: the text once it is in, or that it could not be read.

The visual state of a DaemonOrb, derived from daemon health and activity by orbState.

Last-activity window of the activity filter: sessions active within 1d, 3d, 7d, or 30d, or all.

Which sessions the status filter shows: active, archived, or all.

Visual state of a StatusDot.

An extra row of the menu: one choice among options, an on/off toggle, or several picks.

Where an extra row sits: with the view, the filters or the sort.

A choice of the view axis: a grouping of the list model, host, one section per host, which the app lays out itself (the desktop sidebar's Per host), or agent, one group per agent.

The display settings a transcript reads: zidane's Settings fields of the same names.