@dbx-tools/ui-mastra 0.9.119 → 0.9.121

package/README.md

@@ -288,6 +288,7 @@ export function ReviewChat(props: ChatViewProps) {
 sidebar, transcript, tool progress, approval cards, suggestions, export controls,
 feedback controls, and composer from props. Use it when your app already has a
 transport or needs to combine Mastra messages with another state model.
+
 `MastraChat` shows a spinner in the model control while its live default model
 is being resolved. The picker groups endpoints into
 model-family submenus. Its compact first popup shows only the current

package/index.ts

@@ -3,7 +3,7 @@
 // Hand edits are overwritten on the next watch; this file is read-only.
 
 export const PACKAGE_IDENTIFIER = "@dbx-tools/ui-mastra";
-export const PACKAGE_VERSION = "0.9.119";
+export const PACKAGE_VERSION = "0.9.121";
 export * as reactBubbles from "./src/react/bubbles.tsx";
 export * as reactChatApprovals from "./src/react/chat-approvals.ts";
 export * as reactChatComposer from "./src/react/chat-composer.tsx";
@@ -71,7 +71,7 @@ export type { StoredActiveRun } from "./src/support/active-runs.ts";
 export { LIGHT_CHART_CHROME } from "./src/support/chart-theme.ts";
 export type { ChartChrome } from "./src/support/chart-theme.ts";
 export type { ExportFormat, ExportBrand, EmbedResolver, ExportChatOptions } from "./src/support/export.ts";
-export { MastraPluginClient, useMastraConfig, useMastraClient, useMastraMlflowExperiment, useMastraModels, useMastraDefaultModel, useMastraSuggestions, useMastraThreads, useChartFetch, useStatementFetch } from "./src/support/mastra-client.ts";
+export { MastraChatRequestError, MastraPluginClient, useMastraConfig, useMastraClient, useMastraMlflowExperiment, useMastraModels, useMastraDefaultModel, useMastraSuggestions, useMastraThreads, useChartFetch, useStatementFetch } from "./src/support/mastra-client.ts";
 export type { MastraStreamResponse, MastraMemoryThread, ByIdFetchState } from "./src/support/mastra-client.ts";
 export { defaultReasoningEffort, modelStorageKey, readStoredModel, storeSelectedModel } from "./src/support/model-selection.ts";
 export type { MastraRequestContextInput, MastraRequestContextSource, MastraRequestContextSnapshot } from "./src/support/request-context.ts";

package/package.json

@@ -29,11 +29,11 @@
     "react-dom": "~19.2.4"
   },
   "dependencies": {
-    "@dbx-tools/shared-core": "^0.9.119",
-    "@dbx-tools/shared-genie": "^0.9.119",
-    "@dbx-tools/shared-mastra": "^0.9.119",
-    "@dbx-tools/shared-model": "^0.9.119",
-    "@dbx-tools/ui": "^0.9.119",
+    "@dbx-tools/shared-core": "^0.9.121",
+    "@dbx-tools/shared-genie": "^0.9.121",
+    "@dbx-tools/shared-mastra": "^0.9.121",
+    "@dbx-tools/shared-model": "^0.9.121",
+    "@dbx-tools/ui": "^0.9.121",
     "@mastra/client-js": "1.50.0",
     "@mastra/core": "1.71.0",
     "@tanstack/react-table": "^8.21.3",
@@ -50,7 +50,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.9.119",
+  "version": "0.9.121",
   "dbxToolsConfig": {
     "tags": [
       "ui"

package/src/react/bubbles.tsx

@@ -340,6 +340,7 @@ type AssistantBubbleProps = {
   mlflowExperimentUrl?: string;
 };
 
+/** Render one assistant message with tool progress, actions, and optional feedback. */
 export const AssistantBubble = ({
   message,
   isLast,
@@ -523,6 +524,7 @@ export const AssistantBubble = ({
   );
 };
 
+/** Render one user message, including text and image attachments. */
 export const UserBubble = ({ message }: { message: UIMessage }) => {
   const text = message.parts
     .filter((p): p is { type: "text"; text: string } => p.type === "text")

package/src/react/chat-composer.tsx

@@ -423,7 +423,7 @@ export const ChatComposer = ({
             }}
             placeholder="Send a message..."
             rows={1}
-            className="field-sizing-fixed min-h-10 max-h-64 w-full flex-none overflow-y-auto px-4 pb-2 pt-4 text-base md:text-xs"
+            className="field-sizing-fixed min-h-10 max-h-64 w-full flex-none overflow-y-auto px-4 pb-2 pt-4 text-sm"
           />
           {fileError && (
             <div className="px-4 text-xs text-destructive" role="alert">

package/src/react/chat-feedback.ts

@@ -51,7 +51,7 @@ export function useChatFeedback({
       } catch (error) {
         logger.error("feedback error", {
           traceId,
-          error: errorUtils.errorMessage(error),
+          error: errorUtils.toError(error),
         });
       }
     },

package/src/react/chat-history.ts

@@ -116,7 +116,7 @@ export function useChatHistory({
           .catch((error: unknown) => {
             if ((error as { name?: string }).name === "AbortError") throw error;
             logger.warn("suspended-run discovery error", {
-              error: errorUtils.errorMessage(error),
+              error: errorUtils.toError(error),
             });
             return { runs: [], total: 0 };
           });
@@ -140,7 +140,7 @@ export function useChatHistory({
       .catch((error: unknown) => {
         if (cancelled || (error as { name?: string }).name === "AbortError") return;
         logger.error("history load error", {
-          error: errorUtils.errorMessage(error),
+          error: errorUtils.toError(error),
         });
         updateSession(threadId, (current) => ({
           ...current,
@@ -181,7 +181,7 @@ export function useChatHistory({
       .catch((error: unknown) => {
         logger.error("history load-more error", {
           page,
-          error: errorUtils.errorMessage(error),
+          error: errorUtils.toError(error),
         });
         updateSession(threadId, (current) => ({
           ...current,

package/src/react/chat-sessions.ts

@@ -8,13 +8,16 @@ import {
   type ThreadSession,
 } from "../support/thread-sessions.ts";
 
+/** Read or lazily create the mutable session state for one thread. */
 export type ThreadSessionReader = (threadId: string) => ThreadSession;
 
+/** Replace one thread session through a state-producing callback. */
 export type ThreadSessionUpdater = (
   threadId: string,
   updater: (session: ThreadSession) => ThreadSession,
 ) => void;
 
+/** Replace the transcript stored for one thread. */
 export type ThreadMessageWriter = (threadId: string, messages: UIMessage[]) => void;
 
 /** Own the mutable per-thread session registry behind the public chat hook. */

package/src/react/chat-stream.ts

@@ -127,7 +127,7 @@ export function useChatStream({ getSession, updateSession, writeMessages }: UseC
         if (error instanceof StreamAborted || signal.aborted) return;
         if (isStaleMastraResumeError(error)) {
           logger.warn("ignored stale mastra resume", {
-            error: errorUtils.errorMessage(error),
+            error: errorUtils.toError(error),
           });
           return;
         }

package/src/react/chat-thread-layout.tsx

@@ -113,7 +113,7 @@ export const ChatThreadLayout = ({
   const rootRef = useRef<HTMLDivElement>(null);
   const isNarrow = useIsNarrow(rootRef);
   const showThreads = Boolean(threads && onSelectThread) && threadPlacement !== "disabled";
-  const placement = threadPlacement === "auto" ? (isNarrow ? "top" : "right") : threadPlacement;
+  const placement = threadPlacement === "auto" ? (isNarrow ? "top" : "left") : threadPlacement;
   const tabbedThreads = showThreads && placement === "top";
   const dockedSide = placement === "right" ? "right" : "left";
   const dockedThreads = showThreads && (placement === "left" || placement === "right");

package/src/react/data-grid.tsx

@@ -50,6 +50,7 @@ export type DataRow = Record<string, unknown>;
  */
 const DELTA_PATTERN = /^([+\u2212-])\s*\d[\d,.\s]*(?:%|\s*pts?)?$/i;
 
+/** Apply success or destructive text color to a signed numeric delta string. */
 export function colorizeDelta(content: React.ReactNode): React.ReactNode {
   if (typeof content !== "string") return content;
   const text = content.trim();

package/src/react/feedback-controls.tsx

@@ -23,6 +23,7 @@ import type { FeedbackSubmission, FeedbackValue } from "./types.ts";
 // wires feedback (which only happens when MLflow logging is enabled and
 // the turn has a captured trace id).
 
+/** Render per-message rating and comment controls for an MLflow-backed trace. */
 export const FeedbackControls = ({
   value,
   onSubmit,

package/src/react/mastra-chat.tsx

@@ -27,6 +27,7 @@ import {
   useMastraModels,
   useMastraSuggestions,
   useMastraThreads,
+  MastraChatRequestError,
   type MastraMemoryThread,
   type MastraStreamResponse,
 } from "../support/mastra-client.ts";
@@ -479,6 +480,7 @@ export const useMastraChat = <TValues extends Record<string, unknown> = Record<s
           if (
             controller.signal.aborted ||
             getSession(threadId).runToken !== token ||
+            initialError instanceof MastraChatRequestError ||
             !mastraClient.backgroundTurns ||
             !runId
           ) {
@@ -486,7 +488,7 @@ export const useMastraChat = <TValues extends Record<string, unknown> = Record<s
           }
           logger.warn("chat stream disconnected; reconnecting to background run", {
             runId,
-            error: errorUtils.errorMessage(initialError),
+            error: errorUtils.toError(initialError),
           });
           const messagesBeforeReplay = getSession(threadId).messages;
           writeMessages(
@@ -528,7 +530,7 @@ export const useMastraChat = <TValues extends Record<string, unknown> = Record<s
         if (getSession(threadId).runToken !== token) return;
         if (isStaleMastraResumeError(caught)) {
           logger.warn("ignored stale mastra resume", {
-            error: errorUtils.errorMessage(caught),
+            error: errorUtils.toError(caught),
           });
           updateSession(threadId, (session) => {
             if (session.runToken !== token) return session;
@@ -548,7 +550,7 @@ export const useMastraChat = <TValues extends Record<string, unknown> = Record<s
           return;
         }
         logger.error("stream error", {
-          error: errorUtils.errorMessage(caught),
+          error: errorUtils.toError(caught),
         });
         updateSession(threadId, (session) => ({
           ...session,
@@ -557,6 +559,8 @@ export const useMastraChat = <TValues extends Record<string, unknown> = Record<s
           abortController: session.abortController === controller ? null : session.abortController,
           runId: runIdRef.current,
         }));
+        const failedRunId = runIdRef.current;
+        if (failedRunId) removeStoredActiveRun(activeRunsKey, failedRunId);
       }
     },
     [
@@ -699,7 +703,7 @@ export const useMastraChat = <TValues extends Record<string, unknown> = Record<s
           .catch((error: unknown) => {
             logger.warn("failed to abort background run", {
               runId: current.runId,
-              error: errorUtils.errorMessage(error),
+              error: errorUtils.toError(error),
             });
           });
       }
@@ -841,7 +845,7 @@ export const useMastraChat = <TValues extends Record<string, unknown> = Record<s
       logger.info("history cleared", { threadId });
     } catch (error) {
       logger.error("history clear error", {
-        error: errorUtils.errorMessage(error),
+        error: errorUtils.toError(error),
       });
     }
     resetSession(threadId, true);
@@ -882,7 +886,7 @@ export const useMastraChat = <TValues extends Record<string, unknown> = Record<s
       } catch (error) {
         logger.error("thread delete error", {
           threadId,
-          error: errorUtils.errorMessage(error),
+          error: errorUtils.toError(error),
         });
       }
       removeSession(threadId);
@@ -927,7 +931,7 @@ export const useMastraChat = <TValues extends Record<string, unknown> = Record<s
       } catch (error) {
         logger.error("thread rename error", {
           threadId,
-          error: errorUtils.errorMessage(error),
+          error: errorUtils.toError(error),
         });
         setRenamedThreads((prev) => {
           if (!(threadId in prev)) return prev;
@@ -970,7 +974,7 @@ export const useMastraChat = <TValues extends Record<string, unknown> = Record<s
       .catch((error: unknown) => {
         logger.error("regenerate cleanup error", {
           threadId,
-          error: errorUtils.errorMessage(error),
+          error: errorUtils.toError(error),
         });
         updateSession(threadId, (session) => ({
           ...session,
@@ -1040,7 +1044,7 @@ export const useMastraChat = <TValues extends Record<string, unknown> = Record<s
       } catch (error) {
         logger.error("conversation export error", {
           format,
-          error: errorUtils.errorMessage(error),
+          error: errorUtils.toError(error),
         });
       }
     },
@@ -1062,7 +1066,7 @@ export const useMastraChat = <TValues extends Record<string, unknown> = Record<s
       } catch (error) {
         logger.error("message export error", {
           format,
-          error: errorUtils.errorMessage(error),
+          error: errorUtils.toError(error),
         });
       }
     },

package/src/react/suggestion-pills.tsx

@@ -5,6 +5,7 @@ import { Button, cn } from "@dbx-tools/ui/react";
 // the per-message follow-up suggestions use this so the two look and
 // behave identically.
 
+/** Props for the shared starter and follow-up question pill row. */
 export interface SuggestionPillsProps {
   /** Questions to render as clickable pills. Empty renders nothing. */
   questions: string[];

package/src/react/tool-pill.tsx

@@ -424,6 +424,7 @@ const RawToolPayload = ({
   );
 };
 
+/** Compact source-code preview extracted from a tool request payload. */
 export type ToolInputPresentation = {
   label: "Code" | "Command" | "Output";
   language: "typescript" | "javascript" | "python" | "sql" | "json" | "bash" | "text";
@@ -511,6 +512,7 @@ const ToolInputSource = ({ presentation }: { presentation: ToolInputPresentation
 
 type ToolStatusProgress = Extract<ToolProgress, { type: "tool_status" }>;
 
+/** One native web-search request and the result progress events associated with it. */
 export type WebSearchProgressGroup = {
   key: string;
   search?: ToolStatusProgress;

package/src/support/index.ts

@@ -20,7 +20,7 @@ export type { StoredActiveRun } from "./active-runs.ts";
 export { LIGHT_CHART_CHROME } from "./chart-theme.ts";
 export type { ChartChrome } from "./chart-theme.ts";
 export type { ExportFormat, ExportBrand, EmbedResolver, ExportChatOptions } from "./export.ts";
-export { MastraPluginClient, useMastraConfig, useMastraClient, useMastraMlflowExperiment, useMastraModels, useMastraDefaultModel, useMastraSuggestions, useMastraThreads, useChartFetch, useStatementFetch } from "./mastra-client.ts";
+export { MastraChatRequestError, MastraPluginClient, useMastraConfig, useMastraClient, useMastraMlflowExperiment, useMastraModels, useMastraDefaultModel, useMastraSuggestions, useMastraThreads, useChartFetch, useStatementFetch } from "./mastra-client.ts";
 export type { MastraStreamResponse, MastraMemoryThread, ByIdFetchState } from "./mastra-client.ts";
 export { defaultReasoningEffort, modelStorageKey, readStoredModel, storeSelectedModel } from "./model-selection.ts";
 export type { MastraRequestContextInput, MastraRequestContextSource, MastraRequestContextSnapshot } from "./request-context.ts";

package/src/support/mastra-client.ts

@@ -33,6 +33,17 @@ export interface MastraStreamResponse {
   stream: ReadableStream<UIMessageChunk>;
 }
 
+/** Terminal HTTP failure returned before a chat stream was established. */
+export class MastraChatRequestError extends Error {
+  constructor(
+    message: string,
+    readonly status: number,
+  ) {
+    super(message);
+    this.name = "MastraChatRequestError";
+  }
+}
+
 /** One memory thread returned by the native Mastra client. */
 export type MastraMemoryThread = ListMemoryThreadsResponse["threads"][number];
 
@@ -634,7 +645,10 @@ async function assertChatResponse(response: Response): Promise<void> {
       .clone()
       .text()
       .catch(() => ""));
-  throw new Error(message.trim() || `Chat request failed (${response.status})`);
+  throw new MastraChatRequestError(
+    message.trim() || `Chat request failed (${response.status})`,
+    response.status,
+  );
 }
 
 function responseErrorMessage(body: unknown): string | undefined {

package/src/support/thread-sessions.ts

@@ -42,6 +42,7 @@ export type ThreadSession = {
 /** Map key for the classic single-thread chat (no explicit thread id). */
 export const DEFAULT_THREAD_SESSION_KEY = "__session__";
 
+/** Create the empty transcript and run state used for a new conversation thread. */
 export function createThreadSession(): ThreadSession {
   return {
     messages: [],
@@ -61,6 +62,7 @@ export function createThreadSession(): ThreadSession {
   };
 }
 
+/** Return whether a thread has a submitted or actively streaming run. */
 export function isSessionRunning(session: ThreadSession): boolean {
   return session.status === "submitted" || session.status === "streaming";
 }
@@ -98,6 +100,7 @@ export function reorderSteers<T extends QueuedSteer>(queue: T[], orderedIds: str
   return next;
 }
 
+/** Resolve an explicit thread id or the shared key used by single-thread chat. */
 export function sessionKey(activeThreadId: string | undefined): string {
   return activeThreadId ?? DEFAULT_THREAD_SESSION_KEY;
 }