@dbx-tools/appkit-mastra 0.3.3 → 0.3.5

package/README.md

@@ -278,6 +278,13 @@ Use `serving.extractModelOverride()` and `serving.resolveServingConfig()` when
 building custom routes that should behave like the plugin's `/models` and stream
 routes.
 
+The plugin also serves `GET /default-model` (and `/default-model/:agentId`),
+returning `{ agentId, model, displayName }` - the static serving-endpoint an
+agent falls back to when the client pins no model, plus its humanized label.
+`model` / `displayName` are `null` when the agent resolves its model
+dynamically at call time. This lets a model picker label its default option
+without waiting on the `/models` catalogue (so it never flashes a raw id).
+
 ## Threads, History, And Suggestions
 
 When storage is enabled, the plugin provides route helpers and in-process

package/package.json

@@ -27,22 +27,22 @@
     "@opentelemetry/api": "^1.9.1",
     "pg": "^8.22.0",
     "zod": "^4.3.6",
-    "@dbx-tools/appkit": "0.3.3",
-    "@dbx-tools/databricks": "0.3.3",
-    "@dbx-tools/model": "0.3.3",
-    "@dbx-tools/shared-genie": "0.3.3",
-    "@dbx-tools/shared-core": "0.3.3",
-    "@dbx-tools/core": "0.3.3",
-    "@dbx-tools/genie": "0.3.3",
-    "@dbx-tools/shared-mastra": "0.3.3",
-    "@dbx-tools/shared-model": "0.3.3"
+    "@dbx-tools/appkit": "0.3.5",
+    "@dbx-tools/core": "0.3.5",
+    "@dbx-tools/genie": "0.3.5",
+    "@dbx-tools/databricks": "0.3.5",
+    "@dbx-tools/model": "0.3.5",
+    "@dbx-tools/shared-core": "0.3.5",
+    "@dbx-tools/shared-genie": "0.3.5",
+    "@dbx-tools/shared-mastra": "0.3.5",
+    "@dbx-tools/shared-model": "0.3.5"
   },
   "main": "index.ts",
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.3.3",
+  "version": "0.3.5",
   "types": "index.ts",
   "type": "module",
   "exports": {

package/src/agents.ts

@@ -331,8 +331,9 @@ export interface BuiltAgents {
   /**
    * Static default serving-endpoint id per agent id, as resolved by
    * {@link describeAgentDefaultModel}. `"<dynamic>"` when the model is a
-   * function decided at call time. Surfaced so `clientConfig()` can label
-   * the picker's "Server default" option with the real endpoint.
+   * function decided at call time. Consumed by the plugin's
+   * `GET /default-model` route handler so the client's model picker can label
+   * its default option with the real endpoint's humanized name.
    */
   defaultModels: Record<string, string>;
   /**

package/src/plugin.ts

@@ -62,7 +62,7 @@ import {
   type StatementData,
 } from "@dbx-tools/shared-mastra";
 import { serving as nodeServing } from "@dbx-tools/model";
-import { type ServingEndpointSummary } from "@dbx-tools/shared-model";
+import { display, type ServingEndpointSummary } from "@dbx-tools/shared-model";
 import { buildAgents, FALLBACK_AGENT_ID, type BuiltAgents } from "./agents";
 import { fetchChart } from "./chart";
 import type { MastraPluginConfig } from "./config";
@@ -318,19 +318,31 @@ export class MastraPlugin extends Plugin<MastraPluginConfig> {
         .catch(next);
     });
 
-    // `GET /default-model[?agentId=]` reports the static serving-endpoint id
-    // an agent falls back to when the client pins no model, so the picker can
-    // name its "Server default" option. Agent-scoped (defaults to the default
-    // agent); `model` is null when the agent has no static default (a dynamic,
-    // call-time model) or the agent id is unknown. Registered before the
-    // catch-all, same as `/models`.
-    router.get(routes.MASTRA_ROUTES.defaultModel, (req, res) => {
-      const requested = string.firstNonEmpty(req.query["agentId"]);
+    // `GET /default-model` (and `/default-model/:agentId`) reports the static
+    // serving-endpoint an agent falls back to when the client pins no model,
+    // so the picker can label its default option with the model's humanized
+    // name. Agent-scoped via the optional `/:agentId` suffix (URL symmetry
+    // with the history / threads / suggestions routes), defaulting to the
+    // default agent. `model` / `displayName` are null when the agent has no
+    // static default (a dynamic, call-time model) or the agent id is unknown.
+    // Reads only in-memory build state, so it's synchronous and needs no OBO
+    // scoping. Registered before the catch-all, same as `/models`.
+    const handleDefaultModel = (req: express.Request, res: express.Response): void => {
+      const requested = string.firstNonEmpty(req.params["agentId"]);
       const agentId = requested ?? this.built?.defaultAgentId ?? FALLBACK_AGENT_ID;
-      const model = this.built?.defaultModels[agentId];
+      const raw = this.built?.defaultModels[agentId];
       // `"<dynamic>"` (a call-time function) has no fixed id to advertise.
-      res.json({ agentId, model: model && model !== "<dynamic>" ? model : null });
-    });
+      const model = raw && raw !== "<dynamic>" ? raw : null;
+      // Return the humanized label too, so the picker shows a friendly name on
+      // load without waiting on the `/models` catalogue (no raw-id flash).
+      res.json({
+        agentId,
+        model,
+        displayName: model ? display.toModelDisplayName(model) : null,
+      });
+    };
+    router.get(routes.MASTRA_ROUTES.defaultModel, handleDefaultModel);
+    router.get(`${routes.MASTRA_ROUTES.defaultModel}/:agentId`, handleDefaultModel);
 
     // `GET /embed/:type/:id` is the single resolver for every embed
     // marker the agent emits in prose (`[chart:<id>]`,