notdiamond 1.1.4 → 2.0.0-rc10

package/resources/models.d.ts

@@ -0,0 +1,110 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Models extends APIResource {
+    /**
+     * List all supported text generation models with optional filtering.
+     *
+     * including pricing, context length, latency, and OpenRouter availability.
+     *
+     * **Note:** Image generation models are excluded from this endpoint.
+     *
+     * **Examples:**
+     *
+     * - Get all models: `/v2/models`
+     * - OpenRouter only: `/v2/models?openrouter_only=true`
+     * - Specific provider: `/v2/models?provider=openai`
+     * - Multiple providers: `/v2/models?provider=openai&provider=anthropic`
+     *
+     * **Query Parameters:**
+     *
+     * - **provider**: Filter by provider name(s). Can specify multiple times for
+     *   multiple providers (e.g., `?provider=openai&provider=anthropic`)
+     * - **openrouter_only**: Return only models that have OpenRouter support (default:
+     *   false)
+     *
+     * **Returns:**
+     *
+     * - **models**: List of active text generation model objects with metadata
+     * - **total**: Total number of active models returned
+     * - **deprecated_models**: List of deprecated text generation model objects with
+     *   metadata (respects the same filters as active models)
+     *
+     * **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 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 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;
+}
+/**
+ * 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 {
+    /**
+     * List of deprecated models that are no longer recommended but may still work
+     */
+    deprecated_models: Array<Model>;
+    /**
+     * List of active/supported text generation models with their metadata
+     */
+    models: Array<Model>;
+    /**
+     * Total count of active models in the response
+     */
+    total: number;
+}
+export interface ModelListParams {
+    /**
+     * Return only OpenRouter-supported models
+     */
+    openrouter_only?: boolean;
+    /**
+     * Filter by provider name(s). Can specify multiple providers (e.g., 'openai',
+     * 'anthropic')
+     */
+    provider?: Array<string> | null;
+}
+export declare namespace Models {
+    export { type Model as Model, type ModelListResponse as ModelListResponse, type ModelListParams as ModelListParams, };
+}
+//# sourceMappingURL=models.d.ts.map

package/resources/models.d.ts.map

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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

@@ -0,0 +1,49 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Models = void 0;
+const resource_1 = require("../core/resource.js");
+class Models extends resource_1.APIResource {
+    /**
+     * List all supported text generation models with optional filtering.
+     *
+     * including pricing, context length, latency, and OpenRouter availability.
+     *
+     * **Note:** Image generation models are excluded from this endpoint.
+     *
+     * **Examples:**
+     *
+     * - Get all models: `/v2/models`
+     * - OpenRouter only: `/v2/models?openrouter_only=true`
+     * - Specific provider: `/v2/models?provider=openai`
+     * - Multiple providers: `/v2/models?provider=openai&provider=anthropic`
+     *
+     * **Query Parameters:**
+     *
+     * - **provider**: Filter by provider name(s). Can specify multiple times for
+     *   multiple providers (e.g., `?provider=openai&provider=anthropic`)
+     * - **openrouter_only**: Return only models that have OpenRouter support (default:
+     *   false)
+     *
+     * **Returns:**
+     *
+     * - **models**: List of active text generation model objects with metadata
+     * - **total**: Total number of active models returned
+     * - **deprecated_models**: List of deprecated text generation model objects with
+     *   metadata (respects the same filters as active models)
+     *
+     * **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 });
+    }
+}
+exports.Models = Models;
+//# sourceMappingURL=models.js.map

package/resources/models.js.map

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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

@@ -0,0 +1,45 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+export class Models extends APIResource {
+    /**
+     * List all supported text generation models with optional filtering.
+     *
+     * including pricing, context length, latency, and OpenRouter availability.
+     *
+     * **Note:** Image generation models are excluded from this endpoint.
+     *
+     * **Examples:**
+     *
+     * - Get all models: `/v2/models`
+     * - OpenRouter only: `/v2/models?openrouter_only=true`
+     * - Specific provider: `/v2/models?provider=openai`
+     * - Multiple providers: `/v2/models?provider=openai&provider=anthropic`
+     *
+     * **Query Parameters:**
+     *
+     * - **provider**: Filter by provider name(s). Can specify multiple times for
+     *   multiple providers (e.g., `?provider=openai&provider=anthropic`)
+     * - **openrouter_only**: Return only models that have OpenRouter support (default:
+     *   false)
+     *
+     * **Returns:**
+     *
+     * - **models**: List of active text generation model objects with metadata
+     * - **total**: Total number of active models returned
+     * - **deprecated_models**: List of deprecated text generation model objects with
+     *   metadata (respects the same filters as active models)
+     *
+     * **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 });
+    }
+}
+//# sourceMappingURL=models.mjs.map

package/resources/models.mjs.map

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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

@@ -0,0 +1,97 @@
+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 {
+    /**
+     * Create a new preference ID for personalized LLM routing.
+     *
+     * A preference ID enables personalized routing by tracking your feedback and
+     * learning your preferences over time. Once created, you can:
+     *
+     * 1. Use it in model_select() calls to get personalized routing decisions
+     * 2. Submit feedback via the feedback endpoint to improve routing quality
+     * 3. Train a custom router specific to your use case
+     *
+     * **Workflow:**
+     *
+     * 1. Create a preference ID (this endpoint)
+     * 2. Use the preference_id in POST /v2/modelRouter/modelSelect requests
+     * 3. Submit feedback on routing decisions via POST /v2/report/metrics/feedback
+     * 4. Optionally train a custom router via POST /v2/pzn/trainCustomRouter
+     *
+     * **Benefits:**
+     *
+     * - Personalized routing that learns from your feedback
+     * - Improved accuracy for your specific use case
+     * - Ability to train custom routers on your evaluation data
+     *
+     * **Note:** If you don't provide a preference_id in model_select() calls, the
+     * default router will be used.
+     *
+     * @example
+     * ```ts
+     * const preference = await client.preferences.create();
+     * ```
+     */
+    create(body: PreferenceCreateParams, options?: RequestOptions): APIPromise<PreferenceCreateResponse>;
+    /**
+     * Update User Preference
+     *
+     * @example
+     * ```ts
+     * const preference = await client.preferences.update({
+     *   preference_id: 'preference_id',
+     * });
+     * ```
+     */
+    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>;
+}
+/**
+ * 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 PreferenceCreateResponse {
+    /**
+     * 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 PreferenceUpdateResponse = unknown;
+export type PreferenceDeleteResponse = unknown;
+export interface PreferenceCreateParams {
+    /**
+     * 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 PreferenceUpdateParams {
+    preference_id: string;
+    name?: string | null;
+}
+export declare namespace Preferences {
+    export { type PreferenceCreateResponse as PreferenceCreateResponse, type PreferenceUpdateResponse as PreferenceUpdateResponse, type PreferenceDeleteResponse as PreferenceDeleteResponse, type PreferenceCreateParams as PreferenceCreateParams, type PreferenceUpdateParams as PreferenceUpdateParams, };
+}
+//# sourceMappingURL=preferences.d.mts.map

package/resources/preferences.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.mts","sourceRoot":"","sources":["../src/resources/preferences.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,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;;;;;;;;;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,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,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,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/preferences.d.ts

@@ -0,0 +1,97 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Preferences extends APIResource {
+    /**
+     * Create a new preference ID for personalized LLM routing.
+     *
+     * A preference ID enables personalized routing by tracking your feedback and
+     * learning your preferences over time. Once created, you can:
+     *
+     * 1. Use it in model_select() calls to get personalized routing decisions
+     * 2. Submit feedback via the feedback endpoint to improve routing quality
+     * 3. Train a custom router specific to your use case
+     *
+     * **Workflow:**
+     *
+     * 1. Create a preference ID (this endpoint)
+     * 2. Use the preference_id in POST /v2/modelRouter/modelSelect requests
+     * 3. Submit feedback on routing decisions via POST /v2/report/metrics/feedback
+     * 4. Optionally train a custom router via POST /v2/pzn/trainCustomRouter
+     *
+     * **Benefits:**
+     *
+     * - Personalized routing that learns from your feedback
+     * - Improved accuracy for your specific use case
+     * - Ability to train custom routers on your evaluation data
+     *
+     * **Note:** If you don't provide a preference_id in model_select() calls, the
+     * default router will be used.
+     *
+     * @example
+     * ```ts
+     * const preference = await client.preferences.create();
+     * ```
+     */
+    create(body: PreferenceCreateParams, options?: RequestOptions): APIPromise<PreferenceCreateResponse>;
+    /**
+     * Update User Preference
+     *
+     * @example
+     * ```ts
+     * const preference = await client.preferences.update({
+     *   preference_id: 'preference_id',
+     * });
+     * ```
+     */
+    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>;
+}
+/**
+ * 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 PreferenceCreateResponse {
+    /**
+     * 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 PreferenceUpdateResponse = unknown;
+export type PreferenceDeleteResponse = unknown;
+export interface PreferenceCreateParams {
+    /**
+     * 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 PreferenceUpdateParams {
+    preference_id: string;
+    name?: string | null;
+}
+export declare namespace Preferences {
+    export { type PreferenceCreateResponse as PreferenceCreateResponse, type PreferenceUpdateResponse as PreferenceUpdateResponse, type PreferenceDeleteResponse as PreferenceDeleteResponse, type PreferenceCreateParams as PreferenceCreateParams, type PreferenceUpdateParams as PreferenceUpdateParams, };
+}
+//# sourceMappingURL=preferences.d.ts.map

package/resources/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../src/resources/preferences.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,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;;;;;;;;;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,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,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,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/preferences.js

@@ -0,0 +1,70 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Preferences = void 0;
+const resource_1 = require("../core/resource.js");
+const path_1 = require("../internal/utils/path.js");
+class Preferences extends resource_1.APIResource {
+    /**
+     * Create a new preference ID for personalized LLM routing.
+     *
+     * A preference ID enables personalized routing by tracking your feedback and
+     * learning your preferences over time. Once created, you can:
+     *
+     * 1. Use it in model_select() calls to get personalized routing decisions
+     * 2. Submit feedback via the feedback endpoint to improve routing quality
+     * 3. Train a custom router specific to your use case
+     *
+     * **Workflow:**
+     *
+     * 1. Create a preference ID (this endpoint)
+     * 2. Use the preference_id in POST /v2/modelRouter/modelSelect requests
+     * 3. Submit feedback on routing decisions via POST /v2/report/metrics/feedback
+     * 4. Optionally train a custom router via POST /v2/pzn/trainCustomRouter
+     *
+     * **Benefits:**
+     *
+     * - Personalized routing that learns from your feedback
+     * - Improved accuracy for your specific use case
+     * - Ability to train custom routers on your evaluation data
+     *
+     * **Note:** If you don't provide a preference_id in model_select() calls, the
+     * default router will be used.
+     *
+     * @example
+     * ```ts
+     * const preference = await client.preferences.create();
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v2/preferences/userPreferenceCreate', { body, ...options });
+    }
+    /**
+     * Update User Preference
+     *
+     * @example
+     * ```ts
+     * const preference = await client.preferences.update({
+     *   preference_id: 'preference_id',
+     * });
+     * ```
+     */
+    update(body, options) {
+        return this._client.put('/v2/preferences/userPreferenceUpdate', { body, ...options });
+    }
+    /**
+     * Delete User Preference
+     *
+     * @example
+     * ```ts
+     * const preference = await client.preferences.delete(
+     *   'preference_id',
+     * );
+     * ```
+     */
+    delete(preferenceID, options) {
+        return this._client.delete((0, path_1.path) `/v2/preferences/userPreferenceDelete/${preferenceID}`, options);
+    }
+}
+exports.Preferences = Preferences;
+//# sourceMappingURL=preferences.js.map

package/resources/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../src/resources/preferences.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAA8C;AAE9C,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sCAAsC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,YAAoB,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,wCAAwC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;IAClG,CAAC;CACF;AA/DD,kCA+DC"}

package/resources/preferences.mjs

@@ -0,0 +1,66 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { path } from "../internal/utils/path.mjs";
+export class Preferences extends APIResource {
+    /**
+     * Create a new preference ID for personalized LLM routing.
+     *
+     * A preference ID enables personalized routing by tracking your feedback and
+     * learning your preferences over time. Once created, you can:
+     *
+     * 1. Use it in model_select() calls to get personalized routing decisions
+     * 2. Submit feedback via the feedback endpoint to improve routing quality
+     * 3. Train a custom router specific to your use case
+     *
+     * **Workflow:**
+     *
+     * 1. Create a preference ID (this endpoint)
+     * 2. Use the preference_id in POST /v2/modelRouter/modelSelect requests
+     * 3. Submit feedback on routing decisions via POST /v2/report/metrics/feedback
+     * 4. Optionally train a custom router via POST /v2/pzn/trainCustomRouter
+     *
+     * **Benefits:**
+     *
+     * - Personalized routing that learns from your feedback
+     * - Improved accuracy for your specific use case
+     * - Ability to train custom routers on your evaluation data
+     *
+     * **Note:** If you don't provide a preference_id in model_select() calls, the
+     * default router will be used.
+     *
+     * @example
+     * ```ts
+     * const preference = await client.preferences.create();
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v2/preferences/userPreferenceCreate', { body, ...options });
+    }
+    /**
+     * Update User Preference
+     *
+     * @example
+     * ```ts
+     * const preference = await client.preferences.update({
+     *   preference_id: 'preference_id',
+     * });
+     * ```
+     */
+    update(body, options) {
+        return this._client.put('/v2/preferences/userPreferenceUpdate', { body, ...options });
+    }
+    /**
+     * Delete User Preference
+     *
+     * @example
+     * ```ts
+     * const preference = await client.preferences.delete(
+     *   'preference_id',
+     * );
+     * ```
+     */
+    delete(preferenceID, options) {
+        return this._client.delete(path `/v2/preferences/userPreferenceDelete/${preferenceID}`, options);
+    }
+}
+//# sourceMappingURL=preferences.mjs.map

package/resources/preferences.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.mjs","sourceRoot":"","sources":["../src/resources/preferences.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sCAAsC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,YAAoB,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,wCAAwC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;IAClG,CAAC;CACF"}