@textui/chat 0.6.0

package/dist/sessionhead.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@textui/core/jsx-runtime";
+import { defineComponent, useTheme } from '@textui/core';
+import { Column, KeyValue, Row } from '@textui/widgets';
+/**
+ * A timestamp a person can read, in whatever this machine calls a date.
+ *
+ * The host sends ISO, which is unambiguous and not what anybody wants to read
+ * off a caption. An unparseable one is passed through rather than shown as
+ * "Invalid Date": what the host said is more useful than what we made of it.
+ */
+function when(iso) {
+    if (!iso)
+        return '';
+    const at = new Date(iso);
+    if (Number.isNaN(at.getTime()))
+        return iso;
+    return at.toLocaleString(undefined, {
+        year: 'numeric', month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit',
+    });
+}
+export const ChatSessionHead = defineComponent('ChatSessionHead', (props) => {
+    const { session, model, chat, settings = [], present = [], ...rest } = props;
+    const theme = useTheme();
+    const status = session.status;
+    const started = when(session.createdAt);
+    const updated = when(session.modifiedAt);
+    // Only what is known. A row of empty values is what building this from a
+    // fixed list produces, and it reads as a session the host would not talk
+    // about rather than as one nobody has asked yet.
+    const rows = [
+        { label: 'Harness', value: [session.provider, model].filter(Boolean).join(`  ${theme.glyphs.separator}  `) },
+        ...settings.filter((setting) => setting.value).map((setting) => ({ ...setting })),
+        { label: 'Workspace', value: session.workingDirectories.map((dir) => dir.replace(/^file:\/\//, '')).join(', ') },
+        // Only when the host says one. A blank branch row reads as a detached
+        // head rather than as a host that does not report branches.
+        ...(session.branch ? [{ label: 'Branch', value: session.branch }] : []),
+        {
+            label: 'Started',
+            value: started && updated && updated !== started
+                ? `${started}  ${theme.glyphs.separator}  updated ${updated}`
+                : started,
+        },
+        // Last, and in full. A uri you can read half of is worse than one you
+        // cannot see at all: it looks like the whole thing.
+        { label: 'Session', value: session.id },
+        ...(chat ? [{ label: 'Chat', value: chat }] : []),
+        // Only when somebody else is here. One entry is this client, and a row
+        // saying you are the person reading it is a row that tells nobody
+        // anything.
+        ...(present.length > 1
+            ? [{
+                    label: 'Here',
+                    value: present.map((one) => one.displayName ?? one.clientId).join(`  ${theme.glyphs.separator}  `),
+                }]
+            : []),
+    ].filter((row) => row.value !== '');
+    return (_jsxs(Column, { ...rest, gap: 0, children: [_jsxs(Row, { gap: 1, children: [_jsx("text", { content: theme.glyphs[status.glyph], fg: status.tone, shrink: 0 }), _jsx("text", { content: session.title, bold: true, wrap: "word", flex: 1 }), _jsx("text", { content: status.label, fg: status.tone, shrink: 0 })] }), _jsx(KeyValue, { items: rows })] }));
+});

package/dist/sessions.d.ts

@@ -0,0 +1,35 @@
+import type { BoxProps, RenderOutput } from '@textui/core';
+import type { ChatSession } from './types.js';
+/**
+ * The catalogue.
+ *
+ * Still a `List` - the selection, the keys, the window and the highlight are
+ * all the list's, and reimplementing them here is what the transcript already
+ * proved is a mistake. What is ours is the row, because a session does not fit
+ * the one-line shape a list gives you for free.
+ *
+ * It takes two lines, and the first one is why. A title, a harness, a
+ * workspace and a status sharing a pane that is also sharing the terminal
+ * with the detail panel leaves every one of them truncated:
+ * `Draft replies for desk-produ…` beside `1b444e78-d050-4fb5-a5…` names
+ * neither the conversation nor the directory it is in. So the title gets the
+ * width, and everything that qualifies it goes underneath.
+ */
+export interface SessionListProps extends BoxProps {
+    sessions: ChatSession[];
+    selectedId?: string | null;
+    onSelect?(id: string): void;
+    onOpen?(id: string): void;
+    emptyMessage?: string;
+    focusId?: string;
+    autoFocus?: boolean;
+}
+export declare const SessionList: (props: SessionListProps) => RenderOutput;
+export interface ConnectionBadgeProps extends BoxProps {
+    url: string;
+    state: 'connecting' | 'connected' | 'offline';
+    sessions?: number;
+}
+/** Which host, and whether it is answering. */
+export declare const ConnectionBadge: (props: ConnectionBadgeProps) => RenderOutput;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAmB,MAAM,cAAc,CAAC;AAI5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,WAAW,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,YAuFnD,CAAC;AAEL,MAAM,WAAW,oBAAqB,SAAQ,QAAQ;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,eAAO,MAAM,eAAe,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,YAiB3D,CAAC"}

package/dist/sessions.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@textui/core/jsx-runtime";
+import { defineComponent, stringWidth, useTheme } from '@textui/core';
+import { Badge, Column, List, Marquee, Row } from '@textui/widgets';
+export const SessionList = defineComponent('SessionList', (props) => {
+    const { sessions, selectedId, onSelect, onOpen, emptyMessage, focusId, autoFocus, ...rest } = props;
+    const theme = useTheme();
+    const dot = `  ${theme.glyphs.separator}  `;
+    const items = sessions.map((session) => {
+        const status = session.status;
+        const changes = session.changes;
+        return {
+            id: session.id,
+            // Glyph first, so the one that wants a person is findable in a piped
+            // log, a 16-colour session and by a reader who cannot see the colour.
+            icon: theme.glyphs[status.glyph],
+            label: session.title,
+            // The second line, in the order it gets read: which harness, then
+            // where, then what it has to show for it.
+            //
+            // The harness stands where a model would: a catalogue row does not
+            // carry one, and a model per row would be a subscription per row.
+            description: [
+                session.provider,
+                // The project, then the branch it is on - a catalogue spanning
+                // several repositories is read by which one each row is in, and a
+                // list of them all on `main` is a list that needs opening to tell
+                // apart. Then the pull request the branch became, where the host
+                // found one: a merged branch is a finished row.
+                [session.project, session.branch, session.pullRequest].filter(Boolean).join(' '),
+                changes?.files
+                    ? `${changes.files} files  +${changes.additions ?? 0} -${changes.deletions ?? 0}`
+                    : '',
+                // What the host says it is doing, in its own words. Last, because it
+                // is the one that is usually not there.
+                session.activity ?? '',
+                // Why it is here at all, when nobody started it. Without this a
+                // session that appeared at nine in the morning is a row with no
+                // account of itself, sitting among rows somebody typed.
+                session.origin ?? '',
+                status.archived ? 'archived' : '',
+            ].filter(Boolean).join(dot),
+            meta: status.label,
+            tone: status.tone,
+        };
+    });
+    return (_jsx(List, { items: items, itemHeight: 2, renderItem: (item, state) => (_jsxs(Column, { children: [_jsxs(Row, { gap: 1, children: [_jsx("text", { content: item.icon ?? '', ...(state.selected ? {} : { fg: item.tone }), shrink: 0 }), _jsx(Marquee, { content: item.label, active: state.selected && state.focused, flex: 1 }), _jsx("text", { content: item.meta ?? '', ...(state.selected ? {} : { fg: 'muted' }), shrink: 0 })] }), _jsxs(Row, { children: [_jsx("text", { content: ' '.repeat(stringWidth(item.icon ?? '') + 1), shrink: 0 }), _jsx(Marquee, { content: item.description ?? '', active: state.selected && state.focused, ...(state.selected ? {} : { fg: 'muted' }), flex: 1 })] })] })), ...(selectedId ? { selectedId } : {}), emptyMessage: emptyMessage ?? 'No sessions on this host', onSelect: (id) => onSelect?.(id), onActivate: (id) => onOpen?.(id), ...(focusId ? { focusId } : {}), ...(autoFocus ? { autoFocus: true } : {}), ...rest }));
+});
+/** Which host, and whether it is answering. */
+export const ConnectionBadge = defineComponent('ConnectionBadge', (props) => {
+    const { url, state, sessions, ...rest } = props;
+    const theme = useTheme();
+    const look = {
+        connected: { tone: 'success', glyph: theme.glyphs.bulletFilled },
+        connecting: { tone: 'warning', glyph: theme.glyphs.bulletHalf },
+        offline: { tone: 'danger', glyph: theme.glyphs.cross },
+    }[state];
+    return (_jsxs(Row, { gap: 1, ...rest, children: [_jsx("text", { content: look.glyph, fg: look.tone }), _jsx("text", { content: url, fg: "muted", truncate: "start" }), sessions !== undefined ? _jsx(Badge, { label: `${sessions} sessions`, tone: "muted" }) : null] }));
+});

package/dist/toolcall.d.ts

@@ -0,0 +1,28 @@
+import type { BoxProps, RenderOutput } from '@textui/core';
+import type { ChatToolCall } from './types.js';
+/**
+ * A tool call, as a row.
+ *
+ * Twenty of these in a turn look identical unless the *command* is on the row,
+ * so the input is the row and the display name is a prefix. What it meant to
+ * do is markdown, like everything else a host writes for a person; what came
+ * back is not, and is shown as it arrived.
+ *
+ * The status is a glyph and a colour together. A 16-colour session, a piped
+ * log and a colourblind reader all lose the colour and keep the glyph.
+ *
+ * In the transcript it sits beside a blank gutter rather than inside the rule,
+ * with its status glyph where the header's bullet is. A tool call is something
+ * the agent *did*; indenting it inside the rule filed it under what the agent
+ * was saying, which is the one thing it is not.
+ */
+export interface ToolCallRowProps extends BoxProps {
+    call: ChatToolCall;
+    expanded?: boolean;
+    /** The transcript's cursor is on this row. */
+    active?: boolean;
+    /** Clicking the row opens it. */
+    onToggle?(): void;
+}
+export declare const ToolCallRow: (props: ToolCallRowProps) => RenderOutput;
+//# sourceMappingURL=toolcall.d.ts.map

package/dist/toolcall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolcall.d.ts","sourceRoot":"","sources":["../src/toolcall.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAmB,MAAM,cAAc,CAAC;AAG5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,QAAQ,CAAC,IAAI,IAAI,CAAC;CACnB;AA0BD,eAAO,MAAM,WAAW,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,YAgFnD,CAAC"}

package/dist/toolcall.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@textui/core/jsx-runtime";
+import { defineComponent, useTheme } from '@textui/core';
+import { Badge, Column, MarkdownView, Row } from '@textui/widgets';
+const LOOK = {
+    pending: { tone: 'muted', glyph: 'bulletHollow' },
+    'pending-confirmation': { tone: 'warning', glyph: 'bulletHalf' },
+    running: { tone: 'accent', glyph: 'bulletFilled' },
+    completed: { tone: 'success', glyph: 'check' },
+    failed: { tone: 'danger', glyph: 'cross' },
+    cancelled: { tone: 'muted', glyph: 'cross' },
+};
+/**
+ * The input, as one line.
+ *
+ * A tool's arguments are often JSON, and JSON arrives with newlines in it. Put
+ * straight on the row, a three-line object makes the row three lines tall and
+ * every other cell in it vertically centred - so the name floats beside the
+ * middle line of a brace-delimited block. The whole thing is on its own lines
+ * once the row is opened; this is the part that fits beside a name.
+ */
+function oneLine(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+export const ToolCallRow = defineComponent('ToolCallRow', (props) => {
+    const { call, expanded, active, onToggle, ...rest } = props;
+    const theme = useTheme();
+    const look = LOOK[call.status] ?? { tone: 'muted', glyph: 'bulletHollow' };
+    const glyph = theme.glyphs[look.glyph];
+    const chevron = expanded ? theme.glyphs.chevronDown : theme.glyphs.chevronRight;
+    const failed = call.status === 'failed' || (call.exitCode !== undefined && call.exitCode !== 0);
+    // What it is doing beats what it was asked, for as long as it is doing
+    // it: a subagent's row that says "look for the bug" for a minute is a
+    // row that says nothing, and the host has a line for what it is up to.
+    const summary = oneLine(call.progress ?? call.input ?? call.intention ?? '');
+    // Only when there is something under it. A chevron on a row that opens on
+    // to nothing is a promise the row cannot keep.
+    const opens = Boolean(call.intention ?? call.input ?? call.output ?? call.outcome
+        ?? (call.files && call.files.length > 0));
+    // On the selection the name, the summary and the chevron take `inverted`,
+    // the theme's own rule for that tone; the status glyph keeps its own, since
+    // a check that turned white would stop saying "completed".
+    return (_jsxs(Column, { ...rest, ...(active ? { bg: 'selected' } : {}), children: [_jsxs(Row, { gap: 1, ...(opens && onToggle ? { onClick: onToggle } : {}), 
+                // The whole row lights up, not the glyph the pointer happens to be
+                // over: the row is the thing that opens.
+                style: { hover: { bg: 'hover' } }, children: [_jsx("text", { content: glyph, fg: look.tone }), _jsx("text", { content: call.name, bold: true, ...(active ? { fg: 'inverted' } : {}) }), _jsx("text", { content: summary, fg: active ? 'inverted' : 'muted', flex: 1, truncate: "middle" }), call.status === 'pending-confirmation' ? _jsx(Badge, { label: "asks", tone: "warning", icon: theme.glyphs.warning }) : null, failed ? _jsx(Badge, { label: `exit ${call.exitCode ?? 1}`, tone: "danger" }) : null, opens ? _jsx("text", { content: chevron, fg: active ? 'inverted' : 'subtle' }) : null] }), expanded ? (
+            // Indented to the row's own text, which starts one glyph and one gap
+            // in - so what opened out of a row lines up under it.
+            _jsxs(Column, { padding: [0, 0, 0, 2], gap: 0, children: [call.intention && call.intention !== call.name && call.intention !== call.input
+                        ? _jsx(MarkdownView, { content: call.intention, quiet: true })
+                        : null, call.input ? (
+                    // On its own lines, wrapped as written. This is where the JSON
+                    // goes: whole, and not sharing a row with the name.
+                    _jsx(Column, { bg: "surfaceAlt", padding: [0, 1], children: call.input.split('\n').map((line, i) => (_jsx("text", { content: line, fg: "text", wrap: "word" }, i))) })) : null, call.output ? (_jsxs(Column, { children: [call.output.split('\n').slice(0, 12).map((line, i) => (_jsx("text", { content: line, fg: "muted", truncate: "end" }, i))), call.output.split('\n').length > 12 ? (_jsx("text", { content: `${theme.glyphs.ellipsis} ${call.output.split('\n').length - 12} more lines`, fg: "subtle" })) : null] })) : null, call.files && call.files.length > 0 ? (_jsx(Column, { children: call.files.map((file) => (_jsx("text", { content: `${theme.glyphs.chevronRight} ${file}`, fg: "info" }, file))) })) : null, call.outcome ? _jsx("text", { content: call.outcome, fg: "subtle" }) : null] })) : null] }));
+});

package/dist/transcript.d.ts

@@ -0,0 +1,53 @@
+import type { BoxProps, RenderOutput } from '@textui/core';
+import type { Block } from './blocks.js';
+/**
+ * The conversation, as blocks in a feed.
+ *
+ * There is no scrolling in this file. `Feed` owns the viewport, the cursor and
+ * the tail it follows, because none of that is about chat: a transcript, an
+ * activity stream and a list of search results with snippets are the same
+ * problem, which is "entries that are not one line tall". What is left here is
+ * the only part that *is* about chat - which block draws as what.
+ */
+export interface ChatTranscriptProps extends BoxProps {
+    blocks: Block[];
+    expanded: Record<string, boolean>;
+    onToggle(id: string): void;
+    /** Which block the cursor is on. Held by the screen, like every other state. */
+    cursor?: number;
+    onCursor?(index: number): void;
+    /**
+     * What the find box is looking for.
+     *
+     * Passed down to be coloured where it appears, not to decide what is drawn:
+     * every block stays where it was and the ones holding the term light up, so
+     * a reader keeps the conversation around a hit instead of a filtered list
+     * of the lines that matched.
+     */
+    match?: string;
+    /**
+     * Keep the cursor in view rather than only when it moves.
+     *
+     * For the find box, which drives the cursor: its first hit is often the
+     * block the cursor is already on, and a feed that only scrolls on a change
+     * would leave that one off screen while the box counted it.
+     */
+    pinCursor?: boolean;
+    /**
+     * What this conversation is, as the first thing in it.
+     *
+     * Inside the scrolling region rather than pinned above it: a caption outside
+     * costs a row of the conversation on every screen for ever, so it has to
+     * earn each one - which is what forces it down to a line and then down to
+     * less than it was for. Here it costs nothing after the first screen.
+     *
+     * It is not a block. The cursor walks the conversation and there is nothing
+     * to do to a caption, so it sits ahead of the indices rather than in them.
+     */
+    head?: RenderOutput;
+    focusId?: string;
+    /** Prose and reasoning as markdown (the default), or as the characters that arrived. */
+    markdown?: boolean;
+}
+export declare const ChatTranscript: (props: ChatTranscriptProps) => RenderOutput;
+//# sourceMappingURL=transcript.d.ts.map

package/dist/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../src/transcript.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIzC;;;;;;;;GAQG;AAEH,MAAM,WAAW,mBAAoB,SAAQ,QAAQ;IACnD,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,cAAc,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,YA2CzD,CAAC"}

package/dist/transcript.js

@@ -0,0 +1,67 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@textui/core/jsx-runtime";
+import { defineComponent, useTheme } from '@textui/core';
+import { Feed, Row } from '@textui/widgets';
+import { ChatBubble, Gutter, ReasoningBlock, StreamingText, cursorBar } from './bubble.js';
+import { ToolCallRow } from './toolcall.js';
+export const ChatTranscript = defineComponent('ChatTranscript', (props) => {
+    const { blocks, expanded, onToggle, cursor, onCursor, head, markdown, match, pinCursor, focusId = 'chat.transcript', ...rest } = props;
+    // The caption is an entry the feed scrolls and the cursor does not visit,
+    // so every index the feed reports is one further along than the block it
+    // stands for. Converted here, once, rather than at each of the three
+    // places that would otherwise each have to remember.
+    const lead = head ? 1 : 0;
+    return (_jsxs(Feed, { focusId: focusId, 
+        // Page up from the composer means the conversation above it. There is
+        // nothing else on this screen those keys could be for, and taking the
+        // keyboard off the field to use them is what a reader is avoiding.
+        pageKeys: "always", ...(cursor !== undefined ? { selectedIndex: cursor + lead } : {}), ...(pinCursor ? { pinSelection: true } : {}), ...(onCursor ? { onSelect: (index) => onCursor(Math.max(0, index - lead)) } : {}), onActivate: (index) => {
+            const block = blocks[index - lead];
+            if (block)
+                onToggle(block.id);
+        }, ...rest, children: [head ?? null, blocks.map((block) => (_jsx(BlockView, { block: block, expanded: expanded[block.id] ?? false, active: cursor !== undefined && blocks[cursor]?.id === block.id, onToggle: () => onToggle(block.id), ...(markdown !== undefined ? { markdown } : {}), ...(match ? { match } : {}) }, block.id)))] }));
+});
+const BlockView = defineComponent('ChatBlockView', ({ block, expanded, active, onToggle, markdown, match }) => {
+    const asMarkdown = markdown !== undefined ? { markdown } : {};
+    // Spread rather than passed, so a block with no search over it carries no
+    // extra prop and its text node is compared unchanged.
+    const hit = match ? { match } : {};
+    const theme = useTheme();
+    // Every block has a one-cell left column the cursor is drawn in. The blocks
+    // that are something said keep the rule they draw there; a block whose
+    // first row already carries a glyph in that column - the header's bullet,
+    // the user line's chevron - has that glyph as its gutter cell, and the bar
+    // takes its place while the cursor is on it; the rest lead with a blank
+    // gutter, so their text starts where the prose does.
+    const mark = active ? { active: true } : {};
+    switch (block.kind) {
+        case 'said':
+            // The blank row is the turn boundary. A uniform gap between every block
+            // would space a paragraph from the sentence it belongs to just as much
+            // as it spaces one speaker from the next.
+            return (_jsx(ChatBubble, { speaker: "user", padding: [1, 0, 0, 0], ...mark, children: _jsx("text", { content: block.text, wrap: "word", ...hit }) }));
+        case 'header':
+            return (_jsxs(Row, { gap: 1, padding: [1, 0, 0, 0], children: [_jsx("text", { content: active ? cursorBar(theme) : theme.glyphs.bulletFilled, fg: active || block.state === 'running' ? 'accent' : 'muted' }), _jsx("text", { content: block.model ?? 'agent', bold: true, fg: "accent" }), block.settings ? _jsx("text", { content: block.settings, fg: "subtle" }) : null, _jsx("text", { content: block.meta, fg: "subtle", flex: 1 }), block.state === 'cancelled' ? _jsx("text", { content: "stopped", fg: "warning" }) : null, block.state === 'failed' ? _jsx("text", { content: "failed", fg: "danger" }) : null] }));
+        case 'prose':
+            return (_jsxs(Row, { gap: 1, children: [_jsx(Gutter, { ...mark }), _jsx(StreamingText, { content: block.content, streaming: block.streaming, flex: 1, ...asMarkdown, ...hit })] }));
+        case 'reasoning':
+            return (_jsxs(Row, { gap: 1, children: [_jsx(Gutter, { ...mark }), _jsx(ReasoningBlock, { content: block.content, expanded: expanded, streaming: block.streaming, onToggle: onToggle, flex: 1, ...mark, ...asMarkdown, ...hit })] }));
+        case 'notice':
+            return (_jsxs(Row, { gap: 1, children: [_jsx(Gutter, { blank: true, ...mark }), _jsx("text", { content: theme.glyphs.info, fg: "info" }), _jsx("text", { content: block.content, fg: "muted", wrap: "word", flex: 1, ...hit })] }));
+        // Not a notice. A notice is the harness saying something in passing, and
+        // this is the turn stopping - so it takes the danger tone and says whether
+        // there is anything to carry on from.
+        case 'failure':
+            return (_jsxs(Row, { gap: 1, children: [_jsx(Gutter, { blank: true, ...mark }), _jsx("text", { content: theme.glyphs.cross, fg: "danger" }), _jsx("text", { content: block.content, fg: "danger", wrap: "word", flex: 1, ...hit }), block.resumable ? _jsx("text", { content: "resumable", fg: "subtle" }) : null] }));
+        case 'tool':
+            // No rule. A tool call is something the agent *did*, not something it
+            // said, so its status glyph sits where the header's bullet is - rather
+            // than inside the rule as though it were a paragraph of the answer.
+            return (_jsxs(Row, { gap: 1, children: [_jsx(Gutter, { blank: true, ...mark }), _jsx(ToolCallRow, { call: block.call, expanded: expanded, active: active, onToggle: onToggle, flex: 1 })] }));
+        case 'queued':
+            // Not sent. It reads as a message unless it says so, and "I typed that
+            // and nothing happened" is the complaint that follows.
+            return (_jsxs(Row, { gap: 1, children: [_jsx(Gutter, { blank: true, ...mark }), _jsx("text", { content: theme.glyphs.chevronRight, fg: active ? 'accent' : 'subtle' }), _jsx("text", { content: block.text, fg: "subtle", italic: true, wrap: "word", flex: 1, ...hit }), _jsx("text", { content: active ? 'enter drops it' : 'queued', fg: "warning" })] }));
+        default:
+            return null;
+    }
+});

package/dist/types.d.ts

@@ -0,0 +1,176 @@
+/**
+ * What the chat components are told, in the components' own words.
+ *
+ * These are view shapes, not a protocol. A client that speaks AHP, or
+ * anything else, maps its own records onto them and the components never
+ * learn where a session or a tool call came from. The field names follow the
+ * Agent Host Protocol's where one exists, so that mapping is a pick rather
+ * than a rename - but nothing here is imported from it, and nothing here
+ * says how a session is fetched.
+ */
+export type ChatToolCallStatus = 'pending' | 'pending-confirmation' | 'running' | 'completed' | 'failed' | 'cancelled';
+/** One tool call, flat: the fields that are not there yet are absent. */
+export interface ChatToolCall {
+    id: string;
+    /** What the row calls it. */
+    name: string;
+    /**
+     * The tool's own id, where it differs from the display name.
+     *
+     * Hosts give many tools one display name - every subagent is "Explore" or
+     * "Plan" and the tool under all of them is `Task` - and a person searching
+     * the transcript for the one or the other should find the row either way.
+     */
+    toolName?: string;
+    status: ChatToolCallStatus;
+    /** The command. The only thing separating twenty identical rows. */
+    input?: string;
+    /** What it meant to do. Markdown. */
+    intention?: string;
+    /**
+     * What it is doing right now, while it runs.
+     *
+     * A line drawn on a running row and dropped when the row ends: a
+     * subagent's own summary of how far it has got, the last tool it reached
+     * for. Read only while `running`; a host that leaves it on a finished call
+     * is still describing a state the call is no longer in.
+     */
+    progress?: string;
+    /** What it did, past tense. */
+    outcome?: string;
+    /** What came back. */
+    output?: string;
+    exitCode?: number;
+    files?: string[];
+    /** Set while `pending-confirmation`. */
+    confirmationTitle?: string;
+    options?: {
+        id: string;
+        label: string;
+    }[];
+}
+export type ChatActivity = 'input' | 'running' | 'error' | 'idle';
+/**
+ * A session's state, already decoded.
+ *
+ * The word, the colour and the glyph travel together because none of them is
+ * allowed to be the only carrier: a piped log keeps the word, a 16-colour
+ * terminal keeps the glyph, and a reader who cannot see the colour keeps both.
+ */
+export interface ChatSessionStatus {
+    activity: ChatActivity;
+    archived: boolean;
+    read: boolean;
+    label: string;
+    tone: 'warning' | 'accent' | 'danger' | 'muted';
+    glyph: 'bulletHalf' | 'bulletFilled' | 'cross' | 'bulletHollow';
+}
+/** One row of the catalogue, and the head over a conversation. */
+export interface ChatSession {
+    id: string;
+    title: string;
+    /** Which harness runs it. */
+    provider: string;
+    status: ChatSessionStatus;
+    createdAt: string;
+    modifiedAt: string;
+    workingDirectories: string[];
+    /** The project as the host names it, when it does. */
+    project?: string;
+    branch?: string;
+    /**
+     * The pull request the branch became, as the row says it: `#412 merged`.
+     *
+     * Already a label. Which host key holds the number and which the state is
+     * the client's to know; the row only has one line to say it on.
+     */
+    pullRequest?: string;
+    /** What the host says it is doing, in its own words. */
+    activity?: string;
+    /** Why it is here when nobody started it, as a phrase: "by an automation". */
+    origin?: string;
+    changes?: {
+        files?: number;
+        additions?: number;
+        deletions?: number;
+    };
+}
+export type ChatQuestionKind = 'text' | 'number' | 'integer' | 'boolean' | 'single-select' | 'multi-select';
+export interface ChatQuestion {
+    id: string;
+    kind: ChatQuestionKind;
+    message: string;
+    required?: boolean;
+    options?: {
+        id: string;
+        label: string;
+    }[];
+    /** Answering in words *instead of* choosing, not as a choice. */
+    allowFreeformInput?: boolean;
+}
+export type ChatAnswer = {
+    kind: 'text';
+    value: string;
+} | {
+    kind: 'number';
+    value: number;
+} | {
+    kind: 'boolean';
+    value: boolean;
+} | {
+    kind: 'selected';
+    value: string;
+} | {
+    kind: 'selected-many';
+    value: string[];
+};
+/** A yes or a no about a command, with named options where there are any. */
+export interface ChatToolConfirmation {
+    kind: 'toolConfirmation';
+    id: string;
+    call: ChatToolCall;
+}
+/** A request in prose, with the questions under it. */
+export interface ChatInputRequest {
+    kind: 'chatInput';
+    id: string;
+    message: string;
+    questions: ChatQuestion[];
+}
+export type ChatPendingInput = ChatToolConfirmation | ChatInputRequest;
+/** One entry of the path menu under the composer. */
+export interface ChatCompletion {
+    /** What to put in the draft. */
+    insertText: string;
+    /** Where the replaced fragment starts, as an offset into the draft. */
+    rangeStart: number;
+    /** Where it ends. */
+    rangeEnd: number;
+    /** What a person reads in the menu. */
+    label: string;
+    /** One line under it, when there is something worth reading. */
+    description?: string;
+}
+/** One entry of the slash menu. */
+export interface ChatCommand {
+    id: string;
+    kind: 'client' | 'session';
+    title: string;
+    description?: string;
+    /** Where a session command came from: the plugin or directory. */
+    from?: string;
+    /**
+     * What goes after the name, written the way it would be typed.
+     *
+     * `/autocompact <tokens>` says more about the command than a sentence
+     * describing it, and it is the one thing a menu cannot show in a row: the
+     * row is the name.
+     */
+    hint?: string;
+}
+/** The row under the composer: gone to the host, or never going. */
+export interface ChatSendStatus {
+    state: 'sending' | 'failed';
+    text: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * What the chat components are told, in the components' own words.
+ *
+ * These are view shapes, not a protocol. A client that speaks AHP, or
+ * anything else, maps its own records onto them and the components never
+ * learn where a session or a tool call came from. The field names follow the
+ * Agent Host Protocol's where one exists, so that mapping is a pick rather
+ * than a rename - but nothing here is imported from it, and nothing here
+ * says how a session is fetched.
+ */
+export {};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@textui/chat",
+  "version": "0.6.0",
+  "description": "The TextUI chat components - transcript, composer, tool calls, questions, sessions and diffs",
+  "keywords": [
+    "terminal",
+    "tui",
+    "chat",
+    "agent",
+    "components",
+    "jsx",
+    "ui",
+    "text-ui"
+  ],
+  "homepage": "https://softov.github.io/textui/",
+  "bugs": {
+    "url": "https://github.com/softov/textui/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/softov/textui.git",
+    "directory": "packages/chat"
+  },
+  "license": "MIT",
+  "author": "Softov <softov@brbyte.com>",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@textui/core": "workspace:^",
+    "@textui/widgets": "workspace:^"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@textui/testing": "workspace:*"
+  }
+}