@dbx-tools/shared-model 0.1.21 → 0.1.23

package/README.md

@@ -16,9 +16,28 @@ Key features:
 - Endpoint classifier that groups serving endpoints by score profile and family
   naming conventions.
 - Version/family parsing helpers for model catalogues and tests.
+- Human-readable endpoint display names via `display.toModelDisplayName`.
 - Types that match the server selection API without depending on the Databricks
   SDK.
 
+## Human-Readable Display Names
+
+```ts
+import { display } from "@dbx-tools/shared-model";
+
+display.toModelDisplayName("databricks-claude-sonnet-4-6"); // "Claude Sonnet 4 6"
+display.toModelDisplayName("system.ai.bge_large_en"); // "Bge Large En"
+display.toModelDisplayName("x", "Claude 4.6 (Preview)"); // provided name wins
+```
+
+`ServingEndpointSummary.displayName` is the optional friendly label for the
+picker; `name` stays the invoke id. A Databricks-provided name (a
+`display_name`/`displayName`/`name` endpoint tag, or an external-model name —
+extracted in [`@dbx-tools/model`](../../node/model)'s `serving.ts`) wins;
+otherwise the pure helper strips leading vendor prefixes and title-cases via
+`@dbx-tools/shared-core`'s tokenizer. It flows through `GET /models`
+automatically, and the UI picker shows `displayName ?? name`.
+
 ## Validate A Model Lookup Request
 
 ```ts

package/index.ts

@@ -3,6 +3,7 @@
 // Hand edits are overwritten on the next watch; this file is read-only.
 
 export * as classify from "./src/classify";
+export * as display from "./src/display";
 export * as model from "./src/model";
 export type { FamilyClass } from "./src/classify";
 export type { ModelProfile, ServingEndpointSummary, ModelQuery, RankedModel } from "./src/model";

package/package.json

@@ -12,14 +12,14 @@
   },
   "dependencies": {
     "zod": "^4.3.6",
-    "@dbx-tools/shared-core": "0.1.21"
+    "@dbx-tools/shared-core": "0.1.23"
   },
   "main": "index.ts",
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.21",
+  "version": "0.1.23",
   "types": "index.ts",
   "type": "module",
   "exports": {

package/src/display.ts

@@ -0,0 +1,59 @@
+/**
+ * Human-readable model display names. Pure (no Node-only imports) so a
+ * browser client can label a `/models` response without server deps.
+ *
+ * The endpoint `name` is the invoke id (e.g. `databricks-claude-sonnet-4-6`);
+ * this derives a friendly label from it. Prefer a Databricks-provided name
+ * (a display-name tag or an external-model name) when the server has one -
+ * see `@dbx-tools/model`'s serving lister, which passes it as `provided`.
+ */
+import { string } from "@dbx-tools/shared-core";
+
+/**
+ * Vendor / namespace prefixes stripped from a tokenized endpoint name
+ * before title-casing. Lowercased tokens; matched only as leading tokens
+ * so a legitimate mid-name token is never dropped. `ai` is stripped ONLY
+ * as the second half of the `system.ai.*` builtin namespace (handled
+ * below), never on its own - so a model literally named `...-ai-...`
+ * keeps its "AI" word via the tokenizer's built-in casing override.
+ */
+const STRIP_LEADING_TOKENS = new Set(["databricks", "system", "dbx"]);
+
+/**
+ * Derive a human-readable display name for a serving endpoint.
+ *
+ * When `provided` is a non-blank string (a Databricks display-name tag or
+ * external-model name), it wins verbatim (trimmed). Otherwise `name` is
+ * tokenized with the shared-core tokenizer (which title-cases and
+ * special-cases "AI"), known leading vendor prefixes are dropped, and the
+ * remaining tokens are joined with spaces. Falls back to the trimmed raw
+ * `name` if stripping leaves nothing.
+ *
+ * @example
+ * toModelDisplayName("databricks-claude-sonnet-4-6") // "Claude Sonnet 4 6"
+ * toModelDisplayName("system.ai.bge_large_en")       // "Bge Large En"
+ * toModelDisplayName("x", "GPT-5 (Preview)")          // "GPT-5 (Preview)"
+ */
+export function toModelDisplayName(name: string, provided?: string | null): string {
+  const providedTrimmed = string.trimToNull(provided);
+  if (providedTrimmed) return providedTrimmed;
+
+  const tokens = [...string.tokenizeWithOptions({ capitalize: true }, name)];
+  // Drop known vendor/namespace prefixes only while they lead the list, so
+  // a model literally named after one of these words mid-string is kept.
+  let start = 0;
+  while (start < tokens.length && STRIP_LEADING_TOKENS.has(tokens[start]!.toLowerCase())) {
+    // `system` is followed by `ai` in the `system.ai.*` builtin namespace;
+    // consume that `ai` too (but only right after `system`, never alone).
+    if (
+      tokens[start]!.toLowerCase() === "system" &&
+      tokens[start + 1]?.toLowerCase() === "ai"
+    ) {
+      start += 1;
+    }
+    start += 1;
+  }
+  const kept = tokens.slice(start);
+  const label = (kept.length > 0 ? kept : tokens).join(" ");
+  return label || name.trim();
+}

package/src/model.ts

@@ -74,6 +74,12 @@ export const ServingEndpointSummarySchema = z.object({
     .describe(
       "Endpoint name as listed by the Model Serving REST API; the id used to invoke the model.",
     ),
+  displayName: z
+    .string()
+    .optional()
+    .describe(
+      "Human-readable label for the endpoint: a Databricks-provided name when present (a display-name tag or external-model name), else a title-cased rendering of `name` with vendor prefixes stripped. `name` remains the invoke id.",
+    ),
   task: z.string().optional().describe("Task hint, e.g. 'llm/v1/chat' or 'llm/v1/embeddings'."),
   state: z.string().optional().describe("Deployment state, e.g. ready, updating, or failed."),
   description: z.string().optional().describe("Free-form endpoint description; informational."),