notdiamond 2.0.0-rc2 → 2.0.0-rc20

package/internal/uploads.d.ts

@@ -1,6 +1,6 @@
 import { type RequestOptions } from "./request-options.js";
 import type { FilePropertyBag, Fetch } from "./builtin-types.js";
-import type { NotDiamond } from "../client.js";
+import type { Notdiamond } from "../client.js";
 export type BlobPart = string | ArrayBuffer | ArrayBufferView | Blob | DataView;
 type FsReadStream = AsyncIterable<Uint8Array> & {
     path: string | {
@@ -32,11 +32,11 @@ export declare const isAsyncIterable: (value: any) => value is AsyncIterable<any
  * Returns a multipart/form-data request if any part of the given request body contains a File / Blob value.
  * Otherwise returns the request as is.
  */
-export declare const maybeMultipartFormRequestOptions: (opts: RequestOptions, fetch: NotDiamond | Fetch) => Promise<RequestOptions>;
+export declare const maybeMultipartFormRequestOptions: (opts: RequestOptions, fetch: Notdiamond | Fetch) => Promise<RequestOptions>;
 type MultipartFormRequestOptions = Omit<RequestOptions, 'body'> & {
     body: unknown;
 };
-export declare const multipartFormRequestOptions: (opts: MultipartFormRequestOptions, fetch: NotDiamond | Fetch) => Promise<RequestOptions>;
-export declare const createForm: <T = Record<string, unknown>>(body: T | undefined, fetch: NotDiamond | Fetch) => Promise<FormData>;
+export declare const multipartFormRequestOptions: (opts: MultipartFormRequestOptions, fetch: Notdiamond | Fetch) => Promise<RequestOptions>;
+export declare const createForm: <T = Record<string, unknown>>(body: T | undefined, fetch: Notdiamond | Fetch) => Promise<FormData>;
 export {};
 //# sourceMappingURL=uploads.d.ts.map

package/internal/utils/base64.js

@@ -16,7 +16,7 @@ const toBase64 = (data) => {
     if (typeof btoa !== 'undefined') {
         return btoa(String.fromCharCode.apply(null, data));
     }
-    throw new error_1.NotDiamondError('Cannot generate base64 string; Expected `Buffer` or `btoa` to be defined');
+    throw new error_1.NotdiamondError('Cannot generate base64 string; Expected `Buffer` or `btoa` to be defined');
 };
 exports.toBase64 = toBase64;
 const fromBase64 = (str) => {
@@ -32,7 +32,7 @@ const fromBase64 = (str) => {
         }
         return buf;
     }
-    throw new error_1.NotDiamondError('Cannot decode base64 string; Expected `Buffer` or `atob` to be defined');
+    throw new error_1.NotdiamondError('Cannot decode base64 string; Expected `Buffer` or `atob` to be defined');
 };
 exports.fromBase64 = fromBase64;
 //# sourceMappingURL=base64.js.map

package/internal/utils/base64.mjs

@@ -1,5 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-import { NotDiamondError } from "../../core/error.mjs";
+import { NotdiamondError } from "../../core/error.mjs";
 import { encodeUTF8 } from "./bytes.mjs";
 export const toBase64 = (data) => {
     if (!data)
@@ -13,7 +13,7 @@ export const toBase64 = (data) => {
     if (typeof btoa !== 'undefined') {
         return btoa(String.fromCharCode.apply(null, data));
     }
-    throw new NotDiamondError('Cannot generate base64 string; Expected `Buffer` or `btoa` to be defined');
+    throw new NotdiamondError('Cannot generate base64 string; Expected `Buffer` or `btoa` to be defined');
 };
 export const fromBase64 = (str) => {
     if (typeof globalThis.Buffer !== 'undefined') {
@@ -28,6 +28,6 @@ export const fromBase64 = (str) => {
         }
         return buf;
     }
-    throw new NotDiamondError('Cannot decode base64 string; Expected `Buffer` or `atob` to be defined');
+    throw new NotdiamondError('Cannot decode base64 string; Expected `Buffer` or `atob` to be defined');
 };
 //# sourceMappingURL=base64.mjs.map

package/internal/utils/env.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.mts","sourceRoot":"","sources":["../../src/internal/utils/env.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAQ9C,CAAC"}
+{"version":3,"file":"env.d.mts","sourceRoot":"","sources":["../../src/internal/utils/env.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAU9C,CAAC"}

package/internal/utils/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/internal/utils/env.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAQ9C,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/internal/utils/env.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAU9C,CAAC"}

package/internal/utils/env.js

@@ -11,10 +11,12 @@ exports.readEnv = void 0;
  */
 const readEnv = (env) => {
     if (typeof globalThis.process !== 'undefined') {
-        return globalThis.process.env?.[env]?.trim() ?? undefined;
+        const value = globalThis.process.env?.[env]?.trim() ?? undefined;
+        return value === '' ? undefined : value;
     }
     if (typeof globalThis.Deno !== 'undefined') {
-        return globalThis.Deno.env?.get?.(env)?.trim();
+        const value = globalThis.Deno.env?.get?.(env)?.trim();
+        return value === '' ? undefined : value;
     }
     return undefined;
 };

package/internal/utils/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/internal/utils/env.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF;;;;;;GAMG;AACI,MAAM,OAAO,GAAG,CAAC,GAAW,EAAsB,EAAE;IACzD,IAAI,OAAQ,UAAkB,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACvD,OAAQ,UAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACrE,CAAC;IACD,IAAI,OAAQ,UAAkB,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACpD,OAAQ,UAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AARW,QAAA,OAAO,WAQlB"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/internal/utils/env.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF;;;;;;GAMG;AACI,MAAM,OAAO,GAAG,CAAC,GAAW,EAAsB,EAAE;IACzD,IAAI,OAAQ,UAAkB,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACvD,MAAM,KAAK,GAAI,UAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QAC1E,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1C,CAAC;IACD,IAAI,OAAQ,UAAkB,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACpD,MAAM,KAAK,GAAI,UAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;QAC/D,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAVW,QAAA,OAAO,WAUlB"}

package/internal/utils/env.mjs

@@ -8,10 +8,12 @@
  */
 export const readEnv = (env) => {
     if (typeof globalThis.process !== 'undefined') {
-        return globalThis.process.env?.[env]?.trim() ?? undefined;
+        const value = globalThis.process.env?.[env]?.trim() ?? undefined;
+        return value === '' ? undefined : value;
     }
     if (typeof globalThis.Deno !== 'undefined') {
-        return globalThis.Deno.env?.get?.(env)?.trim();
+        const value = globalThis.Deno.env?.get?.(env)?.trim();
+        return value === '' ? undefined : value;
     }
     return undefined;
 };

package/internal/utils/env.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.mjs","sourceRoot":"","sources":["../../src/internal/utils/env.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAsB,EAAE;IACzD,IAAI,OAAQ,UAAkB,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACvD,OAAQ,UAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACrE,CAAC;IACD,IAAI,OAAQ,UAAkB,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACpD,OAAQ,UAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}
+{"version":3,"file":"env.mjs","sourceRoot":"","sources":["../../src/internal/utils/env.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAsB,EAAE;IACzD,IAAI,OAAQ,UAAkB,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACvD,MAAM,KAAK,GAAI,UAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QAC1E,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1C,CAAC;IACD,IAAI,OAAQ,UAAkB,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACpD,MAAM,KAAK,GAAI,UAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;QAC/D,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/internal/utils/log.d.mts

@@ -1,4 +1,4 @@
-import { type NotDiamond } from "../../client.mjs";
+import { type Notdiamond } from "../../client.mjs";
 import { RequestOptions } from "../request-options.mjs";
 type LogFn = (message: string, ...rest: unknown[]) => void;
 export type Logger = {
@@ -8,8 +8,8 @@ export type Logger = {
     debug: LogFn;
 };
 export type LogLevel = 'off' | 'error' | 'warn' | 'info' | 'debug';
-export declare const parseLogLevel: (maybeLevel: string | undefined, sourceName: string, client: NotDiamond) => LogLevel | undefined;
-export declare function loggerFor(client: NotDiamond): Logger;
+export declare const parseLogLevel: (maybeLevel: string | undefined, sourceName: string, client: Notdiamond) => LogLevel | undefined;
+export declare function loggerFor(client: Notdiamond): Logger;
 export declare const formatRequestDetails: (details: {
     options?: RequestOptions | undefined;
     headers?: Headers | Record<string, string> | undefined;

package/internal/utils/log.d.ts

@@ -1,4 +1,4 @@
-import { type NotDiamond } from "../../client.js";
+import { type Notdiamond } from "../../client.js";
 import { RequestOptions } from "../request-options.js";
 type LogFn = (message: string, ...rest: unknown[]) => void;
 export type Logger = {
@@ -8,8 +8,8 @@ export type Logger = {
     debug: LogFn;
 };
 export type LogLevel = 'off' | 'error' | 'warn' | 'info' | 'debug';
-export declare const parseLogLevel: (maybeLevel: string | undefined, sourceName: string, client: NotDiamond) => LogLevel | undefined;
-export declare function loggerFor(client: NotDiamond): Logger;
+export declare const parseLogLevel: (maybeLevel: string | undefined, sourceName: string, client: Notdiamond) => LogLevel | undefined;
+export declare function loggerFor(client: Notdiamond): Logger;
 export declare const formatRequestDetails: (details: {
     options?: RequestOptions | undefined;
     headers?: Headers | Record<string, string> | undefined;

package/internal/utils/path.js

@@ -65,7 +65,7 @@ const createPathTagFunction = (pathEncoder = encodeURIPath) => function path(sta
             lastEnd = segment.start + segment.length;
             return acc + spaces + arrows;
         }, '');
-        throw new error_1.NotDiamondError(`Path parameters result in path with invalid segments:\n${invalidSegments
+        throw new error_1.NotdiamondError(`Path parameters result in path with invalid segments:\n${invalidSegments
             .map((e) => e.error)
             .join('\n')}\n${path}\n${underline}`);
     }

package/internal/utils/path.mjs

@@ -1,4 +1,4 @@
-import { NotDiamondError } from "../../core/error.mjs";
+import { NotdiamondError } from "../../core/error.mjs";
 /**
  * Percent-encode everything that isn't safe to have in a path without encoding safe chars.
  *
@@ -61,7 +61,7 @@ export const createPathTagFunction = (pathEncoder = encodeURIPath) => function p
             lastEnd = segment.start + segment.length;
             return acc + spaces + arrows;
         }, '');
-        throw new NotDiamondError(`Path parameters result in path with invalid segments:\n${invalidSegments
+        throw new NotdiamondError(`Path parameters result in path with invalid segments:\n${invalidSegments
             .map((e) => e.error)
             .join('\n')}\n${path}\n${underline}`);
     }

package/internal/utils/values.js

@@ -40,17 +40,17 @@ function isObj(obj) {
 }
 const ensurePresent = (value) => {
     if (value == null) {
-        throw new error_1.NotDiamondError(`Expected a value to be given but received ${value} instead.`);
+        throw new error_1.NotdiamondError(`Expected a value to be given but received ${value} instead.`);
     }
     return value;
 };
 exports.ensurePresent = ensurePresent;
 const validatePositiveInteger = (name, n) => {
     if (typeof n !== 'number' || !Number.isInteger(n)) {
-        throw new error_1.NotDiamondError(`${name} must be an integer`);
+        throw new error_1.NotdiamondError(`${name} must be an integer`);
     }
     if (n < 0) {
-        throw new error_1.NotDiamondError(`${name} must be a positive integer`);
+        throw new error_1.NotdiamondError(`${name} must be a positive integer`);
     }
     return n;
 };
@@ -60,7 +60,7 @@ const coerceInteger = (value) => {
         return Math.round(value);
     if (typeof value === 'string')
         return parseInt(value, 10);
-    throw new error_1.NotDiamondError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+    throw new error_1.NotdiamondError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
 };
 exports.coerceInteger = coerceInteger;
 const coerceFloat = (value) => {
@@ -68,7 +68,7 @@ const coerceFloat = (value) => {
         return value;
     if (typeof value === 'string')
         return parseFloat(value);
-    throw new error_1.NotDiamondError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+    throw new error_1.NotdiamondError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
 };
 exports.coerceFloat = coerceFloat;
 const coerceBoolean = (value) => {

package/internal/utils/values.mjs

@@ -1,5 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-import { NotDiamondError } from "../../core/error.mjs";
+import { NotdiamondError } from "../../core/error.mjs";
 // https://url.spec.whatwg.org/#url-scheme-string
 const startsWithSchemeRegexp = /^[a-z][a-z0-9+.-]*:/i;
 export const isAbsoluteURL = (url) => {
@@ -31,16 +31,16 @@ export function isObj(obj) {
 }
 export const ensurePresent = (value) => {
     if (value == null) {
-        throw new NotDiamondError(`Expected a value to be given but received ${value} instead.`);
+        throw new NotdiamondError(`Expected a value to be given but received ${value} instead.`);
     }
     return value;
 };
 export const validatePositiveInteger = (name, n) => {
     if (typeof n !== 'number' || !Number.isInteger(n)) {
-        throw new NotDiamondError(`${name} must be an integer`);
+        throw new NotdiamondError(`${name} must be an integer`);
     }
     if (n < 0) {
-        throw new NotDiamondError(`${name} must be a positive integer`);
+        throw new NotdiamondError(`${name} must be a positive integer`);
     }
     return n;
 };
@@ -49,14 +49,14 @@ export const coerceInteger = (value) => {
         return Math.round(value);
     if (typeof value === 'string')
         return parseInt(value, 10);
-    throw new NotDiamondError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+    throw new NotdiamondError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
 };
 export const coerceFloat = (value) => {
     if (typeof value === 'number')
         return value;
     if (typeof value === 'string')
         return parseFloat(value);
-    throw new NotDiamondError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+    throw new NotdiamondError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
 };
 export const coerceBoolean = (value) => {
     if (typeof value === 'boolean')

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "notdiamond",
-  "version": "2.0.0-rc2",
-  "description": "The official TypeScript library for the Not Diamond API",
-  "author": "Not Diamond <d6@notdiamond.ai>",
+  "version": "2.0.0-rc20",
+  "description": "The official TypeScript library for the Notdiamond API",
+  "author": "Notdiamond <contact@notdiamond.ai>",
   "types": "./index.d.ts",
   "main": "./index.js",
   "type": "commonjs",
   "repository": "github:Not-Diamond/not-diamond-typescript",
   "license": "Apache-2.0",
-  "packageManager": "yarn@1.22.22",
   "files": [
     "**/*"
   ],
@@ -16,14 +15,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "test": "./scripts/test",
-    "build": "./scripts/build",
-    "format": "./scripts/format",
-    "tsn": "ts-node -r tsconfig-paths/register",
-    "lint": "./scripts/lint",
-    "fix": "./scripts/format"
-  },
   "dependencies": {},
   "exports": {
     ".": {
@@ -134,5 +125,13 @@
     "./version.mjs": {
       "default": "./version.mjs"
     }
+  },
+  "scripts": {
+    "test": "./scripts/test",
+    "build": "./scripts/build",
+    "format": "./scripts/format",
+    "tsn": "ts-node -r tsconfig-paths/register",
+    "lint": "./scripts/lint",
+    "fix": "./scripts/format"
   }
 }

package/resources/custom-router.d.mts

@@ -0,0 +1,145 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { type Uploadable } from "../core/uploads.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class CustomRouter extends APIResource {
+    /**
+     * Train a custom router on your evaluation data to optimize routing for your
+     * specific use case.
+     *
+     * This endpoint allows you to train a domain-specific router that learns which
+     * models perform best for different types of queries in your application. The
+     * router analyzes your evaluation dataset, clusters similar queries, and learns
+     * model performance patterns.
+     *
+     * **Training Process:**
+     *
+     * 1. Upload a CSV file with your evaluation data
+     * 2. Specify which models to route between
+     * 3. Define the evaluation metric (score column)
+     * 4. The system trains asynchronously and returns a preference_id
+     * 5. Use the preference_id in model_select() calls once training completes
+     *
+     * **Dataset Requirements:**
+     *
+     * - Format: CSV file
+     * - Minimum samples: 25 (more is better for accuracy)
+     * - Required columns:
+     *   - Prompt column (specified in prompt_column parameter)
+     *   - For each model: `{provider}/{model}/score` and `{provider}/{model}/response`
+     *
+     * **Example CSV structure:**
+     *
+     * ```
+     * prompt,openai/gpt-4o/score,openai/gpt-4o/response,anthropic/claude-sonnet-4-5-20250929/score,anthropic/claude-sonnet-4-5-20250929/response
+     * "Explain quantum computing",0.95,"Quantum computing uses...",0.87,"Quantum computers leverage..."
+     * "Write a Python function",0.82,"def my_function()...",0.91,"Here's a Python function..."
+     * ```
+     *
+     * **Model Selection:**
+     *
+     * - Specify standard models: `{"provider": "openai", "model": "gpt-4o"}`
+     * - Or custom models with pricing:
+     *   `{"provider": "custom", "model": "my-model", "is_custom": true, "input_price": 10.0, "output_price": 30.0, "context_length": 8192, "latency": 1.5}`
+     *
+     * **Training Time:**
+     *
+     * - Training is asynchronous and typically takes 5-15 minutes
+     * - Larger datasets or more models take longer
+     * - You'll receive a preference_id immediately
+     * - Check training status by attempting to use the preference_id in model_select()
+     *
+     * **Best Practices:**
+     *
+     * 1. Use diverse, representative examples from your production workload
+     * 2. Include at least 50-100 samples for best results
+     * 3. Ensure consistent evaluation metrics across all models
+     * 4. Use the same models you plan to route between in production
+     *
+     * **Related Documentation:** See
+     * https://docs.notdiamond.ai/docs/adapting-prompts-to-new-models for detailed
+     * guide.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.customRouter.trainCustomRouter({
+     *     dataset_file: fs.createReadStream('path/to/file'),
+     *     language: 'english',
+     *     llm_providers:
+     *       '[{"provider": "openai", "model": "gpt-4o"}, {"provider": "anthropic", "model": "claude-sonnet-4-5-20250929"}]',
+     *     maximize: true,
+     *     prompt_column: 'prompt',
+     *   });
+     * ```
+     */
+    trainCustomRouter(body: CustomRouterTrainCustomRouterParams, options?: RequestOptions): APIPromise<CustomRouterTrainCustomRouterResponse>;
+}
+/**
+ * Response model for POST /v2/pzn/trainCustomRouter endpoint.
+ *
+ * Returned immediately after submitting a custom router training request. The
+ * training process runs asynchronously (typically 5-15 minutes), so use the
+ * returned preference_id to make routing calls once training completes.
+ *
+ * **Next steps:**
+ *
+ * 1. Store the preference_id
+ * 2. Wait for training to complete (typically 5-15 minutes)
+ * 3. Use this preference_id in POST /v2/modelRouter/modelSelect requests
+ * 4. The router will use your custom-trained model to make routing decisions
+ *
+ * **How to use the preference_id:**
+ *
+ * - Include it in the 'preference_id' field of model_select() calls
+ * - The system automatically uses your custom router once training is complete
+ * - No need to poll status - you can start using it immediately (will use default
+ *   until ready)
+ */
+export interface CustomRouterTrainCustomRouterResponse {
+    /**
+     * Unique identifier for the custom router. Use this in model_select() calls to
+     * enable routing with your custom-trained router
+     */
+    preference_id: string;
+}
+export interface CustomRouterTrainCustomRouterParams {
+    /**
+     * CSV file containing evaluation data with prompt column and score/response
+     * columns for each model
+     */
+    dataset_file: Uploadable;
+    /**
+     * Language of the evaluation data. Use 'english' for English-only data or
+     * 'multilingual' for multi-language support
+     */
+    language: string;
+    /**
+     * JSON string array of LLM providers to train the router on. Format:
+     * '[{"provider": "openai", "model": "gpt-4o"}, {"provider": "anthropic", "model":
+     * "claude-sonnet-4-5-20250929"}]'
+     */
+    llm_providers: string;
+    /**
+     * Whether higher scores are better. Set to true if higher scores indicate better
+     * performance, false otherwise
+     */
+    maximize: boolean;
+    /**
+     * Name of the column in the CSV file that contains the prompts
+     */
+    prompt_column: string;
+    /**
+     * Whether to override an existing custom router for this preference_id
+     */
+    override?: boolean | null;
+    /**
+     * Optional preference ID to update an existing router. If not provided, a new
+     * preference will be created
+     */
+    preference_id?: string | null;
+}
+export declare namespace CustomRouter {
+    export { type CustomRouterTrainCustomRouterResponse as CustomRouterTrainCustomRouterResponse, type CustomRouterTrainCustomRouterParams as CustomRouterTrainCustomRouterParams, };
+}
+//# sourceMappingURL=custom-router.d.mts.map

package/resources/custom-router.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-router.d.mts","sourceRoot":"","sources":["../src/resources/custom-router.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,KAAK,UAAU,EAAE;OACnB,EAAE,cAAc,EAAE;AAGzB,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqEG;IACH,iBAAiB,CACf,IAAI,EAAE,mCAAmC,EACzC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qCAAqC,CAAC;CAMrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,qCAAqC;IACpD;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mCAAmC;IAClD;;;OAGG;IACH,YAAY,EAAE,UAAU,CAAC;IAEzB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,qCAAqC,IAAI,qCAAqC,EACnF,KAAK,mCAAmC,IAAI,mCAAmC,GAChF,CAAC;CACH"}

package/resources/custom-router.d.ts

@@ -0,0 +1,145 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { type Uploadable } from "../core/uploads.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class CustomRouter extends APIResource {
+    /**
+     * Train a custom router on your evaluation data to optimize routing for your
+     * specific use case.
+     *
+     * This endpoint allows you to train a domain-specific router that learns which
+     * models perform best for different types of queries in your application. The
+     * router analyzes your evaluation dataset, clusters similar queries, and learns
+     * model performance patterns.
+     *
+     * **Training Process:**
+     *
+     * 1. Upload a CSV file with your evaluation data
+     * 2. Specify which models to route between
+     * 3. Define the evaluation metric (score column)
+     * 4. The system trains asynchronously and returns a preference_id
+     * 5. Use the preference_id in model_select() calls once training completes
+     *
+     * **Dataset Requirements:**
+     *
+     * - Format: CSV file
+     * - Minimum samples: 25 (more is better for accuracy)
+     * - Required columns:
+     *   - Prompt column (specified in prompt_column parameter)
+     *   - For each model: `{provider}/{model}/score` and `{provider}/{model}/response`
+     *
+     * **Example CSV structure:**
+     *
+     * ```
+     * prompt,openai/gpt-4o/score,openai/gpt-4o/response,anthropic/claude-sonnet-4-5-20250929/score,anthropic/claude-sonnet-4-5-20250929/response
+     * "Explain quantum computing",0.95,"Quantum computing uses...",0.87,"Quantum computers leverage..."
+     * "Write a Python function",0.82,"def my_function()...",0.91,"Here's a Python function..."
+     * ```
+     *
+     * **Model Selection:**
+     *
+     * - Specify standard models: `{"provider": "openai", "model": "gpt-4o"}`
+     * - Or custom models with pricing:
+     *   `{"provider": "custom", "model": "my-model", "is_custom": true, "input_price": 10.0, "output_price": 30.0, "context_length": 8192, "latency": 1.5}`
+     *
+     * **Training Time:**
+     *
+     * - Training is asynchronous and typically takes 5-15 minutes
+     * - Larger datasets or more models take longer
+     * - You'll receive a preference_id immediately
+     * - Check training status by attempting to use the preference_id in model_select()
+     *
+     * **Best Practices:**
+     *
+     * 1. Use diverse, representative examples from your production workload
+     * 2. Include at least 50-100 samples for best results
+     * 3. Ensure consistent evaluation metrics across all models
+     * 4. Use the same models you plan to route between in production
+     *
+     * **Related Documentation:** See
+     * https://docs.notdiamond.ai/docs/adapting-prompts-to-new-models for detailed
+     * guide.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.customRouter.trainCustomRouter({
+     *     dataset_file: fs.createReadStream('path/to/file'),
+     *     language: 'english',
+     *     llm_providers:
+     *       '[{"provider": "openai", "model": "gpt-4o"}, {"provider": "anthropic", "model": "claude-sonnet-4-5-20250929"}]',
+     *     maximize: true,
+     *     prompt_column: 'prompt',
+     *   });
+     * ```
+     */
+    trainCustomRouter(body: CustomRouterTrainCustomRouterParams, options?: RequestOptions): APIPromise<CustomRouterTrainCustomRouterResponse>;
+}
+/**
+ * Response model for POST /v2/pzn/trainCustomRouter endpoint.
+ *
+ * Returned immediately after submitting a custom router training request. The
+ * training process runs asynchronously (typically 5-15 minutes), so use the
+ * returned preference_id to make routing calls once training completes.
+ *
+ * **Next steps:**
+ *
+ * 1. Store the preference_id
+ * 2. Wait for training to complete (typically 5-15 minutes)
+ * 3. Use this preference_id in POST /v2/modelRouter/modelSelect requests
+ * 4. The router will use your custom-trained model to make routing decisions
+ *
+ * **How to use the preference_id:**
+ *
+ * - Include it in the 'preference_id' field of model_select() calls
+ * - The system automatically uses your custom router once training is complete
+ * - No need to poll status - you can start using it immediately (will use default
+ *   until ready)
+ */
+export interface CustomRouterTrainCustomRouterResponse {
+    /**
+     * Unique identifier for the custom router. Use this in model_select() calls to
+     * enable routing with your custom-trained router
+     */
+    preference_id: string;
+}
+export interface CustomRouterTrainCustomRouterParams {
+    /**
+     * CSV file containing evaluation data with prompt column and score/response
+     * columns for each model
+     */
+    dataset_file: Uploadable;
+    /**
+     * Language of the evaluation data. Use 'english' for English-only data or
+     * 'multilingual' for multi-language support
+     */
+    language: string;
+    /**
+     * JSON string array of LLM providers to train the router on. Format:
+     * '[{"provider": "openai", "model": "gpt-4o"}, {"provider": "anthropic", "model":
+     * "claude-sonnet-4-5-20250929"}]'
+     */
+    llm_providers: string;
+    /**
+     * Whether higher scores are better. Set to true if higher scores indicate better
+     * performance, false otherwise
+     */
+    maximize: boolean;
+    /**
+     * Name of the column in the CSV file that contains the prompts
+     */
+    prompt_column: string;
+    /**
+     * Whether to override an existing custom router for this preference_id
+     */
+    override?: boolean | null;
+    /**
+     * Optional preference ID to update an existing router. If not provided, a new
+     * preference will be created
+     */
+    preference_id?: string | null;
+}
+export declare namespace CustomRouter {
+    export { type CustomRouterTrainCustomRouterResponse as CustomRouterTrainCustomRouterResponse, type CustomRouterTrainCustomRouterParams as CustomRouterTrainCustomRouterParams, };
+}
+//# sourceMappingURL=custom-router.d.ts.map

package/resources/custom-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-router.d.ts","sourceRoot":"","sources":["../src/resources/custom-router.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,KAAK,UAAU,EAAE;OACnB,EAAE,cAAc,EAAE;AAGzB,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqEG;IACH,iBAAiB,CACf,IAAI,EAAE,mCAAmC,EACzC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qCAAqC,CAAC;CAMrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,qCAAqC;IACpD;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mCAAmC;IAClD;;;OAGG;IACH,YAAY,EAAE,UAAU,CAAC;IAEzB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,qCAAqC,IAAI,qCAAqC,EACnF,KAAK,mCAAmC,IAAI,mCAAmC,GAChF,CAAC;CACH"}