notdiamond 2.0.0-rc1 → 2.0.0-rc4

package/resources/model-router.d.mts

@@ -0,0 +1,311 @@
+import { APIResource } from "../core/resource.mjs";
+import * as AdaptAPI from "./prompt/adapt.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare 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: ModelRouterOpenHandsSelectParams, options?: RequestOptions): APIPromise<unknown>;
+    /**
+     * 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: ModelRouterSelectModelParams, options?: RequestOptions): APIPromise<ModelRouterSelectModelResponse>;
+}
+export type ModelRouterOpenHandsSelectResponse = unknown;
+/**
+ * Response from model selection endpoint.
+ */
+export interface ModelRouterSelectModelResponse {
+    /**
+     * List containing the selected provider
+     */
+    providers: Array<ModelRouterSelectModelResponse.Provider>;
+    /**
+     * Unique session ID for this routing decision
+     */
+    session_id: string;
+}
+export declare namespace ModelRouterSelectModelResponse {
+    /**
+     * Selected LLM provider information from model selection endpoints.
+     *
+     * Part of ModelSelectResponse. Contains the provider and model that Not Diamond's
+     * routing algorithm selected as optimal for your query. Use these values to make
+     * your LLM API call to the recommended model.
+     */
+    interface Provider {
+        /**
+         * Model identifier for the selected model (e.g., 'gpt-4o',
+         * 'claude-3-opus-20240229')
+         */
+        model: string;
+        /**
+         * Provider name for the selected model (e.g., 'openai', 'anthropic', 'google')
+         */
+        provider: string;
+    }
+}
+export interface ModelRouterOpenHandsSelectParams {
+    /**
+     * List of LLM providers to route between. Specify at least one provider in format
+     * {provider, model}
+     */
+    llm_providers: Array<AdaptAPI.RequestProvider | ModelRouterOpenHandsSelectParams.OpenRouterProvider>;
+    /**
+     * Array of message objects in OpenAI format (with 'role' and 'content' keys)
+     */
+    messages: Array<{
+        [key: string]: string | Array<unknown>;
+    }> | string;
+    /**
+     * Whether to hash message content for privacy
+     */
+    hash_content?: boolean;
+    /**
+     * Maximum number of models to consider for routing. If not specified, considers
+     * all provided models
+     */
+    max_model_depth?: number | null;
+    /**
+     * Optimization metric for model selection
+     */
+    metric?: string;
+    /**
+     * Preference ID for personalized routing. Create one via POST
+     * /v2/preferences/userPreferenceCreate
+     */
+    preference_id?: string | null;
+    /**
+     * Previous session ID to link related requests
+     */
+    previous_session?: string | null;
+    /**
+     * OpenAI-format function calling tools
+     */
+    tools?: Array<{
+        [key: string]: unknown;
+    }> | null;
+    /**
+     * Optimization tradeoff strategy. Use 'cost' to prioritize cost savings or
+     * 'latency' to prioritize speed
+     */
+    tradeoff?: string | null;
+}
+export declare namespace ModelRouterOpenHandsSelectParams {
+    /**
+     * Model for specifying an LLM provider using OpenRouter format.
+     *
+     * Used in model routing requests when you want to specify providers using the
+     * OpenRouter naming convention (combined 'provider/model' format). This is an
+     * alternative to the standard RequestProvider which uses separate provider and
+     * model fields.
+     *
+     * **When to use:**
+     *
+     * - When working with OpenRouter-compatible systems
+     * - When you prefer the unified 'provider/model' format
+     * - For models accessed via OpenRouter proxy
+     */
+    interface OpenRouterProvider {
+        /**
+         * OpenRouter model identifier in 'provider/model' format (e.g., 'openai/gpt-4o',
+         * 'anthropic/claude-sonnet-4-5-20250929')
+         */
+        model: string;
+        /**
+         * Maximum context length for the model (required for custom models)
+         */
+        context_length?: number | null;
+        /**
+         * Input token price per million tokens in USD (required for custom models)
+         */
+        input_price?: number | null;
+        /**
+         * Whether this is a custom model not in Not Diamond's supported model list
+         */
+        is_custom?: boolean;
+        /**
+         * Average latency in seconds (required for custom models)
+         */
+        latency?: number | null;
+        /**
+         * Output token price per million tokens in USD (required for custom models)
+         */
+        output_price?: number | null;
+    }
+}
+export interface ModelRouterSelectModelParams {
+    /**
+     * Body param: List of LLM providers to route between. Specify at least one
+     * provider in format {provider, model}
+     */
+    llm_providers: Array<AdaptAPI.RequestProvider | ModelRouterSelectModelParams.OpenRouterProvider>;
+    /**
+     * Body param: Array of message objects in OpenAI format (with 'role' and 'content'
+     * keys)
+     */
+    messages: Array<{
+        [key: string]: string | Array<unknown>;
+    }> | string;
+    /**
+     * Query param: Optional format type. Use 'openrouter' to accept and return
+     * OpenRouter-format model identifiers
+     */
+    type?: string | null;
+    /**
+     * Body param: Whether to hash message content for privacy
+     */
+    hash_content?: boolean;
+    /**
+     * Body param: Maximum number of models to consider for routing. If not specified,
+     * considers all provided models
+     */
+    max_model_depth?: number | null;
+    /**
+     * Body param: Optimization metric for model selection
+     */
+    metric?: string;
+    /**
+     * Body param: Preference ID for personalized routing. Create one via POST
+     * /v2/preferences/userPreferenceCreate
+     */
+    preference_id?: string | null;
+    /**
+     * Body param: Previous session ID to link related requests
+     */
+    previous_session?: string | null;
+    /**
+     * Body param: OpenAI-format function calling tools
+     */
+    tools?: Array<{
+        [key: string]: unknown;
+    }> | null;
+    /**
+     * Body param: Optimization tradeoff strategy. Use 'cost' to prioritize cost
+     * savings or 'latency' to prioritize speed
+     */
+    tradeoff?: string | null;
+}
+export declare namespace ModelRouterSelectModelParams {
+    /**
+     * Model for specifying an LLM provider using OpenRouter format.
+     *
+     * Used in model routing requests when you want to specify providers using the
+     * OpenRouter naming convention (combined 'provider/model' format). This is an
+     * alternative to the standard RequestProvider which uses separate provider and
+     * model fields.
+     *
+     * **When to use:**
+     *
+     * - When working with OpenRouter-compatible systems
+     * - When you prefer the unified 'provider/model' format
+     * - For models accessed via OpenRouter proxy
+     */
+    interface OpenRouterProvider {
+        /**
+         * OpenRouter model identifier in 'provider/model' format (e.g., 'openai/gpt-4o',
+         * 'anthropic/claude-sonnet-4-5-20250929')
+         */
+        model: string;
+        /**
+         * Maximum context length for the model (required for custom models)
+         */
+        context_length?: number | null;
+        /**
+         * Input token price per million tokens in USD (required for custom models)
+         */
+        input_price?: number | null;
+        /**
+         * Whether this is a custom model not in Not Diamond's supported model list
+         */
+        is_custom?: boolean;
+        /**
+         * Average latency in seconds (required for custom models)
+         */
+        latency?: number | null;
+        /**
+         * Output token price per million tokens in USD (required for custom models)
+         */
+        output_price?: number | null;
+    }
+}
+export declare namespace ModelRouter {
+    export { type ModelRouterOpenHandsSelectResponse as ModelRouterOpenHandsSelectResponse, type ModelRouterSelectModelResponse as ModelRouterSelectModelResponse, type ModelRouterOpenHandsSelectParams as ModelRouterOpenHandsSelectParams, type ModelRouterSelectModelParams as ModelRouterSelectModelParams, };
+}
+//# sourceMappingURL=model-router.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.d.mts","sourceRoot":"","sources":["../src/resources/model-router.ts"],"names":[],"mappings":"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"}

package/resources/model-router.d.ts

@@ -0,0 +1,311 @@
+import { APIResource } from "../core/resource.js";
+import * as AdaptAPI from "./prompt/adapt.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare 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: ModelRouterOpenHandsSelectParams, options?: RequestOptions): APIPromise<unknown>;
+    /**
+     * 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: ModelRouterSelectModelParams, options?: RequestOptions): APIPromise<ModelRouterSelectModelResponse>;
+}
+export type ModelRouterOpenHandsSelectResponse = unknown;
+/**
+ * Response from model selection endpoint.
+ */
+export interface ModelRouterSelectModelResponse {
+    /**
+     * List containing the selected provider
+     */
+    providers: Array<ModelRouterSelectModelResponse.Provider>;
+    /**
+     * Unique session ID for this routing decision
+     */
+    session_id: string;
+}
+export declare namespace ModelRouterSelectModelResponse {
+    /**
+     * Selected LLM provider information from model selection endpoints.
+     *
+     * Part of ModelSelectResponse. Contains the provider and model that Not Diamond's
+     * routing algorithm selected as optimal for your query. Use these values to make
+     * your LLM API call to the recommended model.
+     */
+    interface Provider {
+        /**
+         * Model identifier for the selected model (e.g., 'gpt-4o',
+         * 'claude-3-opus-20240229')
+         */
+        model: string;
+        /**
+         * Provider name for the selected model (e.g., 'openai', 'anthropic', 'google')
+         */
+        provider: string;
+    }
+}
+export interface ModelRouterOpenHandsSelectParams {
+    /**
+     * List of LLM providers to route between. Specify at least one provider in format
+     * {provider, model}
+     */
+    llm_providers: Array<AdaptAPI.RequestProvider | ModelRouterOpenHandsSelectParams.OpenRouterProvider>;
+    /**
+     * Array of message objects in OpenAI format (with 'role' and 'content' keys)
+     */
+    messages: Array<{
+        [key: string]: string | Array<unknown>;
+    }> | string;
+    /**
+     * Whether to hash message content for privacy
+     */
+    hash_content?: boolean;
+    /**
+     * Maximum number of models to consider for routing. If not specified, considers
+     * all provided models
+     */
+    max_model_depth?: number | null;
+    /**
+     * Optimization metric for model selection
+     */
+    metric?: string;
+    /**
+     * Preference ID for personalized routing. Create one via POST
+     * /v2/preferences/userPreferenceCreate
+     */
+    preference_id?: string | null;
+    /**
+     * Previous session ID to link related requests
+     */
+    previous_session?: string | null;
+    /**
+     * OpenAI-format function calling tools
+     */
+    tools?: Array<{
+        [key: string]: unknown;
+    }> | null;
+    /**
+     * Optimization tradeoff strategy. Use 'cost' to prioritize cost savings or
+     * 'latency' to prioritize speed
+     */
+    tradeoff?: string | null;
+}
+export declare namespace ModelRouterOpenHandsSelectParams {
+    /**
+     * Model for specifying an LLM provider using OpenRouter format.
+     *
+     * Used in model routing requests when you want to specify providers using the
+     * OpenRouter naming convention (combined 'provider/model' format). This is an
+     * alternative to the standard RequestProvider which uses separate provider and
+     * model fields.
+     *
+     * **When to use:**
+     *
+     * - When working with OpenRouter-compatible systems
+     * - When you prefer the unified 'provider/model' format
+     * - For models accessed via OpenRouter proxy
+     */
+    interface OpenRouterProvider {
+        /**
+         * OpenRouter model identifier in 'provider/model' format (e.g., 'openai/gpt-4o',
+         * 'anthropic/claude-sonnet-4-5-20250929')
+         */
+        model: string;
+        /**
+         * Maximum context length for the model (required for custom models)
+         */
+        context_length?: number | null;
+        /**
+         * Input token price per million tokens in USD (required for custom models)
+         */
+        input_price?: number | null;
+        /**
+         * Whether this is a custom model not in Not Diamond's supported model list
+         */
+        is_custom?: boolean;
+        /**
+         * Average latency in seconds (required for custom models)
+         */
+        latency?: number | null;
+        /**
+         * Output token price per million tokens in USD (required for custom models)
+         */
+        output_price?: number | null;
+    }
+}
+export interface ModelRouterSelectModelParams {
+    /**
+     * Body param: List of LLM providers to route between. Specify at least one
+     * provider in format {provider, model}
+     */
+    llm_providers: Array<AdaptAPI.RequestProvider | ModelRouterSelectModelParams.OpenRouterProvider>;
+    /**
+     * Body param: Array of message objects in OpenAI format (with 'role' and 'content'
+     * keys)
+     */
+    messages: Array<{
+        [key: string]: string | Array<unknown>;
+    }> | string;
+    /**
+     * Query param: Optional format type. Use 'openrouter' to accept and return
+     * OpenRouter-format model identifiers
+     */
+    type?: string | null;
+    /**
+     * Body param: Whether to hash message content for privacy
+     */
+    hash_content?: boolean;
+    /**
+     * Body param: Maximum number of models to consider for routing. If not specified,
+     * considers all provided models
+     */
+    max_model_depth?: number | null;
+    /**
+     * Body param: Optimization metric for model selection
+     */
+    metric?: string;
+    /**
+     * Body param: Preference ID for personalized routing. Create one via POST
+     * /v2/preferences/userPreferenceCreate
+     */
+    preference_id?: string | null;
+    /**
+     * Body param: Previous session ID to link related requests
+     */
+    previous_session?: string | null;
+    /**
+     * Body param: OpenAI-format function calling tools
+     */
+    tools?: Array<{
+        [key: string]: unknown;
+    }> | null;
+    /**
+     * Body param: Optimization tradeoff strategy. Use 'cost' to prioritize cost
+     * savings or 'latency' to prioritize speed
+     */
+    tradeoff?: string | null;
+}
+export declare namespace ModelRouterSelectModelParams {
+    /**
+     * Model for specifying an LLM provider using OpenRouter format.
+     *
+     * Used in model routing requests when you want to specify providers using the
+     * OpenRouter naming convention (combined 'provider/model' format). This is an
+     * alternative to the standard RequestProvider which uses separate provider and
+     * model fields.
+     *
+     * **When to use:**
+     *
+     * - When working with OpenRouter-compatible systems
+     * - When you prefer the unified 'provider/model' format
+     * - For models accessed via OpenRouter proxy
+     */
+    interface OpenRouterProvider {
+        /**
+         * OpenRouter model identifier in 'provider/model' format (e.g., 'openai/gpt-4o',
+         * 'anthropic/claude-sonnet-4-5-20250929')
+         */
+        model: string;
+        /**
+         * Maximum context length for the model (required for custom models)
+         */
+        context_length?: number | null;
+        /**
+         * Input token price per million tokens in USD (required for custom models)
+         */
+        input_price?: number | null;
+        /**
+         * Whether this is a custom model not in Not Diamond's supported model list
+         */
+        is_custom?: boolean;
+        /**
+         * Average latency in seconds (required for custom models)
+         */
+        latency?: number | null;
+        /**
+         * Output token price per million tokens in USD (required for custom models)
+         */
+        output_price?: number | null;
+    }
+}
+export declare namespace ModelRouter {
+    export { type ModelRouterOpenHandsSelectResponse as ModelRouterOpenHandsSelectResponse, type ModelRouterSelectModelResponse as ModelRouterSelectModelResponse, type ModelRouterOpenHandsSelectParams as ModelRouterOpenHandsSelectParams, type ModelRouterSelectModelParams as ModelRouterSelectModelParams, };
+}
+//# sourceMappingURL=model-router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.d.ts","sourceRoot":"","sources":["../src/resources/model-router.ts"],"names":[],"mappings":"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"}