notdiamond 2.0.0-rc2 → 2.0.0-rc4

package/resources/model-router.js

@@ -0,0 +1,97 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelRouter = void 0;
+const resource_1 = require("../core/resource.js");
+class ModelRouter extends resource_1.APIResource {
+    /**
+     * Openhands Model Select
+     *
+     * @example
+     * ```ts
+     * const response = await client.modelRouter.openHandsSelect({
+     *   llm_providers: [
+     *     { model: 'gpt-4o', provider: 'openai' },
+     *     {
+     *       model: 'claude-sonnet-4-5-20250929',
+     *       provider: 'anthropic',
+     *     },
+     *     { model: 'gemini-1.5-pro', provider: 'google' },
+     *   ],
+     *   messages: [
+     *     {
+     *       content: 'You are a helpful assistant.',
+     *       role: 'system',
+     *     },
+     *     { content: 'Explain quantum computing', role: 'user' },
+     *   ],
+     * });
+     * ```
+     */
+    openHandsSelect(body, options) {
+        return this._client.post('/v2/modelRouter/openHandsRouter', { body, ...options });
+    }
+    /**
+     * Select the optimal LLM to handle your query based on Not Diamond's routing
+     * algorithm.
+     *
+     * This endpoint analyzes your messages and returns the best-suited model from your
+     * specified providers. The router considers factors like query complexity, model
+     * capabilities, cost, and latency based on your preferences.
+     *
+     * **Key Features:**
+     *
+     * - Intelligent routing across multiple LLM providers
+     * - Support for custom routers trained on your evaluation data
+     * - Optional cost/latency optimization
+     * - Function calling support for compatible models
+     * - Privacy-preserving content hashing
+     *
+     * **Usage:**
+     *
+     * 1. Pass your messages in OpenAI format (array of objects with 'role' and
+     *    'content')
+     * 2. Specify which LLM providers you want to route between
+     * 3. Optionally provide a preference_id for personalized routing
+     * 4. Receive a recommended model and session_id
+     * 5. Use the session_id to submit feedback and improve routing
+     *
+     * **Related Endpoints:**
+     *
+     * - `POST /v2/preferences/userPreferenceCreate` - Create a preference ID for
+     *   personalized routing
+     * - `POST /v2/report/metrics/feedback` - Submit feedback on routing decisions
+     * - `POST /v2/pzn/trainCustomRouter` - Train a custom router on your evaluation
+     *   data
+     *
+     * @example
+     * ```ts
+     * const response = await client.modelRouter.selectModel({
+     *   llm_providers: [
+     *     { provider: 'openai', model: 'gpt-4o' },
+     *     {
+     *       provider: 'anthropic',
+     *       model: 'claude-sonnet-4-5-20250929',
+     *     },
+     *     { provider: 'google', model: 'gemini-1.5-pro' },
+     *   ],
+     *   messages: [
+     *     {
+     *       role: 'system',
+     *       content: 'You are a helpful assistant.',
+     *     },
+     *     {
+     *       role: 'user',
+     *       content: 'Explain quantum computing in simple terms',
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    selectModel(params, options) {
+        const { type, ...body } = params;
+        return this._client.post('/v2/modelRouter/modelSelect', { query: { type }, body, ...options });
+    }
+}
+exports.ModelRouter = ModelRouter;
+//# sourceMappingURL=model-router.js.map

package/resources/model-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.js","sourceRoot":"","sources":["../src/resources/model-router.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAK/C,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,eAAe,CAAC,IAAsC,EAAE,OAAwB;QAC9E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACH,WAAW,CACT,MAAoC,EACpC,OAAwB;QAExB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;CACF;AA7FD,kCA6FC"}

package/resources/model-router.mjs

@@ -0,0 +1,93 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+export class ModelRouter extends APIResource {
+    /**
+     * Openhands Model Select
+     *
+     * @example
+     * ```ts
+     * const response = await client.modelRouter.openHandsSelect({
+     *   llm_providers: [
+     *     { model: 'gpt-4o', provider: 'openai' },
+     *     {
+     *       model: 'claude-sonnet-4-5-20250929',
+     *       provider: 'anthropic',
+     *     },
+     *     { model: 'gemini-1.5-pro', provider: 'google' },
+     *   ],
+     *   messages: [
+     *     {
+     *       content: 'You are a helpful assistant.',
+     *       role: 'system',
+     *     },
+     *     { content: 'Explain quantum computing', role: 'user' },
+     *   ],
+     * });
+     * ```
+     */
+    openHandsSelect(body, options) {
+        return this._client.post('/v2/modelRouter/openHandsRouter', { body, ...options });
+    }
+    /**
+     * Select the optimal LLM to handle your query based on Not Diamond's routing
+     * algorithm.
+     *
+     * This endpoint analyzes your messages and returns the best-suited model from your
+     * specified providers. The router considers factors like query complexity, model
+     * capabilities, cost, and latency based on your preferences.
+     *
+     * **Key Features:**
+     *
+     * - Intelligent routing across multiple LLM providers
+     * - Support for custom routers trained on your evaluation data
+     * - Optional cost/latency optimization
+     * - Function calling support for compatible models
+     * - Privacy-preserving content hashing
+     *
+     * **Usage:**
+     *
+     * 1. Pass your messages in OpenAI format (array of objects with 'role' and
+     *    'content')
+     * 2. Specify which LLM providers you want to route between
+     * 3. Optionally provide a preference_id for personalized routing
+     * 4. Receive a recommended model and session_id
+     * 5. Use the session_id to submit feedback and improve routing
+     *
+     * **Related Endpoints:**
+     *
+     * - `POST /v2/preferences/userPreferenceCreate` - Create a preference ID for
+     *   personalized routing
+     * - `POST /v2/report/metrics/feedback` - Submit feedback on routing decisions
+     * - `POST /v2/pzn/trainCustomRouter` - Train a custom router on your evaluation
+     *   data
+     *
+     * @example
+     * ```ts
+     * const response = await client.modelRouter.selectModel({
+     *   llm_providers: [
+     *     { provider: 'openai', model: 'gpt-4o' },
+     *     {
+     *       provider: 'anthropic',
+     *       model: 'claude-sonnet-4-5-20250929',
+     *     },
+     *     { provider: 'google', model: 'gemini-1.5-pro' },
+     *   ],
+     *   messages: [
+     *     {
+     *       role: 'system',
+     *       content: 'You are a helpful assistant.',
+     *     },
+     *     {
+     *       role: 'user',
+     *       content: 'Explain quantum computing in simple terms',
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    selectModel(params, options) {
+        const { type, ...body } = params;
+        return this._client.post('/v2/modelRouter/modelSelect', { query: { type }, body, ...options });
+    }
+}
+//# sourceMappingURL=model-router.mjs.map

package/resources/model-router.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.mjs","sourceRoot":"","sources":["../src/resources/model-router.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAKtB,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,eAAe,CAAC,IAAsC,EAAE,OAAwB;QAC9E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACH,WAAW,CACT,MAAoC,EACpC,OAAwB;QAExB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;CACF"}

package/resources/models.d.mts

@@ -33,40 +33,65 @@ export declare class Models extends APIResource {
      * **Caching:**
      *
      * - Response is cacheable for 1 hour (model list rarely changes)
+     *
+     * @example
+     * ```ts
+     * const models = await client.models.list();
+     * ```
      */
     list(query?: ModelListParams | null | undefined, options?: RequestOptions): APIPromise<ModelListResponse>;
 }
 /**
- * Response for models list endpoint.
+ * Response model for a single LLM model from GET /v2/models endpoint.
+ *
+ * Contains metadata about a supported text generation model including pricing,
+ * context limits, and availability information.
  */
-export interface ModelListResponse {
-    deprecated_models: Array<ModelListResponse.DeprecatedModel>;
-    models: Array<ModelListResponse.Model>;
-    total: number;
+export interface Model {
+    /**
+     * Maximum context window size in tokens
+     */
+    context_length: number;
+    /**
+     * Price per million input tokens in USD
+     */
+    input_price: number;
+    /**
+     * Model identifier (e.g., 'gpt-4', 'claude-3-opus-20240229')
+     */
+    model: string;
+    /**
+     * Price per million output tokens in USD
+     */
+    output_price: number;
+    /**
+     * Provider name (e.g., 'openai', 'anthropic', 'google')
+     */
+    provider: string;
+    /**
+     * OpenRouter model identifier if available, null if not supported via OpenRouter
+     */
+    openrouter_model?: string | null;
 }
-export declare namespace ModelListResponse {
+/**
+ * Response model for GET /v2/models endpoint.
+ *
+ * Returns a list of all supported text generation models with their metadata,
+ * separated into active and deprecated models.
+ */
+export interface ModelListResponse {
     /**
-     * Response model for a single LLM provider.
+     * List of deprecated models that are no longer recommended but may still work
      */
-    interface DeprecatedModel {
-        context_length: number;
-        input_price: number;
-        model: string;
-        output_price: number;
-        provider: string;
-        openrouter_model?: string | null;
-    }
+    deprecated_models: Array<Model>;
     /**
-     * Response model for a single LLM provider.
+     * List of active/supported text generation models with their metadata
      */
-    interface Model {
-        context_length: number;
-        input_price: number;
-        model: string;
-        output_price: number;
-        provider: string;
-        openrouter_model?: string | null;
-    }
+    models: Array<Model>;
+    /**
+     * Total count of active models in the response
+     */
+    total: number;
 }
 export interface ModelListParams {
     /**
@@ -80,6 +105,6 @@ export interface ModelListParams {
     provider?: Array<string> | null;
 }
 export declare namespace Models {
-    export { type ModelListResponse as ModelListResponse, type ModelListParams as ModelListParams };
+    export { type Model as Model, type ModelListResponse as ModelListResponse, type ModelListParams as ModelListParams, };
 }
 //# sourceMappingURL=models.d.mts.map

package/resources/models.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.mts","sourceRoot":"","sources":["../src/resources/models.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iBAAiB,CAAC;CAGjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAE5D,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAEvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yBAAiB,iBAAiB,CAAC;IACjC;;OAEG;IACH,UAAiB,eAAe;QAC9B,cAAc,EAAE,MAAM,CAAC;QAEvB,WAAW,EAAE,MAAM,CAAC;QAEpB,KAAK,EAAE,MAAM,CAAC;QAEd,YAAY,EAAE,MAAM,CAAC;QAErB,QAAQ,EAAE,MAAM,CAAC;QAEjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC;IAED;;OAEG;IACH,UAAiB,KAAK;QACpB,cAAc,EAAE,MAAM,CAAC;QAEvB,WAAW,EAAE,MAAM,CAAC;QAEpB,KAAK,EAAE,MAAM,CAAC;QAEd,YAAY,EAAE,MAAM,CAAC;QAErB,QAAQ,EAAE,MAAM,CAAC;QAEjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC;CACF;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EAAE,KAAK,iBAAiB,IAAI,iBAAiB,EAAE,KAAK,eAAe,IAAI,eAAe,EAAE,CAAC;CACjG"}
+{"version":3,"file":"models.d.mts","sourceRoot":"","sources":["../src/resources/models.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iBAAiB,CAAC;CAGjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAEhC;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/models.d.ts

@@ -33,40 +33,65 @@ export declare class Models extends APIResource {
      * **Caching:**
      *
      * - Response is cacheable for 1 hour (model list rarely changes)
+     *
+     * @example
+     * ```ts
+     * const models = await client.models.list();
+     * ```
      */
     list(query?: ModelListParams | null | undefined, options?: RequestOptions): APIPromise<ModelListResponse>;
 }
 /**
- * Response for models list endpoint.
+ * Response model for a single LLM model from GET /v2/models endpoint.
+ *
+ * Contains metadata about a supported text generation model including pricing,
+ * context limits, and availability information.
  */
-export interface ModelListResponse {
-    deprecated_models: Array<ModelListResponse.DeprecatedModel>;
-    models: Array<ModelListResponse.Model>;
-    total: number;
+export interface Model {
+    /**
+     * Maximum context window size in tokens
+     */
+    context_length: number;
+    /**
+     * Price per million input tokens in USD
+     */
+    input_price: number;
+    /**
+     * Model identifier (e.g., 'gpt-4', 'claude-3-opus-20240229')
+     */
+    model: string;
+    /**
+     * Price per million output tokens in USD
+     */
+    output_price: number;
+    /**
+     * Provider name (e.g., 'openai', 'anthropic', 'google')
+     */
+    provider: string;
+    /**
+     * OpenRouter model identifier if available, null if not supported via OpenRouter
+     */
+    openrouter_model?: string | null;
 }
-export declare namespace ModelListResponse {
+/**
+ * Response model for GET /v2/models endpoint.
+ *
+ * Returns a list of all supported text generation models with their metadata,
+ * separated into active and deprecated models.
+ */
+export interface ModelListResponse {
     /**
-     * Response model for a single LLM provider.
+     * List of deprecated models that are no longer recommended but may still work
      */
-    interface DeprecatedModel {
-        context_length: number;
-        input_price: number;
-        model: string;
-        output_price: number;
-        provider: string;
-        openrouter_model?: string | null;
-    }
+    deprecated_models: Array<Model>;
     /**
-     * Response model for a single LLM provider.
+     * List of active/supported text generation models with their metadata
      */
-    interface Model {
-        context_length: number;
-        input_price: number;
-        model: string;
-        output_price: number;
-        provider: string;
-        openrouter_model?: string | null;
-    }
+    models: Array<Model>;
+    /**
+     * Total count of active models in the response
+     */
+    total: number;
 }
 export interface ModelListParams {
     /**
@@ -80,6 +105,6 @@ export interface ModelListParams {
     provider?: Array<string> | null;
 }
 export declare namespace Models {
-    export { type ModelListResponse as ModelListResponse, type ModelListParams as ModelListParams };
+    export { type Model as Model, type ModelListResponse as ModelListResponse, type ModelListParams as ModelListParams, };
 }
 //# sourceMappingURL=models.d.ts.map

package/resources/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/resources/models.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iBAAiB,CAAC;CAGjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAE5D,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAEvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yBAAiB,iBAAiB,CAAC;IACjC;;OAEG;IACH,UAAiB,eAAe;QAC9B,cAAc,EAAE,MAAM,CAAC;QAEvB,WAAW,EAAE,MAAM,CAAC;QAEpB,KAAK,EAAE,MAAM,CAAC;QAEd,YAAY,EAAE,MAAM,CAAC;QAErB,QAAQ,EAAE,MAAM,CAAC;QAEjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC;IAED;;OAEG;IACH,UAAiB,KAAK;QACpB,cAAc,EAAE,MAAM,CAAC;QAEvB,WAAW,EAAE,MAAM,CAAC;QAEpB,KAAK,EAAE,MAAM,CAAC;QAEd,YAAY,EAAE,MAAM,CAAC;QAErB,QAAQ,EAAE,MAAM,CAAC;QAEjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC;CACF;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EAAE,KAAK,iBAAiB,IAAI,iBAAiB,EAAE,KAAK,eAAe,IAAI,eAAe,EAAE,CAAC;CACjG"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/resources/models.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,IAAI,CACF,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iBAAiB,CAAC;CAGjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAEhC;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/models.js

@@ -35,6 +35,11 @@ class Models extends resource_1.APIResource {
      * **Caching:**
      *
      * - Response is cacheable for 1 hour (model list rarely changes)
+     *
+     * @example
+     * ```ts
+     * const models = await client.models.list();
+     * ```
      */
     list(query = {}, options) {
         return this._client.get('/v2/models', { query, ...options });

package/resources/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/resources/models.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF;AAvCD,wBAuCC"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/resources/models.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF;AA5CD,wBA4CC"}

package/resources/models.mjs

@@ -32,6 +32,11 @@ export class Models extends APIResource {
      * **Caching:**
      *
      * - Response is cacheable for 1 hour (model list rarely changes)
+     *
+     * @example
+     * ```ts
+     * const models = await client.models.list();
+     * ```
      */
     list(query = {}, options) {
         return this._client.get('/v2/models', { query, ...options });

package/resources/models.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"models.mjs","sourceRoot":"","sources":["../src/resources/models.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF"}
+{"version":3,"file":"models.mjs","sourceRoot":"","sources":["../src/resources/models.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/resources/preferences.d.mts

@@ -2,18 +2,6 @@ import { APIResource } from "../core/resource.mjs";
 import { APIPromise } from "../core/api-promise.mjs";
 import { RequestOptions } from "../internal/request-options.mjs";
 export declare class Preferences extends APIResource {
-    /**
-     * Get User Preference By Id
-     *
-     * @example
-     * ```ts
-     * const preference = await client.preferences.retrieve(
-     *   'preference_id',
-     *   { user_id: 'user_id', 'x-token': 'x-token' },
-     * );
-     * ```
-     */
-    retrieve(preferenceID: string, params: PreferenceRetrieveParams, options?: RequestOptions): APIPromise<unknown>;
     /**
      * Create a new preference ID for personalized LLM routing.
      *
@@ -42,70 +30,84 @@ export declare class Preferences extends APIResource {
      *
      * @example
      * ```ts
-     * const response =
-     *   await client.preferences.createUserPreference();
+     * const preference = await client.preferences.create();
      * ```
      */
-    createUserPreference(body: PreferenceCreateUserPreferenceParams, options?: RequestOptions): APIPromise<PreferenceCreateUserPreferenceResponse>;
+    create(body: PreferenceCreateParams, options?: RequestOptions): APIPromise<PreferenceCreateResponse>;
     /**
-     * Delete User Preference
+     * Get User Preference
      *
      * @example
      * ```ts
-     * const response =
-     *   await client.preferences.deleteUserPreference(
-     *     'preference_id',
-     *   );
+     * const preference = await client.preferences.retrieve(
+     *   'user_id',
+     *   { 'x-token': 'x-token' },
+     * );
      * ```
      */
-    deleteUserPreference(preferenceID: string, options?: RequestOptions): APIPromise<unknown>;
+    retrieve(userID: string, params: PreferenceRetrieveParams, options?: RequestOptions): APIPromise<unknown>;
     /**
      * Update User Preference
      *
      * @example
      * ```ts
-     * const response =
-     *   await client.preferences.updateUserPreference({
-     *     preference_id: 'preference_id',
-     *   });
+     * const preference = await client.preferences.update({
+     *   preference_id: 'preference_id',
+     * });
      * ```
      */
-    updateUserPreference(body: PreferenceUpdateUserPreferenceParams, options?: RequestOptions): APIPromise<unknown>;
+    update(body: PreferenceUpdateParams, options?: RequestOptions): APIPromise<unknown>;
+    /**
+     * Delete User Preference
+     *
+     * @example
+     * ```ts
+     * const preference = await client.preferences.delete(
+     *   'preference_id',
+     * );
+     * ```
+     */
+    delete(preferenceID: string, options?: RequestOptions): APIPromise<unknown>;
 }
-export type PreferenceRetrieveResponse = unknown;
 /**
- * Response from preference creation endpoint.
+ * Response model for POST /v2/preferences/userPreferenceCreate endpoint.
+ *
+ * Returns the newly created preference ID which can be used to enable personalized
+ * LLM routing. Store this ID and include it in subsequent model_select() calls to
+ * activate personalized routing based on your feedback and usage patterns.
+ *
+ * **Next steps after creation:**
+ *
+ * 1. Use the preference_id in POST /v2/modelRouter/modelSelect requests
+ * 2. Submit feedback on routing decisions to improve accuracy
+ * 3. Optionally train a custom router using your evaluation data
  */
-export interface PreferenceCreateUserPreferenceResponse {
+export interface PreferenceCreateResponse {
     /**
-     * The newly created preference ID. Use this in model_select() calls for
-     * personalized routing
+     * Unique identifier for the newly created preference. Use this in the
+     * 'preference_id' parameter of model_select() calls to enable personalized routing
      */
     preference_id: string;
 }
-export type PreferenceDeleteUserPreferenceResponse = unknown;
-export type PreferenceUpdateUserPreferenceResponse = unknown;
-export interface PreferenceRetrieveParams {
-    /**
-     * Path param:
-     */
-    user_id: string;
-    /**
-     * Header param:
-     */
-    'x-token': string;
-}
-export interface PreferenceCreateUserPreferenceParams {
+export type PreferenceRetrieveResponse = unknown;
+export type PreferenceUpdateResponse = unknown;
+export type PreferenceDeleteResponse = unknown;
+export interface PreferenceCreateParams {
     /**
-     * Optional name for the preference
+     * Optional name for the preference. If not provided, an auto-generated timestamp
+     * will be used. Use descriptive names like 'Production API' or 'Customer Support
+     * Bot' for easy identification
      */
     name?: string | null;
 }
-export interface PreferenceUpdateUserPreferenceParams {
+export interface PreferenceRetrieveParams {
+    'x-token': string;
+}
+export interface PreferenceUpdateParams {
     preference_id: string;
     name?: string | null;
 }
 export declare namespace Preferences {
-    export { type PreferenceRetrieveResponse as PreferenceRetrieveResponse, type PreferenceCreateUserPreferenceResponse as PreferenceCreateUserPreferenceResponse, type PreferenceDeleteUserPreferenceResponse as PreferenceDeleteUserPreferenceResponse, type PreferenceUpdateUserPreferenceResponse as PreferenceUpdateUserPreferenceResponse, type PreferenceRetrieveParams as PreferenceRetrieveParams, type PreferenceCreateUserPreferenceParams as PreferenceCreateUserPreferenceParams, type PreferenceUpdateUserPreferenceParams as PreferenceUpdateUserPreferenceParams, };
+    export { type PreferenceCreateResponse as PreferenceCreateResponse, type PreferenceRetrieveResponse as PreferenceRetrieveResponse, type PreferenceUpdateResponse as PreferenceUpdateResponse, type PreferenceDeleteResponse as PreferenceDeleteResponse, type PreferenceCreateParams as PreferenceCreateParams, type PreferenceRetrieveParams as PreferenceRetrieveParams, type PreferenceUpdateParams as PreferenceUpdateParams, };
 }
 //# sourceMappingURL=preferences.d.mts.map

package/resources/preferences.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"preferences.d.mts","sourceRoot":"","sources":["../src/resources/preferences.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAGzB,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;OAUG;IACH,QAAQ,CACN,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC;IAQtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,oBAAoB,CAClB,IAAI,EAAE,oCAAoC,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,sCAAsC,CAAC;IAIrD;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAIzF;;;;;;;;;;OAUG;IACH,oBAAoB,CAClB,IAAI,EAAE,oCAAoC,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC;CAGvB;AAED,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,sCAAsC;IACrD;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,sCAAsC,GAAG,OAAO,CAAC;AAE7D,MAAM,MAAM,sCAAsC,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oCAAoC;IACnD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,oCAAoC;IACnD,aAAa,EAAE,MAAM,CAAC;IAEtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,sCAAsC,IAAI,sCAAsC,EACrF,KAAK,sCAAsC,IAAI,sCAAsC,EACrF,KAAK,sCAAsC,IAAI,sCAAsC,EACrF,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,oCAAoC,IAAI,oCAAoC,EACjF,KAAK,oCAAoC,IAAI,oCAAoC,GAClF,CAAC;CACH"}
+{"version":3,"file":"preferences.d.mts","sourceRoot":"","sources":["../src/resources/preferences.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAGzB,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,wBAAwB,CAAC;IAIpG;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAQzG;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAInF;;;;;;;;;OASG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;CAG5E;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAEjD,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAE/C,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IAEtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}