@azure/ai-projects 2.7.1 → 2.8.0

package/dist/esm/models/models.d.ts

@@ -1,5 +1,5 @@
-import type { NodeReadableStream } from "../static-helpers/platform-types.js";
 import type { FileContents } from "../static-helpers/multipartHelpers.js";
+import type { NodeReadableStream } from "../static-helpers/platform-types.js";
 /**
  * This file contains only generated model types and their (de)serializers.
  * Disable the following rules for internal models with '_' prefix and deserializers which require 'any' for raw JSON input.
@@ -192,7 +192,7 @@ export interface Tool {
 export declare function toolSerializer(item: Tool): any;
 export declare function toolDeserializer(item: any): Tool;
 /** Alias for ToolUnion */
-export type ToolUnion = GitHubCopilotToolsetPreview | BingGroundingTool | MicrosoftFabricPreviewTool | SharepointPreviewTool | AzureAISearchTool | OpenApiTool | BingCustomSearchPreviewTool | BrowserAutomationPreviewTool | AzureFunctionTool | CaptureStructuredOutputsTool | A2APreviewTool | A2ATool | WorkIQPreviewTool | FabricIQPreviewTool | WebIQPreviewTool | MemorySearchPreviewTool | CodeInterpreterTool | FileSearchTool | WebSearchTool | MCPTool | FunctionTool | ComputerUsePreviewTool | ProgrammaticToolCallingParam | ImageGenTool | LocalShellToolParam | FunctionShellToolParam | CustomToolParam | WebSearchPreviewTool | ApplyPatchToolParam | ComputerTool | NamespaceToolParam | ToolSearchToolParam | Tool;
+export type ToolUnion = GitHubCopilotToolsetPreview | BingGroundingTool | MicrosoftFabricPreviewTool | SharepointPreviewTool | AzureAISearchTool | OpenApiTool | BingCustomSearchPreviewTool | BrowserAutomationPreviewTool | BrowserAutomationTool | AzureFunctionTool | CaptureStructuredOutputsTool | A2APreviewTool | A2ATool | WorkIQPreviewTool | FabricIQPreviewTool | WebIQPreviewTool | MemorySearchPreviewTool | CodeInterpreterTool | FileSearchTool | WebSearchTool | MCPTool | FunctionTool | ComputerUsePreviewTool | ProgrammaticToolCallingParam | ImageGenTool | LocalShellToolParam | FunctionShellToolParam | CustomToolParam | WebSearchPreviewTool | ApplyPatchToolParam | ComputerTool | NamespaceToolParam | ToolSearchToolParam | Tool;
 export declare function toolUnionSerializer(item: ToolUnion): any;
 export declare function toolUnionDeserializer(item: any): ToolUnion;
 /** Type of ToolType */
@@ -511,6 +511,15 @@ export interface BrowserAutomationToolConnectionParameters {
 }
 export declare function browserAutomationToolConnectionParametersSerializer(item: BrowserAutomationToolConnectionParameters): any;
 export declare function browserAutomationToolConnectionParametersDeserializer(item: any): BrowserAutomationToolConnectionParameters;
+/** The input definition information for a Browser Automation Tool, as used to configure an Agent. */
+export interface BrowserAutomationTool extends Tool {
+    /** The object type, which is always 'browser_automation'. */
+    type: "browser_automation";
+    /** The Browser Automation Tool parameters. */
+    browser_automation: BrowserAutomationToolParameters;
+}
+export declare function browserAutomationToolSerializer(item: BrowserAutomationTool): any;
+export declare function browserAutomationToolDeserializer(item: any): BrowserAutomationTool;
 /** The input definition information for an Azure Function Tool, as used to configure an Agent. */
 export interface AzureFunctionTool extends Tool {
     /** The object type, which is always 'browser_automation'. */
@@ -2368,7 +2377,7 @@ export interface Connection {
 }
 export declare function connectionDeserializer(item: any): Connection;
 /** The Type (or category) of the connection */
-export type ConnectionType = "AzureOpenAI" | "AzureBlob" | "AzureStorageAccount" | "CognitiveSearch" | "CosmosDB" | "ApiKey" | "AppConfig" | "AppInsights" | "CustomKeys" | "RemoteTool_Preview";
+export type ConnectionType = "AzureOpenAI" | "AzureBlob" | "AzureStorageAccount" | "CognitiveSearch" | "CosmosDB" | "ApiKey" | "AppConfig" | "AppInsights" | "CustomKeys" | "RemoteTool_Preview" | "OpenAPI" | "RemoteA2A";
 /** A base class for connection credentials */
 export interface BaseCredentials {
     /** The type of credential used by the connection */
@@ -2928,11 +2937,11 @@ export interface ToolboxTool {
 export declare function toolboxToolSerializer(item: ToolboxTool): any;
 export declare function toolboxToolDeserializer(item: any): ToolboxTool;
 /** Alias for ToolboxToolUnion */
-export type ToolboxToolUnion = CodeInterpreterToolboxTool | FileSearchToolboxTool | WebSearchToolboxTool | ShellToolboxTool | MCPToolboxTool | AzureAISearchToolboxTool | OpenApiToolboxTool | A2AToolboxTool | A2APreviewToolboxTool | BrowserAutomationPreviewToolboxTool | ReminderPreviewToolboxTool | WorkIQPreviewToolboxTool | FabricIQPreviewToolboxTool | WebIQPreviewToolboxTool | ToolboxSearchPreviewToolboxTool | ToolSearchToolboxTool | ToolboxTool;
+export type ToolboxToolUnion = CodeInterpreterToolboxTool | FileSearchToolboxTool | WebSearchToolboxTool | ShellToolboxTool | MCPToolboxTool | AzureAISearchToolboxTool | OpenApiToolboxTool | A2AToolboxTool | A2APreviewToolboxTool | BrowserAutomationPreviewToolboxTool | BrowserAutomationToolboxTool | ReminderPreviewToolboxTool | WorkIQPreviewToolboxTool | FabricIQPreviewToolboxTool | WebIQPreviewToolboxTool | ToolboxSearchPreviewToolboxTool | ToolSearchToolboxTool | ToolboxTool;
 export declare function toolboxToolUnionSerializer(item: ToolboxToolUnion): any;
 export declare function toolboxToolUnionDeserializer(item: any): ToolboxToolUnion;
 /** Supported tool types for tools stored in a toolbox. */
-export type ToolboxToolType = "code_interpreter" | "file_search" | "web_search" | "mcp" | "azure_ai_search" | "openapi" | "a2a_preview" | "browser_automation_preview" | "reminder_preview" | "work_iq_preview" | "fabric_iq_preview" | "toolbox_search" | "toolbox_search_preview" | "a2a" | "shell" | "web_iq_preview";
+export type ToolboxToolType = "code_interpreter" | "file_search" | "web_search" | "mcp" | "azure_ai_search" | "openapi" | "a2a_preview" | "browser_automation_preview" | "reminder_preview" | "work_iq_preview" | "fabric_iq_preview" | "toolbox_search" | "toolbox_search_preview" | "a2a" | "shell" | "web_iq_preview" | "browser_automation";
 /** A code interpreter tool stored in a toolbox. */
 export interface CodeInterpreterToolboxTool extends ToolboxTool {
     /** The type of the code interpreter toolbox tool. Always `code_interpreter`. */
@@ -3097,6 +3106,14 @@ export interface BrowserAutomationPreviewToolboxTool extends ToolboxTool {
 }
 export declare function browserAutomationPreviewToolboxToolSerializer(item: BrowserAutomationPreviewToolboxTool): any;
 export declare function browserAutomationPreviewToolboxToolDeserializer(item: any): BrowserAutomationPreviewToolboxTool;
+/** A browser automation tool stored in a toolbox. */
+export interface BrowserAutomationToolboxTool extends ToolboxTool {
+    type: "browser_automation";
+    /** The Browser Automation Tool parameters. */
+    browser_automation: BrowserAutomationToolParameters;
+}
+export declare function browserAutomationToolboxToolSerializer(item: BrowserAutomationToolboxTool): any;
+export declare function browserAutomationToolboxToolDeserializer(item: any): BrowserAutomationToolboxTool;
 /** A reminder tool stored in a toolbox. */
 export interface ReminderPreviewToolboxTool extends ToolboxTool {
     /** The toolbox tool type. Always `reminder_preview`. */
@@ -3745,14 +3762,22 @@ export declare function evaluatorCredentialRequestSerializer(item: EvaluatorCred
 export interface EvaluatorGenerationJob {
     /** Server-assigned unique identifier. */
     readonly id?: string;
-    /** Caller-supplied inputs. */
-    inputs?: EvaluatorGenerationInputs;
     /** Result produced on success. */
     readonly result?: EvaluatorVersion;
     /** Current lifecycle status. */
     readonly status?: JobStatus;
     /** Error details — populated only on failure. */
     readonly error?: ErrorModel;
+    /** Source materials for generation — agent descriptions, prompts, traces, or datasets. Each entry is an `EvaluatorGenerationJobSource` variant discriminated by `type`. */
+    sources: EvaluatorGenerationJobSourceUnion[];
+    /** The LLM model to use for rubric generation (e.g., 'gpt-4o'). Required — users must provide their own model rather than relying on service-owned capacity. */
+    model: string;
+    /** The evaluator name (immutable identifier). 1-256 characters; allowed characters are ASCII letters, digits, underscore (`_`), period (`.`), tilde (`~`), and hyphen (`-`). The prefix `builtin.` is reserved for system-managed evaluators and is rejected by the service. If an evaluator with this name already exists in the project (and is rubric-subtype), the service creates a new version under the same name and uses the prior version's `dimensions` as context for incremental improvement (foundation of the post-//build adaptive loop). Old versions remain queryable via `get_version(name, version)`. If the existing evaluator is not a rubric-subtype evaluator (built-in, prompt-based, code-based), the request is rejected with `400 Bad Request`. */
+    evaluator_name: string;
+    /** Optional human-friendly display name for the resulting evaluator. Surfaced as `EvaluatorVersion.display_name` on the persisted evaluator. When omitted, the service uses `evaluator_name` as the display name. The `evaluator_` prefix disambiguates this from the immutable `evaluator_name` identifier. */
+    evaluator_display_name?: string;
+    /** Optional human-friendly description for the resulting evaluator. Surfaced as `EvaluatorVersion.description` on the persisted evaluator. Typically collected from the UI alongside `evaluator_display_name`. The `evaluator_` prefix disambiguates this from any other description fields on related models. */
+    evaluator_description?: string;
     /** The timestamp when the job was created, represented in Unix time (seconds since January 1, 1970). */
     readonly created_at?: Date;
     /** The timestamp when the job finished, represented in Unix time (seconds since January 1, 1970). */
@@ -3762,7 +3787,6 @@ export interface EvaluatorGenerationJob {
     /** Non-fatal input-quality advisories produced by the generation pipeline. Read-only; service-generated; populated only on terminal jobs when advisories fired. Omitted when generation was clean. Cleared when a subsequent `PATCH` to the paired `EvaluatorVersion.definition` invalidates the advisories. */
     readonly input_quality_warnings?: RubricGenerationInputQualityWarning[];
 }
-export declare function evaluatorGenerationJobSerializer(item: EvaluatorGenerationJob): any;
 export declare function evaluatorGenerationJobDeserializer(item: any): EvaluatorGenerationJob;
 /** Caller-supplied inputs for an evaluator generation job. */
 export interface EvaluatorGenerationInputs {
@@ -3778,7 +3802,6 @@ export interface EvaluatorGenerationInputs {
     evaluator_description?: string;
 }
 export declare function evaluatorGenerationInputsSerializer(item: EvaluatorGenerationInputs): any;
-export declare function evaluatorGenerationInputsDeserializer(item: any): EvaluatorGenerationInputs;
 export declare function evaluatorGenerationJobSourceUnionArraySerializer(result: Array<EvaluatorGenerationJobSourceUnion>): any[];
 export declare function evaluatorGenerationJobSourceUnionArrayDeserializer(result: Array<EvaluatorGenerationJobSourceUnion>): any[];
 /** The base source model for evaluator generation jobs. Polymorphic over `type`. */
@@ -4089,7 +4112,6 @@ export interface _AgentsPagedResultEvaluatorGenerationJob {
     has_more: boolean;
 }
 export declare function _agentsPagedResultEvaluatorGenerationJobDeserializer(item: any): _AgentsPagedResultEvaluatorGenerationJob;
-export declare function evaluatorGenerationJobArraySerializer(result: Array<EvaluatorGenerationJob>): any[];
 export declare function evaluatorGenerationJobArrayDeserializer(result: Array<EvaluatorGenerationJob>): any[];
 /** The response body for cluster insights. */
 export interface Insight {
@@ -5388,20 +5410,26 @@ export declare function deleteSkillVersionResponseDeserializer(item: any): Delet
 export interface DataGenerationJob {
     /** Server-assigned unique identifier. */
     readonly id?: string;
-    /** Caller-supplied inputs. */
-    inputs?: DataGenerationJobInputs;
     /** Result produced on success. */
     readonly result?: DataGenerationJobResult;
     /** Current lifecycle status. */
     readonly status?: JobStatus;
     /** Error details — populated only on failure. */
     readonly error?: ErrorModel;
+    /** The display name of the data generation job. */
+    name: string;
+    /** The sources used for the data generation job. */
+    sources: DataGenerationJobSourceUnion[];
+    /** The generation configuration for the data generation job. */
+    generation_configuration: DataGenerationJobConfigurationUnion;
+    /** The scenario of the data generation job. Either for fine-tuning or evaluation. */
+    /** The discriminator possible values: evaluation, supervised_finetuning, reinforcement_finetuning */
+    scenario: DataGenerationJobScenario;
     /** The timestamp when the job was created, represented in Unix time (seconds since January 1, 1970). */
     readonly created_at?: Date;
     /** The timestamp when the job was finished, represented in Unix time (seconds since January 1, 1970). */
     readonly finished_at?: Date;
 }
-export declare function dataGenerationJobSerializer(item: DataGenerationJob): any;
 export declare function dataGenerationJobDeserializer(item: any): DataGenerationJob;
 /** Caller-supplied inputs for a data generation job. */
 export interface DataGenerationJobInputs {
@@ -5409,15 +5437,13 @@ export interface DataGenerationJobInputs {
     name: string;
     /** The sources used for the data generation job. */
     sources: DataGenerationJobSourceUnion[];
-    /** The options for the data generation job. */
-    options: DataGenerationJobOptionsUnion;
+    /** The generation configuration for the data generation job. */
+    generation_configuration: DataGenerationJobConfigurationUnion;
     /** The scenario of the data generation job. Either for fine-tuning or evaluation. */
+    /** The discriminator possible values: evaluation, supervised_finetuning, reinforcement_finetuning */
     scenario: DataGenerationJobScenario;
-    /** Optional caller-supplied metadata for the job's output. See individual fields for whether they apply to file outputs (fine-tuning scenarios), dataset outputs (evaluation scenario), or both. */
-    output_options?: DataGenerationJobOutputOptions;
 }
 export declare function dataGenerationJobInputsSerializer(item: DataGenerationJobInputs): any;
-export declare function dataGenerationJobInputsDeserializer(item: any): DataGenerationJobInputs;
 export declare function dataGenerationJobSourceUnionArraySerializer(result: Array<DataGenerationJobSourceUnion>): any[];
 export declare function dataGenerationJobSourceUnionArrayDeserializer(result: Array<DataGenerationJobSourceUnion>): any[];
 /** The base source model for data generation jobs. */
@@ -5490,24 +5516,8 @@ export interface FileDataGenerationJobSource extends DataGenerationJobSource {
 }
 export declare function fileDataGenerationJobSourceSerializer(item: FileDataGenerationJobSource): any;
 export declare function fileDataGenerationJobSourceDeserializer(item: any): FileDataGenerationJobSource;
-/** Options for managing data generation jobs. */
-export interface DataGenerationJobOptions {
-    /** The data generation job type. */
-    /** The discriminator possible values: simple_qna, traces, task_generation, simulation_seed, tool_use */
-    type: DataGenerationJobType;
-    /** The proportion of the generated data to be used for training when the data is used for fine-tuning. The rest will be used for validation. Value should be between 0 and 1. */
-    train_split?: number;
-    /** The LLM model options. */
-    model_options?: DataGenerationModelOptions;
-}
-export declare function dataGenerationJobOptionsSerializer(item: DataGenerationJobOptions): any;
-export declare function dataGenerationJobOptionsDeserializer(item: any): DataGenerationJobOptions;
-/** Alias for DataGenerationJobOptionsUnion */
-export type DataGenerationJobOptionsUnion = SimpleQnADataGenerationJobOptions | TracesDataGenerationJobOptions | TaskGenerationDataGenerationJobOptions | SimulationSeedDataGenerationJobOptions | ToolUseFineTuningDataGenerationJobOptions | DataGenerationJobOptions;
-export declare function dataGenerationJobOptionsUnionSerializer(item: DataGenerationJobOptionsUnion): any;
-export declare function dataGenerationJobOptionsUnionDeserializer(item: any): DataGenerationJobOptionsUnion;
 /** The supported data generation job types. */
-export type DataGenerationJobType = "simple_qna" | "traces" | "tool_use" | "task_generation" | "simulation_seed";
+export type DataGenerationJobType = "simple_qna" | "traces" | "tool_use" | "simulation_seed";
 /** LLM model options for data generation jobs. */
 export interface DataGenerationModelOptions {
     /** Base model name used to generate data. */
@@ -5515,74 +5525,10 @@ export interface DataGenerationModelOptions {
 }
 export declare function dataGenerationModelOptionsSerializer(item: DataGenerationModelOptions): any;
 export declare function dataGenerationModelOptionsDeserializer(item: any): DataGenerationModelOptions;
-/** The options for a data generation job with SimpleQnA type. */
-export interface SimpleQnADataGenerationJobOptions extends DataGenerationJobOptions {
-    /** The data generation job type, which is SimpleQnA for this model. */
-    type: "simple_qna";
-    /** The question types to generate. Used only for fine-tuning scenarios. */
-    question_types?: SimpleQnAFineTuningQuestionType[];
-    /** Maximum number of samples to generate, up to service-defined limits. */
-    max_samples: number;
-}
-export declare function simpleQnADataGenerationJobOptionsSerializer(item: SimpleQnADataGenerationJobOptions): any;
-export declare function simpleQnADataGenerationJobOptionsDeserializer(item: any): SimpleQnADataGenerationJobOptions;
 /** The supported question types for SimpleQnA data generation jobs used for fine-tuning scenarios. */
 export type SimpleQnAFineTuningQuestionType = "short_answer" | "long_answer";
-/** The options for a data generation job with Traces type. */
-export interface TracesDataGenerationJobOptions extends DataGenerationJobOptions {
-    /** The data generation job type, which is Traces for this model. */
-    type: "traces";
-    /** Whether to redact private content from traces. When omitted or set to true, private content is redacted. Set to false to opt out of redaction. */
-    redact_private_content?: boolean;
-    /** Maximum number of samples to generate, up to service-defined limits. If omitted, sampling is turned off. */
-    max_samples?: number;
-}
-export declare function tracesDataGenerationJobOptionsSerializer(item: TracesDataGenerationJobOptions): any;
-export declare function tracesDataGenerationJobOptionsDeserializer(item: any): TracesDataGenerationJobOptions;
-/** The options for a simulation seed data generation job. Use with multiturn evaluation scenarios and with prompt, file, or agent sources. Generated dataset rows include fields such as `id`, `category`, `test_case_description`, and `desired_num_turns`. */
-export interface SimulationSeedDataGenerationJobOptions extends DataGenerationJobOptions {
-    /** The data generation job type, which is SimulationSeed for this model. */
-    type: "simulation_seed";
-}
-export declare function simulationSeedDataGenerationJobOptionsSerializer(item: SimulationSeedDataGenerationJobOptions): any;
-export declare function simulationSeedDataGenerationJobOptionsDeserializer(item: any): SimulationSeedDataGenerationJobOptions;
-/**
- * Options for the legacy task generation job, including the maximum number of generated samples.
- *
- * @deprecated Use `SimulationSeedDataGenerationJobOptions` instead.
- */
-export interface TaskGenerationDataGenerationJobOptions extends DataGenerationJobOptions {
-    /** Maximum number of samples to generate. */
-    max_samples: number;
-    /** The data generation job type. */
-    type: "task_generation";
-}
-export declare function taskGenerationDataGenerationJobOptionsSerializer(item: TaskGenerationDataGenerationJobOptions): any;
-export declare function taskGenerationDataGenerationJobOptionsDeserializer(item: any): TaskGenerationDataGenerationJobOptions;
-/** The options for a data generation job with ToolUse type. Used only for fine-tuning scenarios. */
-export interface ToolUseFineTuningDataGenerationJobOptions extends DataGenerationJobOptions {
-    /** The data generation job type, which is ToolUse for this model. */
-    type: "tool_use";
-    /** Maximum number of samples to generate, up to service-defined limits. */
-    max_samples: number;
-}
-export declare function toolUseFineTuningDataGenerationJobOptionsSerializer(item: ToolUseFineTuningDataGenerationJobOptions): any;
-export declare function toolUseFineTuningDataGenerationJobOptionsDeserializer(item: any): ToolUseFineTuningDataGenerationJobOptions;
 /** The supported scenarios for a data generation job. */
-export type DataGenerationJobScenario = "supervised_finetuning" | "reinforcement_finetuning" | "evaluation";
-/** Output options for data generation job. */
-export interface DataGenerationJobOutputOptions {
-    /** Name to assign to the output. Used as the filename for Azure OpenAI file outputs (fine-tuning scenarios) and as the dataset name for dataset outputs (evaluation scenario). */
-    name?: string;
-    /** Description to assign to the output. Applies only to dataset outputs (evaluation scenario); ignored for Azure OpenAI file outputs. */
-    description?: string;
-    /** Tags to assign to the output. Applies only to dataset outputs (evaluation scenario); ignored for Azure OpenAI file outputs. */
-    tags?: Record<string, string>;
-    /** Controls how dataset outputs are written. If omitted, defaults to `overwrite` and creates the next dataset version using only newly generated rows. */
-    write_mode?: DataGenerationJobOutputWriteMode;
-}
-export declare function dataGenerationJobOutputOptionsSerializer(item: DataGenerationJobOutputOptions): any;
-export declare function dataGenerationJobOutputOptionsDeserializer(item: any): DataGenerationJobOutputOptions;
+export type DataGenerationJobScenario = "supervised_finetuning_preview" | "reinforcement_finetuning_preview" | "evaluation";
 /** Result produced by a successful data generation job. */
 export interface DataGenerationJobResult {
     /** The final job outputs: Azure OpenAI files for fine-tuning, or datasets for evaluation. */
@@ -5645,7 +5591,7 @@ export declare function dataGenerationTokenUsageDeserializer(item: any): DataGen
 /** The response data for a requested list of items. */
 export interface _AgentsPagedResultDataGenerationJob {
     /** The requested list of items. */
-    data: DataGenerationJob[];
+    data: DataGenerationJobUnion[];
     /** The first ID represented in this list. */
     first_id?: string;
     /** The last ID represented in this list. */
@@ -5654,298 +5600,78 @@ export interface _AgentsPagedResultDataGenerationJob {
     has_more: boolean;
 }
 export declare function _agentsPagedResultDataGenerationJobDeserializer(item: any): _AgentsPagedResultDataGenerationJob;
-export declare function dataGenerationJobArraySerializer(result: Array<DataGenerationJob>): any[];
-export declare function dataGenerationJobArrayDeserializer(result: Array<DataGenerationJob>): any[];
-/** Agent optimization job resource — a long-running job that optimizes an agent's configuration (instructions, model, skills, tools) to maximize evaluation scores. On success, the result contains scored candidates. */
+/** Agent optimization job resource — a long-running job that produces candidate changes to a Foundry agent configuration. */
 export interface AgentOptimizationJob {
     /** Server-assigned unique identifier. */
-    readonly id: string;
-    /** Caller-supplied inputs. */
-    inputs?: AgentOptimizationJobInputs;
+    readonly id?: string;
     /** Result produced on success. */
     readonly result?: AgentOptimizationJobResult;
     /** Current lifecycle status. */
-    readonly status: JobStatus;
+    readonly status?: JobStatus;
     /** Error details — populated only on failure. */
     readonly error?: ErrorModel;
+    /** Human-readable label. Omitted when no label is needed; it has no uniqueness, routing, or idempotency semantics. */
+    display_name?: string;
+    /** Foundry agent whose configuration is optimized. Omitted when the workflow does not target a registered Foundry agent. */
+    target_configuration?: AgentOptimizationTargetConfigurationUnion;
+    /** Model used to generate candidate changes. An existing deployment name is also accepted. */
+    optimization_model_configuration: AgentOptimizationModelConfiguration;
+    /** Type-specific optimization configuration. */
+    optimization_configuration: AgentOptimizationConfigurationBaseUnion;
+    /** Duration for which the job has been running, in milliseconds. */
+    readonly run_duration_ms?: number;
     /** The timestamp when the job was created, represented in Unix time. */
-    readonly created_at: Date;
+    readonly created_at?: Date;
     /** The timestamp when the job was last updated, represented in Unix time. */
-    readonly updated_at: Date;
-    /** Progress snapshot. May be present in terminal states reflecting last-known progress. */
-    readonly progress?: AgentOptimizationJobProgress;
-    /** Non-fatal warnings emitted at any point during optimization. */
+    readonly updated_at?: Date;
+    /** Non-fatal warnings emitted during optimization. Omitted when no warnings were produced. */
     readonly warnings?: string[];
 }
 export declare function agentOptimizationJobSerializer(item: AgentOptimizationJob): any;
 export declare function agentOptimizationJobDeserializer(item: any): AgentOptimizationJob;
-/** Caller-supplied inputs for an optimization job. */
-export interface AgentOptimizationJobInputs {
-    /** The agent (and pinned version) being optimized. */
-    agent: OptimizedAgentIdentifier;
-    /** Training dataset — either inline items or a reference to a registered dataset. Required. */
-    train_dataset: AgentOptimizationDatasetInputUnion;
-    /** Optional held-out validation dataset for measuring generalization of the final candidate. */
-    validation_dataset?: AgentOptimizationDatasetInputUnion;
-    /** Job-level evaluators referenced by name and optional version. Required; at least one must be provided. */
-    evaluators: AgentOptimizationEvaluatorRef[];
-    /** Tuning knobs and run-mode. */
-    options?: AgentOptimizationOptions;
-}
-export declare function agentOptimizationJobInputsSerializer(item: AgentOptimizationJobInputs): any;
-export declare function agentOptimizationJobInputsDeserializer(item: any): AgentOptimizationJobInputs;
-/** Identifies the registered Foundry agent to optimize (request-only). Skills, tools, and system_prompt are specified in options.optimization_config. */
-export interface OptimizedAgentIdentifier {
-    /** Registered Foundry agent name (required). */
-    agent_name: string;
-    /** Pinned agent version. Defaults to latest if omitted. */
-    agent_version?: string;
-}
-export declare function optimizedAgentIdentifierSerializer(item: OptimizedAgentIdentifier): any;
-export declare function optimizedAgentIdentifierDeserializer(item: any): OptimizedAgentIdentifier;
-/** Base discriminated model for dataset input. Either inline items or a registered reference. */
-export interface AgentOptimizationDatasetInput {
-    /** Dataset input type discriminator. */
-    /** The discriminator possible values: inline, reference */
-    type: AgentOptimizationDatasetInputType;
-}
-export declare function agentOptimizationDatasetInputSerializer(item: AgentOptimizationDatasetInput): any;
-export declare function agentOptimizationDatasetInputDeserializer(item: any): AgentOptimizationDatasetInput;
-/** Alias for AgentOptimizationDatasetInputUnion */
-export type AgentOptimizationDatasetInputUnion = AgentOptimizationInlineDatasetInput | AgentOptimizationReferenceDatasetInput | AgentOptimizationDatasetInput;
-export declare function agentOptimizationDatasetInputUnionSerializer(item: AgentOptimizationDatasetInputUnion): any;
-export declare function agentOptimizationDatasetInputUnionDeserializer(item: any): AgentOptimizationDatasetInputUnion;
-/** Discriminator values for the dataset input union. */
-export type AgentOptimizationDatasetInputType = "inline" | "reference";
-/** Inline dataset — items supplied directly in the request body. */
-export interface AgentOptimizationInlineDatasetInput extends AgentOptimizationDatasetInput {
-    /** Dataset input type discriminator. */
-    type: "inline";
-    /** Dataset items. */
-    items: AgentOptimizationDatasetItem[];
-}
-export declare function agentOptimizationInlineDatasetInputSerializer(item: AgentOptimizationInlineDatasetInput): any;
-export declare function agentOptimizationInlineDatasetInputDeserializer(item: any): AgentOptimizationInlineDatasetInput;
-export declare function agentOptimizationDatasetItemArraySerializer(result: Array<AgentOptimizationDatasetItem>): any[];
-export declare function agentOptimizationDatasetItemArrayDeserializer(result: Array<AgentOptimizationDatasetItem>): any[];
-/** A single item in an inline dataset. */
-export interface AgentOptimizationDatasetItem {
-    /** The user query / prompt. */
-    query?: string;
-    /** Expected ground truth answer. */
-    ground_truth?: string;
-    /** Desired number of conversation turns for simulation mode (1-20). */
-    desired_num_turns?: number;
-    /** Per-item evaluation criteria. */
-    criteria?: AgentOptimizationDatasetCriterion[];
-}
-export declare function agentOptimizationDatasetItemSerializer(item: AgentOptimizationDatasetItem): any;
-export declare function agentOptimizationDatasetItemDeserializer(item: any): AgentOptimizationDatasetItem;
-export declare function agentOptimizationDatasetCriterionArraySerializer(result: Array<AgentOptimizationDatasetCriterion>): any[];
-export declare function agentOptimizationDatasetCriterionArrayDeserializer(result: Array<AgentOptimizationDatasetCriterion>): any[];
-/** Evaluation criterion: a name + instruction pair used for per-item scoring. */
-export interface AgentOptimizationDatasetCriterion {
-    /** Criterion name. */
-    name: string;
-    /** Criterion instruction / description. */
-    instruction: string;
-}
-export declare function agentOptimizationDatasetCriterionSerializer(item: AgentOptimizationDatasetCriterion): any;
-export declare function agentOptimizationDatasetCriterionDeserializer(item: any): AgentOptimizationDatasetCriterion;
-/** Reference to a registered Foundry dataset. */
-export interface AgentOptimizationReferenceDatasetInput extends AgentOptimizationDatasetInput {
-    /** Dataset input type discriminator. */
-    type: "reference";
-    /** Registered dataset name. */
-    name: string;
-    /** Dataset version. If not specified, the latest version is used. */
-    version?: string;
-}
-export declare function agentOptimizationReferenceDatasetInputSerializer(item: AgentOptimizationReferenceDatasetInput): any;
-export declare function agentOptimizationReferenceDatasetInputDeserializer(item: any): AgentOptimizationReferenceDatasetInput;
-export declare function agentOptimizationEvaluatorRefArraySerializer(result: Array<AgentOptimizationEvaluatorRef>): any[];
-export declare function agentOptimizationEvaluatorRefArrayDeserializer(result: Array<AgentOptimizationEvaluatorRef>): any[];
-/** Reference to a named evaluator, optionally pinned to a version. */
-export interface AgentOptimizationEvaluatorRef {
-    /** Evaluator name. */
-    name: string;
-    /** Evaluator version. If not specified, the latest version is used. */
-    version?: string;
-}
-export declare function agentOptimizationEvaluatorRefSerializer(item: AgentOptimizationEvaluatorRef): any;
-export declare function agentOptimizationEvaluatorRefDeserializer(item: any): AgentOptimizationEvaluatorRef;
-/** Tuning knobs and run-mode for an optimization job. */
-export interface AgentOptimizationOptions {
-    /** Maximum number of optimization candidates to generate. Must be >= 1. Default: 5. */
-    max_candidates?: number;
-    /** Per-target-attribute configuration overrides. Contains skills, tools, system_prompt for the agent, plus model space for model optimization. */
-    optimization_config?: Record<string, any>;
-    /** Model deployment used for evaluation. Defaults to server config (typically 'gpt-4o'). */
-    eval_model?: string;
-    /** Model deployment for optimization reasoning (must be gpt-5 family). Falls back to the default eval model when not set. */
-    optimization_model?: string;
-    /** Evaluation granularity. Null/omitted means per-item single-turn. Set to 'conversation' for per-conversation multi-turn simulation scoring. */
-    evaluation_level?: EvaluationLevel;
-    /** Maximum number of consecutive reflective minibatch rejections before stopping early. A 'stall' occurs when the optimizer proposes a prompt change, evaluates it on a small subset, and the score does not improve — so no full validation-set evaluation is triggered. The counter resets whenever a minibatch passes and its full-validation score beats the current best. Only a sustained plateau of `max_stalls` consecutive minibatch failures triggers the stop. The service defaults to 5 if a value is not specified by the caller. Must be >= 1 when set. */
-    max_stalls?: number;
-}
-export declare function agentOptimizationOptionsSerializer(item: AgentOptimizationOptions): any;
-export declare function agentOptimizationOptionsDeserializer(item: any): AgentOptimizationOptions;
-/** Terminal-state result body. Populated when status is succeeded or failed. */
+/** Partial or terminal result produced by an agent optimization job. */
 export interface AgentOptimizationJobResult {
-    /** Candidate ID of the original (un-optimized) baseline evaluation. */
-    baseline?: string;
-    /** Candidate ID of the highest-scoring candidate found during optimization. */
-    best?: string;
-    /** All evaluated candidates including baseline. */
-    candidates?: AgentOptimizationCandidate[];
+    /** Summary of candidates produced by the job. Omitted until candidate processing begins. */
+    candidate_summary?: AgentOptimizationResultCandidateSummary;
+    /** Aggregate token usage per stage and model. Always present; empty array when no calls were measured. */
+    token_usage: AgentOptimizationJobTokenUsage[];
+    /** Aggregate latency per stage and model. Always present; empty when no server-measured latency is available. */
+    latency_metrics: AgentOptimizationJobLatency[];
+    /** Reason the candidate search terminated. Omitted for jobs that do not comparatively evaluate candidates and until the job reaches a terminal state. */
+    termination_reason?: AgentOptimizationTerminationReason;
 }
 export declare function agentOptimizationJobResultDeserializer(item: any): AgentOptimizationJobResult;
 export declare function agentOptimizationCandidateArrayDeserializer(result: Array<AgentOptimizationCandidate>): any[];
-/** Aggregated evaluation result for a single candidate agent configuration across all tasks. */
+/** A candidate generated by an optimization job. */
 export interface AgentOptimizationCandidate {
-    /** Server-assigned candidate identifier. Use with GET /candidates/{id} sub-endpoints. */
-    candidate_id?: string;
+    /** Server-assigned candidate identifier. */
+    candidate_id: string;
+    /** Identifier of the parent optimization job. */
+    job_id: string;
     /** Display name of the candidate (e.g., 'baseline', 'instruction-v2'). */
     name: string;
-    /** What was mutated from the baseline (e.g., {system_prompt: 'new prompt'}). */
-    mutations?: Record<string, any>;
-    /** Average composite score across all tasks. */
-    avg_score: number;
-    /** Average token usage across all tasks. */
-    avg_tokens: number;
-    /** Foundry evaluation identifier used to score this candidate. */
-    eval_id?: string;
-    /** Foundry evaluation run identifier for this candidate's scoring run. */
-    eval_run_id?: string;
-    /** Promotion metadata. Null if the candidate has not been promoted. */
-    promotion?: PromotionInfo;
+    /** The candidate's current lifecycle state. */
+    status: AgentOptimizationCandidateStatus;
+    /** Timestamp when work on this candidate slot began, represented in Unix time. */
+    started_at: Date;
+    /** Typed output generated for this candidate. The output type matches the parent job's optimization type. Omitted until output is available. */
+    output?: AgentOptimizationCandidateOutputUnion;
+    /** Human-readable explanation of why the optimizer produced this candidate. Populated on candidate GET when available and omitted from LIST. */
+    rationale?: string;
+    /** Foundry agent version associated with this candidate. Omitted when no temporary or evaluated agent version was created. */
+    agent_version?: string;
+    /** Comparative evaluation summary. Omitted when this candidate was not comparatively evaluated. */
+    evaluation?: AgentOptimizationCandidateEvaluation;
+    /** Promotion metadata. Omitted if this candidate has not been promoted. */
+    promotion?: AgentOptimizationCandidatePromotionInfo;
 }
 export declare function agentOptimizationCandidateDeserializer(item: any): AgentOptimizationCandidate;
-/** Promotion metadata recorded when a candidate is deployed to a Foundry agent. */
-export interface PromotionInfo {
-    /** Timestamp when promotion occurred, represented in Unix time. */
-    promoted_at: Date;
-    /** Name of the Foundry agent this candidate was promoted to. */
-    agent_name: string;
-    /** Version of the Foundry agent this candidate was promoted to. */
-    agent_version: string;
-}
-export declare function promotionInfoDeserializer(item: any): PromotionInfo;
-/** In-flight progress; only populated while status is queued or in_progress. */
-export interface AgentOptimizationJobProgress {
-    /** Number of candidates whose evaluation has completed so far. */
-    candidates_completed: number;
-    /** Best score observed so far across all candidates. */
-    best_score: number;
-    /** Wall-clock time elapsed in seconds since the job began executing. */
-    elapsed_seconds: number;
-}
-export declare function agentOptimizationJobProgressDeserializer(item: any): AgentOptimizationJobProgress;
-/** The response data for a requested list of items. */
-export interface _AgentsPagedResultAgentOptimizationJobListItem {
-    /** The requested list of items. */
-    data: AgentOptimizationJobListItem[];
-    /** The first ID represented in this list. */
-    first_id?: string;
-    /** The last ID represented in this list. */
-    last_id?: string;
-    /** A value indicating whether there are additional values available not captured in this list. */
-    has_more: boolean;
-}
-export declare function _agentsPagedResultAgentOptimizationJobListItemDeserializer(item: any): _AgentsPagedResultAgentOptimizationJobListItem;
-export declare function agentOptimizationJobListItemArrayDeserializer(result: Array<AgentOptimizationJobListItem>): any[];
-/** Slim job representation returned by the LIST endpoint. */
-export interface AgentOptimizationJobListItem {
-    /** Server-assigned unique identifier. */
-    readonly id: string;
-    /** Current lifecycle status. */
-    readonly status: JobStatus;
-    /** Error details — populated only on failure. */
-    readonly error?: ErrorModel;
-    /** The timestamp when the job was created, represented in Unix time. */
-    readonly created_at: Date;
-    /** The timestamp when the job was last updated, represented in Unix time. */
-    readonly updated_at: Date;
-    /** Progress snapshot. May be present in terminal states reflecting last-known progress. */
-    readonly progress?: AgentOptimizationJobProgress;
-    /** The agent targeted by this optimization job. */
-    readonly agent?: OptimizedAgentIdentifier;
-}
 /**
  * An agent optimization job that tracks inputs, progress, status, and candidate evaluation results.
  *
  * @deprecated Use `AgentOptimizationJob` instead.
  */
 export type OptimizationJob = AgentOptimizationJob;
-/**
- * The agent, datasets, evaluators, and options supplied to an agent optimization job.
- *
- * @deprecated Use `AgentOptimizationJobInputs` instead.
- */
-export type OptimizationJobInputs = AgentOptimizationJobInputs;
-/**
- * Identifies the registered Foundry agent and optional version to optimize.
- *
- * @deprecated Use `OptimizedAgentIdentifier` instead.
- */
-export type OptimizationAgentIdentifier = OptimizedAgentIdentifier;
-/**
- * The base description of an inline or registered dataset supplied to an agent optimization job.
- *
- * @deprecated Use `AgentOptimizationDatasetInput` instead.
- */
-export type OptimizationDatasetInput = AgentOptimizationDatasetInput;
-/**
- * An optimization dataset supplied as inline items or a reference to a registered Foundry dataset.
- *
- * @deprecated Use `AgentOptimizationDatasetInputUnion` instead.
- */
-export type OptimizationDatasetInputUnion = AgentOptimizationDatasetInputUnion;
-/**
- * The supported forms of optimization dataset input: inline items or a registered dataset
- * reference.
- *
- * @deprecated Use `AgentOptimizationDatasetInputType` instead.
- */
-export type OptimizationDatasetInputType = AgentOptimizationDatasetInputType;
-/**
- * Optimization dataset items supplied directly in the request body.
- *
- * @deprecated Use `AgentOptimizationInlineDatasetInput` instead.
- */
-export type OptimizationInlineDatasetInput = AgentOptimizationInlineDatasetInput;
-/**
- * An inline optimization dataset item containing a query, expected answer, and evaluation criteria.
- *
- * @deprecated Use `AgentOptimizationDatasetItem` instead.
- */
-export type OptimizationDatasetItem = AgentOptimizationDatasetItem;
-/**
- * A named evaluation instruction used to score an optimization dataset item.
- *
- * @deprecated Use `AgentOptimizationDatasetCriterion` instead.
- */
-export type OptimizationDatasetCriterion = AgentOptimizationDatasetCriterion;
-/**
- * A reference to a registered Foundry dataset by name and optional version for agent optimization.
- *
- * @deprecated Use `AgentOptimizationReferenceDatasetInput` instead.
- */
-export type OptimizationReferenceDatasetInput = AgentOptimizationReferenceDatasetInput;
-/**
- * A reference to an evaluator by name and optional version for an agent optimization job.
- *
- * @deprecated Use `AgentOptimizationEvaluatorRef` instead.
- */
-export type OptimizationEvaluatorRef = AgentOptimizationEvaluatorRef;
-/**
- * Settings that control candidate generation, model selection, and evaluation for an agent
- * optimization job.
- *
- * @deprecated Use `AgentOptimizationOptions` instead.
- */
-export type OptimizationOptions = AgentOptimizationOptions;
 /**
  * The evaluated candidates and identifiers of the baseline and best candidate from an optimization
  * job.
@@ -5959,20 +5685,6 @@ export type OptimizationJobResult = AgentOptimizationJobResult;
  * @deprecated Use `AgentOptimizationCandidate` instead.
  */
 export type OptimizationCandidate = AgentOptimizationCandidate;
-/**
- * A progress snapshot containing completed candidate counts, the best score, and elapsed execution
- * time.
- *
- * @deprecated Use `AgentOptimizationJobProgress` instead.
- */
-export type OptimizationJobProgress = AgentOptimizationJobProgress;
-/**
- * A summary of an agent optimization job returned by a list operation.
- *
- * @deprecated Use `AgentOptimizationJobListItem` instead.
- */
-export type OptimizationJobListItem = AgentOptimizationJobListItem;
-export declare function agentOptimizationJobListItemDeserializer(item: any): AgentOptimizationJobListItem;
 /** model interface UpdateToolboxRequest */
 export interface UpdateToolboxRequest {
     /** The name of the toolbox to update. */
@@ -5991,7 +5703,7 @@ export type AgentDefinitionOptInKeys = "WorkflowAgents=V1Preview" | "ExternalAge
 /** Type of PageOrder */
 export type PageOrder = "asc" | "desc";
 /** Type of FoundryFeaturesOptInKeys */
-export type FoundryFeaturesOptInKeys = "Evaluations=V1Preview" | "Schedules=V1Preview" | "RedTeams=V1Preview" | "Insights=V1Preview" | "AgentInsights=V1Preview" | "MemoryStores=V1Preview" | "Routines=V1Preview" | "Routines=V2Preview" | "Skills=V1Preview" | "DataGenerationJobs=V1Preview" | "Models=V1Preview" | "AgentsOptimization=V2Preview" | "ModelRouterControls=V1Preview";
+export type FoundryFeaturesOptInKeys = "Evaluations=V1Preview" | "Schedules=V1Preview" | "RedTeams=V1Preview" | "Insights=V1Preview" | "AgentInsights=V1Preview" | "MemoryStores=V1Preview" | "Routines=V1Preview" | "Routines=V2Preview" | "Skills=V1Preview" | "DataGenerationJobs=V1Preview" | "Models=V1Preview" | "ModelRouterControls=V1Preview";
 /** The type of pending upload. */
 export type PendingUploadType = "None" | "BlobReference" | "TemporaryBlobReference";
 /** Type of MemoryStoreType */
@@ -10129,4 +9841,792 @@ export type BetaVoiceAgentsConversationsDownloadAudioItemResponse = {
      */
     readableStreamBody?: NodeReadableStream;
 };
+/** Summary of candidates produced by an agent optimization job. */
+export interface AgentOptimizationResultCandidateSummary {
+    /** Number of completed candidates. Does not include the baseline. */
+    completed_candidate_count: number;
+    /** Candidate ID of the original baseline. Omitted until the baseline candidate is available. */
+    baseline_id?: string;
+    /** Candidate ID of the highest-scoring candidate for evaluated jobs, or the selected transformed output for non-comparative jobs. Omitted until a candidate has been selected. */
+    best_id?: string;
+    /** Normalized score of the baseline candidate from 0.0 to 1.0 for a comparatively evaluated job. Omitted otherwise and until baseline evaluation completes. */
+    baseline_score?: number;
+    /** Best normalized score observed from 0.0 to 1.0 for a comparatively evaluated job. Omitted otherwise and until a candidate completes evaluation. */
+    best_score?: number;
+    /** Most recently promoted candidate for the job. Omitted if no candidates have been promoted. */
+    latest_promoted_candidate?: AgentOptimizationCandidatePromotionInfo;
+}
+export declare function agentOptimizationResultCandidateSummaryDeserializer(item: any): AgentOptimizationResultCandidateSummary;
+/** Promotion metadata recorded for a candidate. */
+export interface AgentOptimizationCandidatePromotionInfo {
+    /** Timestamp when promotion occurred, represented in Unix time. */
+    promoted_at: Date;
+    /** Agent reference associated with the completed promotion. */
+    promoted_agent: AgentReference;
+}
+export declare function agentOptimizationCandidatePromotionInfoDeserializer(item: any): AgentOptimizationCandidatePromotionInfo;
+/** model interface AgentReference */
+export interface AgentReference {
+    type: "agent_reference";
+    /** The name of the agent. */
+    name: string;
+    /** The version identifier of the agent. */
+    version?: string;
+}
+export declare function agentReferenceDeserializer(item: any): AgentReference;
+export declare function agentOptimizationJobTokenUsageArrayDeserializer(result: Array<AgentOptimizationJobTokenUsage>): any[];
+/** Aggregated token usage for one optimization stage and model. */
+export interface AgentOptimizationJobTokenUsage {
+    /** Optimization stage that generated these calls. */
+    stage: AgentOptimizationStage;
+    /** Model name or deployment name that served the calls. */
+    model?: string;
+    /** Total input tokens. Omitted when unmeasured. */
+    input_tokens?: number;
+    /** Total output tokens. Omitted when unmeasured. */
+    output_tokens?: number;
+    /** Sum of input_tokens + output_tokens. Omitted when unmeasured. */
+    total_tokens?: number;
+    /** Input tokens served from the model's cache. Included in input_tokens and not additive. If omitted, the service defaults to 0. */
+    cached_tokens?: number;
+    /** Reasoning tokens counted separately by reasoning models. Included in output_tokens and not additive. If omitted, the service defaults to 0. */
+    reasoning_tokens?: number;
+}
+export declare function agentOptimizationJobTokenUsageDeserializer(item: any): AgentOptimizationJobTokenUsage;
+/** Stage of optimization that consumed model resources. */
+export type AgentOptimizationStage = "agent" | "evaluation" | "optimization";
+export declare function agentOptimizationJobLatencyArrayDeserializer(result: Array<AgentOptimizationJobLatency>): any[];
+/** Average latency for one optimization stage and model. */
+export interface AgentOptimizationJobLatency {
+    /** Optimization stage measured by this entry. */
+    stage: AgentOptimizationStage;
+    /** Model name or deployment name measured by this entry. */
+    model?: string;
+    /** Average per-call latency, rounded to milliseconds. */
+    avg_latency_ms: number;
+    /** Total number of calls contributing to this entry. */
+    call_count: number;
+}
+export declare function agentOptimizationJobLatencyDeserializer(item: any): AgentOptimizationJobLatency;
+/** Reason the optimization process ended. Early termination reasons still indicate a successful job; completed candidates remain available. */
+export type AgentOptimizationTerminationReason = "completed" | "budget_exhausted" | "candidate_screening_stalled";
+/** Base target configuration for an optimization job. */
+export interface AgentOptimizationTargetConfiguration {
+    /** Target configuration type. Additional types may be added in future API versions. */
+    /** The discriminator possible values: foundry_agent */
+    type: AgentOptimizationTargetConfigurationType;
+}
+export declare function agentOptimizationTargetConfigurationSerializer(item: AgentOptimizationTargetConfiguration): any;
+export declare function agentOptimizationTargetConfigurationDeserializer(item: any): AgentOptimizationTargetConfiguration;
+/** Alias for AgentOptimizationTargetConfigurationUnion */
+export type AgentOptimizationTargetConfigurationUnion = AgentOptimizationFoundryAgentTargetConfiguration | AgentOptimizationTargetConfiguration;
+export declare function agentOptimizationTargetConfigurationUnionSerializer(item: AgentOptimizationTargetConfigurationUnion): any;
+export declare function agentOptimizationTargetConfigurationUnionDeserializer(item: any): AgentOptimizationTargetConfigurationUnion;
+/** Target configuration types supported by optimization jobs. */
+export type AgentOptimizationTargetConfigurationType = "foundry_agent";
+/** Identifies the Foundry agent that owns the configuration being optimized. */
+export interface AgentOptimizationFoundryAgentTargetConfiguration extends AgentOptimizationTargetConfiguration {
+    /** Foundry-agent target discriminator. */
+    type: "foundry_agent";
+    /** Registered Foundry agent name. */
+    name: string;
+    /** Pinned agent version. Omitted to resolve and pin the latest version. */
+    version?: string;
+}
+export declare function agentOptimizationFoundryAgentTargetConfigurationSerializer(item: AgentOptimizationFoundryAgentTargetConfiguration): any;
+export declare function agentOptimizationFoundryAgentTargetConfigurationDeserializer(item: any): AgentOptimizationFoundryAgentTargetConfiguration;
+/** Identifies a model used by an optimization or evaluation step. */
+export interface AgentOptimizationModelConfiguration {
+    /** Model name or existing deployment name in the Foundry project. */
+    model: string;
+}
+export declare function agentOptimizationModelConfigurationSerializer(item: AgentOptimizationModelConfiguration): any;
+export declare function agentOptimizationModelConfigurationDeserializer(item: any): AgentOptimizationModelConfiguration;
+/** Base model for type-specific optimization configuration. */
+export interface AgentOptimizationConfigurationBase {
+    /** Optimization type discriminator. */
+    /** The discriminator possible values: agent_optimization, prompt_optimization */
+    type: AgentOptimizationConfigurationType;
+}
+export declare function agentOptimizationConfigurationBaseSerializer(item: AgentOptimizationConfigurationBase): any;
+export declare function agentOptimizationConfigurationBaseDeserializer(item: any): AgentOptimizationConfigurationBase;
+/** Alias for AgentOptimizationConfigurationBaseUnion */
+export type AgentOptimizationConfigurationBaseUnion = AgentOptimizationConfiguration | PromptOptimizationConfiguration | AgentOptimizationConfigurationBase;
+export declare function agentOptimizationConfigurationBaseUnionSerializer(item: AgentOptimizationConfigurationBaseUnion): any;
+export declare function agentOptimizationConfigurationBaseUnionDeserializer(item: any): AgentOptimizationConfigurationBaseUnion;
+/** Optimization job configuration types. */
+export type AgentOptimizationConfigurationType = "agent_optimization" | "prompt_optimization";
+/** Configuration for optimizing an agent for measured quality. */
+export interface AgentOptimizationConfiguration extends AgentOptimizationConfigurationBase {
+    /** Optimization type discriminator. */
+    type: "agent_optimization";
+    /** Optimization goal. If omitted, the service defaults to improve_quality. */
+    goal?: AgentOptimizationGoal;
+    /** Quality measurement configuration. */
+    evaluation_configuration: AgentOptimizationEvaluationConfiguration;
+    /** Configuration for candidate search and screening. */
+    candidate_search_configuration: AgentOptimizationCandidateSearchConfiguration;
+    /** Caller-supplied baseline agent configuration. Omitted when all baseline values can be resolved from the target agent. */
+    baseline_agent_configuration?: AgentOptimizationBaselineAgentConfiguration;
+    /** Agent attributes and alternatives available to the search. */
+    agent_optimization_space: AgentOptimizationSpace;
+}
+export declare function agentOptimizationConfigurationSerializer(item: AgentOptimizationConfiguration): any;
+export declare function agentOptimizationConfigurationDeserializer(item: any): AgentOptimizationConfiguration;
+/** Goal for an agent-optimization job. */
+export type AgentOptimizationGoal = "improve_quality";
+/** Reusable quality-measurement configuration. */
+export interface AgentOptimizationEvaluationConfiguration {
+    /** Evaluation set used to guide the optimization search. Inline data supports up to 2,000 test cases when a separate validation set is supplied; otherwise it is also used for validation and is limited to 500. */
+    training_set: AgentOptimizationEvaluationSetUnion;
+    /** Held-out evaluation set used for full candidate evaluation, limited to 500 inline test cases. The training set is reused and subject to the same 500-test-case validation limit when omitted. */
+    validation_set?: AgentOptimizationEvaluationSetUnion;
+    /** Evaluator references used to score candidate quality. */
+    evaluators: AgentOptimizationEvaluator[];
+    /** Model configuration used by model-based evaluators and conversation simulation. */
+    evaluation_model: EvaluationModelConfiguration;
+    /** Maximum number of target-agent runs executed concurrently during each single-turn evaluation. If omitted, the service defaults to 1. Conversation evaluation supports only 1. */
+    max_concurrent_agent_runs?: number;
+}
+export declare function agentOptimizationEvaluationConfigurationSerializer(item: AgentOptimizationEvaluationConfiguration): any;
+export declare function agentOptimizationEvaluationConfigurationDeserializer(item: any): AgentOptimizationEvaluationConfiguration;
+/** Base discriminated model for an optimization evaluation set. */
+export interface AgentOptimizationEvaluationSet {
+    /** Logical format of the evaluation set rows. */
+    /** The discriminator possible values: target_completion, user_conversation_simulation */
+    type: AgentOptimizationEvaluationSetType;
+}
+export declare function agentOptimizationEvaluationSetSerializer(item: AgentOptimizationEvaluationSet): any;
+export declare function agentOptimizationEvaluationSetDeserializer(item: any): AgentOptimizationEvaluationSet;
+/** Alias for AgentOptimizationEvaluationSetUnion */
+export type AgentOptimizationEvaluationSetUnion = AgentOptimizationTargetCompletionEvaluationSet | AgentOptimizationUserConversationSimulationEvaluationSet | AgentOptimizationEvaluationSet;
+export declare function agentOptimizationEvaluationSetUnionSerializer(item: AgentOptimizationEvaluationSetUnion): any;
+export declare function agentOptimizationEvaluationSetUnionDeserializer(item: any): AgentOptimizationEvaluationSetUnion;
+/** Logical row formats supported by optimization evaluation sets. */
+export type AgentOptimizationEvaluationSetType = "target_completion" | "user_conversation_simulation";
+/** Evaluation set containing independent single-turn inputs. */
+export interface AgentOptimizationTargetCompletionEvaluationSet extends AgentOptimizationEvaluationSet {
+    /** Target-completion set discriminator. */
+    type: "target_completion";
+    /** Inline test cases or an explicitly versioned registered Foundry dataset. */
+    source: AgentOptimizationTargetCompletionDataSourceUnion;
+}
+export declare function agentOptimizationTargetCompletionEvaluationSetSerializer(item: AgentOptimizationTargetCompletionEvaluationSet): any;
+export declare function agentOptimizationTargetCompletionEvaluationSetDeserializer(item: any): AgentOptimizationTargetCompletionEvaluationSet;
+/** Base source for a target-completion optimization evaluation set. */
+export interface AgentOptimizationTargetCompletionDataSource {
+    /** Target-completion source type. Additional types may be added in future API versions. */
+    /** The discriminator possible values: inline, dataset_reference */
+    type: AgentOptimizationDataSourceType;
+}
+export declare function agentOptimizationTargetCompletionDataSourceSerializer(item: AgentOptimizationTargetCompletionDataSource): any;
+export declare function agentOptimizationTargetCompletionDataSourceDeserializer(item: any): AgentOptimizationTargetCompletionDataSource;
+/** Alias for AgentOptimizationTargetCompletionDataSourceUnion */
+export type AgentOptimizationTargetCompletionDataSourceUnion = AgentOptimizationTargetCompletionInlineDataSource | AgentOptimizationTargetCompletionDatasetReferenceDataSource | AgentOptimizationTargetCompletionDataSource;
+export declare function agentOptimizationTargetCompletionDataSourceUnionSerializer(item: AgentOptimizationTargetCompletionDataSourceUnion): any;
+export declare function agentOptimizationTargetCompletionDataSourceUnionDeserializer(item: any): AgentOptimizationTargetCompletionDataSourceUnion;
+/** Source types supported by optimization evaluation sets. */
+export type AgentOptimizationDataSourceType = "inline" | "dataset_reference";
+/** Supplies single-turn rows directly in the optimization request. */
+export interface AgentOptimizationTargetCompletionInlineDataSource extends AgentOptimizationTargetCompletionDataSource {
+    /** Inline source discriminator. */
+    type: "inline";
+    /** Target-completion test cases. */
+    test_cases: AgentOptimizationTargetCompletionTestCase[];
+}
+export declare function agentOptimizationTargetCompletionInlineDataSourceSerializer(item: AgentOptimizationTargetCompletionInlineDataSource): any;
+export declare function agentOptimizationTargetCompletionInlineDataSourceDeserializer(item: any): AgentOptimizationTargetCompletionInlineDataSource;
+export declare function agentOptimizationTargetCompletionTestCaseArraySerializer(result: Array<AgentOptimizationTargetCompletionTestCase>): any[];
+export declare function agentOptimizationTargetCompletionTestCaseArrayDeserializer(result: Array<AgentOptimizationTargetCompletionTestCase>): any[];
+/** A single item in an inline evaluation set. */
+export interface AgentOptimizationTargetCompletionTestCase {
+    /** The user query / prompt. */
+    query: string;
+    /** Expected ground truth answer. Omitted when no ground truth is supplied. */
+    ground_truth?: string;
+}
+export declare function agentOptimizationTargetCompletionTestCaseSerializer(item: AgentOptimizationTargetCompletionTestCase): any;
+export declare function agentOptimizationTargetCompletionTestCaseDeserializer(item: any): AgentOptimizationTargetCompletionTestCase;
+/** References an explicitly versioned registered Foundry dataset for target-completion evaluation. */
+export interface AgentOptimizationTargetCompletionDatasetReferenceDataSource extends AgentOptimizationTargetCompletionDataSource {
+    /** Registered dataset source discriminator. */
+    type: "dataset_reference";
+    /** Registered dataset name. */
+    name: string;
+    /** Registered dataset version. */
+    version: string;
+}
+export declare function agentOptimizationTargetCompletionDatasetReferenceDataSourceSerializer(item: AgentOptimizationTargetCompletionDatasetReferenceDataSource): any;
+export declare function agentOptimizationTargetCompletionDatasetReferenceDataSourceDeserializer(item: any): AgentOptimizationTargetCompletionDatasetReferenceDataSource;
+/** Evaluation set containing scenarios for simulated conversations. */
+export interface AgentOptimizationUserConversationSimulationEvaluationSet extends AgentOptimizationEvaluationSet {
+    /** User-conversation-simulation set discriminator. */
+    type: "user_conversation_simulation";
+    /** Inline test cases or an explicitly versioned registered Foundry dataset. */
+    source: AgentOptimizationUserConversationSimulationDataSourceUnion;
+    /** Defaults applied to every scenario. A test case's simulation_configuration overrides corresponding properties. */
+    default_simulation_configuration?: UserConversationSimulationConfiguration;
+}
+export declare function agentOptimizationUserConversationSimulationEvaluationSetSerializer(item: AgentOptimizationUserConversationSimulationEvaluationSet): any;
+export declare function agentOptimizationUserConversationSimulationEvaluationSetDeserializer(item: any): AgentOptimizationUserConversationSimulationEvaluationSet;
+/** Base source for a user-conversation-simulation optimization evaluation set. */
+export interface AgentOptimizationUserConversationSimulationDataSource {
+    /** User-conversation-simulation source type. Additional types may be added in future API versions. */
+    /** The discriminator possible values: inline, dataset_reference */
+    type: AgentOptimizationDataSourceType;
+}
+export declare function agentOptimizationUserConversationSimulationDataSourceSerializer(item: AgentOptimizationUserConversationSimulationDataSource): any;
+export declare function agentOptimizationUserConversationSimulationDataSourceDeserializer(item: any): AgentOptimizationUserConversationSimulationDataSource;
+/** Alias for AgentOptimizationUserConversationSimulationDataSourceUnion */
+export type AgentOptimizationUserConversationSimulationDataSourceUnion = AgentOptimizationUserConversationSimulationInlineDataSource | AgentOptimizationUserConversationSimulationDatasetReferenceDataSource | AgentOptimizationUserConversationSimulationDataSource;
+export declare function agentOptimizationUserConversationSimulationDataSourceUnionSerializer(item: AgentOptimizationUserConversationSimulationDataSourceUnion): any;
+export declare function agentOptimizationUserConversationSimulationDataSourceUnionDeserializer(item: any): AgentOptimizationUserConversationSimulationDataSourceUnion;
+/** Supplies Evals user-conversation simulation test cases directly in the optimization request. */
+export interface AgentOptimizationUserConversationSimulationInlineDataSource extends AgentOptimizationUserConversationSimulationDataSource {
+    /** Inline source discriminator. */
+    type: "inline";
+    /** Conversation test scenarios. */
+    test_cases: UserConversationSimulationTestCase[];
+}
+export declare function agentOptimizationUserConversationSimulationInlineDataSourceSerializer(item: AgentOptimizationUserConversationSimulationInlineDataSource): any;
+export declare function agentOptimizationUserConversationSimulationInlineDataSourceDeserializer(item: any): AgentOptimizationUserConversationSimulationInlineDataSource;
+export declare function userConversationSimulationTestCaseArraySerializer(result: Array<UserConversationSimulationTestCase>): any[];
+export declare function userConversationSimulationTestCaseArrayDeserializer(result: Array<UserConversationSimulationTestCase>): any[];
+/** Defines one test scenario. Simulation configuration properties specified here override the corresponding data-source defaults. */
+export interface UserConversationSimulationTestCase {
+    /** Identifier for the test case. When omitted, the service generates a random identifier. */
+    test_case_id?: string;
+    /** Category used to group related test cases. When omitted, the service leaves the category null. */
+    test_case_category?: string;
+    /** Scenario, simulated user goal, and behavioral constraints that guide the conversation. The length must be from 1 through 2,500 characters. */
+    test_case_description?: string;
+    /** Configuration for conversations generated from this test case. Each specified property overrides the corresponding property in `default_simulation_configuration`. */
+    simulation_configuration?: UserConversationSimulationConfiguration;
+}
+export declare function userConversationSimulationTestCaseSerializer(item: UserConversationSimulationTestCase): any;
+export declare function userConversationSimulationTestCaseDeserializer(item: any): UserConversationSimulationTestCase;
+/** Configures the number, length, audio effects, and simulated user behavior of conversations. */
+export interface UserConversationSimulationConfiguration {
+    /** Hard limit on turns in each conversation. When omitted, the service defaults to 20. */
+    max_num_turns?: number;
+    /** Number of independent conversation repetitions for each test case. Defaults to 1 when not specified at either the data-source or test-case level. */
+    conversation_repetitions?: number;
+    /** Target number of turns in each conversation. The effective value cannot exceed the effective `max_num_turns`. When omitted, no target is set and the simulation model determines the conversation length dynamically from the scenario. */
+    desired_num_turns?: number;
+    /** Audio effects applied to voice conversation simulations. This property is ignored for text-only simulations. */
+    audio_effects?: UserConversationSimulationAudioEffectsConfiguration;
+    /** Conversation behavior of the simulated user. */
+    user_behavior?: UserConversationSimulationUserBehaviorConfiguration;
+}
+export declare function userConversationSimulationConfigurationSerializer(item: UserConversationSimulationConfiguration): any;
+export declare function userConversationSimulationConfigurationDeserializer(item: any): UserConversationSimulationConfiguration;
+/** Configures effects applied to simulated conversation audio. */
+export interface UserConversationSimulationAudioEffectsConfiguration {
+    /** Effects to apply to simulated audio. */
+    effects?: UserConversationSimulationAudioEffect[];
+    /** Volume of the configured audio effects, as a percentage from 1 through 100. When omitted, the service defaults to 15. */
+    volume_percentage?: number;
+}
+export declare function userConversationSimulationAudioEffectsConfigurationSerializer(item: UserConversationSimulationAudioEffectsConfiguration): any;
+export declare function userConversationSimulationAudioEffectsConfigurationDeserializer(item: any): UserConversationSimulationAudioEffectsConfiguration;
+/** Effect that can be applied to simulated conversation audio. The union is extensible for additional effects. */
+export type UserConversationSimulationAudioEffect = "street_traffic" | "crowd_chatter" | "background_tv" | "metro_station" | "telephonic_voice";
+/** Configures conversation behavior for the simulated user. */
+export interface UserConversationSimulationUserBehaviorConfiguration {
+    /** Configures how the simulated user interrupts the target while it is speaking. Omit to disable interruption. */
+    interruption?: UserConversationSimulationInterruptionConfigurationUnion;
+}
+export declare function userConversationSimulationUserBehaviorConfigurationSerializer(item: UserConversationSimulationUserBehaviorConfiguration): any;
+export declare function userConversationSimulationUserBehaviorConfigurationDeserializer(item: any): UserConversationSimulationUserBehaviorConfiguration;
+/** Configuration for simulated user interruption behavior. */
+export interface UserConversationSimulationInterruptionConfiguration {
+    /** The interruption type. */
+    /** The discriminator possible values: default */
+    type: string;
+}
+export declare function userConversationSimulationInterruptionConfigurationSerializer(item: UserConversationSimulationInterruptionConfiguration): any;
+export declare function userConversationSimulationInterruptionConfigurationDeserializer(item: any): UserConversationSimulationInterruptionConfiguration;
+/** Alias for UserConversationSimulationInterruptionConfigurationUnion */
+export type UserConversationSimulationInterruptionConfigurationUnion = UserConversationSimulationDefaultInterruptionConfiguration | UserConversationSimulationInterruptionConfiguration;
+export declare function userConversationSimulationInterruptionConfigurationUnionSerializer(item: UserConversationSimulationInterruptionConfigurationUnion): any;
+export declare function userConversationSimulationInterruptionConfigurationUnionDeserializer(item: any): UserConversationSimulationInterruptionConfigurationUnion;
+/** Configures the default interruption behavior for the simulated user. */
+export interface UserConversationSimulationDefaultInterruptionConfiguration extends UserConversationSimulationInterruptionConfiguration {
+    /** The interruption type, always `default`. */
+    type: "default";
+}
+export declare function userConversationSimulationDefaultInterruptionConfigurationSerializer(item: UserConversationSimulationDefaultInterruptionConfiguration): any;
+export declare function userConversationSimulationDefaultInterruptionConfigurationDeserializer(item: any): UserConversationSimulationDefaultInterruptionConfiguration;
+/** References an explicitly versioned registered Foundry dataset for user-conversation-simulation evaluation. */
+export interface AgentOptimizationUserConversationSimulationDatasetReferenceDataSource extends AgentOptimizationUserConversationSimulationDataSource {
+    /** Registered dataset source discriminator. */
+    type: "dataset_reference";
+    /** Registered dataset name. */
+    name: string;
+    /** Registered dataset version. */
+    version: string;
+}
+export declare function agentOptimizationUserConversationSimulationDatasetReferenceDataSourceSerializer(item: AgentOptimizationUserConversationSimulationDatasetReferenceDataSource): any;
+export declare function agentOptimizationUserConversationSimulationDatasetReferenceDataSourceDeserializer(item: any): AgentOptimizationUserConversationSimulationDatasetReferenceDataSource;
+export declare function agentOptimizationEvaluatorArraySerializer(result: Array<AgentOptimizationEvaluator>): any[];
+export declare function agentOptimizationEvaluatorArrayDeserializer(result: Array<AgentOptimizationEvaluator>): any[];
+/** Reference to a named evaluator, optionally pinned to a version. */
+export interface AgentOptimizationEvaluator {
+    /** Evaluator name. */
+    name: string;
+    /** Evaluator version. Omitted to use the latest version. */
+    version?: string;
+    /** Parameters passed to the evaluator at initialization. Omitted when the evaluator requires no initialization parameters. */
+    initialization_parameters?: Record<string, any>;
+}
+export declare function agentOptimizationEvaluatorSerializer(item: AgentOptimizationEvaluator): any;
+export declare function agentOptimizationEvaluatorDeserializer(item: any): AgentOptimizationEvaluator;
+/** Configures the model that plays the simulated user. This model is separate from the evaluated `target`. */
+export interface EvaluationModelConfiguration {
+    /** Model deployment that generates simulated user turns, in the format `{connectionName}/modelDeploymentName`. */
+    model: string;
+    /** Sampling parameters applied when the simulation model produces user turns. */
+    sampling_params?: ModelSamplingParams;
+    /** Voice configuration used to convert simulated user text to speech. Currently, only Azure standard voices are supported. Omit for text-only simulation. */
+    voice_model?: EvaluationVoiceModelConfigurationUnion;
+}
+export declare function evaluationModelConfigurationSerializer(item: EvaluationModelConfiguration): any;
+export declare function evaluationModelConfigurationDeserializer(item: any): EvaluationModelConfiguration;
+/** Voice configuration used to convert text to speech for evaluation through the Voice Live endpoint. */
+export interface EvaluationVoiceModelConfiguration {
+    /** The voice kind. */
+    /** The discriminator possible values: azure-standard */
+    type: string;
+}
+export declare function evaluationVoiceModelConfigurationSerializer(item: EvaluationVoiceModelConfiguration): any;
+export declare function evaluationVoiceModelConfigurationDeserializer(item: any): EvaluationVoiceModelConfiguration;
+/** Alias for EvaluationVoiceModelConfigurationUnion */
+export type EvaluationVoiceModelConfigurationUnion = EvaluationAzureStandardVoiceModelConfiguration | EvaluationVoiceModelConfiguration;
+export declare function evaluationVoiceModelConfigurationUnionSerializer(item: EvaluationVoiceModelConfigurationUnion): any;
+export declare function evaluationVoiceModelConfigurationUnionDeserializer(item: any): EvaluationVoiceModelConfigurationUnion;
+/** Configures an Azure standard neural voice used to convert text to speech for evaluation through the Voice Live endpoint. */
+export interface EvaluationAzureStandardVoiceModelConfiguration extends EvaluationVoiceModelConfiguration {
+    /** The voice kind. Always `azure-standard`. */
+    type: "azure-standard";
+    /** The Azure neural voice name. */
+    name: string;
+    /** The synthesis temperature, from 0 to 1. When omitted, the service defaults to the underlying voice model's default temperature. */
+    temperature?: number;
+}
+export declare function evaluationAzureStandardVoiceModelConfigurationSerializer(item: EvaluationAzureStandardVoiceModelConfiguration): any;
+export declare function evaluationAzureStandardVoiceModelConfigurationDeserializer(item: any): EvaluationAzureStandardVoiceModelConfiguration;
+/** Candidate search settings. */
+export interface AgentOptimizationCandidateSearchConfiguration {
+    /** Maximum number of non-baseline candidates to fully evaluate. If omitted, the service defaults to 1. */
+    max_candidates?: number;
+}
+export declare function agentOptimizationCandidateSearchConfigurationSerializer(item: AgentOptimizationCandidateSearchConfiguration): any;
+export declare function agentOptimizationCandidateSearchConfigurationDeserializer(item: any): AgentOptimizationCandidateSearchConfiguration;
+/** Caller-supplied baseline agent values that cannot be resolved from the target agent. */
+export interface AgentOptimizationBaselineAgentConfiguration {
+    /** Caller-supplied baseline system prompt. Omitted to resolve the baseline from the target; a prompt agent's stored definition is authoritative. */
+    system_prompt?: string;
+    /** Current model name. An existing deployment name is also accepted. Omitted to resolve the model from the target. */
+    current_model?: string;
+    /** Skills available for optimization. Omitted when no manual skill surface is supplied. */
+    skills?: AgentOptimizationSkill[];
+    /** Function tools available for optimization. Omitted when no manual tool surface is supplied. The optimizer may change function and argument descriptions while preserving names and parameter JSON Schema. */
+    tools?: ChatCompletionTool[];
+}
+export declare function agentOptimizationBaselineAgentConfigurationSerializer(item: AgentOptimizationBaselineAgentConfiguration): any;
+export declare function agentOptimizationBaselineAgentConfigurationDeserializer(item: any): AgentOptimizationBaselineAgentConfiguration;
+export declare function agentOptimizationSkillArraySerializer(result: Array<AgentOptimizationSkill>): any[];
+export declare function agentOptimizationSkillArrayDeserializer(result: Array<AgentOptimizationSkill>): any[];
+/** A skill in the manually supplied agent optimization surface. */
+export interface AgentOptimizationSkill {
+    /** Stable skill name. */
+    name: string;
+    /** Short description used for skill discovery and progressive disclosure. */
+    description: string;
+    /** Skill instructions or content that may be optimized. Omitted when the skill has no body. */
+    body?: string;
+}
+export declare function agentOptimizationSkillSerializer(item: AgentOptimizationSkill): any;
+export declare function agentOptimizationSkillDeserializer(item: any): AgentOptimizationSkill;
+/** The agent attributes and alternative values available to an agent-optimization search. */
+export interface AgentOptimizationSpace {
+    /** Agent attributes the optimizer may change. If omitted, the service defaults to instructions. */
+    target_attributes?: TargetAttribute[];
+    /** Alternative model names or existing deployment names available when model is an optimization target. */
+    model_search_space?: string[];
+}
+export declare function agentOptimizationSpaceSerializer(item: AgentOptimizationSpace): any;
+export declare function agentOptimizationSpaceDeserializer(item: any): AgentOptimizationSpace;
+/** Agent attribute that can be optimized. */
+export type TargetAttribute = "instructions" | "model" | "skills" | "tools";
+/** Configuration for a one-shot prompt transformation without comparative evaluation. */
+export interface PromptOptimizationConfiguration extends AgentOptimizationConfigurationBase {
+    /** Optimization type discriminator. */
+    type: "prompt_optimization";
+    /** Context used to steer prompt optimization. Omitted when no context is supplied. */
+    context?: OptimizationContextUnion[];
+}
+export declare function promptOptimizationConfigurationSerializer(item: PromptOptimizationConfiguration): any;
+export declare function promptOptimizationConfigurationDeserializer(item: any): PromptOptimizationConfiguration;
+export declare function optimizationContextUnionArraySerializer(result: Array<OptimizationContextUnion>): any[];
+export declare function optimizationContextUnionArrayDeserializer(result: Array<OptimizationContextUnion>): any[];
+/** Base model for typed optimization context. */
+export interface OptimizationContext {
+    /** Optimization context type discriminator. */
+    /** The discriminator possible values: steering_prompt */
+    type: OptimizationContextType;
+}
+export declare function optimizationContextSerializer(item: OptimizationContext): any;
+export declare function optimizationContextDeserializer(item: any): OptimizationContext;
+/** Alias for OptimizationContextUnion */
+export type OptimizationContextUnion = SteeringPromptOptimizationContext | OptimizationContext;
+export declare function optimizationContextUnionSerializer(item: OptimizationContextUnion): any;
+export declare function optimizationContextUnionDeserializer(item: any): OptimizationContextUnion;
+/** Type of context supplied to an optimization workflow. */
+export type OptimizationContextType = "steering_prompt";
+/** Natural-language guidance for the desired optimization. */
+export interface SteeringPromptOptimizationContext extends OptimizationContext {
+    /** Optimization context type discriminator. */
+    type: "steering_prompt";
+    /** Developer guidance describing the desired changes. */
+    prompt: string;
+}
+export declare function steeringPromptOptimizationContextSerializer(item: SteeringPromptOptimizationContext): any;
+export declare function steeringPromptOptimizationContextDeserializer(item: any): SteeringPromptOptimizationContext;
+/** Inputs for estimating an agent-optimization job. */
+export interface AgentOptimizationEstimateInputs {
+    /** Foundry agent whose configuration would be optimized. Omitted when the workflow does not target a registered Foundry agent. */
+    target_configuration?: AgentOptimizationTargetConfigurationUnion;
+    /** Model that would generate candidate changes. An existing deployment name is also accepted. */
+    optimization_model_configuration: AgentOptimizationModelConfiguration;
+    /** Agent-optimization configuration to estimate. */
+    optimization_configuration: AgentOptimizationConfiguration;
+}
+export declare function agentOptimizationEstimateInputsSerializer(item: AgentOptimizationEstimateInputs): any;
+/** Result returned when estimating an agent-optimization job. */
+export interface AgentOptimizationEstimateResult {
+    /** Estimated model-call counts grouped by optimization stage. Typical values are calibrated expectations and may be fractional. */
+    call_counts?: AgentOptimizationStageEstimate;
+    /** Estimated monetary cost. Omitted when no contributing model has pricing data. */
+    cost?: AgentOptimizationCostEstimate;
+    /** Timestamp of the pricing snapshot used for cost estimation, represented in Unix time. Omitted when no valid pricing snapshot is available. */
+    prices_as_of?: Date;
+}
+export declare function agentOptimizationEstimateResultDeserializer(item: any): AgentOptimizationEstimateResult;
+/** Estimated values grouped by optimization stage. */
+export interface AgentOptimizationStageEstimate {
+    /** Estimated values for calls made by the agent being optimized. */
+    agent?: AgentOptimizationEstimateBand;
+    /** Estimated values for calls that evaluate candidate quality. */
+    evaluation?: AgentOptimizationEstimateBand;
+    /** Estimated values for calls that generate candidate changes. */
+    optimization?: AgentOptimizationEstimateBand;
+}
+export declare function agentOptimizationStageEstimateDeserializer(item: any): AgentOptimizationStageEstimate;
+/** A low/typical/ceiling range for an estimated quantity. Expected values may be fractional, including estimated model-call counts. */
+export interface AgentOptimizationEstimateBand {
+    /** Lower bound. */
+    low: number;
+    /** Central estimate. */
+    typical: number;
+    /** Upper bound. */
+    ceiling: number;
+}
+export declare function agentOptimizationEstimateBandDeserializer(item: any): AgentOptimizationEstimateBand;
+/** Estimated monetary cost. Present only when at least one contributing model has pricing data. */
+export interface AgentOptimizationCostEstimate {
+    /** ISO 4217 currency code for all monetary values in this estimate. */
+    currency: string;
+    /** Total estimated cost across all priced stages. */
+    total?: AgentOptimizationEstimateBand;
+    /** Estimated cost grouped by optimization stage. */
+    by_stage?: AgentOptimizationStageEstimate;
+    /** Stages excluded from the total because pricing was unavailable. */
+    unpriced_stages?: AgentOptimizationStage[];
+}
+export declare function agentOptimizationCostEstimateDeserializer(item: any): AgentOptimizationCostEstimate;
+/** The response data for a requested list of items. */
+export interface _AgentsPagedResultAgentOptimizationJob {
+    /** The requested list of items. */
+    data: AgentOptimizationJob[];
+    /** The first ID represented in this list. */
+    first_id?: string;
+    /** The last ID represented in this list. */
+    last_id?: string;
+    /** A value indicating whether there are additional values available not captured in this list. */
+    has_more: boolean;
+}
+export declare function _agentsPagedResultAgentOptimizationJobDeserializer(item: any): _AgentsPagedResultAgentOptimizationJob;
+export declare function agentOptimizationJobArraySerializer(result: Array<AgentOptimizationJob>): any[];
+export declare function agentOptimizationJobArrayDeserializer(result: Array<AgentOptimizationJob>): any[];
+/** The response data for a requested list of items. */
+export interface _AgentsPagedResultAgentOptimizationCandidate {
+    /** The requested list of items. */
+    data: AgentOptimizationCandidate[];
+    /** The first ID represented in this list. */
+    first_id?: string;
+    /** The last ID represented in this list. */
+    last_id?: string;
+    /** A value indicating whether there are additional values available not captured in this list. */
+    has_more: boolean;
+}
+export declare function _agentsPagedResultAgentOptimizationCandidateDeserializer(item: any): _AgentsPagedResultAgentOptimizationCandidate;
+/** The candidate's lifecycle state. */
+export type AgentOptimizationCandidateStatus = "generating" | "evaluating" | "completed" | "failed";
+/** Base candidate output. Job types define derived output models with their own fields. */
+export interface AgentOptimizationCandidateOutput {
+    /** Output type matching the parent job's optimization type. Additional types may be added in future API versions. */
+    /** The discriminator possible values: agent_optimization, prompt_optimization */
+    type: AgentOptimizationConfigurationType;
+}
+export declare function agentOptimizationCandidateOutputDeserializer(item: any): AgentOptimizationCandidateOutput;
+/** Alias for AgentOptimizationCandidateOutputUnion */
+export type AgentOptimizationCandidateOutputUnion = AgentOptimizationAgentCandidateOutput | AgentOptimizationPromptCandidateOutput | AgentOptimizationCandidateOutput;
+export declare function agentOptimizationCandidateOutputUnionDeserializer(item: any): AgentOptimizationCandidateOutputUnion;
+/** Candidate output produced by an agent-optimization job. */
+export interface AgentOptimizationAgentCandidateOutput extends AgentOptimizationCandidateOutput {
+    type: "agent_optimization";
+    /** Typed configuration mutations applied to the baseline. Omitted for the baseline candidate. LIST without `expand=mutations` returns mutation items with only `type`; expanded LIST and candidate GET populate each mutation's `value`. */
+    mutations?: AgentOptimizationMutationUnion[];
+}
+export declare function agentOptimizationAgentCandidateOutputDeserializer(item: any): AgentOptimizationAgentCandidateOutput;
+export declare function agentOptimizationMutationUnionArrayDeserializer(result: Array<AgentOptimizationMutationUnion>): any[];
+/** Base candidate mutation. */
+export interface AgentOptimizationMutation {
+    /** Attribute changed by this mutation. */
+    /** The discriminator possible values: instructions, model, skills, tools */
+    type: TargetAttribute;
+}
+export declare function agentOptimizationMutationDeserializer(item: any): AgentOptimizationMutation;
+/** Alias for AgentOptimizationMutationUnion */
+export type AgentOptimizationMutationUnion = AgentOptimizationInstructionsMutation | AgentOptimizationModelMutation | AgentOptimizationSkillsMutation | AgentOptimizationToolsMutation | AgentOptimizationMutation;
+export declare function agentOptimizationMutationUnionDeserializer(item: any): AgentOptimizationMutationUnion;
+/** Instructions mutation. */
+export interface AgentOptimizationInstructionsMutation extends AgentOptimizationMutation {
+    type: "instructions";
+    /** Optimized agent instructions. Omitted on LIST unless `expand=mutations` is specified. */
+    value?: string;
+}
+export declare function agentOptimizationInstructionsMutationDeserializer(item: any): AgentOptimizationInstructionsMutation;
+/** Model mutation. */
+export interface AgentOptimizationModelMutation extends AgentOptimizationMutation {
+    type: "model";
+    /** Selected model name or deployment name. Omitted on LIST unless `expand=mutations` is specified. */
+    value?: string;
+}
+export declare function agentOptimizationModelMutationDeserializer(item: any): AgentOptimizationModelMutation;
+/** Skill mutations. */
+export interface AgentOptimizationSkillsMutation extends AgentOptimizationMutation {
+    type: "skills";
+    /** Added or changed skills. Omitted on LIST unless `expand=mutations` is specified. */
+    value?: AgentOptimizationSkill[];
+}
+export declare function agentOptimizationSkillsMutationDeserializer(item: any): AgentOptimizationSkillsMutation;
+/** Tool mutations. */
+export interface AgentOptimizationToolsMutation extends AgentOptimizationMutation {
+    type: "tools";
+    /** Added or changed function tools. Omitted on LIST unless `expand=mutations` is specified. */
+    value?: ChatCompletionTool[];
+}
+export declare function agentOptimizationToolsMutationDeserializer(item: any): AgentOptimizationToolsMutation;
+/** Candidate output produced by a prompt-optimization job. */
+export interface AgentOptimizationPromptCandidateOutput extends AgentOptimizationCandidateOutput {
+    type: "prompt_optimization";
+    /** Typed configuration mutations applied to the baseline. Omitted for the baseline candidate. LIST without `expand=mutations` returns mutation items with only `type`; expanded LIST and candidate GET populate each mutation's `value`. */
+    mutations?: AgentOptimizationMutationUnion[];
+}
+export declare function agentOptimizationPromptCandidateOutputDeserializer(item: any): AgentOptimizationPromptCandidateOutput;
+/** Comparative evaluation summary for a candidate. */
+export interface AgentOptimizationCandidateEvaluation {
+    /** Average composite score across evaluated tasks. Omitted until scoring produces an aggregate score. */
+    score?: number;
+    /** Average total tokens consumed per task. Omitted when token usage was not measured. */
+    avg_tokens?: number;
+    /** Average end-to-end latency per task, rounded to milliseconds. */
+    avg_latency_ms?: number;
+    /** Foundry evaluation identifier used to score this candidate. Omitted when unavailable. */
+    eval_id?: string;
+    /** Foundry evaluation run identifier used to score this candidate. Omitted when unavailable. */
+    eval_run_id?: string;
+    /** Timestamp when full candidate evaluation completed, represented in Unix time. Omitted when unavailable. */
+    completed_at?: Date;
+}
+export declare function agentOptimizationCandidateEvaluationDeserializer(item: any): AgentOptimizationCandidateEvaluation;
+/** Alias for DataGenerationJobUnion */
+export type DataGenerationJobUnion = EvaluationDataGenerationJob | SupervisedFineTuningDataGenerationJob | ReinforcementFineTuningDataGenerationJob | DataGenerationJob;
+export declare function dataGenerationJobUnionDeserializer(item: any): DataGenerationJobUnion;
+/** Evaluation data generation job resource. */
+export interface EvaluationDataGenerationJob extends DataGenerationJob {
+    /** The scenario of the data generation job, which is Evaluation for this model. */
+    scenario: "evaluation";
+    /** Optional dataset output configuration for the generated evaluation data. */
+    output_configuration?: EvaluationDataGenerationJobOutputConfiguration;
+}
+export declare function evaluationDataGenerationJobDeserializer(item: any): EvaluationDataGenerationJob;
+/** Supervised fine-tuning data generation job resource. This is a preview feature. */
+export interface SupervisedFineTuningDataGenerationJob extends DataGenerationJob {
+    /** The scenario of the data generation job, which is Supervised Fine-tuning preview for this model. */
+    scenario: "supervised_finetuning_preview";
+    /** Optional file output configuration for the generated supervised fine-tuning data. */
+    output_configuration?: SupervisedFineTuningDataGenerationJobOutputConfiguration;
+}
+export declare function supervisedFineTuningDataGenerationJobDeserializer(item: any): SupervisedFineTuningDataGenerationJob;
+/** Reinforcement fine-tuning data generation job resource. This is a preview feature. */
+export interface ReinforcementFineTuningDataGenerationJob extends DataGenerationJob {
+    /** The scenario of the data generation job, which is Reinforcement Fine-tuning preview for this model. */
+    scenario: "reinforcement_finetuning_preview";
+    /** Optional file output configuration for the generated reinforcement fine-tuning data. */
+    output_configuration?: ReinforcementFineTuningDataGenerationJobOutputConfiguration;
+}
+export declare function reinforcementFineTuningDataGenerationJobDeserializer(item: any): ReinforcementFineTuningDataGenerationJob;
+export declare function dataGenerationJobUnionArrayDeserializer(result: Array<DataGenerationJobUnion>): any[];
+/** Alias for DataGenerationJobInputsUnion */
+export type DataGenerationJobInputsUnion = EvaluationDataGenerationJobInputs | SupervisedFineTuningDataGenerationJobInputs | ReinforcementFineTuningDataGenerationJobInputs | DataGenerationJobInputs;
+export declare function dataGenerationJobInputsUnionSerializer(item: DataGenerationJobInputsUnion): any;
+/** Caller-supplied inputs for an evaluation data generation job. */
+export interface EvaluationDataGenerationJobInputs extends DataGenerationJobInputs {
+    /** The scenario of the data generation job, which is Evaluation for this model. */
+    scenario: "evaluation";
+    /** Optional dataset output configuration for the generated evaluation data. */
+    output_configuration?: EvaluationDataGenerationJobOutputConfiguration;
+}
+export declare function evaluationDataGenerationJobInputsSerializer(item: EvaluationDataGenerationJobInputs): any;
+/** Caller-supplied inputs for a supervised fine-tuning data generation job. This is a preview feature. */
+export interface SupervisedFineTuningDataGenerationJobInputs extends DataGenerationJobInputs {
+    /** The scenario of the data generation job, which is Supervised Fine-tuning preview for this model. */
+    scenario: "supervised_finetuning_preview";
+    /** Optional file output configuration for the generated supervised fine-tuning data. */
+    output_configuration?: SupervisedFineTuningDataGenerationJobOutputConfiguration;
+}
+export declare function supervisedFineTuningDataGenerationJobInputsSerializer(item: SupervisedFineTuningDataGenerationJobInputs): any;
+/** Caller-supplied inputs for a reinforcement fine-tuning data generation job. This is a preview feature. */
+export interface ReinforcementFineTuningDataGenerationJobInputs extends DataGenerationJobInputs {
+    /** The scenario of the data generation job, which is Reinforcement Fine-tuning preview for this model. */
+    scenario: "reinforcement_finetuning_preview";
+    /** Optional file output configuration for the generated reinforcement fine-tuning data. */
+    output_configuration?: ReinforcementFineTuningDataGenerationJobOutputConfiguration;
+}
+export declare function reinforcementFineTuningDataGenerationJobInputsSerializer(item: ReinforcementFineTuningDataGenerationJobInputs): any;
+/** Vocabulary for the `expand` query parameter on the candidate LIST endpoint. This open union keeps SDKs usable when new expand keys ship server-side. Multiple values are serialized as one comma-separated query parameter. */
+export type AgentOptimizationCandidateExpand = "mutations";
+export declare function chatCompletionToolArraySerializer(result: Array<ChatCompletionTool>): any[];
+export declare function chatCompletionToolArrayDeserializer(result: Array<ChatCompletionTool>): any[];
+/** A function tool that can be used to generate a response. */
+export interface ChatCompletionTool {
+    /** The type of the tool. Currently, only `function` is supported. */
+    type: "function";
+    function: FunctionObject;
+}
+export declare function chatCompletionToolSerializer(item: ChatCompletionTool): any;
+export declare function chatCompletionToolDeserializer(item: any): ChatCompletionTool;
+/** model interface FunctionObject */
+export interface FunctionObject {
+    /** A description of what the function does, used by the model to choose when and how to call the function. */
+    description?: string;
+    /** The name of the function to be called. Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64. */
+    name: string;
+    parameters?: FunctionParameters;
+    strict?: boolean;
+}
+export declare function functionObjectSerializer(item: FunctionObject): any;
+export declare function functionObjectDeserializer(item: any): FunctionObject;
+/**
+ * The parameters the functions accepts, described as a JSON Schema object. See the [guide](/docs/guides/function-calling) for examples, and the [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for documentation about the format.
+ * Omitting `parameters` defines a function with an empty parameter list.
+ */
+export interface FunctionParameters {
+    /** Additional properties */
+    additionalProperties?: Record<string, any>;
+}
+export declare function functionParametersSerializer(item: FunctionParameters): any;
+export declare function functionParametersDeserializer(item: any): FunctionParameters;
+/** Configuration for managing data generation jobs. */
+export interface DataGenerationJobConfiguration {
+    /** The data generation job type. */
+    /** The discriminator possible values: simple_qna, traces, simulation_seed, tool_use */
+    type: DataGenerationJobType;
+    /** The proportion of the generated data to be used for training when the data is used for fine-tuning. The rest will be used for validation. Value should be between 0 and 1. */
+    train_split?: number;
+    /** The LLM model options. */
+    model_options?: DataGenerationModelOptions;
+}
+export declare function dataGenerationJobConfigurationSerializer(item: DataGenerationJobConfiguration): any;
+export declare function dataGenerationJobConfigurationDeserializer(item: any): DataGenerationJobConfiguration;
+/** Alias for DataGenerationJobConfigurationUnion */
+export type DataGenerationJobConfigurationUnion = SimpleQnADataGenerationJobConfiguration | TracesDataGenerationJobConfiguration | SimulationSeedDataGenerationJobConfiguration | ToolUseFineTuningDataGenerationJobConfiguration | DataGenerationJobConfiguration;
+export declare function dataGenerationJobConfigurationUnionSerializer(item: DataGenerationJobConfigurationUnion): any;
+export declare function dataGenerationJobConfigurationUnionDeserializer(item: any): DataGenerationJobConfigurationUnion;
+/** The configuration for a data generation job with SimpleQnA type. */
+export interface SimpleQnADataGenerationJobConfiguration extends DataGenerationJobConfiguration {
+    /** The data generation job type, which is SimpleQnA for this model. */
+    type: "simple_qna";
+    /** Maximum number of samples to generate, up to service-defined limits. */
+    max_samples: number;
+    /** The question types to generate. Used only for fine-tuning scenarios. */
+    question_types?: SimpleQnAFineTuningQuestionType[];
+}
+export declare function simpleQnADataGenerationJobConfigurationSerializer(item: SimpleQnADataGenerationJobConfiguration): any;
+export declare function simpleQnADataGenerationJobConfigurationDeserializer(item: any): SimpleQnADataGenerationJobConfiguration;
+/** The configuration for a data generation job with Traces type. */
+export interface TracesDataGenerationJobConfiguration extends DataGenerationJobConfiguration {
+    /** The data generation job type, which is Traces for this model. */
+    type: "traces";
+    /** Maximum number of samples to generate, up to service-defined limits. If omitted, sampling is turned off. */
+    max_samples?: number;
+    /** Whether to redact private content from traces. When omitted or set to true, private content is redacted. Set to false to opt out of redaction. */
+    redact_private_content?: boolean;
+}
+export declare function tracesDataGenerationJobConfigurationSerializer(item: TracesDataGenerationJobConfiguration): any;
+export declare function tracesDataGenerationJobConfigurationDeserializer(item: any): TracesDataGenerationJobConfiguration;
+/** The configuration for a task generation data generation job. Use with multiturn evaluation scenarios and with prompt, file, or agent sources. Generated dataset rows include fields such as `id`, `category`, `test_case_description`, and `desired_num_turns`. */
+export interface SimulationSeedDataGenerationJobConfiguration extends DataGenerationJobConfiguration {
+    /** The data generation job type, which is SimulationSeed for this model. */
+    type: "simulation_seed";
+}
+export declare function simulationSeedDataGenerationJobConfigurationSerializer(item: SimulationSeedDataGenerationJobConfiguration): any;
+export declare function simulationSeedDataGenerationJobConfigurationDeserializer(item: any): SimulationSeedDataGenerationJobConfiguration;
+/** The configuration for a data generation job with ToolUse type. This is a preview feature used only for fine-tuning scenarios. */
+export interface ToolUseFineTuningDataGenerationJobConfiguration extends DataGenerationJobConfiguration {
+    /** The data generation job type, which is ToolUse for this model. */
+    type: "tool_use";
+    /** Maximum number of samples to generate, up to service-defined limits. */
+    max_samples: number;
+}
+export declare function toolUseFineTuningDataGenerationJobConfigurationSerializer(item: ToolUseFineTuningDataGenerationJobConfiguration): any;
+export declare function toolUseFineTuningDataGenerationJobConfigurationDeserializer(item: any): ToolUseFineTuningDataGenerationJobConfiguration;
+/** Dataset output configuration for an evaluation data generation job. */
+export interface EvaluationDataGenerationJobOutputConfiguration {
+    /** Dataset name to assign to the output. */
+    name?: string;
+    /** Description to assign to the output dataset. */
+    description?: string;
+    /** Tags to assign to the output dataset. */
+    tags?: Record<string, string>;
+    /** Controls how dataset outputs are written. If omitted, defaults to `overwrite` and creates the next dataset version using only newly generated rows. */
+    write_mode?: DataGenerationJobOutputWriteMode;
+}
+export declare function evaluationDataGenerationJobOutputConfigurationSerializer(item: EvaluationDataGenerationJobOutputConfiguration): any;
+export declare function evaluationDataGenerationJobOutputConfigurationDeserializer(item: any): EvaluationDataGenerationJobOutputConfiguration;
+/** File output configuration for a supervised fine-tuning data generation job. This is a preview feature. */
+export interface SupervisedFineTuningDataGenerationJobOutputConfiguration {
+    /** Filename to assign to the generated fine-tuning file. */
+    name: string;
+    /** Controls how file outputs are written. If omitted, defaults to `overwrite` and writes only the newly generated fine-tuning file content. */
+    write_mode?: DataGenerationJobOutputWriteMode;
+    /** File ID to merge into when `write_mode` is `merge`. */
+    merge_file_id?: string;
+}
+export declare function supervisedFineTuningDataGenerationJobOutputConfigurationSerializer(item: SupervisedFineTuningDataGenerationJobOutputConfiguration): any;
+export declare function supervisedFineTuningDataGenerationJobOutputConfigurationDeserializer(item: any): SupervisedFineTuningDataGenerationJobOutputConfiguration;
+/** File output configuration for a reinforcement fine-tuning data generation job. This is a preview feature. */
+export interface ReinforcementFineTuningDataGenerationJobOutputConfiguration {
+    /** Filename to assign to the generated fine-tuning file. */
+    name: string;
+    /** Controls how file outputs are written. If omitted, defaults to `overwrite` and writes only the newly generated fine-tuning file content. */
+    write_mode?: DataGenerationJobOutputWriteMode;
+    /** File ID to merge into when `write_mode` is `merge`. */
+    merge_file_id?: string;
+}
+export declare function reinforcementFineTuningDataGenerationJobOutputConfigurationSerializer(item: ReinforcementFineTuningDataGenerationJobOutputConfiguration): any;
+export declare function reinforcementFineTuningDataGenerationJobOutputConfigurationDeserializer(item: any): ReinforcementFineTuningDataGenerationJobOutputConfiguration;
 //# sourceMappingURL=models.d.ts.map