basalt-ui 1.41.0 → 2.0.1

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

@@ -12,12 +12,15 @@ import {
 } from "@mantine/core";
 import { useDisclosure, useFocusWithin, useHover, useMergedRef } from "@mantine/hooks";
 import { Fragment, lazy, memo, Suspense, useLayoutEffect, useMemo, useRef } from "react";
-import { coalesceParts, narrowAgentPart, PartList } from "../agent/index.js";
-import { cx } from "../common/props.js";
-import { assertRequiredProps } from "../common/validate.js";
-import { Markdown } from "../content/markdown.js";
-import { CopyAction } from "../content/copy-action.js";
-import { VX } from "../tokens/index.js";
+import { isLiveStatus } from "../thread.js";
+import { coalesceParts } from "../coalesce.js";
+import { narrowAgentPart } from "../foreign.js";
+import { PartList } from "../part-list.js";
+import { cx } from "../../common/props.js";
+import { assertRequiredProps } from "../../common/validate.js";
+import { Markdown } from "../../content/markdown.js";
+import { CopyAction } from "../../content/copy-action.js";
+import { VX } from "../../tokens/index.js";
 import { DEFAULT_AFFORDANCES } from "./message-affordances.js";
 import { formatRelativeTime } from "./relative-time.js";
 import { ToolChip } from "./tool-chip.js";
@@ -399,7 +402,9 @@ function VirtualizedTranscript(props) {
 const EMPTY_RENDERERS = {};
 function useStableCallback(callback) {
   const callbackRef = useRef(callback);
-  callbackRef.current = callback;
+  useLayoutEffect(() => {
+    callbackRef.current = callback;
+  });
   const stable = useMemo(
     () => (...args) => callbackRef.current?.(...args),
     []
@@ -438,11 +443,8 @@ function ThreadTranscript(props) {
     () => ({
       timestamp: affordancesProp?.timestamp ?? DEFAULT_AFFORDANCES.timestamp,
       copy: affordancesProp?.copy ?? DEFAULT_AFFORDANCES.copy,
-      // `exactOptionalPropertyTypes` forbids assigning a possibly-`undefined` value to an optional
-      // property directly — spread each field in only when it is actually present, rather than
-      // widening `MessageAffordances` itself to accept an explicit `undefined`.
-      ...stableOnRegenerate !== void 0 && { onRegenerate: stableOnRegenerate },
-      ...actions !== void 0 && { actions }
+      onRegenerate: stableOnRegenerate,
+      actions
     }),
     [affordancesProp?.timestamp, affordancesProp?.copy, stableOnRegenerate, actions]
   );
@@ -481,7 +483,7 @@ function ThreadTranscript(props) {
         MessageBlock,
         {
           message: liveMessage,
-          streaming: liveStatus === "streaming",
+          streaming: isLiveStatus(liveStatus),
           renderers,
           fallbackRenderer
         }

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

@@ -1,6 +1,6 @@
 import type { JSX } 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';
 export type ThreadOutcomeCardProps = BasaltProps & {
     readonly thread: AgentThread;
     /** Whether this row is the active/open thread — applies a subtle highlight. */

package/dist/agent/chat/thread-outcome-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-outcome-card.d.ts","sourceRoot":"","sources":["../../../src/agent/chat/thread-outcome-card.tsx"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,WAAW,CAAA;AAG1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAiGrD,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG;IACjD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;CAC9B,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,KAAK,GACN,EAAE,sBAAsB,GAAG,GAAG,CAAC,OAAO,CAkCtC"}

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

@@ -1,9 +1,9 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Badge, Group, Skeleton, Stack, Text, UnstyledButton } from "@mantine/core";
 import { useHover } from "@mantine/hooks";
-import { assertRequiredProps } from "../common/validate.js";
-import { cx } from "../common/props.js";
-import { alpha, VX } from "../tokens/index.js";
+import { assertRequiredProps } from "../../common/validate.js";
+import { cx } from "../../common/props.js";
+import { alpha, VX } from "../../tokens/index.js";
 import { formatRelativeTime } from "./relative-time.js";
 const STATUS_BADGE = {
   attention: { label: "Needs review", statusToken: VX.status.warn },

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

@@ -1,12 +1,12 @@
 import type { JSX } from 'react';
-import type { ToolCallPart } from '../agent/index.js';
-import type { BasaltProps } from '../common/props.js';
+import type { ToolCallPart } from '../parts.js';
+import type { BasaltProps } from '../../common/props.js';
 export type ToolChipProps = BasaltProps & {
     readonly part: ToolCallPart;
-    readonly defaultExpanded?: boolean;
+    readonly defaultExpanded?: boolean | undefined;
     /** Rendered only in 'approval-requested'. Omit both to render a read-only chip. */
-    readonly onApprove?: (approvalId: string) => void;
-    readonly onDeny?: (approvalId: string, reason?: string) => void;
+    readonly onApprove?: ((approvalId: string) => void) | undefined;
+    readonly onDeny?: ((approvalId: string, reason?: string) => void) | undefined;
 };
 /**
  * A collapsed-by-default row for a single tool-call part. All seven wire states render something

package/dist/agent/chat/tool-chip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-chip.d.ts","sourceRoot":"","sources":["../../../src/agent/chat/tool-chip.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAEhC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AA6ErD,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG;IACxC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9C,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;CAC9E,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,eAAuB,EACvB,SAAS,EACT,MAAM,EACN,SAAS,EACT,KAAK,GACN,EAAE,aAAa,GAAG,GAAG,CAAC,OAAO,CAkG7B"}

package/dist/{agent-chat → agent/chat}/tool-chip.js

@@ -1,10 +1,10 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Box, Button, Collapse, Group, Stack, Text, UnstyledButton } from "@mantine/core";
 import { useDisclosure } from "@mantine/hooks";
-import { isToolCallSettled } from "../agent/index.js";
-import { cx } from "../common/props.js";
-import { assertRequiredProps } from "../common/validate.js";
-import { alpha, VX } from "../tokens/index.js";
+import { isToolCallSettled } from "../parts.js";
+import { cx } from "../../common/props.js";
+import { assertRequiredProps } from "../../common/validate.js";
+import { alpha, VX } from "../../tokens/index.js";
 const MICRO_LABEL_STYLE = {
   fontFamily: "var(--basalt-font-mono)",
   fontSize: VX.text.micro,

package/dist/agent/chat/use-keyboard-inset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-keyboard-inset.d.ts","sourceRoot":"","sources":["../../../src/agent/chat/use-keyboard-inset.ts"],"names":[],"mappings":"AAiCA,wBAAgB,mBAAmB,IAAI,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAkCtE"}

package/dist/{agent-chat → agent/chat}/use-keyboard-inset.js

@@ -1,5 +1,5 @@
 import { useCallback, useState } from "react";
-import { useIsomorphicLayoutEffect } from "../common/isomorphic-layout-effect.js";
+import { useIsomorphicLayoutEffect } from "../../common/isomorphic-layout-effect.js";
 const KEYBOARD_INSET_VAR = "--vx-keyboard-inset";
 function useKeyboardInsetRef() {
   const [node, setNode] = useState(null);

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

@@ -87,13 +87,13 @@
 /** Tuning knobs passed through to `@tanstack/react-virtual`'s `useVirtualizer`. */
 export type VirtualizeOptions = {
     /** Extra rows rendered beyond the visible viewport, each side. Library default: 1. */
-    readonly overscan?: number;
+    readonly overscan?: number | undefined;
     /** Estimated row height in px, used before a row has been measured. */
-    readonly estimateSize?: number;
+    readonly estimateSize?: number | undefined;
     /** Where the transcript sits on first mount. Default 'end' — a chat transcript opens at the
         newest message. 'start' opens at the oldest. See this module's fourth composition rule
         above for the mechanism and why a consumer restoring its own scroll position wants 'start'. */
-    readonly initialScroll?: 'end' | 'start';
+    readonly initialScroll?: 'end' | 'start' | undefined;
 };
 /**
  * `virtualize: false` (or omitted) → no `height` prop (content-sized, non-scrolling-owner layout).
@@ -101,8 +101,8 @@ export type VirtualizeOptions = {
  * scroll container, so there is no valid virtualized layout without one.
  */
 export type VirtualizeProps = {
-    readonly virtualize?: false;
-    readonly height?: never;
+    readonly virtualize?: false | undefined;
+    readonly height?: undefined;
 } | {
     readonly virtualize: true | VirtualizeOptions;
     readonly height: number | string;
@@ -126,8 +126,8 @@ export type ResolvedVirtualize = {
  * transcript body with inner scroll, no `@tanstack/react-virtual` peer installed).
  */
 export type RowHeightProps = {
-    readonly virtualize?: false;
-    readonly height?: number | string;
+    readonly virtualize?: false | undefined;
+    readonly height?: number | string | undefined;
 } | {
     readonly virtualize: true | VirtualizeOptions;
     readonly height: number | string;

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

@@ -0,0 +1 @@
+{"version":3,"file":"virtualize.d.ts","sourceRoot":"","sources":["../../../src/agent/chat/virtualize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqFG;AAEH,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C;;sGAEkG;IAClG,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,CAAA;CACrD,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAAE,GACxE;IAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,GAAG,iBAAiB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAA;AAEvF,uFAAuF;AACvF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CACjC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,GAC1F;IAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,GAAG,iBAAiB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAA;AAEvF,gGAAgG;AAChG,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;CAAE,GACzE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAA;AAEtC;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CAezE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,kBAAkB,GAAG,IAAI,CAUnF"}

package/dist/agent/error.d.ts

@@ -0,0 +1,31 @@
+/**
+ * AgentError — the closed, serializable shape of a failed turn (V2-SPEC § 6).
+ *
+ * `useAgentThreadRuns({ onError })` keeps the raw thrown value; `ThreadRunState.error` and the
+ * `chat.turn` telemetry carry this union instead, so a consumer switches on `kind` rather than
+ * parsing an error body. Classification is duck-typed on purpose: this module must never resolve
+ * the optional `ai` peer at runtime.
+ */
+/**
+ * - `http`: the chat endpoint answered with a non-2xx `status` (AI SDK's `APICallError`).
+ * - `stream`: the UI-message stream was malformed (AI SDK's `UIMessageStreamError`).
+ * - `server`: an `error` chunk arrived mid-stream, or any other failure; `message` is the server's
+ *   `errorText` or the thrown error's message.
+ * - `aborted`: the request was aborted by something other than `stop()`.
+ */
+export type AgentError = {
+    readonly kind: 'http';
+    readonly status: number;
+} | {
+    readonly kind: 'stream';
+    readonly chunkType: string;
+    readonly chunkId: string;
+} | {
+    readonly kind: 'server';
+    readonly message: string;
+} | {
+    readonly kind: 'aborted';
+};
+/** Maps whatever a transport threw onto the closed `AgentError` union. */
+export declare function toAgentError(error: unknown): AgentError;
+//# sourceMappingURL=error.d.ts.map

package/dist/agent/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/agent/error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjF;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAQhC,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAavD"}

package/dist/agent/error.js

@@ -0,0 +1,18 @@
+function stringField(value, key) {
+  if (typeof value !== "object" || value === null) return void 0;
+  const field = value[key];
+  return typeof field === "string" ? field : void 0;
+}
+function toAgentError(error) {
+  if (stringField(error, "name") === "AbortError") return { kind: "aborted" };
+  const status = typeof error === "object" && error !== null ? error["statusCode"] : void 0;
+  if (typeof status === "number") return { kind: "http", status };
+  const chunkType = stringField(error, "chunkType");
+  const chunkId = stringField(error, "chunkId");
+  if (chunkType !== void 0 && chunkId !== void 0)
+    return { kind: "stream", chunkType, chunkId };
+  return { kind: "server", message: stringField(error, "message") ?? String(error) };
+}
+export {
+  toAgentError
+};

package/dist/agent/history.d.ts

@@ -1,3 +1,4 @@
+/** ChatMessage — the typed message shape every thread carries. */
 import type { AgentPart } from './parts.js';
 /**
  * A single chat message. The `id` is a stable identifier for React keys and de-duplication.
@@ -17,41 +18,6 @@ export type ChatMessage<TPart = AgentPart> = {
     readonly parts: TPart[];
     readonly createdAt: number;
     /** How the turn ended. Absent on user messages and on pre-1.11 persisted assistant messages. */
-    readonly finish?: 'complete' | 'stopped' | 'error';
+    readonly finish?: 'complete' | 'stopped' | 'error' | undefined;
 };
-export type ChatHistoryStoreOptions = {
-    /** localStorage key (namespaced as `basalt:<key>`). Stable — changes key lose history. */
-    readonly key: string;
-    /** Envelope version. Increment when the ChatMessage shape changes to clear old data. */
-    readonly version: number;
-    /**
-     * Maximum number of messages to retain. Oldest messages are dropped when exceeded.
-     * @default 100
-     */
-    readonly max?: number;
-};
-export type ChatHistoryStore<TPart = AgentPart> = {
-    /** All retained messages, oldest first. */
-    readonly messages: ChatMessage<TPart>[];
-    /** Append a message. Trims to `max` if needed (ring-buffer: drops oldest). */
-    readonly append: (message: ChatMessage<TPart>) => void;
-    /** Clear all messages. */
-    readonly clear: () => void;
-};
-/**
- * Creates a stable persisted chat history hook for the given key + version.
- *
- * Call this ONCE per module (not inside a component). The returned hook can be called in any
- * component that needs access to the same history. All instances sharing the same key stay
- * in sync across tabs via the 'storage' event.
- *
- * @example
- * // src/chat/history.ts — ONE stable creation per key:
- * export const useChatHistory = createChatHistoryStore({ key: 'main-chat', version: 1 })
- *
- * // In a component:
- * const { messages, append, clear } = useChatHistory()
- * append({ id: crypto.randomUUID(), role: 'user', parts: [...], createdAt: Date.now() })
- */
-export declare function createChatHistoryStore<TPart = AgentPart>(opts: ChatHistoryStoreOptions): () => ChatHistoryStore<TPart>;
 //# sourceMappingURL=history.d.ts.map

package/dist/agent/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/agent/history.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxC;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,CAAC,KAAK,GAAG,SAAS,IAAI;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAA;CACnD,CAAA;AAID,MAAM,MAAM,uBAAuB,GAAG;IACpC,0FAA0F;IAC1F,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAID,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,SAAS,IAAI;IAChD,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAA;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;IACtD,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAC3B,CAAA;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,GAAG,SAAS,EACtD,IAAI,EAAE,uBAAuB,GAC5B,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAoC/B"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/agent/history.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxC;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,CAAC,KAAK,GAAG,SAAS,IAAI;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;CAC/D,CAAA"}

package/dist/agent/history.js

@@ -1,32 +0,0 @@
-import { useCallback, useRef } from "react";
-import { createPersistedState } from "../state.js";
-function createChatHistoryStore(opts) {
-  const max = opts.max ?? 100;
-  const usePersistedMessages = createPersistedState({
-    key: opts.key,
-    version: opts.version,
-    initial: []
-  });
-  return function useChatHistoryStore() {
-    const [messages, setMessages] = usePersistedMessages();
-    const ref = useRef(messages);
-    ref.current = messages;
-    const append = useCallback(
-      (message) => {
-        const next = [...ref.current, message];
-        const trimmed = next.length > max ? next.slice(next.length - max) : next;
-        ref.current = trimmed;
-        setMessages(trimmed);
-      },
-      [setMessages]
-    );
-    const clear = useCallback(() => {
-      ref.current = [];
-      setMessages([]);
-    }, [setMessages]);
-    return { messages, append, clear };
-  };
-}
-export {
-  createChatHistoryStore
-};

package/dist/agent/id.d.ts

@@ -1,9 +1,8 @@
 /**
  * Id-minting helpers shared across the agent layer: `mintThreadId` (a low-stakes client-side id —
- * threads, run/chat namespaces — used by `./thread`'s `createThreadsStore`, `./adapter`'s
- * `createAdapterThreadsStore`/`threadsStoreAdapterContract`, `./use-agent-stream`'s per-send run
- * id, and `aiSdkTransport`'s fixed chat id), `mintMessageId` (the higher-stakes id `appendMessage`
- * treats as its only idempotency key), and `withPartIds` (stamps sequence ids onto streamed
+ * threads, run/chat namespaces — used by `useAgentThreadRuns`'s per-send run id and
+ * `aiSdkTransport`'s fixed chat id; the thread store itself is consumer-owned), `mintMessageId`
+ * (the higher-stakes id `appendMessage` treats as its only idempotency key), and `withPartIds` (stamps sequence ids onto streamed
  * parts). Grouped here because they're the id-minting leaves every store/hook/transport in this
  * layer sits above — not because they share a mechanism (`mintMessageId` deliberately diverges
  * from `mintThreadId` on rung 3; see its own doc).
@@ -106,7 +105,7 @@ export declare function mintMessageId(): string;
  * }
  */
 export declare function withPartIds<TPart extends {
-    id?: string;
+    id?: string | undefined;
 }>(runId: string, source: AsyncGenerator<TPart>): AsyncGenerator<TPart & {
     id: string;
 }>;

package/dist/agent/id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/agent/id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAQrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAYtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAuB,WAAW,CAAC,KAAK,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9D,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,GAC5B,cAAc,CAAC,KAAK,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAUxC"}
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/agent/id.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAQrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAYtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAuB,WAAW,CAAC,KAAK,SAAS;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAC1E,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,GAC5B,cAAc,CAAC,KAAK,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAUxC"}

package/dist/agent/index.d.ts

@@ -1,60 +1,27 @@
 /**
- * basalt-ui/agent — headless, Mantine-free streaming-chat layer over an injected transport seam.
- *
- * `aiSdkTransport` (backed by the `ai` npm package) is the RECOMMENDED DEFAULT transport for LLM
- * chat use cases; `edenTransport` remains the zero-extra-dependency alternative. Optional peers
- * (ai, use-stick-to-bottom) are all lazily loaded — importing this module does NOT eagerly resolve
- * either of them. This module ships no markdown renderer — `agent/** -> content` is lint-blocked
- * by design, so `PartList` takes a consumer-supplied `components.text`; basalt's own is
- * `basalt-ui/content`'s `Markdown`.
- *
- * Install optional peers:
- *   bun add ai                                   # aiSdkTransport
- *   bun add use-stick-to-bottom                  # BasaltStickToBottom
+ * basalt-ui/agent — the AI chat surface: a Mantine-free streaming runtime (`src/agent/**` outside
+ * `chat/`) plus the chat UI (`src/agent/chat/**`). `aiSdkTransport` (the `ai` npm package) is the
+ * one transport; `useAgentThreadRuns` is the one runner. Optional peers (`ai`,
+ * `use-stick-to-bottom`) load lazily — importing this module does not resolve either.
  *
  * @example
- * import { useAgentStream, edenTransport, PartList, BasaltStickToBottom } from 'basalt-ui/agent'
- *
- * const transport = edenTransport((input, signal) =>
- *   api.chat.post({ body: { message: input }, fetch: { signal } }),
- * )
- *
- * function Chat() {
- *   const { parts, status, send, stop } = useAgentStream({ transport })
- *   return (
- *     <BasaltStickToBottom style={{ height: '400px', overflow: 'auto' }}>
- *       <PartList parts={parts} />
- *       <button onClick={() => send('Hello')}>Send</button>
- *       {status === 'streaming' && <button onClick={stop}>Stop</button>}
- *     </BasaltStickToBottom>
- *   )
- * }
+ * import { aiSdkTransport, useAgentThreadRuns, ThreadFeed, Composer } from 'basalt-ui/agent'
  */
-export type { AgentPart, AgentPartDraft, Drafted, StartPart, TextPart, ReasoningPart, ToolCallPart, ToolCallState, SourcePart, ErrorPart, } from './parts.js';
-export { parseAgentPart, isStartPart, isToolCallSettled, TERMINAL_TOOL_STATES } from './parts.js';
-export { mergePart } from './merge.js';
-export { withPartIds } from './id.js';
-export { coalesceParts } from './coalesce.js';
-export { definePartRenderers, narrowAgentPart } from './foreign.js';
-export type { ForeignPart, TranscriptPart, ConsumerPart, PartRenderers, PartRenderContext, PartRenderer, } from './foreign.js';
-export type { AgentTransport, ResumableAgentTransport } from './transport.js';
-export { edenTransport, isResumable } from './transport.js';
+export type { AgentPart, ToolCallPart } from './parts.js';
+export { parseAgentPart } from './parts.js';
+export type { ForeignPart, TranscriptPart, PartRenderers, PartRenderer } from './foreign.js';
 export { aiSdkTransport } from './ai-sdk-transport.js';
-export type { AiSdkTransport, AiSdkTransportOptions } from './ai-sdk-transport.js';
-export { useAgentStream } from './use-agent-stream.js';
-export type { StreamStatus, UseAgentStreamReturn } from './use-agent-stream.js';
 export { useAgentThreadRuns } from './use-agent-thread-runs.js';
-export type { ThreadRunState, UseAgentThreadRunsArgs, UseAgentThreadRunsReturn, } from './use-agent-thread-runs.js';
-export { PartList } from './part-list.js';
-export type { PartListProps, AgentPartRenderers, TextPartRenderer, ReasoningPartRenderer, ToolCallPartRenderer, SourcePartRenderer, ErrorPartRenderer, } from './part-list.js';
-export { BasaltStickToBottom } from './stick-to-bottom.js';
-export type { BasaltStickToBottomProps } from './stick-to-bottom.js';
-export { createChatHistoryStore } from './history.js';
-export type { ChatMessage, ChatHistoryStore, ChatHistoryStoreOptions } from './history.js';
-export { createThreadsStore } from './thread.js';
-export type { AgentThread, ThreadStatus, ThreadsStore, ThreadsStoreOptions } from './thread.js';
-export { heuristicOutcome } from './outcome.js';
+export type { ThreadRunState } from './use-agent-thread-runs.js';
+export type { AgentError } from './error.js';
+export type { ChatMessage } from './history.js';
+export type { AgentThread, ThreadStatus, ThreadsStore } from './thread.js';
 export type { AgentOutcome, OutcomeResolver } from './outcome.js';
-export { createAdapterThreadsStore, threadsStoreAdapterContract } from './adapter.js';
-export type { AdapterThreadsStoreOptions, ThreadsStoreAdapter, ThreadsStoreAdapterContractCase, } from './adapter.js';
+export type { AgentTransport, ResumableAgentTransport } from './transport.js';
+export { ThreadFeed } from './chat/thread-feed.js';
+export { ThreadFeedRow } from './chat/thread-feed-row.js';
+export type { MessageAffordances } from './chat/message-affordances.js';
+export { Composer } from './chat/composer.js';
+export type { ComposerHandle, ComposerSubmit } from './chat/composer.js';
+export { ToolChip } from './chat/tool-chip.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,YAAY,EACV,SAAS,EACT,cAAc,EACd,OAAO,EACP,SAAS,EACT,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,SAAS,GACV,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAG9F,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAGnC,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAGlC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG1C,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChE,YAAY,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,WAAW,CAAA;AAGlB,YAAY,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAG5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAGjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAClD,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AAGvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAG5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAG9D,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAA;AAClF,YAAY,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAGzF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAGzC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC9D,YAAY,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAG1E,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/agent/index.js

@@ -1,38 +1,16 @@
-import { parseAgentPart, isStartPart, isToolCallSettled, TERMINAL_TOOL_STATES } from "./parts.js";
-import { mergePart } from "./merge.js";
-import { withPartIds } from "./id.js";
-import { coalesceParts } from "./coalesce.js";
-import { definePartRenderers, narrowAgentPart } from "./foreign.js";
-import { edenTransport, isResumable } from "./transport.js";
+import { parseAgentPart } from "./parts.js";
 import { aiSdkTransport } from "./ai-sdk-transport.js";
-import { useAgentStream } from "./use-agent-stream.js";
 import { useAgentThreadRuns } from "./use-agent-thread-runs.js";
-import { PartList } from "./part-list.js";
-import { BasaltStickToBottom } from "./stick-to-bottom.js";
-import { createChatHistoryStore } from "./history.js";
-import { createThreadsStore } from "./thread.js";
-import { heuristicOutcome } from "./outcome.js";
-import { createAdapterThreadsStore, threadsStoreAdapterContract } from "./adapter.js";
+import { ThreadFeed } from "./chat/thread-feed.js";
+import { ThreadFeedRow } from "./chat/thread-feed-row.js";
+import { Composer } from "./chat/composer.js";
+import { ToolChip } from "./chat/tool-chip.js";
 export {
-  BasaltStickToBottom,
-  PartList,
-  TERMINAL_TOOL_STATES,
+  Composer,
+  ThreadFeed,
+  ThreadFeedRow,
+  ToolChip,
   aiSdkTransport,
-  coalesceParts,
-  createAdapterThreadsStore,
-  createChatHistoryStore,
-  createThreadsStore,
-  definePartRenderers,
-  edenTransport,
-  heuristicOutcome,
-  isResumable,
-  isStartPart,
-  isToolCallSettled,
-  mergePart,
-  narrowAgentPart,
   parseAgentPart,
-  threadsStoreAdapterContract,
-  useAgentStream,
-  useAgentThreadRuns,
-  withPartIds
+  useAgentThreadRuns
 };

package/dist/agent/outcome.d.ts

@@ -5,7 +5,7 @@
  * multi-thread feed — only a short, past-tense summary of what happened. AgentOutcome is
  * that DIFFERENT, smaller shape: a title, a one-line summary, and a status. Producing one
  * is the job of an OutcomeResolver (typically an LLM-backed summarizer wired by the
- * consumer); heuristicOutcome below is a text-only fallback for demos and early wiring.
+ * consumer).
  *
  * @example
  * import type { AgentOutcome } from 'basalt-ui/agent'
@@ -29,12 +29,12 @@ import type { AgentThread } from './thread.js';
  * turn has settled, so those never apply here.
  *
  * Note there are THREE overlapping status-shaped unions in this module family, one per layer:
- * `StreamStatus` (single-turn stream lifecycle, `./use-agent-stream`), `ThreadStatus` (persisted
+ * the internal `StreamStatus` (single-turn stream lifecycle, `./thread`), `ThreadStatus` (persisted
  * thread lifecycle, `./thread`), and this `AgentOutcome['status']` (feed-facing terminal
  * projection). They are related but not identical — `StreamStatus`'s `'idle'` (no turn in
  * flight) corresponds to `ThreadStatus`'s `'pending'` (thread created, no turn started yet); the
  * literal rename from `'idle'` to `'pending'` is intentionally deferred since it would ripple
- * into `use-agent-stream.ts` and its call sites.
+ * into `useAgentThreadRuns` and its call sites.
  *
  * @example
  * const outcome: AgentOutcome = { title: 'New chat', summary: '', status: 'done' }
@@ -57,15 +57,4 @@ export type AgentOutcome = {
  * }
  */
 export type OutcomeResolver<TPart = AgentPart> = (thread: AgentThread<TPart>) => AgentOutcome | Promise<AgentOutcome>;
-/**
- * DEMO-ONLY provisional heuristic — never the production path. Coalesces the last assistant
- * message's text parts into one string and derives a title/summary/status from it with no
- * model call. Real apps should wire an OutcomeResolver backed by an LLM summarizer; this
- * exists purely so a feed has something to render before that wiring lands.
- *
- * @example
- * const outcome = heuristicOutcome(thread)
- * // { title: 'Fixed the flaky test', summary: 'Fixed the flaky test by awaiting…', status: 'done' }
- */
-export declare function heuristicOutcome(thread: AgentThread): AgentOutcome;
 //# sourceMappingURL=outcome.d.ts.map

package/dist/agent/outcome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../src/agent/outcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAI3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAA;CAChD,CAAA;AAID;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,CAAC,KAAK,GAAG,SAAS,IAAI,CAC/C,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,KACvB,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;AAmBzC;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAwBlE"}
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../src/agent/outcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAI3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAA;CAChD,CAAA;AAID;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,CAAC,KAAK,GAAG,SAAS,IAAI,CAC/C,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,KACvB,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA"}

package/dist/agent/outcome.js

@@ -1,30 +0,0 @@
-const TITLE_MAX = 48;
-const SUMMARY_MAX = 88;
-function truncate(text, max) {
-  if (text.length <= max) return text;
-  return `${text.slice(0, max - 1).trimEnd()}\u2026`;
-}
-function firstClause(text) {
-  const match = text.match(/^[^.!?]+[.!?]?/);
-  return (match?.[0] ?? text).trim();
-}
-function heuristicOutcome(thread) {
-  const lastAssistant = thread.messages.toReversed().find((message) => message.role === "assistant");
-  if (lastAssistant === void 0) {
-    return { title: "New chat", summary: "", status: "done" };
-  }
-  const text = lastAssistant.parts.filter((part) => part.type === "text").map((part) => part.text).join("").trim();
-  if (text.length === 0) {
-    return { title: "New chat", summary: "", status: "done" };
-  }
-  const lastPart = lastAssistant.parts[lastAssistant.parts.length - 1];
-  const status = lastPart?.type === "error" ? "error" : "done";
-  return {
-    title: truncate(firstClause(text), TITLE_MAX),
-    summary: truncate(text, SUMMARY_MAX),
-    status
-  };
-}
-export {
-  heuristicOutcome
-};

package/dist/agent/part-list.d.ts

@@ -46,21 +46,21 @@ export type AgentPartRenderers<TPart extends AgentPart = AgentPart> = {
     readonly error: ErrorPartRenderer<TPart>;
 };
 export type PartListProps<TPart extends AgentPart = AgentPart> = {
-    /** The parts accumulator from useAgentStream. */
+    /** The parts accumulator from useAgentThreadRuns. */
     readonly parts: TPart[];
     /**
      * Override individual part renderers. Omitted keys fall back to the headless defaults.
      * Pass `{ text: ({ part, settled }) => <Markdown streaming={!settled} contentTrust="untrusted" density="chat">{part.text}</Markdown> }`
      * to enable rich markdown rendering.
      */
-    readonly components?: Partial<AgentPartRenderers<TPart>>;
+    readonly components?: Partial<AgentPartRenderers<TPart>> | undefined;
     /**
      * `false` while the message these parts belong to is still streaming — forwarded to every
      * renderer so a text renderer can drop out of streaming mode (and a fenced mermaid/diagram can
      * upgrade) once the turn finishes. Defaults to `true`: a caller that knows nothing about a run
      * is rendering a finished list, and un-settled must be opted into by the thing that does know.
      */
-    readonly settled?: boolean;
+    readonly settled?: boolean | undefined;
 };
 /**
  * Renders a list of AgentPart values via an exhaustive switch over part.type.

package/dist/agent/part-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"part-list.d.ts","sourceRoot":"","sources":["../../src/agent/part-list.tsx"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAIhC,OAAO,KAAK,EACV,SAAS,EAMV,MAAM,SAAS,CAAA;AAIhB;;;;;;;GAOG;AACH,KAAK,cAAc,CAAC,KAAK,IAAI;IAC3B,IAAI,EAAE,KAAK,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAClE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,KACpD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACvE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC,KACzD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,oBAAoB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACtE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,KACpD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACpE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC,KACtD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACnE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,KACrD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IACpE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAA;CACzC,CAAA;AAqJD,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IAC/D,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAA;IACxD;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,EAAE,EAC5D,KAAK,EACL,UAAU,EACV,OAAc,GACf,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,CAqFpC"}
+{"version":3,"file":"part-list.d.ts","sourceRoot":"","sources":["../../src/agent/part-list.tsx"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAIhC,OAAO,KAAK,EACV,SAAS,EAMV,MAAM,SAAS,CAAA;AAIhB;;;;;;;GAOG;AACH,KAAK,cAAc,CAAC,KAAK,IAAI;IAC3B,IAAI,EAAE,KAAK,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAClE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,KACpD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACvE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC,KACzD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,oBAAoB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACtE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,KACpD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACpE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC,KACtD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACnE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,KACrD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IACpE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAA;CACzC,CAAA;AAqJD,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IAC/D,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAA;IACpE;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACvC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,EAAE,EAC5D,KAAK,EACL,UAAU,EACV,OAAc,GACf,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,CAqFpC"}