notdiamond 1.1.3 → 2.0.0-rc1

package/resources/index.js

@@ -0,0 +1,17 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Routing = exports.Report = exports.PromptAdaptation = exports.Preferences = exports.Models = exports.Admin = void 0;
+var admin_1 = require("./admin.js");
+Object.defineProperty(exports, "Admin", { enumerable: true, get: function () { return admin_1.Admin; } });
+var models_1 = require("./models.js");
+Object.defineProperty(exports, "Models", { enumerable: true, get: function () { return models_1.Models; } });
+var preferences_1 = require("./preferences.js");
+Object.defineProperty(exports, "Preferences", { enumerable: true, get: function () { return preferences_1.Preferences; } });
+var prompt_adaptation_1 = require("./prompt-adaptation.js");
+Object.defineProperty(exports, "PromptAdaptation", { enumerable: true, get: function () { return prompt_adaptation_1.PromptAdaptation; } });
+var report_1 = require("./report.js");
+Object.defineProperty(exports, "Report", { enumerable: true, get: function () { return report_1.Report; } });
+var routing_1 = require("./routing.js");
+Object.defineProperty(exports, "Routing", { enumerable: true, get: function () { return routing_1.Routing; } });
+//# sourceMappingURL=index.js.map

package/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,oCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,sCAAgF;AAAvE,gGAAA,MAAM,OAAA;AACf,gDASuB;AARrB,0GAAA,WAAW,OAAA;AASb,4DAW6B;AAV3B,qHAAA,gBAAgB,OAAA;AAWlB,sCAQkB;AAPhB,gGAAA,MAAM,OAAA;AAQR,wCAQmB;AAPjB,kGAAA,OAAO,OAAA"}

package/resources/index.mjs

@@ -0,0 +1,8 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Admin } from "./admin.mjs";
+export { Models } from "./models.mjs";
+export { Preferences, } from "./preferences.mjs";
+export { PromptAdaptation, } from "./prompt-adaptation.mjs";
+export { Report, } from "./report.mjs";
+export { Routing, } from "./routing.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,KAAK,EAAE;OACT,EAAE,MAAM,EAAgD;OACxD,EACL,WAAW,GAQZ;OACM,EACL,gBAAgB,GAUjB;OACM,EACL,MAAM,GAOP;OACM,EACL,OAAO,GAOR"}

package/resources/models.d.mts

@@ -0,0 +1,85 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+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)
+     */
+    list(query?: ModelListParams | null | undefined, options?: RequestOptions): APIPromise<ModelListResponse>;
+}
+/**
+ * Response for models list endpoint.
+ */
+export interface ModelListResponse {
+    deprecated_models: Array<ModelListResponse.DeprecatedModel>;
+    models: Array<ModelListResponse.Model>;
+    total: number;
+}
+export declare namespace ModelListResponse {
+    /**
+     * Response model for a single LLM provider.
+     */
+    interface DeprecatedModel {
+        context_length: number;
+        input_price: number;
+        model: string;
+        output_price: number;
+        provider: string;
+        openrouter_model?: string | null;
+    }
+    /**
+     * Response model for a single LLM provider.
+     */
+    interface Model {
+        context_length: number;
+        input_price: number;
+        model: string;
+        output_price: number;
+        provider: string;
+        openrouter_model?: string | null;
+    }
+}
+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 ModelListResponse as ModelListResponse, type ModelListParams as ModelListParams };
+}
+//# sourceMappingURL=models.d.mts.map

package/resources/models.d.mts.map

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

package/resources/models.d.ts

@@ -0,0 +1,85 @@
+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)
+     */
+    list(query?: ModelListParams | null | undefined, options?: RequestOptions): APIPromise<ModelListResponse>;
+}
+/**
+ * Response for models list endpoint.
+ */
+export interface ModelListResponse {
+    deprecated_models: Array<ModelListResponse.DeprecatedModel>;
+    models: Array<ModelListResponse.Model>;
+    total: number;
+}
+export declare namespace ModelListResponse {
+    /**
+     * Response model for a single LLM provider.
+     */
+    interface DeprecatedModel {
+        context_length: number;
+        input_price: number;
+        model: string;
+        output_price: number;
+        provider: string;
+        openrouter_model?: string | null;
+    }
+    /**
+     * Response model for a single LLM provider.
+     */
+    interface Model {
+        context_length: number;
+        input_price: number;
+        model: string;
+        output_price: number;
+        provider: string;
+        openrouter_model?: string | null;
+    }
+}
+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 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}

package/resources/models.js

@@ -0,0 +1,44 @@
+"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)
+     */
+    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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}

package/resources/models.mjs

@@ -0,0 +1,40 @@
+// 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)
+     */
+    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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}

package/resources/preferences.d.mts

@@ -0,0 +1,111 @@
+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.
+     *
+     * 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 response =
+     *   await client.preferences.createUserPreference();
+     * ```
+     */
+    createUserPreference(body: PreferenceCreateUserPreferenceParams, options?: RequestOptions): APIPromise<PreferenceCreateUserPreferenceResponse>;
+    /**
+     * Delete User Preference
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.preferences.deleteUserPreference(
+     *     'preference_id',
+     *   );
+     * ```
+     */
+    deleteUserPreference(preferenceID: string, options?: RequestOptions): APIPromise<unknown>;
+    /**
+     * Update User Preference
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.preferences.updateUserPreference({
+     *     preference_id: 'preference_id',
+     *   });
+     * ```
+     */
+    updateUserPreference(body: PreferenceUpdateUserPreferenceParams, options?: RequestOptions): APIPromise<unknown>;
+}
+export type PreferenceRetrieveResponse = unknown;
+/**
+ * Response from preference creation endpoint.
+ */
+export interface PreferenceCreateUserPreferenceResponse {
+    /**
+     * The newly created preference ID. Use this in model_select() calls for
+     * 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 {
+    /**
+     * Optional name for the preference
+     */
+    name?: string | null;
+}
+export interface PreferenceUpdateUserPreferenceParams {
+    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, };
+}
+//# 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;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"}

package/resources/preferences.d.ts

@@ -0,0 +1,111 @@
+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 {
+    /**
+     * 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.
+     *
+     * 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 response =
+     *   await client.preferences.createUserPreference();
+     * ```
+     */
+    createUserPreference(body: PreferenceCreateUserPreferenceParams, options?: RequestOptions): APIPromise<PreferenceCreateUserPreferenceResponse>;
+    /**
+     * Delete User Preference
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.preferences.deleteUserPreference(
+     *     'preference_id',
+     *   );
+     * ```
+     */
+    deleteUserPreference(preferenceID: string, options?: RequestOptions): APIPromise<unknown>;
+    /**
+     * Update User Preference
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.preferences.updateUserPreference({
+     *     preference_id: 'preference_id',
+     *   });
+     * ```
+     */
+    updateUserPreference(body: PreferenceUpdateUserPreferenceParams, options?: RequestOptions): APIPromise<unknown>;
+}
+export type PreferenceRetrieveResponse = unknown;
+/**
+ * Response from preference creation endpoint.
+ */
+export interface PreferenceCreateUserPreferenceResponse {
+    /**
+     * The newly created preference ID. Use this in model_select() calls for
+     * 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 {
+    /**
+     * Optional name for the preference
+     */
+    name?: string | null;
+}
+export interface PreferenceUpdateUserPreferenceParams {
+    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, };
+}
+//# 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;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"}

package/resources/preferences.js

@@ -0,0 +1,92 @@
+"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 headers_1 = require("../internal/headers.js");
+const path_1 = require("../internal/utils/path.js");
+class Preferences extends resource_1.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, params, options) {
+        const { user_id, 'x-token': xToken } = params;
+        return this._client.get((0, path_1.path) `/v2/preferences/${user_id}/${preferenceID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ 'x-token': xToken }, options?.headers]),
+        });
+    }
+    /**
+     * 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 response =
+     *   await client.preferences.createUserPreference();
+     * ```
+     */
+    createUserPreference(body, options) {
+        return this._client.post('/v2/preferences/userPreferenceCreate', { body, ...options });
+    }
+    /**
+     * Delete User Preference
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.preferences.deleteUserPreference(
+     *     'preference_id',
+     *   );
+     * ```
+     */
+    deleteUserPreference(preferenceID, options) {
+        return this._client.delete((0, path_1.path) `/v2/preferences/userPreferenceDelete/${preferenceID}`, options);
+    }
+    /**
+     * Update User Preference
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.preferences.updateUserPreference({
+     *     preference_id: 'preference_id',
+     *   });
+     * ```
+     */
+    updateUserPreference(body, options) {
+        return this._client.put('/v2/preferences/userPreferenceUpdate', { body, ...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;AAE/C,oDAAmD;AAEnD,oDAA8C;AAE9C,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;OAUG;IACH,QAAQ,CACN,YAAoB,EACpB,MAAgC,EAChC,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,mBAAmB,OAAO,IAAI,YAAY,EAAE,EAAE;YACxE,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SACjE,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,oBAAoB,CAClB,IAA0C,EAC1C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,YAAoB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,wCAAwC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;IAClG,CAAC;IAED;;;;;;;;;;OAUG;IACH,oBAAoB,CAClB,IAA0C,EAC1C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sCAAsC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;CACF;AA/FD,kCA+FC"}