@dbx-tools/shared-model 0.9.129 → 0.9.132

package/README.md

@@ -1,21 +1,13 @@
 # @dbx-tools/shared-model
 
-Browser-safe model-selection contracts let UIs, routes, tools, and tests
-validate model lookups and type ranked model responses without importing
-Databricks clients. Server-side normalization,
-classification, ranking, and fuzzy resolution live in
-[`@dbx-tools/model`](../../node/model).
+Validate model lookups and ranked model responses in UIs, routes, tools, and
+tests without importing Databricks clients. Use the browser-safe model
+selection, capability, reasoning, and OpenAI Chat Completions contracts across
+client and server boundaries.
+Server-side normalization, classification, ranking, and fuzzy resolution live in
+[@dbx-tools/model](../../node/model).
 
-Key features:
-
-- Generated `ModelClass`, endpoint, query, status, profile, ranking, and
-  reasoning-effort contracts as browser-safe TypeScript and zod.
-- Human-readable endpoint display names via `display.toModelDisplayName`.
-- Browser-safe OpenAI Chat message and tool-call contracts.
-- Types that match the server selection API without depending on the Databricks
-  SDK.
-
-## Human-Readable Display Names
+## Format model display names
 
 ```ts
 import { display } from "@dbx-tools/shared-model";
@@ -26,11 +18,15 @@ 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 wins. Otherwise,
+picker. `name` stays the invocation ID. A Databricks-provided name wins. Otherwise,
 the pure helper strips leading vendor prefixes and title-cases through
 `@dbx-tools/shared-core`'s tokenizer.
 
-## Validate A Model Lookup Request
+The package also includes generated `ModelClass`, endpoint, query, status,
+profile, ranking, and reasoning-effort contracts, plus browser-safe OpenAI Chat
+Completions message and tool-call contracts.
+
+## Validate a model lookup request
 
 ```ts
 import { model } from "@dbx-tools/shared-model";
@@ -47,7 +43,7 @@ Use `model.ModelQuerySchema` for route query/body validation and agent tool
 inputs. It keeps client model pickers and backend resolution endpoints on the
 same request shape.
 
-## Use Classified Endpoint Catalogues
+## Use classified endpoint catalogs
 
 ```ts
 import { model } from "@dbx-tools/shared-model";
@@ -57,10 +53,10 @@ const agentModels = endpoints.filter((endpoint) => endpoint.supportsTools);
 ```
 
 The server stamps class and capability fields before returning `/models`.
-Browser clients consume those fields directly; model-family policy does not run
+Browser clients consume those fields directly. Model-family policy does not run
 in the browser.
 
-## Strip Fields Databricks Rejects
+## Strip fields that Databricks rejects
 
 ```ts
 import { openaiChat } from "@dbx-tools/shared-model";
@@ -72,13 +68,18 @@ Databricks Model Serving validates Chat Completions bodies strictly.
 `stripUnsupportedChatFields` deletes known unsupported fields in place and
 returns the removed names so a caller can log the difference.
 
-## Modules
+## Runtime boundary
 
-- `model` - model classes, reasoning-effort schema, endpoint summaries, lookup
+This package doesn't discover endpoints, read credentials, rank models, or send
+Model Serving requests. Use [@dbx-tools/model](../../node/model) for
+server-side model discovery and selection. Use
+[@dbx-tools/shared-model-gateway](../model-gateway) for browser-safe model
+gateway responses and discovery clients.
+
+## Package exports
+
+- `model`: model classes, reasoning-effort schema, endpoint summaries, lookup
   requests, and ranked results.
-- `display` - human-readable endpoint labels.
-- `openaiChat` - Chat Completions message and tool-call types, content helpers,
+- `display`: human-readable endpoint labels.
+- `openaiChat`: Chat Completions message and tool-call types, content helpers,
   and rejected-field sanitization.
-
-Server-side selection, cache, and fuzzy endpoint matching are in
-[`@dbx-tools/model`](../../node/model).

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/shared-model";
-export const PACKAGE_VERSION = "0.9.129";
+export const PACKAGE_VERSION = "0.9.132";
 export * as contracts from "./src/contracts.ts";
 export * as display from "./src/display.ts";
 export * as model from "./src/model.ts";

package/lib/index.d.ts

@@ -1,5 +1,5 @@
 export declare const PACKAGE_IDENTIFIER = "@dbx-tools/shared-model";
-export declare const PACKAGE_VERSION = "0.9.129";
+export declare const PACKAGE_VERSION = "0.9.132";
 export * as contracts from "./src/contracts.ts";
 export * as display from "./src/display.ts";
 export * as model from "./src/model.ts";

package/lib/index.js

@@ -2,11 +2,11 @@
 // Regenerated from the exporting modules in ./src.
 // Hand edits are overwritten on the next watch; this file is read-only.
 export const PACKAGE_IDENTIFIER = "@dbx-tools/shared-model";
-export const PACKAGE_VERSION = "0.9.129";
+export const PACKAGE_VERSION = "0.9.132";
 export * as contracts from "./src/contracts.js";
 export * as display from "./src/display.js";
 export * as model from "./src/model.js";
 export * as openaiChat from "./src/openai-chat.js";
 export { ChatRoleSchema, ChatContentPartSchema, ChatToolCallFunctionSchema, ChatToolCallSchema, ChatMessageSchema, UNSUPPORTED_CHAT_FIELDS, ChatContentToTextOptionsSchema } from "./src/openai-chat.js";
 export * from "./exports.js";
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyx5QkFBeUIsQ0FBQztBQUM1RCxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsU0FBUyxDQUFDO0FBQ3pDLE9BQU8sS0FBSyxTQUFTLE1BQU0sb0JBQW9CLENBQUM7QUFDaEQsT0FBTyxLQUFLLE9BQU8sTUFBTSxrQkFBa0IsQ0FBQztBQUM1QyxPQUFPLEtBQUssS0FBSyxNQUFNLGdCQUFnQixDQUFDO0FBQ3hDLE9BQU8sS0FBSyxVQUFVLE1BQU0sc0JBQXNCLENBQUM7QUFDbkQsT0FBTyxFQUFFLGNBQWMsRUFBRSxxQkFBcUIsRUFBRSwwQkFBMEIsRUFBRSxrQkFBa0IsRUFBRSxpQkFBaUIsRUFBRSx1QkFBdUIsRUFBRSw4QkFBOEIsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBRXpNLGNBQWMsY0FBYyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLy8gR0VORVJBVEVEIGJ5IHByb2plbiB3YXRjaCAtIERPIE5PVCBFRElULlxuLy8gUmVnZW5lcmF0ZWQgZnJvbSB0aGUgZXhwb3J0aW5nIG1vZHVsZXMgaW4gLi9zcmMuXG4vLyBIYW5kIGVkaXRzIGFyZSBvdmVyd3JpdHRlbiBvbiB0aGUgbmV4dCB3YXRjaDsgdGhpcyBmaWxlIGlzIHJlYWQtb25seS5cblxuZXhwb3J0IGNvbnN0IFBBQ0tBR0VfSURFTlRJRklFUiA9IFwiQGRieC10b29scy9zaGFyZWQtbW9kZWxcIjtcbmV4cG9ydCBjb25zdCBQQUNLQUdFX1ZFUlNJT04gPSBcIjAuOS4xMjlcIjtcbmV4cG9ydCAqIGFzIGNvbnRyYWN0cyBmcm9tIFwiLi9zcmMvY29udHJhY3RzLnRzXCI7XG5leHBvcnQgKiBhcyBkaXNwbGF5IGZyb20gXCIuL3NyYy9kaXNwbGF5LnRzXCI7XG5leHBvcnQgKiBhcyBtb2RlbCBmcm9tIFwiLi9zcmMvbW9kZWwudHNcIjtcbmV4cG9ydCAqIGFzIG9wZW5haUNoYXQgZnJvbSBcIi4vc3JjL29wZW5haS1jaGF0LnRzXCI7XG5leHBvcnQgeyBDaGF0Um9sZVNjaGVtYSwgQ2hhdENvbnRlbnRQYXJ0U2NoZW1hLCBDaGF0VG9vbENhbGxGdW5jdGlvblNjaGVtYSwgQ2hhdFRvb2xDYWxsU2NoZW1hLCBDaGF0TWVzc2FnZVNjaGVtYSwgVU5TVVBQT1JURURfQ0hBVF9GSUVMRFMsIENoYXRDb250ZW50VG9UZXh0T3B0aW9uc1NjaGVtYSB9IGZyb20gXCIuL3NyYy9vcGVuYWktY2hhdC50c1wiO1xuZXhwb3J0IHR5cGUgeyBDaGF0Um9sZSwgQ2hhdENvbnRlbnRQYXJ0LCBDaGF0VG9vbENhbGxGdW5jdGlvbiwgQ2hhdFRvb2xDYWxsLCBDaGF0TWVzc2FnZSwgQ2hhdENvbnRlbnRUb1RleHRPcHRpb25zIH0gZnJvbSBcIi4vc3JjL29wZW5haS1jaGF0LnRzXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9leHBvcnRzLnRzXCI7XG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyx5QkFBeUIsQ0FBQztBQUM1RCxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsU0FBUyxDQUFDO0FBQ3pDLE9BQU8sS0FBSyxTQUFTLE1BQU0sb0JBQW9CLENBQUM7QUFDaEQsT0FBTyxLQUFLLE9BQU8sTUFBTSxrQkFBa0IsQ0FBQztBQUM1QyxPQUFPLEtBQUssS0FBSyxNQUFNLGdCQUFnQixDQUFDO0FBQ3hDLE9BQU8sS0FBSyxVQUFVLE1BQU0sc0JBQXNCLENBQUM7QUFDbkQsT0FBTyxFQUFFLGNBQWMsRUFBRSxxQkFBcUIsRUFBRSwwQkFBMEIsRUFBRSxrQkFBa0IsRUFBRSxpQkFBaUIsRUFBRSx1QkFBdUIsRUFBRSw4QkFBOEIsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBRXpNLGNBQWMsY0FBYyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLy8gR0VORVJBVEVEIGJ5IHByb2plbiB3YXRjaCAtIERPIE5PVCBFRElULlxuLy8gUmVnZW5lcmF0ZWQgZnJvbSB0aGUgZXhwb3J0aW5nIG1vZHVsZXMgaW4gLi9zcmMuXG4vLyBIYW5kIGVkaXRzIGFyZSBvdmVyd3JpdHRlbiBvbiB0aGUgbmV4dCB3YXRjaDsgdGhpcyBmaWxlIGlzIHJlYWQtb25seS5cblxuZXhwb3J0IGNvbnN0IFBBQ0tBR0VfSURFTlRJRklFUiA9IFwiQGRieC10b29scy9zaGFyZWQtbW9kZWxcIjtcbmV4cG9ydCBjb25zdCBQQUNLQUdFX1ZFUlNJT04gPSBcIjAuOS4xMzJcIjtcbmV4cG9ydCAqIGFzIGNvbnRyYWN0cyBmcm9tIFwiLi9zcmMvY29udHJhY3RzLnRzXCI7XG5leHBvcnQgKiBhcyBkaXNwbGF5IGZyb20gXCIuL3NyYy9kaXNwbGF5LnRzXCI7XG5leHBvcnQgKiBhcyBtb2RlbCBmcm9tIFwiLi9zcmMvbW9kZWwudHNcIjtcbmV4cG9ydCAqIGFzIG9wZW5haUNoYXQgZnJvbSBcIi4vc3JjL29wZW5haS1jaGF0LnRzXCI7XG5leHBvcnQgeyBDaGF0Um9sZVNjaGVtYSwgQ2hhdENvbnRlbnRQYXJ0U2NoZW1hLCBDaGF0VG9vbENhbGxGdW5jdGlvblNjaGVtYSwgQ2hhdFRvb2xDYWxsU2NoZW1hLCBDaGF0TWVzc2FnZVNjaGVtYSwgVU5TVVBQT1JURURfQ0hBVF9GSUVMRFMsIENoYXRDb250ZW50VG9UZXh0T3B0aW9uc1NjaGVtYSB9IGZyb20gXCIuL3NyYy9vcGVuYWktY2hhdC50c1wiO1xuZXhwb3J0IHR5cGUgeyBDaGF0Um9sZSwgQ2hhdENvbnRlbnRQYXJ0LCBDaGF0VG9vbENhbGxGdW5jdGlvbiwgQ2hhdFRvb2xDYWxsLCBDaGF0TWVzc2FnZSwgQ2hhdENvbnRlbnRUb1RleHRPcHRpb25zIH0gZnJvbSBcIi4vc3JjL29wZW5haS1jaGF0LnRzXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9leHBvcnRzLnRzXCI7XG4iXX0=

package/package.json

@@ -22,7 +22,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@dbx-tools/shared-core": "^0.9.129",
+    "@dbx-tools/shared-core": "^0.9.132",
     "zod": "4.3.6"
   },
   "main": "./lib/index.js",
@@ -59,7 +59,7 @@
       "./package.json": "./package.json"
     }
   },
-  "version": "0.9.129",
+  "version": "0.9.132",
   "types": "./lib/index.d.ts",
   "dbxToolsConfig": {
     "tags": [