@azure/ai-projects 2.4.0 → 2.5.0

package/dist/commonjs/models/models.d.ts

@@ -145,11 +145,11 @@ export interface Tool {
 export declare function toolSerializer(item: Tool): any;
 export declare function toolDeserializer(item: any): Tool;
 /** Alias for ToolUnion */
-export type ToolUnion = BingGroundingTool | MicrosoftFabricPreviewTool | SharepointPreviewTool | AzureAISearchTool | OpenApiTool | BingCustomSearchPreviewTool | BrowserAutomationPreviewTool | AzureFunctionTool | CaptureStructuredOutputsTool | A2APreviewTool | WorkIQPreviewTool | FabricIQPreviewTool | MemorySearchPreviewTool | CodeInterpreterTool | FileSearchTool | WebSearchTool | MCPTool | FunctionTool | ComputerUsePreviewTool | ImageGenTool | LocalShellToolParam | FunctionShellToolParam | CustomToolParam | WebSearchPreviewTool | ApplyPatchToolParam | ComputerTool | NamespaceToolParam | ToolSearchToolParam | Tool;
+export type ToolUnion = BingGroundingTool | MicrosoftFabricPreviewTool | SharepointPreviewTool | AzureAISearchTool | OpenApiTool | BingCustomSearchPreviewTool | BrowserAutomationPreviewTool | AzureFunctionTool | CaptureStructuredOutputsTool | A2APreviewTool | WorkIQPreviewTool | FabricIQPreviewTool | 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 */
-export type ToolType = "function" | "file_search" | "computer" | "computer_use_preview" | "web_search" | "mcp" | "code_interpreter" | "image_generation" | "local_shell" | "shell" | "custom" | "namespace" | "tool_search" | "web_search_preview" | "apply_patch" | "a2a_preview" | "bing_custom_search_preview" | "browser_automation_preview" | "fabric_dataagent_preview" | "sharepoint_grounding_preview" | "memory_search_preview" | "work_iq_preview" | "fabric_iq_preview" | "toolbox_search_preview" | "azure_ai_search" | "azure_function" | "bing_grounding" | "capture_structured_outputs" | "openapi";
+export type ToolType = "function" | "file_search" | "computer" | "computer_use_preview" | "web_search" | "mcp" | "code_interpreter" | "programmatic_tool_calling" | "image_generation" | "local_shell" | "shell" | "custom" | "namespace" | "tool_search" | "web_search_preview" | "apply_patch" | "a2a_preview" | "bing_custom_search_preview" | "browser_automation_preview" | "fabric_dataagent_preview" | "sharepoint_grounding_preview" | "memory_search_preview" | "work_iq_preview" | "fabric_iq_preview" | "toolbox_search_preview" | "azure_ai_search" | "azure_function" | "bing_grounding" | "capture_structured_outputs" | "openapi";
 /** The input definition information for a bing grounding search tool as used to configure an agent. */
 export interface BingGroundingTool extends Tool {
     /** The object type, which is always 'bing_grounding'. */
@@ -650,6 +650,7 @@ export declare function memorySearchOptionsDeserializer(item: any): MemorySearch
 export interface CodeInterpreterTool extends Tool {
     /** The type of the code interpreter tool. Always `code_interpreter`. */
     type: "code_interpreter";
+    allowed_callers?: CallableToolAllowedCaller[];
     /** Deprecated. This property is deprecated and will be removed in a future version. */
     name?: string;
     /** Deprecated. This property is deprecated and will be removed in a future version. */
@@ -739,10 +740,14 @@ export interface FunctionTool extends Tool {
     description?: string;
     /** The parameters schema for the function. */
     parameters?: Record<string, unknown>;
+    /** The schema for the function output. */
+    output_schema?: Record<string, unknown>;
     /** Whether the function arguments must strictly match the parameters schema. */
     strict?: boolean;
     /** Whether this function is deferred and loaded via tool search. */
     defer_loading?: boolean;
+    /** The callers that may invoke this tool. */
+    allowed_callers?: CallableToolAllowedCaller[];
 }
 export declare function functionToolSerializer(item: FunctionTool): any;
 export declare function functionToolDeserializer(item: any): FunctionTool;
@@ -960,6 +965,8 @@ export interface MCPTool extends Tool {
     headers?: Record<string, string>;
     /** The list of allowed tool names for the MCP server. */
     allowed_tools?: string[] | MCPToolFilter;
+    /** The callers that may invoke this tool. */
+    allowed_callers?: CallableToolAllowedCaller[];
     /** The approval requirements for the MCP tool. */
     require_approval?: MCPToolRequireApproval | "always" | "never";
     /** Whether this MCP tool is deferred and discovered via tool search. */
@@ -1058,6 +1065,8 @@ export interface FunctionShellToolParam extends Tool {
     type: "shell";
     /** The environment configuration for the function shell tool. */
     environment?: FunctionShellToolParamEnvironmentUnion;
+    /** The callers that may invoke this tool. */
+    allowed_callers?: CallableToolAllowedCaller[];
     /** Deprecated. This property is deprecated and will be removed in a future version. */
     name?: string;
     /** Deprecated. This property is deprecated and will be removed in a future version. */
@@ -1188,6 +1197,7 @@ export interface CustomToolParam extends Tool {
     format?: CustomToolParamFormatUnion;
     /** Whether this tool should be deferred and discovered via tool search. */
     defer_loading?: boolean;
+    allowed_callers?: CallableToolAllowedCaller[];
 }
 export declare function customToolParamSerializer(item: CustomToolParam): any;
 export declare function customToolParamDeserializer(item: any): CustomToolParam;
@@ -1259,6 +1269,7 @@ export type SearchContentType = "text" | "image";
 export interface ApplyPatchToolParam extends Tool {
     /** The type of the tool. Always `apply_patch`. */
     type: "apply_patch";
+    allowed_callers?: CallableToolAllowedCaller[];
 }
 export declare function applyPatchToolParamSerializer(item: ApplyPatchToolParam): any;
 export declare function applyPatchToolParamDeserializer(item: any): ApplyPatchToolParam;
@@ -1295,8 +1306,10 @@ export interface FunctionToolParam {
     parameters?: EmptyModelParam;
     strict?: boolean;
     type: "function";
+    output_schema?: Record<string, any>;
     /** Whether this function should be deferred and discovered via tool search. */
     defer_loading?: boolean;
+    allowed_callers?: CallableToolAllowedCaller[];
 }
 export declare function functionToolParamSerializer(item: FunctionToolParam): any;
 export declare function functionToolParamDeserializer(item: any): FunctionToolParam;
@@ -1322,6 +1335,14 @@ export type ToolSearchExecutionType = "server" | "client";
 export interface ContainerConfiguration {
     /** The container image for the hosted agent. */
     image: string;
+    /**
+     * The id (or name) of the Foundry project connection that provides the credentials used to
+     * authenticate to the private container registry hosting `image`. The connection abstracts the
+     * auth mechanism — for example a managed-identity-federated token exchange, or a username/token
+     * secret — so registry credentials are never part of the agent definition. Omit for public images
+     * or registries already reachable by the platform's default identity (for example, Azure Container Registry).
+     */
+    registry_connection_id?: string;
 }
 export declare function containerConfigurationSerializer(item: ContainerConfiguration): any;
 export declare function containerConfigurationDeserializer(item: any): ContainerConfiguration;
@@ -1471,6 +1492,11 @@ export declare function promptAgentDefinitionDeserializer(item: any): PromptAgen
  * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
  */
 export interface Reasoning {
+    /**
+     * Controls the reasoning execution mode for the request.
+     *   When returned on a response, this is the effective execution mode.
+     */
+    mode?: ReasoningModeEnum;
     effort?: ReasoningEffort;
     summary?: "auto" | "concise" | "detailed";
     context?: "auto" | "current_turn" | "all_turns";
@@ -1489,7 +1515,7 @@ export declare function reasoningDeserializer(item: any): Reasoning;
  * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
  * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
  */
-export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
 /** Alias for _PromptAgentDefinitionToolChoice */
 export type _PromptAgentDefinitionToolChoice = string | ToolChoiceParamUnion;
 export declare function _promptAgentDefinitionToolChoiceSerializer(item: _PromptAgentDefinitionToolChoice): any;
@@ -1505,11 +1531,11 @@ export interface ToolChoiceParam {
 export declare function toolChoiceParamSerializer(item: ToolChoiceParam): any;
 export declare function toolChoiceParamDeserializer(item: any): ToolChoiceParam;
 /** Alias for ToolChoiceParamUnion */
-export type ToolChoiceParamUnion = ToolChoiceAllowed | ToolChoiceFunction | ToolChoiceMCP | ToolChoiceCustom | SpecificApplyPatchParam | SpecificFunctionShellParam | ToolChoiceFileSearch | ToolChoiceWebSearchPreview | ToolChoiceComputerUsePreview | ToolChoiceWebSearchPreview20250311 | ToolChoiceImageGeneration | ToolChoiceCodeInterpreter | ToolChoiceComputer | ToolChoiceComputerUse | ToolChoiceParam;
+export type ToolChoiceParamUnion = ToolChoiceAllowed | ToolChoiceFunction | ToolChoiceMCP | ToolChoiceCustom | SpecificProgrammaticToolCallingParam | SpecificApplyPatchParam | SpecificFunctionShellParam | ToolChoiceFileSearch | ToolChoiceWebSearchPreview | ToolChoiceComputerUsePreview | ToolChoiceWebSearchPreview20250311 | ToolChoiceImageGeneration | ToolChoiceCodeInterpreter | ToolChoiceComputer | ToolChoiceComputerUse | ToolChoiceParam;
 export declare function toolChoiceParamUnionSerializer(item: ToolChoiceParamUnion): any;
 export declare function toolChoiceParamUnionDeserializer(item: any): ToolChoiceParamUnion;
 /** Type of ToolChoiceParamType */
-export type ToolChoiceParamType = "allowed_tools" | "function" | "mcp" | "custom" | "apply_patch" | "shell" | "file_search" | "web_search_preview" | "computer_use_preview" | "web_search_preview_2025_03_11" | "image_generation" | "code_interpreter" | "computer" | "computer_use";
+export type ToolChoiceParamType = "allowed_tools" | "function" | "mcp" | "custom" | "programmatic_tool_calling" | "apply_patch" | "shell" | "file_search" | "web_search_preview" | "computer_use_preview" | "web_search_preview_2025_03_11" | "image_generation" | "code_interpreter" | "computer" | "computer_use";
 /** Constrains the tools available to the model to a pre-defined set. */
 export interface ToolChoiceAllowed extends ToolChoiceParam {
     /** Allowed tool configuration type. Always `allowed_tools`. */
@@ -2627,6 +2653,7 @@ export type ToolboxToolType = "code_interpreter" | "file_search" | "web_search"
 /** A code interpreter tool stored in a toolbox. */
 export interface CodeInterpreterToolboxTool extends ToolboxTool {
     type: "code_interpreter";
+    allowed_callers?: CallableToolAllowedCaller[];
     /**
      * The code interpreter container. Can be a container ID or an object that
      * specifies uploaded file IDs to make available to your code, along with an
@@ -2705,6 +2732,7 @@ export interface MCPToolboxTool extends ToolboxTool {
     server_description?: string;
     headers?: Record<string, string>;
     allowed_tools?: string[] | MCPToolFilter;
+    allowed_callers?: CallableToolAllowedCaller[];
     require_approval?: MCPToolRequireApproval | "always" | "never";
     /** Whether this MCP tool is deferred and discovered via tool search. */
     defer_loading?: boolean;
@@ -3850,6 +3878,8 @@ export declare function memoryStoreOperationUsageDeserializer(item: any): Memory
 export interface ResponseUsageInputTokensDetails {
     /** The number of cached input tokens used. */
     cached_tokens: number;
+    /** The number of cache-write input tokens used. */
+    cache_write_tokens?: number;
 }
 export declare function responseUsageInputTokensDetailsDeserializer(item: any): ResponseUsageInputTokensDetails;
 /** model interface ResponseUsageOutputTokensDetails */
@@ -4248,30 +4278,22 @@ export interface Routine {
 }
 export declare function routineDeserializer(item: any): Routine;
 /** The response data for a requested list of items. */
-export interface _AgentsPagedResultRoutine {
+export interface _PagedResultWithNextLinkRoutine {
     /** The requested list of items. */
     data: Routine[];
-    /** 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;
+    /** The URL to fetch the next page of results, or absent if there are no additional pages. */
+    next_link?: string;
 }
-export declare function _agentsPagedResultRoutineDeserializer(item: any): _AgentsPagedResultRoutine;
+export declare function _pagedResultWithNextLinkRoutineDeserializer(item: any): _PagedResultWithNextLinkRoutine;
 export declare function routineArrayDeserializer(result: Array<Routine>): any[];
 /** The response data for a requested list of items. */
-export interface _AgentsPagedResultRoutineRun {
+export interface _PagedResultWithNextLinkRoutineRun {
     /** The requested list of items. */
     data: RoutineRun[];
-    /** 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;
+    /** The URL to fetch the next page of results, or absent if there are no additional pages. */
+    next_link?: string;
 }
-export declare function _agentsPagedResultRoutineRunDeserializer(item: any): _AgentsPagedResultRoutineRun;
+export declare function _pagedResultWithNextLinkRoutineRunDeserializer(item: any): _PagedResultWithNextLinkRoutineRun;
 export declare function routineRunArrayDeserializer(result: Array<RoutineRun>): any[];
 /** A single routine run returned from the run history API. */
 export interface RoutineRun {
@@ -4788,7 +4810,7 @@ export declare function fileDataGenerationJobSourceDeserializer(item: any): File
 /** Options for managing data generation jobs. */
 export interface DataGenerationJobOptions {
     /** The data generation job type. */
-    /** The discriminator possible values: simple_qna, traces, task_generation, tool_use */
+    /** The discriminator possible values: simple_qna, traces, task_generation, simulation_seed, tool_use */
     type: DataGenerationJobType;
     /** Maximum number of samples to generate. */
     max_samples: number;
@@ -4800,11 +4822,11 @@ export interface DataGenerationJobOptions {
 export declare function dataGenerationJobOptionsSerializer(item: DataGenerationJobOptions): any;
 export declare function dataGenerationJobOptionsDeserializer(item: any): DataGenerationJobOptions;
 /** Alias for DataGenerationJobOptionsUnion */
-export type DataGenerationJobOptionsUnion = SimpleQnADataGenerationJobOptions | TracesDataGenerationJobOptions | TaskGenerationDataGenerationJobOptions | ToolUseFineTuningDataGenerationJobOptions | DataGenerationJobOptions;
+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";
+export type DataGenerationJobType = "simple_qna" | "traces" | "tool_use" | "task_generation" | "simulation_seed";
 /** LLM model options for data generation jobs. */
 export interface DataGenerationModelOptions {
     /** Base model name used to generate data. */
@@ -4827,12 +4849,21 @@ export type SimpleQnAFineTuningQuestionType = "short_answer" | "long_answer";
 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;
 }
 export declare function tracesDataGenerationJobOptionsSerializer(item: TracesDataGenerationJobOptions): any;
 export declare function tracesDataGenerationJobOptionsDeserializer(item: any): TracesDataGenerationJobOptions;
-/** The options 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`. */
+/** 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;
+/** @deprecated Use `SimulationSeedDataGenerationJobOptions` instead. */
 export interface TaskGenerationDataGenerationJobOptions extends DataGenerationJobOptions {
-    /** The data generation job type, which is TaskGeneration for this model. */
+    /** The data generation job type. */
     type: "task_generation";
 }
 export declare function taskGenerationDataGenerationJobOptionsSerializer(item: TaskGenerationDataGenerationJobOptions): any;
@@ -4931,13 +4962,13 @@ export declare function _agentsPagedResultDataGenerationJobDeserializer(item: an
 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. */
-export interface OptimizationJob {
+export interface AgentOptimizationJob {
     /** Server-assigned unique identifier. */
     readonly id: string;
     /** Caller-supplied inputs. */
-    inputs?: OptimizationJobInputs;
+    inputs?: AgentOptimizationJobInputs;
     /** Result produced on success. */
-    readonly result?: OptimizationJobResult;
+    readonly result?: AgentOptimizationJobResult;
     /** Current lifecycle status. */
     readonly status: JobStatus;
     /** Error details — populated only on failure. */
@@ -4947,63 +4978,63 @@ export interface OptimizationJob {
     /** 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?: OptimizationJobProgress;
+    readonly progress?: AgentOptimizationJobProgress;
     /** Non-fatal warnings emitted at any point during optimization. */
     readonly warnings?: string[];
 }
-export declare function optimizationJobSerializer(item: OptimizationJob): any;
-export declare function optimizationJobDeserializer(item: any): OptimizationJob;
+export declare function agentOptimizationJobSerializer(item: AgentOptimizationJob): any;
+export declare function agentOptimizationJobDeserializer(item: any): AgentOptimizationJob;
 /** Caller-supplied inputs for an optimization job. */
-export interface OptimizationJobInputs {
+export interface AgentOptimizationJobInputs {
     /** The agent (and pinned version) being optimized. */
-    agent: OptimizationAgentIdentifier;
+    agent: OptimizedAgentIdentifier;
     /** Training dataset — either inline items or a reference to a registered dataset. Required. */
-    train_dataset: OptimizationDatasetInputUnion;
+    train_dataset: AgentOptimizationDatasetInputUnion;
     /** Optional held-out validation dataset for measuring generalization of the final candidate. */
-    validation_dataset?: OptimizationDatasetInputUnion;
+    validation_dataset?: AgentOptimizationDatasetInputUnion;
     /** Job-level evaluators referenced by name and optional version. Required; at least one must be provided. */
-    evaluators: OptimizationEvaluatorRef[];
+    evaluators: AgentOptimizationEvaluatorRef[];
     /** Tuning knobs and run-mode. */
-    options?: OptimizationOptions;
+    options?: AgentOptimizationOptions;
 }
-export declare function optimizationJobInputsSerializer(item: OptimizationJobInputs): any;
-export declare function optimizationJobInputsDeserializer(item: any): OptimizationJobInputs;
+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 OptimizationAgentIdentifier {
+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 optimizationAgentIdentifierSerializer(item: OptimizationAgentIdentifier): any;
-export declare function optimizationAgentIdentifierDeserializer(item: any): OptimizationAgentIdentifier;
+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 OptimizationDatasetInput {
+export interface AgentOptimizationDatasetInput {
     /** Dataset input type discriminator. */
     /** The discriminator possible values: inline, reference */
-    type: OptimizationDatasetInputType;
-}
-export declare function optimizationDatasetInputSerializer(item: OptimizationDatasetInput): any;
-export declare function optimizationDatasetInputDeserializer(item: any): OptimizationDatasetInput;
-/** Alias for OptimizationDatasetInputUnion */
-export type OptimizationDatasetInputUnion = OptimizationInlineDatasetInput | OptimizationReferenceDatasetInput | OptimizationDatasetInput;
-export declare function optimizationDatasetInputUnionSerializer(item: OptimizationDatasetInputUnion): any;
-export declare function optimizationDatasetInputUnionDeserializer(item: any): OptimizationDatasetInputUnion;
+    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 OptimizationDatasetInputType = "inline" | "reference";
+export type AgentOptimizationDatasetInputType = "inline" | "reference";
 /** Inline dataset — items supplied directly in the request body. */
-export interface OptimizationInlineDatasetInput extends OptimizationDatasetInput {
+export interface AgentOptimizationInlineDatasetInput extends AgentOptimizationDatasetInput {
     /** Dataset input type discriminator. */
     type: "inline";
     /** Dataset items. */
-    items: OptimizationDatasetItem[];
+    items: AgentOptimizationDatasetItem[];
 }
-export declare function optimizationInlineDatasetInputSerializer(item: OptimizationInlineDatasetInput): any;
-export declare function optimizationInlineDatasetInputDeserializer(item: any): OptimizationInlineDatasetInput;
-export declare function optimizationDatasetItemArraySerializer(result: Array<OptimizationDatasetItem>): any[];
-export declare function optimizationDatasetItemArrayDeserializer(result: Array<OptimizationDatasetItem>): any[];
+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 OptimizationDatasetItem {
+export interface AgentOptimizationDatasetItem {
     /** The user query / prompt. */
     query?: string;
     /** Expected ground truth answer. */
@@ -5011,23 +5042,23 @@ export interface OptimizationDatasetItem {
     /** Desired number of conversation turns for simulation mode (1-20). */
     desired_num_turns?: number;
     /** Per-item evaluation criteria. */
-    criteria?: OptimizationDatasetCriterion[];
+    criteria?: AgentOptimizationDatasetCriterion[];
 }
-export declare function optimizationDatasetItemSerializer(item: OptimizationDatasetItem): any;
-export declare function optimizationDatasetItemDeserializer(item: any): OptimizationDatasetItem;
-export declare function optimizationDatasetCriterionArraySerializer(result: Array<OptimizationDatasetCriterion>): any[];
-export declare function optimizationDatasetCriterionArrayDeserializer(result: Array<OptimizationDatasetCriterion>): any[];
+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 OptimizationDatasetCriterion {
+export interface AgentOptimizationDatasetCriterion {
     /** Criterion name. */
     name: string;
     /** Criterion instruction / description. */
     instruction: string;
 }
-export declare function optimizationDatasetCriterionSerializer(item: OptimizationDatasetCriterion): any;
-export declare function optimizationDatasetCriterionDeserializer(item: any): OptimizationDatasetCriterion;
+export declare function agentOptimizationDatasetCriterionSerializer(item: AgentOptimizationDatasetCriterion): any;
+export declare function agentOptimizationDatasetCriterionDeserializer(item: any): AgentOptimizationDatasetCriterion;
 /** Reference to a registered Foundry dataset. */
-export interface OptimizationReferenceDatasetInput extends OptimizationDatasetInput {
+export interface AgentOptimizationReferenceDatasetInput extends AgentOptimizationDatasetInput {
     /** Dataset input type discriminator. */
     type: "reference";
     /** Registered dataset name. */
@@ -5035,21 +5066,21 @@ export interface OptimizationReferenceDatasetInput extends OptimizationDatasetIn
     /** Dataset version. If not specified, the latest version is used. */
     version?: string;
 }
-export declare function optimizationReferenceDatasetInputSerializer(item: OptimizationReferenceDatasetInput): any;
-export declare function optimizationReferenceDatasetInputDeserializer(item: any): OptimizationReferenceDatasetInput;
-export declare function optimizationEvaluatorRefArraySerializer(result: Array<OptimizationEvaluatorRef>): any[];
-export declare function optimizationEvaluatorRefArrayDeserializer(result: Array<OptimizationEvaluatorRef>): any[];
+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 OptimizationEvaluatorRef {
+export interface AgentOptimizationEvaluatorRef {
     /** Evaluator name. */
     name: string;
     /** Evaluator version. If not specified, the latest version is used. */
     version?: string;
 }
-export declare function optimizationEvaluatorRefSerializer(item: OptimizationEvaluatorRef): any;
-export declare function optimizationEvaluatorRefDeserializer(item: any): OptimizationEvaluatorRef;
+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 OptimizationOptions {
+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. */
@@ -5063,21 +5094,21 @@ export interface OptimizationOptions {
     /** 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 optimizationOptionsSerializer(item: OptimizationOptions): any;
-export declare function optimizationOptionsDeserializer(item: any): OptimizationOptions;
+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. */
-export interface OptimizationJobResult {
+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?: OptimizationCandidate[];
+    candidates?: AgentOptimizationCandidate[];
 }
-export declare function optimizationJobResultDeserializer(item: any): OptimizationJobResult;
-export declare function optimizationCandidateArrayDeserializer(result: Array<OptimizationCandidate>): any[];
+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. */
-export interface OptimizationCandidate {
+export interface AgentOptimizationCandidate {
     /** Server-assigned candidate identifier. Use with GET /candidates/{id} sub-endpoints. */
     candidate_id?: string;
     /** Display name of the candidate (e.g., 'baseline', 'instruction-v2'). */
@@ -5095,7 +5126,7 @@ export interface OptimizationCandidate {
     /** Promotion metadata. Null if the candidate has not been promoted. */
     promotion?: PromotionInfo;
 }
-export declare function optimizationCandidateDeserializer(item: any): OptimizationCandidate;
+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. */
@@ -5107,7 +5138,7 @@ export interface PromotionInfo {
 }
 export declare function promotionInfoDeserializer(item: any): PromotionInfo;
 /** In-flight progress; only populated while status is queued or in_progress. */
-export interface OptimizationJobProgress {
+export interface AgentOptimizationJobProgress {
     /** Number of candidates whose evaluation has completed so far. */
     candidates_completed: number;
     /** Best score observed so far across all candidates. */
@@ -5115,11 +5146,11 @@ export interface OptimizationJobProgress {
     /** Wall-clock time elapsed in seconds since the job began executing. */
     elapsed_seconds: number;
 }
-export declare function optimizationJobProgressDeserializer(item: any): OptimizationJobProgress;
+export declare function agentOptimizationJobProgressDeserializer(item: any): AgentOptimizationJobProgress;
 /** The response data for a requested list of items. */
-export interface _AgentsPagedResultOptimizationJobListItem {
+export interface _AgentsPagedResultAgentOptimizationJobListItem {
     /** The requested list of items. */
-    data: OptimizationJobListItem[];
+    data: AgentOptimizationJobListItem[];
     /** The first ID represented in this list. */
     first_id?: string;
     /** The last ID represented in this list. */
@@ -5127,10 +5158,10 @@ export interface _AgentsPagedResultOptimizationJobListItem {
     /** A value indicating whether there are additional values available not captured in this list. */
     has_more: boolean;
 }
-export declare function _agentsPagedResultOptimizationJobListItemDeserializer(item: any): _AgentsPagedResultOptimizationJobListItem;
-export declare function optimizationJobListItemArrayDeserializer(result: Array<OptimizationJobListItem>): any[];
+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 OptimizationJobListItem {
+export interface AgentOptimizationJobListItem {
     /** Server-assigned unique identifier. */
     readonly id: string;
     /** Current lifecycle status. */
@@ -5142,11 +5173,43 @@ export interface OptimizationJobListItem {
     /** 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?: OptimizationJobProgress;
+    readonly progress?: AgentOptimizationJobProgress;
     /** The agent targeted by this optimization job. */
-    readonly agent?: OptimizationAgentIdentifier;
-}
-export declare function optimizationJobListItemDeserializer(item: any): OptimizationJobListItem;
+    readonly agent?: OptimizedAgentIdentifier;
+}
+/** @deprecated Use `AgentOptimizationJob` instead. */
+export type OptimizationJob = AgentOptimizationJob;
+/** @deprecated Use `AgentOptimizationJobInputs` instead. */
+export type OptimizationJobInputs = AgentOptimizationJobInputs;
+/** @deprecated Use `OptimizedAgentIdentifier` instead. */
+export type OptimizationAgentIdentifier = OptimizedAgentIdentifier;
+/** @deprecated Use `AgentOptimizationDatasetInput` instead. */
+export type OptimizationDatasetInput = AgentOptimizationDatasetInput;
+/** @deprecated Use `AgentOptimizationDatasetInputUnion` instead. */
+export type OptimizationDatasetInputUnion = AgentOptimizationDatasetInputUnion;
+/** @deprecated Use `AgentOptimizationDatasetInputType` instead. */
+export type OptimizationDatasetInputType = AgentOptimizationDatasetInputType;
+/** @deprecated Use `AgentOptimizationInlineDatasetInput` instead. */
+export type OptimizationInlineDatasetInput = AgentOptimizationInlineDatasetInput;
+/** @deprecated Use `AgentOptimizationDatasetItem` instead. */
+export type OptimizationDatasetItem = AgentOptimizationDatasetItem;
+/** @deprecated Use `AgentOptimizationDatasetCriterion` instead. */
+export type OptimizationDatasetCriterion = AgentOptimizationDatasetCriterion;
+/** @deprecated Use `AgentOptimizationReferenceDatasetInput` instead. */
+export type OptimizationReferenceDatasetInput = AgentOptimizationReferenceDatasetInput;
+/** @deprecated Use `AgentOptimizationEvaluatorRef` instead. */
+export type OptimizationEvaluatorRef = AgentOptimizationEvaluatorRef;
+/** @deprecated Use `AgentOptimizationOptions` instead. */
+export type OptimizationOptions = AgentOptimizationOptions;
+/** @deprecated Use `AgentOptimizationJobResult` instead. */
+export type OptimizationJobResult = AgentOptimizationJobResult;
+/** @deprecated Use `AgentOptimizationCandidate` instead. */
+export type OptimizationCandidate = AgentOptimizationCandidate;
+/** @deprecated Use `AgentOptimizationJobProgress` instead. */
+export type OptimizationJobProgress = AgentOptimizationJobProgress;
+/** @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. */
@@ -5161,11 +5224,11 @@ export declare function _listVersionsRequestTypeSerializer(item: _ListVersionsRe
 /** Type of AgentType */
 export type AgentType = "agent" | "agent.version" | "agent.deleted" | "agent.version.deleted" | "agent.container";
 /** Feature opt-in keys for agent definition operations supporting hosted or workflow agents. */
-export type AgentDefinitionOptInKeys = "WorkflowAgents=V1Preview" | "ExternalAgents=V1Preview" | "DraftAgents=V1Preview";
+export type AgentDefinitionOptInKeys = "WorkflowAgents=V1Preview" | "ExternalAgents=V1Preview" | "DraftAgents=V1Preview" | "VoiceAgents=V1Preview";
 /** Type of PageOrder */
 export type PageOrder = "asc" | "desc";
 /** Type of FoundryFeaturesOptInKeys */
-export type FoundryFeaturesOptInKeys = "Evaluations=V1Preview" | "Schedules=V1Preview" | "RedTeams=V1Preview" | "Insights=V1Preview" | "MemoryStores=V1Preview" | "Routines=V1Preview" | "Skills=V1Preview" | "DataGenerationJobs=V1Preview" | "Models=V1Preview" | "AgentsOptimization=V2Preview";
+export type FoundryFeaturesOptInKeys = "Evaluations=V1Preview" | "Schedules=V1Preview" | "RedTeams=V1Preview" | "Insights=V1Preview" | "MemoryStores=V1Preview" | "Routines=V1Preview" | "Routines=V2Preview" | "Skills=V1Preview" | "DataGenerationJobs=V1Preview" | "Models=V1Preview" | "AgentsOptimization=V2Preview";
 /** The type of pending upload. */
 export type PendingUploadType = "None" | "BlobReference" | "TemporaryBlobReference";
 /** Type of MemoryStoreType */
@@ -5239,4 +5302,24 @@ export type BetaSkillsDownloadResponse = {
      */
     readableStreamBody?: NodeReadableStream;
 };
+/** Type of CallableToolAllowedCaller */
+export type CallableToolAllowedCaller = "direct" | "programmatic";
+/** model interface ProgrammaticToolCallingParam */
+export interface ProgrammaticToolCallingParam extends Tool {
+    /** The type of the tool. Always `programmatic_tool_calling`. */
+    type: "programmatic_tool_calling";
+}
+/** model interface SpecificProgrammaticToolCallingParam */
+export interface SpecificProgrammaticToolCallingParam extends ToolChoiceParam {
+    /** The tool to call. Always `programmatic_tool_calling`. */
+    type: "programmatic_tool_calling";
+}
+/** Alias for ReasoningModeEnum */
+export type ReasoningModeEnum = string | "standard" | "pro";
+export declare function programmaticToolCallingParamDeserializer(item: any): ProgrammaticToolCallingParam;
+export declare function programmaticToolCallingParamSerializer(item: ProgrammaticToolCallingParam): any;
+export declare function reasoningModeEnumDeserializer(item: any): ReasoningModeEnum;
+export declare function reasoningModeEnumSerializer(item: ReasoningModeEnum): any;
+export declare function specificProgrammaticToolCallingParamDeserializer(item: any): SpecificProgrammaticToolCallingParam;
+export declare function specificProgrammaticToolCallingParamSerializer(item: SpecificProgrammaticToolCallingParam): any;
 //# sourceMappingURL=models.d.ts.map