@dbx-tools/ui-mastra 0.3.4 → 0.3.5

package/README.md

@@ -25,7 +25,7 @@ Key features:
   the server plugin.
 - Conversation sidebar with new, select, rename, delete, active-thread, and
   background-streaming states.
-- Export menu for print/PDF and Markdown, resolving charts and tables so
+- Export menu for PDF and Markdown, resolving charts and tables so
   exported conversations remain useful offline.
 
 ## Why Not Just AppKit UI?
@@ -44,7 +44,7 @@ understand Mastra-specific behavior:
   answer.
 - `[chart:<id>]` and `[data:<id>]` assistant markers rendered as ECharts charts
   and sortable tables.
-- Conversation export that resolves those embeds into Markdown or print/PDF.
+- Conversation export that resolves those embeds into Markdown or PDF.
 
 ## Add The Styles
 
@@ -133,6 +133,7 @@ transport or needs to combine Mastra messages with another state model.
 import {
   MastraPluginClient,
   useMastraClient,
+  useMastraDefaultModel,
   useMastraModels,
   useMastraSuggestions,
   useMastraThreads,
@@ -172,7 +173,7 @@ The UI understands the extra events produced by
 <MastraChat enableExport />
 ```
 
-Exports support Markdown downloads and print/PDF. Chart and data markers are
+Exports support Markdown downloads and PDF (rendered through a hidden print iframe, so the browser's Save-as-PDF dialog opens with no popup tab). Chart and data markers are
 resolved during export: charts are rendered to inline SVG with ECharts' server
 renderer, and data markers become real tables. Expired or missing embeds are
 skipped so old transcripts still export cleanly.
@@ -184,8 +185,9 @@ skipped so old transcripts still export cleanly.
 - `ChatView` - controlled presentational chat shell.
 - `MastraPluginClient` - `@mastra/client-js` plus AppKit-Mastra custom routes.
 - `useMastraClient`, `useMastraConfig`, `useMastraModels`,
-  `useMastraSuggestions`, `useMastraThreads`, `useChartFetch`,
-  `useStatementFetch` - route/config hooks for controlled clients.
+  `useMastraDefaultModel`, `useMastraSuggestions`, `useMastraThreads`,
+  `useChartFetch`, `useStatementFetch` - route/config hooks for controlled
+  clients.
 - `ThreadSidebar` - controlled conversation list.
 - `ExportMenu` - shared export format menu.
 - Types - `ChatViewProps`, `MastraChatProps`, `UseMastraChatOptions`,

package/package.json

@@ -26,19 +26,19 @@
     "shiki": "^3.0.0",
     "sql-formatter": "^15.6.9",
     "streamdown": "^2.5.0",
-    "@dbx-tools/shared-core": "0.3.4",
-    "@dbx-tools/shared-genie": "0.3.4",
-    "@dbx-tools/shared-mastra": "0.3.4",
-    "@dbx-tools/ui-appkit": "0.3.4",
-    "@dbx-tools/ui-branding": "0.3.4",
-    "@dbx-tools/shared-model": "0.3.4"
+    "@dbx-tools/shared-core": "0.3.5",
+    "@dbx-tools/shared-genie": "0.3.5",
+    "@dbx-tools/shared-mastra": "0.3.5",
+    "@dbx-tools/ui-appkit": "0.3.5",
+    "@dbx-tools/ui-branding": "0.3.5",
+    "@dbx-tools/shared-model": "0.3.5"
   },
   "main": "index.ts",
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.3.4",
+  "version": "0.3.5",
   "types": "index.ts",
   "type": "module",
   "exports": {

package/src/react/data-grid.tsx

@@ -84,13 +84,7 @@ export function humanizeLabel(
   value: string,
   options?: string.TokenizeOptions,
 ): string {
-  const tokens = [
-    ...string.tokenizeWithOptions(
-      { lowerCase: true, capitalize: true, ...options },
-      value,
-    ),
-  ];
-  return tokens.length > 0 ? tokens.join(" ") : value;
+  return string.toLabel(value, options);
 }
 
 /**

package/src/react/mastra-chat.tsx

@@ -348,10 +348,10 @@ export const useMastraChat = (
   // hidden and skips the catalogue fetch entirely.
   const showModelPicker = Boolean(options.showModelPicker);
   const { models } = useMastraModels(showModelPicker);
-  // The endpoint the active agent falls back to when no model is pinned, so
-  // the picker can name its "Server default" option. Fetched only when the
-  // picker is shown; `null` when the agent's model is dynamic.
-  const defaultModelName = useMastraDefaultModel(agentId, showModelPicker);
+  // The humanized name of the model the active agent falls back to when no
+  // model is pinned, so the picker can label its default option. Fetched only
+  // when the picker is shown; `null` when the agent's model is dynamic.
+  const { defaultModel: defaultModelName } = useMastraDefaultModel(agentId, showModelPicker);
   // Starter suggestions: an explicit `options.suggestions` always
   // wins (including `[]` to force none) and is rendered verbatim;
   // otherwise auto-source the agent's Genie space sample questions.

package/src/react/types.ts

@@ -117,10 +117,10 @@ export type ChatViewProps = {
   model?: string;
   onModelChange?: (model: string) => void;
   /**
-   * The serving-endpoint id the server falls back to when no model is pinned.
-   * When set, the picker's "Server default" option names it (e.g. "Server
-   * default (Claude Sonnet 4.6)"), using the matching `models` entry's
-   * `displayName` when available.
+   * The serving-endpoint fallback the server uses when no model is pinned,
+   * already humanized (the server's `displayName`, e.g. "Claude Sonnet 4.6").
+   * When set, the picker's default option shows this name; otherwise it shows
+   * a neutral "Default". Never a raw endpoint id.
    */
   defaultModelName?: string;
   /**

package/src/support/export.ts

@@ -222,7 +222,7 @@ function messageText(message: UIMessage): string {
 function roleLabel(role: UIMessage["role"], userLabel: string): string {
   if (role === "user") return userLabel;
   if (role === "assistant") return "Assistant";
-  return role.charAt(0).toUpperCase() + role.slice(1);
+  return string.capitalize(role);
 }
 
 /* --------------------------------- HTML ---------------------------------- */
@@ -331,7 +331,7 @@ async function dataTableHtml(
   const data = await safeStatement(resolver, id);
   if (!data || data.rows.length === 0) return null;
   const head = data.columns
-    .map((c) => `<th>${escapeHtml(humanizeHeader(c))}</th>`)
+    .map((c) => `<th>${escapeHtml(string.toLabel(c))}</th>`)
     .join("");
   const body = data.rows
     .map(
@@ -409,7 +409,7 @@ async function dataTableMarkdown(
 ): Promise<string | null> {
   const data = await safeStatement(resolver, id);
   if (!data || data.rows.length === 0) return null;
-  const header = `| ${data.columns.map((c) => mdCell(humanizeHeader(c))).join(" | ")} |`;
+  const header = `| ${data.columns.map((c) => mdCell(string.toLabel(c))).join(" | ")} |`;
   const sep = `| ${data.columns.map(() => "---").join(" | ")} |`;
   const rows = data.rows.map(
     (row) => `| ${data.columns.map((c) => mdCell(cellText(row[c]))).join(" | ")} |`,
@@ -458,14 +458,6 @@ function mdCell(value: string): string {
   return value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
 }
 
-/** Title-case a snake/kebab/camel column name for a header label. */
-function humanizeHeader(name: string): string {
-  const tokens = [
-    ...string.tokenizeWithOptions({ lowerCase: true, capitalize: true }, name),
-  ];
-  return tokens.length > 0 ? tokens.join(" ") : name;
-}
-
 /** Escape HTML-significant characters (from the shared string utils). */
 const escapeHtml = string.escapeHtml;
 

package/src/support/mastra-client.ts

@@ -184,9 +184,8 @@ export class MastraPluginClient extends MastraClient {
    * arrives. Defaults to the server's default agent when `agentId` is omitted.
    */
   async defaultModel(agentId?: string, signal?: AbortSignal): Promise<string | null> {
-    const query = agentId ? `?agentId=${encodeURIComponent(agentId)}` : "";
     const payload = await this.#getJson(
-      `${this.basePath}${routes.MASTRA_ROUTES.defaultModel}${query}`,
+      this.#agentScoped(routes.MASTRA_ROUTES.defaultModel, agentId),
       wire.DefaultModelResponseSchema,
       signal,
     );
@@ -553,35 +552,47 @@ export const useMastraModels = (
 };
 
 /**
- * Fetch the static default serving-endpoint id the given agent (or the
- * server's default agent) falls back to when no model is pinned, via
- * `client.defaultModel(agentId)`. `null` while loading, when the agent's
- * model is dynamic, or on error - the picker then shows a plain "Server
- * default". Pass `enabled: false` to skip the fetch (e.g. picker hidden).
+ * Fetch the humanized name of the static default model the given agent (or
+ * the server's default agent) falls back to when no model is pinned, via
+ * `client.defaultModel(agentId)`. `defaultModel` is `null` while loading,
+ * when the agent's model is dynamic, or on error - the picker then shows a
+ * plain "Default". Pass `enabled: false` to skip the fetch (e.g. picker
+ * hidden), which also clears any prior value. Returns an object to match the
+ * shape of the sibling data hooks ({@link useMastraModels},
+ * {@link useMastraSuggestions}).
  */
 export const useMastraDefaultModel = (
   agentId?: string,
   enabled = true,
-): string | null => {
+): { defaultModel: string | null; loading: boolean } => {
   const client = useMastraClient();
   const [model, setModel] = useState<string | null>(null);
+  const [loading, setLoading] = useState(enabled);
 
   useEffect(() => {
-    if (!enabled) return;
+    if (!enabled) {
+      setModel(null);
+      setLoading(false);
+      return;
+    }
     const controller = new AbortController();
+    setLoading(true);
     client
       .defaultModel(agentId, controller.signal)
       .then((m) => {
         if (!controller.signal.aborted) setModel(m);
       })
       .catch(() => {
-        // Non-critical: a missing default just yields a plain "Server default".
+        // Non-critical: a missing default just yields a plain "Default".
         if (!controller.signal.aborted) setModel(null);
+      })
+      .finally(() => {
+        if (!controller.signal.aborted) setLoading(false);
       });
     return () => controller.abort();
   }, [client, agentId, enabled]);
 
-  return model;
+  return { defaultModel: model, loading };
 };
 
 /**