basalt-ui 1.41.0 → 2.0.1

package/configs/oxlint.json

@@ -13,7 +13,7 @@
     "react/rules-of-hooks": "error",
     "react/jsx-key": "error",
     "react/react-in-jsx-scope": "off",
-    "typescript/no-explicit-any": "warn",
+    "typescript/no-explicit-any": "error",
     "import/no-duplicates": "error",
     "import/no-unassigned-import": "off",
     "jsx-a11y/prefer-tag-over-role": "off",
@@ -22,7 +22,15 @@
       {
         "allow": ["__APP_VERSION__"]
       }
-    ]
+    ],
+    "react/globals": "error",
+    "react/immutability": "error",
+    "react/incompatible-library": "error",
+    "react/preserve-manual-memoization": "error",
+    "react/refs": "error",
+    "react/only-export-components": ["warn", { "allowExportNames": ["Route"] }],
+    "react/set-state-in-effect": "error",
+    "no-constant-binary-expression": "error"
   },
   "overrides": [
     {

package/dist/agent/ai-sdk-transport.d.ts

@@ -1,18 +1,30 @@
 import type { AgentPart } from './parts.js';
 import type { ResumableAgentTransport } from './transport.js';
-export type AiSdkTransportOptions = {
+import type { ChatTransport, UIMessage } from 'ai';
+export type AiSdkHttpOptions = {
     /** The API URL AI SDK's transport POSTs new turns to and GETs reconnects from. */
     readonly api: string;
+    readonly transport?: undefined;
     /** HTTP headers to send with every request. */
-    readonly headers?: Record<string, string> | Headers;
+    readonly headers?: Record<string, string> | Headers | undefined;
     /** The fetch credentials mode. Defaults to 'same-origin' (AI SDK's own default). */
-    readonly credentials?: RequestCredentials;
+    readonly credentials?: RequestCredentials | undefined;
     /**
      * Custom fetch implementation — e.g. to scope requests to a mock backend in tests/playground,
      * or to add middleware. Defaults to the ambient `fetch` when omitted.
      */
-    readonly fetch?: typeof globalThis.fetch;
+    readonly fetch?: typeof globalThis.fetch | undefined;
 };
+/**
+ * Any AI SDK `ChatTransport<UIMessage>`, used as-is: a `WebSocketChatTransport` plugs in here
+ * unwrapped. basalt never wraps or re-implements a transport; it only reads the chunk stream the
+ * transport returns.
+ */
+export type AiSdkCustomOptions = {
+    readonly api?: undefined;
+    readonly transport: ChatTransport<UIMessage>;
+};
+export type AiSdkTransportOptions = AiSdkHttpOptions | AiSdkCustomOptions;
 export type AiSdkTransport<TPart = AgentPart> = ResumableAgentTransport<TPart, string> & {
     /**
      * Returns an AgentTransport bound to a stable chat id (e.g. a basalt-ui thread id) instead of
@@ -22,15 +34,15 @@ export type AiSdkTransport<TPart = AgentPart> = ResumableAgentTransport<TPart, s
     readonly forThread: (chatId: string) => ResumableAgentTransport<TPart, string>;
 };
 /**
- * Wraps AI SDK's `DefaultChatTransport` + `readUIMessageStream` into an AgentTransport.
+ * Wraps an AI SDK `ChatTransport` (`DefaultChatTransport` for `{ api }`, or your own via
+ * `{ transport }`) + `readUIMessageStream` into an AgentTransport.
  *
- * The returned object is immediately usable with useAgentStream (one fixed, stable chat id for
+ * The returned object is immediately usable as-is (one fixed, stable chat id for
  * the whole conversation). Call `.forThread(threadId)` to get a transport bound to a different
  * (caller-supplied) chat id — the per-thread form for useAgentThreadRuns.
  *
  * @example
  * const transport = aiSdkTransport<AgentPart>({ api: '/api/chat' })
- * const { send, parts, status } = useAgentStream({ transport })
  */
 export declare function aiSdkTransport<TPart = AgentPart>(options: AiSdkTransportOptions): AiSdkTransport<TPart>;
 //# sourceMappingURL=ai-sdk-transport.d.ts.map

package/dist/agent/ai-sdk-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-sdk-transport.d.ts","sourceRoot":"","sources":["../../src/agent/ai-sdk-transport.ts"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,SAAS,CAAA;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAmB1D,MAAM,MAAM,qBAAqB,GAAG;IAClC,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAA;IACnD,oFAAoF;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAA;IACzC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CACzC,CAAA;AAID,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,SAAS,IAAI,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG;IACvF;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CAC/E,CAAA;AAwRD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAG,SAAS,EAC9C,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAAC,KAAK,CAAC,CAyDvB"}
+{"version":3,"file":"ai-sdk-transport.d.ts","sourceRoot":"","sources":["../../src/agent/ai-sdk-transport.ts"],"names":[],"mappings":"AAkDA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,SAAS,CAAA;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAK1D,OAAO,KAAK,EACV,aAAa,EAGb,SAAS,EAGV,MAAM,IAAI,CAAA;AAOX,MAAM,MAAM,gBAAgB,GAAG;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,GAAG,SAAS,CAAA;IAC/D,oFAAoF;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAA;IACrD;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAA;CACrD,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;CAC7C,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,kBAAkB,CAAA;AAIzE,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,SAAS,IAAI,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG;IACvF;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CAC/E,CAAA;AA8RD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAG,SAAS,EAC9C,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAAC,KAAK,CAAC,CA4DvB"}

package/dist/agent/ai-sdk-transport.js

@@ -6,7 +6,7 @@ function createAiSdkResolver(options) {
   return function resolveAiSdk() {
     resolved ??= import("ai").then(
       ({ DefaultChatTransport: DefaultChatTransportCtor, readUIMessageStream: read }) => ({
-        httpTransport: new DefaultChatTransportCtor({
+        chatTransport: options.transport !== void 0 ? options.transport : new DefaultChatTransportCtor({
           api: options.api,
           ...options.headers !== void 0 ? { headers: options.headers } : {},
           ...options.credentials !== void 0 ? { credentials: options.credentials } : {},
@@ -142,7 +142,7 @@ function diffMessage(chatId, prev, curr, toolStartTimes) {
 async function* diffChunkStream(chatId, chunkStream, readStream, signal) {
   let prev;
   const toolStartTimes = /* @__PURE__ */ new Map();
-  for await (const curr of readStream({ stream: chunkStream })) {
+  for await (const curr of readStream({ stream: chunkStream, terminateOnError: true })) {
     if (signal?.aborted) return;
     for (const part of diffMessage(chatId, prev, curr, toolStartTimes)) {
       yield part;
@@ -160,19 +160,19 @@ function aiSdkTransport(options) {
       idempotentReplay: true,
       async *stream(input, signal, ctx) {
         yield { id: `${chatId}#start`, type: "start", runId: chatId, resumeToken: chatId };
-        const { httpTransport, readUIMessageStream: readStream } = await resolveAiSdk();
+        const { chatTransport, readUIMessageStream: readStream } = await resolveAiSdk();
         const userMessage = {
           // This id is what AI SDK's own backend persistence/dedup keys turns hang off — the same
           // idempotency-key cost as basalt's own ChatMessage.id (see mintMessageId's doc). Prefer
           // the caller's OWN idempotency key (ctx.messageId — the id useAgentThreadRuns.start()
           // already minted for this turn's ChatMessage) so the two never diverge for one turn; only
-          // a caller that omits ctx (useAgentStream, a hand-rolled stream() call) falls back to
+          // a caller that omits ctx (a hand-rolled stream() call) falls back to
           // minting a fresh one here.
           id: ctx?.messageId ?? mintMessageId(),
           role: "user",
           parts: [{ type: "text", text: input }]
         };
-        const chunkStream = await httpTransport.sendMessages({
+        const chunkStream = await chatTransport.sendMessages({
           chatId,
           messages: [userMessage],
           trigger: "submit-message",
@@ -182,8 +182,11 @@ function aiSdkTransport(options) {
         yield* diffChunkStream(chatId, chunkStream, readStream, signal);
       },
       async *resume(resumeToken, signal) {
-        const { httpTransport, readUIMessageStream: readStream } = await resolveAiSdk();
-        const chunkStream = await httpTransport.reconnectToStream({ chatId: resumeToken });
+        const { chatTransport, readUIMessageStream: readStream } = await resolveAiSdk();
+        const chunkStream = await chatTransport.reconnectToStream({
+          chatId: resumeToken,
+          ...signal !== void 0 ? { abortSignal: signal } : {}
+        });
         if (chunkStream === null) return;
         yield* diffChunkStream(resumeToken, chunkStream, readStream, signal);
       }

package/dist/{agent-chat → agent/chat}/composer.d.ts

@@ -1,5 +1,5 @@
 import type { ClipboardEvent, JSX, ReactNode, Ref } from 'react';
-import type { BasaltProps, SlotStylesProps } from '../common/props.js';
+import type { BasaltProps, SlotStylesProps } from '../../common/props.js';
 export type ComposerAttachment = {
     readonly id: string;
     readonly name: string;
@@ -63,7 +63,7 @@ export type ComposerHandle = {
 export type ComposerSlot = 'root' | 'input' | 'actions';
 export type ComposerProps = BasaltProps & SlotStylesProps<ComposerSlot> & {
     /** Imperative write/focus handle — see `ComposerHandle`. */
-    readonly ref?: Ref<ComposerHandle>;
+    readonly ref?: Ref<ComposerHandle> | undefined;
     /**
      * Called with the trimmed text plus the pending attachments. May return `void` (fire-and-forget,
      * validated only synchronously) or a `Promise<void>` (its outcome is awaited, its timing is not).
@@ -86,41 +86,41 @@ export type ComposerProps = BasaltProps & SlotStylesProps<ComposerSlot> & {
      * A resolved promise clears and stays cleared, same as a `void` return.
      */
     readonly onSubmit: (payload: ComposerSubmit) => void | Promise<void>;
-    readonly placeholder?: string;
+    readonly placeholder?: string | undefined;
     /** Autofocuses the textarea on mount. */
-    readonly autoFocus?: boolean;
+    readonly autoFocus?: boolean | undefined;
     /** Autosize ceiling for the textarea. Default 6. */
-    readonly maxRows?: number;
+    readonly maxRows?: number | undefined;
     /** Hard-disable, independent of streaming (e.g. offline). */
-    readonly disabled?: boolean;
+    readonly disabled?: boolean | undefined;
     /** A run is in flight on this thread. */
-    readonly streaming?: boolean;
+    readonly streaming?: boolean | undefined;
     /** Default false — preserves the historical `disabled={streaming}` behaviour. */
-    readonly allowSubmitWhileStreaming?: boolean;
+    readonly allowSubmitWhileStreaming?: boolean | undefined;
     /** When given, the send action becomes a Stop action while `streaming`. */
-    readonly onStop?: () => void;
+    readonly onStop?: (() => void) | undefined;
     /**
      * Opaque slot rendered before the textarea (a voice recorder, a mode switch, …). Slot content
      * that needs to WRITE into the composer — append a transcript, insert a suggestion — does so
      * through the `ref` handle (`ComposerHandle`), not a callback prop here; see the file's
      * `@example`.
      */
-    readonly leftSection?: ReactNode;
+    readonly leftSection?: ReactNode | undefined;
     /** Opaque slot rendered between the textarea and the send action (an attach button, …). */
-    readonly rightSection?: ReactNode;
+    readonly rightSection?: ReactNode | undefined;
     /**
      * Pending attachments, owned by the caller. Composer only forwards them on submit and asks for a
      * reset afterwards — rendering previews is the caller's job, via `leftSection`/`rightSection`.
      */
-    readonly attachments?: readonly ComposerAttachment[];
+    readonly attachments?: readonly ComposerAttachment[] | undefined;
     /**
      * Called with `[]` optimistically the instant a submit goes out WITH pending attachments — a
      * submit that had none to begin with skips the call rather than reporting a no-op change — and,
      * subject to the restoration guards documented on `onSubmit`, with the original attachments
      * again if that submit later rejects.
      */
-    readonly onAttachmentsChange?: (next: readonly ComposerAttachment[]) => void;
-    readonly onPaste?: (event: ClipboardEvent<HTMLTextAreaElement>) => void;
+    readonly onAttachmentsChange?: ((next: readonly ComposerAttachment[]) => void) | undefined;
+    readonly onPaste?: ((event: ClipboardEvent<HTMLTextAreaElement>) => void) | undefined;
     /**
      * Persists the unsent draft under `basalt:composer-draft:<key>`; switching keys swaps drafts, and
      * the entry is removed (not blanked) on a successful submit.
@@ -129,9 +129,9 @@ export type ComposerProps = BasaltProps & SlotStylesProps<ComposerSlot> & {
      * that fails, synchronously or later over the network, restores this persisted draft instead of
      * leaving it erased (subject to the restoration guards documented on `onSubmit`).
      */
-    readonly draftKey?: string;
+    readonly draftKey?: string | undefined;
     /** Replaces the whole Enter/Shift+Enter hint row. Pass `null` to drop it entirely. */
-    readonly hint?: ReactNode;
+    readonly hint?: ReactNode | undefined;
 };
 /**
  * An autosize Textarea + send ActionIcon, with slots either side. Enter submits, Shift+Enter

package/dist/agent/chat/composer.d.ts.map

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

package/dist/{agent-chat → agent/chat}/composer.js

@@ -1,9 +1,9 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { ActionIcon, Box, Group, Kbd, Stack, Text, Textarea } from "@mantine/core";
-import { useImperativeHandle, useLayoutEffect, useRef, useSyncExternalStore } from "react";
-import { cx } from "../common/props.js";
-import { readPersistedValue } from "../state.js";
-import { VX } from "../tokens/index.js";
+import { useImperativeHandle, useLayoutEffect, useMemo, useRef, useSyncExternalStore } from "react";
+import { cx } from "../../common/props.js";
+import { readPersistedValue } from "../../state/persisted.js";
+import { VX } from "../../tokens/index.js";
 import { useKeyboardInsetRef } from "./use-keyboard-inset.js";
 function SendGlyph() {
   return /* @__PURE__ */ jsx("svg", { width: 16, height: 16, viewBox: "0 0 24 24", fill: "none", "aria-hidden": true, children: /* @__PURE__ */ jsx(
@@ -129,9 +129,8 @@ function Composer({
   style,
   classNames
 }) {
-  const memoryStore = useRef(null);
-  memoryStore.current ??= createDraftStore(null);
-  const store = draftKey === void 0 ? memoryStore.current : persistedDraftStore(draftKey);
+  const memoryStore = useMemo(() => createDraftStore(null), []);
+  const store = draftKey === void 0 ? memoryStore : persistedDraftStore(draftKey);
   const value = useSyncExternalStore(
     isServer ? noopSubscribe : store.subscribe,
     isServer ? emptyDraft : store.get,
@@ -144,9 +143,11 @@ function Composer({
   const trimmed = value.trim();
   const hasPayload = trimmed.length > 0 || pending.length > 0;
   const attachmentsRef = useRef(pending);
-  attachmentsRef.current = pending;
   const draftKeyRef = useRef(draftKey);
-  draftKeyRef.current = draftKey;
+  useLayoutEffect(() => {
+    attachmentsRef.current = pending;
+    draftKeyRef.current = draftKey;
+  });
   const textareaRef = useRef(null);
   const pendingCaretRef = useRef(null);
   useLayoutEffect(() => {

package/dist/{agent-chat → agent/chat}/message-affordances.d.ts

@@ -10,13 +10,14 @@
  * stays internal — resolving unset fields is the components' job, not the consumer's.
  */
 import type { ReactNode } from 'react';
-import type { ChatMessage, TranscriptPart } from '../agent/index.js';
+import type { ChatMessage } from '../history.js';
+import type { TranscriptPart } from '../foreign.js';
 export type MessageAffordances = {
     /**
      * How the per-message timestamp renders.
      * @default 'relative'
      */
-    readonly timestamp?: 'relative' | 'absolute' | 'none';
+    readonly timestamp?: 'relative' | 'absolute' | 'none' | undefined;
     /**
      * Whether a copy action is offered on the hover row. Copies the message's COALESCED text (the
      * same merged/de-duplicated text `coalesceParts` produces for display), not the raw `parts`
@@ -25,7 +26,7 @@ export type MessageAffordances = {
      * assembled.
      * @default true
      */
-    readonly copy?: boolean;
+    readonly copy?: boolean | undefined;
     /**
      * Regenerate action, shown on the LAST ASSISTANT message only (never on earlier turns, never on
      * user messages). Receives that message's `id`. `useAgentThreadRuns`'s `retry` is
@@ -33,7 +34,7 @@ export type MessageAffordances = {
      * whole thread — the consumer bridges this messageId-keyed callback to that thread-keyed retry;
      * the framework only ever hands back the messageId, it does not know about threads.
      */
-    readonly onRegenerate?: (messageId: string) => void;
+    readonly onRegenerate?: ((messageId: string) => void) | undefined;
     /**
      * Extra actions appended to the hover row, after the built-in copy/regenerate actions.
      *
@@ -47,9 +48,9 @@ export type MessageAffordances = {
      * a long thread it is worth avoiding: wrap `actions` in the consumer's own `useCallback`, keyed
      * on whatever state it actually reads.
      */
-    readonly actions?: (ctx: {
+    readonly actions?: ((ctx: {
         readonly message: ChatMessage<TranscriptPart>;
-    }) => ReactNode;
+    }) => ReactNode) | undefined;
 };
 /**
  * Resolved defaults for the optional {@link MessageAffordances} fields — one place, so

package/dist/agent/chat/message-affordances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-affordances.d.ts","sourceRoot":"","sources":["../../../src/agent/chat/message-affordances.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAA;IACjE;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IACjE;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,OAAO,CAAC,EACb,CAAC,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,cAAc,CAAC,CAAA;KAAE,KAAK,SAAS,CAAC,GACvE,SAAS,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,MAAM,CAAC,CAGxF,CAAA"}

package/dist/agent/chat/relative-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-time.d.ts","sourceRoot":"","sources":["../../../src/agent/chat/relative-time.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAc5D"}

package/dist/{agent-chat → agent/chat}/thread-feed-row.d.ts

@@ -1,6 +1,8 @@
 import type { JSX, ReactNode } from 'react';
-import type { AgentThread, ChatMessage, ForeignPart, PartRenderer, PartRenderers, StreamStatus, TranscriptPart } from '../agent/index.js';
-import type { BasaltProps, SlotStylesProps } from '../common/props.js';
+import type { AgentThread, StreamStatus } from '../thread.js';
+import type { ChatMessage } from '../history.js';
+import type { ForeignPart, PartRenderer, PartRenderers, TranscriptPart } from '../foreign.js';
+import type { BasaltProps, SlotStylesProps } from '../../common/props.js';
 import type { ComposerProps, ComposerSubmit } from './composer.js';
 import type { MessageAffordances } from './message-affordances.js';
 import type { RowHeightProps } from './virtualize.js';
@@ -26,48 +28,48 @@ type ThreadFeedRowBase = {
      * and never guessed client-side), pass it directly instead of forcing an outcome shape onto data
      * that never had one.
      */
-    readonly title?: string;
+    readonly title?: string | undefined;
     /** Header summary override, same fallback rule as `title` (`thread.outcome?.summary ?? ''`). */
-    readonly summary?: string;
+    readonly summary?: string | undefined;
     /** Rendered at the START of the header row, before the title/summary stack — a pin icon, a type
      * badge (argo's hermes-chat S5). Absent by default; renders nothing extra when omitted. */
-    readonly headerLeft?: ReactNode;
+    readonly headerLeft?: ReactNode | undefined;
     /** Rendered at the END of the header row, before the timestamp and chevron — a collapsed-only
      * streaming indicator (argo's hermes-chat S5). Absent by default; renders nothing extra when
      * omitted. */
-    readonly headerRight?: ReactNode;
+    readonly headerRight?: ReactNode | undefined;
     /**
      * Overrides the transcript source: when provided, the row renders THESE messages instead of
      * reading `thread.messages` directly (argo's hermes-chat S6 — the confirmed transcript is an
      * optimistic-overlay MERGE over the store's messages, not the store's messages verbatim).
      * Defaults to `thread.messages`.
      */
-    readonly messages?: readonly ChatMessage<TranscriptPart>[];
+    readonly messages?: readonly ChatMessage<TranscriptPart>[] | undefined;
     /** The live (in-flight) assistant turn's parts, when a run is streaming for this thread. */
-    readonly liveParts?: readonly TranscriptPart[];
+    readonly liveParts?: readonly TranscriptPart[] | undefined;
     /** The live run's status — drives the in-progress indicator on the live block. */
-    readonly liveStatus?: StreamStatus;
+    readonly liveStatus?: StreamStatus | undefined;
     /** Consumer renderers keyed by part.type, forwarded to `ThreadTranscript`. */
-    readonly renderers?: PartRenderers;
+    readonly renderers?: PartRenderers | undefined;
     /** Forwarded to `ThreadTranscript` — see its own prop doc. */
-    readonly fallbackRenderer?: PartRenderer<ForeignPart>;
+    readonly fallbackRenderer?: PartRenderer<ForeignPart> | undefined;
     /**
      * Per-message hover-row contract (timestamp/copy/regenerate/actions), forwarded verbatim to the
      * row's `ThreadTranscript`. Shared with it via `message-affordances.ts` so the two cannot drift
      * on what an unset field means.
      */
-    readonly affordances?: MessageAffordances;
+    readonly affordances?: MessageAffordances | undefined;
     /** Forwarded to `ThreadTranscript` — suppresses role label + chrome on same-speaker runs.
      * @default true */
-    readonly groupConsecutive?: boolean;
+    readonly groupConsecutive?: boolean | undefined;
     /** Called with the composer's submit payload. */
     readonly onSend: (payload: ComposerSubmit) => void;
-    /** Shown as the composer's Stop action while `liveStatus === 'streaming'`. */
-    readonly onStop?: () => void;
+    /** Shown as the composer's Stop action while `liveStatus` is `'submitted'` or `'streaming'`. */
+    readonly onStop?: (() => void) | undefined;
     /** Forwarded to the row's `Composer`, minus the three props this component always wires itself
      * (`onSubmit`, `onStop`, and `streaming` — the last derived from `liveStatus` so a consumer can't
      * pass one that disagrees with the row's own live status). */
-    readonly composerProps?: Omit<ComposerProps, 'onSubmit' | 'onStop' | 'streaming'>;
+    readonly composerProps?: Omit<ComposerProps, 'onSubmit' | 'onStop' | 'streaming'> | undefined;
 };
 /**
  * `virtualize`/`height` are forwarded straight to the row's `ThreadTranscript`, carrying the same

package/dist/agent/chat/thread-feed-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-feed-row.d.ts","sourceRoot":"","sources":["../../../src/agent/chat/thread-feed-row.tsx"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAG3C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG1F,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGtE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAI/D,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,cAAc,CAAA;AAsCnE,KAAK,iBAAiB,GAAG;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,cAAc,CAAC,CAAA;IAC5C,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,gGAAgG;IAChG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC;+FAC2F;IAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC3C;;kBAEc;IACd,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,WAAW,CAAC,cAAc,CAAC,EAAE,GAAG,SAAS,CAAA;IACtE,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,CAAA;IAC1D,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IAC9C,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;IAC9C,8DAA8D;IAC9D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,GAAG,SAAS,CAAA;IACjE;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAA;IACrD;uBACmB;IACnB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/C,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;IAClD,gGAAgG;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;IAC1C;;kEAE8D;IAC9D,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC,GAAG,SAAS,CAAA;CAC9F,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAChD,cAAc,GACd,eAAe,CAAC,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC,GAC3C,WAAW,CAAA;AAkBb;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,GAAG,CAAC,OAAO,CA8JpE"}

package/dist/{agent-chat → agent/chat}/thread-feed-row.js

@@ -1,10 +1,11 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Box, Group, Stack, Text, UnstyledButton } from "@mantine/core";
 import { useState } from "react";
-import { BasaltStickToBottom } from "../agent/index.js";
-import { cx } from "../common/props.js";
-import { assertRequiredProps } from "../common/validate.js";
-import { VX } from "../tokens/index.js";
+import { isLiveStatus } from "../thread.js";
+import { BasaltStickToBottom } from "../stick-to-bottom.js";
+import { cx } from "../../common/props.js";
+import { assertRequiredProps } from "../../common/validate.js";
+import { VX } from "../../tokens/index.js";
 import { Composer } from "./composer.js";
 import { formatRelativeTime } from "./relative-time.js";
 import { ThreadTranscript } from "./thread-message.js";
@@ -81,17 +82,17 @@ function ThreadFeedRow(props) {
   const resolvedTitle = rowTitle(thread, title);
   const resolvedSummary = rowSummary(thread, summaryOverride);
   const transcriptMessages = messages ?? thread.messages;
-  const streaming = liveStatus === "streaming";
+  const streaming = isLiveStatus(liveStatus);
   const transcript = /* @__PURE__ */ jsx(
     ThreadTranscript,
     {
       messages: transcriptMessages,
-      ...liveParts !== void 0 ? { liveParts } : {},
-      ...liveStatus !== void 0 ? { liveStatus } : {},
-      ...renderers !== void 0 ? { renderers } : {},
-      ...fallbackRenderer !== void 0 ? { fallbackRenderer } : {},
-      ...affordances !== void 0 ? { affordances } : {},
-      ...groupConsecutive !== void 0 ? { groupConsecutive } : {},
+      liveParts,
+      liveStatus,
+      renderers,
+      fallbackRenderer,
+      affordances,
+      groupConsecutive,
       ...virtualizeProps
     }
   );

package/dist/{agent-chat → agent/chat}/thread-feed.d.ts

@@ -1,6 +1,6 @@
 import type { JSX, ReactNode } from 'react';
-import type { AgentThread } from '../agent/index.js';
-import type { BasaltProps } from '../common/props.js';
+import type { AgentThread } from '../thread.js';
+import type { BasaltProps } from '../../common/props.js';
 import type { ComposerSubmit } from './composer.js';
 export type ThreadFeedProps = BasaltProps & {
     readonly threads: AgentThread[];
@@ -19,22 +19,22 @@ export type ThreadFeedProps = BasaltProps & {
      * directly (the previous shape) meant a plain `onSelect={setActiveId}` consumer could never
      * collapse a row, since re-selecting the same id is a no-op state update. Collapsing here is
      * local, UI-only state, reset whenever `activeId` changes to point at a DIFFERENT thread. Since
-     * this reset is a `useEffect` keyed on `activeId`, re-driving it to the SAME id from outside
-     * this component is a no-op React dep comparison, so it does not clear the override.
+     * this reset compares `activeId` against the last one seen, re-driving it to the SAME id from outside
+     * this component is a no-op comparison, so it does not clear the override.
      */
-    readonly variant?: 'outcome' | 'inline';
+    readonly variant?: 'outcome' | 'inline' | undefined;
     /**
      * Wires the built-in `'inline'` row's composer to a real send channel — called with the thread
      * and the composer's submit payload. Omit it and the row's composer renders disabled (visibly
      * inert) instead of a live control that silently discards whatever is typed into it; a consumer
      * that needs the composer live must supply this (or `renderRow`, for full control over the row).
      */
-    readonly onSend?: (thread: AgentThread, payload: ComposerSubmit) => void;
+    readonly onSend?: ((thread: AgentThread, payload: ComposerSubmit) => void) | undefined;
     /** Overrides row rendering entirely, for BOTH variants — when supplied, this is called for every
      * thread instead of either built-in row. Gives full control over live-run wiring
      * (`onStop`/`liveParts`/`liveStatus`) the built-in `'inline'` row doesn't expose; see `variant`
      * and `onSend`. */
-    readonly renderRow?: (thread: AgentThread) => ReactNode;
+    readonly renderRow?: ((thread: AgentThread) => ReactNode) | undefined;
     /**
      * Scroll anchor. `'start'` (default) is today's top-anchored `ScrollArea` feed, unchanged.
      * `'end'` anchors the feed's growth to the BOTTOM instead — a `BasaltStickToBottom` scroll node
@@ -44,7 +44,7 @@ export type ThreadFeedProps = BasaltProps & {
      * (argo's hermes-chat S15 — oldest→newest top→bottom, pinned last, `renderRow`-driven) needs
      * instead of hand-rolling its own scroll shell around `renderRow`.
      */
-    readonly anchor?: 'start' | 'end';
+    readonly anchor?: 'start' | 'end' | undefined;
 };
 /**
  * A scrollable feed of thread rows, animated on add/remove/reorder. Row content comes from

package/dist/agent/chat/thread-feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-feed.d.ts","sourceRoot":"","sources":["../../../src/agent/chat/thread-feed.tsx"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAG5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAShD,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG;IAC1C,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,CAAA;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC;uGACmG;IACnG,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IACtF;;;uBAGmB;IACnB,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAC,GAAG,SAAS,CAAA;IACrE;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,CAAA;CAC9C,CAAA;AAgCD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,OAAmB,EACnB,MAAM,EACN,SAAS,EACT,MAAgB,EAChB,SAAS,EACT,KAAK,GACN,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CAsF/B"}

package/dist/{agent-chat → agent/chat}/thread-feed.js

@@ -1,12 +1,12 @@
 import { jsx } from "react/jsx-runtime";
 import { Box, ScrollArea, Stack } from "@mantine/core";
 import { useReducedMotion } from "@mantine/hooks";
-import { AnimatePresence, motion } from "motion/react";
-import { useEffect, useState } from "react";
-import { BasaltStickToBottom } from "../agent/index.js";
-import { cx } from "../common/props.js";
-import { assertRequiredProps } from "../common/validate.js";
-import { MOTION_SPRING } from "../common/motion.js";
+import { AnimatePresence, MotionConfig, motion } from "motion/react";
+import { useState } from "react";
+import { BasaltStickToBottom } from "../stick-to-bottom.js";
+import { cx } from "../../common/props.js";
+import { assertRequiredProps } from "../../common/validate.js";
+import { MOTION_SPRING } from "../../common/motion.js";
 import { ThreadFeedRow } from "./thread-feed-row.js";
 import { ThreadOutcomeCard } from "./thread-outcome-card.js";
 function noopSend() {
@@ -48,9 +48,11 @@ function ThreadFeed({
   assertRequiredProps("ThreadFeed", { threads }, ["threads"]);
   const reduceMotion = useReducedMotion();
   const [collapsedId, setCollapsedId] = useState(null);
-  useEffect(() => {
+  const [seenActiveId, setSeenActiveId] = useState(activeId);
+  if (seenActiveId !== activeId) {
+    setSeenActiveId(activeId);
     setCollapsedId(null);
-  }, [activeId]);
+  }
   function handleInlineToggle(id) {
     const isOpen = id === activeId && id !== collapsedId;
     if (isOpen) {
@@ -62,7 +64,7 @@ function ThreadFeed({
   }
   const rowFor = (thread) => renderRow !== void 0 ? renderRow(thread) : defaultRow(thread, variant, activeId, collapsedId, handleInlineToggle, onSelect, onSend);
   const stackAnchorProps = anchor === "end" ? { justify: "flex-end", mih: "100%" } : {};
-  const list = reduceMotion ? /* @__PURE__ */ jsx(Stack, { gap: "sm", p: "sm", ...stackAnchorProps, children: threads.map((thread) => /* @__PURE__ */ jsx(Box, { children: rowFor(thread) }, thread.id)) }) : /* @__PURE__ */ jsx(Stack, { gap: "sm", p: "sm", ...stackAnchorProps, children: /* @__PURE__ */ jsx(AnimatePresence, { mode: "popLayout", initial: false, children: threads.map((thread) => /* @__PURE__ */ jsx(
+  const list = reduceMotion ? /* @__PURE__ */ jsx(Stack, { gap: "sm", p: "sm", ...stackAnchorProps, children: threads.map((thread) => /* @__PURE__ */ jsx(Box, { children: rowFor(thread) }, thread.id)) }) : /* @__PURE__ */ jsx(Stack, { gap: "sm", p: "sm", ...stackAnchorProps, children: /* @__PURE__ */ jsx(MotionConfig, { reducedMotion: "user", children: /* @__PURE__ */ jsx(AnimatePresence, { mode: "popLayout", initial: false, children: threads.map((thread) => /* @__PURE__ */ jsx(
     motion.div,
     {
       layout: true,
@@ -73,7 +75,7 @@ function ThreadFeed({
       children: rowFor(thread)
     },
     thread.id
-  )) }) });
+  )) }) }) });
   if (anchor === "end") {
     return /* @__PURE__ */ jsx(BasaltStickToBottom, { className: cx(className), style: { height: "100%", ...style }, children: list });
   }

package/dist/{agent-chat → agent/chat}/thread-message.d.ts

@@ -1,6 +1,9 @@
 import type { JSX } from 'react';
-import type { AgentPartRenderers, ChatMessage, ForeignPart, PartRenderer, PartRenderers, StreamStatus, TranscriptPart } from '../agent/index.js';
-import type { BasaltProps } from '../common/props.js';
+import type { AgentPartRenderers } from '../part-list.js';
+import type { ChatMessage } from '../history.js';
+import type { ForeignPart, PartRenderer, PartRenderers, TranscriptPart } from '../foreign.js';
+import type { StreamStatus } from '../thread.js';
+import type { BasaltProps } from '../../common/props.js';
 import type { MessageAffordances } from './message-affordances.js';
 import type { VirtualizeOptions, VirtualizeProps } from './virtualize.js';
 /**
@@ -185,22 +188,22 @@ type ThreadTranscriptBase = BasaltProps & {
     /** Settled messages for the thread, oldest first. */
     readonly messages: readonly ChatMessage<TranscriptPart>[];
     /** The live (in-flight) assistant turn's parts, when a run is streaming for this thread. */
-    readonly liveParts?: readonly TranscriptPart[];
+    readonly liveParts?: readonly TranscriptPart[] | undefined;
     /** The live run's status — drives the in-progress indicator on the live block. */
-    readonly liveStatus?: StreamStatus;
+    readonly liveStatus?: StreamStatus | undefined;
     /** Consumer renderers keyed by part.type. Consulted BEFORE the built-in union. */
-    readonly renderers?: PartRenderers;
+    readonly renderers?: PartRenderers | undefined;
     /** Called for a part whose type is neither an AgentPart variant nor a registered key. Defaults
      * to a visible `UnknownPartChip` outside production, `null` in production — never throws. */
-    readonly fallbackRenderer?: PartRenderer<ForeignPart>;
+    readonly fallbackRenderer?: PartRenderer<ForeignPart> | undefined;
     /** Per-message hover-row affordances (timestamp/copy/regenerate/custom actions). Unset fields
      * fall back to `DEFAULT_AFFORDANCES`. Never shown on the live/streaming message — see
      * `MessageBlockProps.affordances`. */
-    readonly affordances?: MessageAffordances;
+    readonly affordances?: MessageAffordances | undefined;
     /** Suppresses the role label and surface chrome on a message whose predecessor shares its role
      * and landed within 5 minutes — the Slack rhythm.
      * @default true */
-    readonly groupConsecutive?: boolean;
+    readonly groupConsecutive?: boolean | undefined;
 };
 export type ThreadTranscriptProps = ThreadTranscriptBase & VirtualizeProps;
 /**
@@ -219,7 +222,7 @@ export type ThreadTranscriptProps = ThreadTranscriptBase & VirtualizeProps;
  *
  * @example
  * import { ThreadTranscript } from 'basalt-ui'
- * <ThreadTranscript messages={thread.messages} liveParts={liveParts} liveStatus={runStatus} />
+ * <ThreadTranscript messages={thread.messages} liveParts={run?.parts} liveStatus={run?.status} />
  *
  * @example
  * // Windowed, for a long thread:

package/dist/agent/chat/thread-message.d.ts.map

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