@orq-ai/node 4.15.0-rc.8 → 4.15.0

package/packages/orq-rc/src/models/operations/retrieveagentrequest.ts

@@ -0,0 +1,3103 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type RetrieveAgentRequestRequest = {
+  /**
+   * The unique key of the agent to retrieve
+   */
+  agentKey: string;
+};
+
+/**
+ * The status of the agent. `Live` is the latest version of the agent. `Draft` is a version that is not yet published. `Pending` is a version that is pending approval. `Published` is a version that was live and has been replaced by a new version.
+ */
+export const RetrieveAgentRequestStatus = {
+  Live: "live",
+  Draft: "draft",
+  Pending: "pending",
+  Published: "published",
+} as const;
+/**
+ * The status of the agent. `Live` is the latest version of the agent. `Draft` is a version that is not yet published. `Pending` is a version that is pending approval. `Published` is a version that was live and has been replaced by a new version.
+ */
+export type RetrieveAgentRequestStatus = ClosedEnum<
+  typeof RetrieveAgentRequestStatus
+>;
+
+export type RetrieveAgentRequestTeamOfAgents = {
+  /**
+   * The unique key of the agent within the workspace
+   */
+  key: string;
+  /**
+   * The role of the agent in this context. This is used to give extra information to the leader to help it decide which agent to hand off to.
+   */
+  role?: string | undefined;
+};
+
+export type RetrieveAgentRequestMetrics = {
+  totalCost: number;
+};
+
+export type RetrieveAgentRequestKnowledgeBases = {
+  /**
+   * Unique identifier of the knowledge base to search
+   */
+  knowledgeId: string;
+};
+
+export const RetrieveAgentRequestSource = {
+  Internal: "internal",
+  External: "external",
+  Experiment: "experiment",
+} as const;
+export type RetrieveAgentRequestSource = ClosedEnum<
+  typeof RetrieveAgentRequestSource
+>;
+
+export const RetrieveAgentRequestEngine = {
+  Text: "text",
+  Jinja: "jinja",
+  Mustache: "mustache",
+} as const;
+export type RetrieveAgentRequestEngine = ClosedEnum<
+  typeof RetrieveAgentRequestEngine
+>;
+
+/**
+ * Agent type: internal (Orquesta-managed) or a2a (external A2A-compliant)
+ */
+export const RetrieveAgentRequestType = {
+  Internal: "internal",
+  A2a: "a2a",
+} as const;
+/**
+ * Agent type: internal (Orquesta-managed) or a2a (external A2A-compliant)
+ */
+export type RetrieveAgentRequestType = ClosedEnum<
+  typeof RetrieveAgentRequestType
+>;
+
+/**
+ * If all, the agent will require approval for all tools. If respect_tool, the agent will require approval for tools that have the requires_approval flag set to true. If none, the agent will not require approval for any tools.
+ */
+export const RetrieveAgentRequestToolApprovalRequired = {
+  All: "all",
+  RespectTool: "respect_tool",
+  None: "none",
+} as const;
+/**
+ * If all, the agent will require approval for all tools. If respect_tool, the agent will require approval for tools that have the requires_approval flag set to true. If none, the agent will not require approval for any tools.
+ */
+export type RetrieveAgentRequestToolApprovalRequired = ClosedEnum<
+  typeof RetrieveAgentRequestToolApprovalRequired
+>;
+
+export type RetrieveAgentRequestConditions = {
+  /**
+   * The argument of the tool call to evaluate
+   */
+  condition: string;
+  /**
+   * The operator to use
+   */
+  operator: string;
+  /**
+   * The value to compare against
+   */
+  value: string;
+};
+
+export type RetrieveAgentRequestTools = {
+  /**
+   * The id of the resource
+   */
+  id: string;
+  /**
+   * Optional tool key for custom tools
+   */
+  key?: string | undefined;
+  actionType: string;
+  displayName?: string | undefined;
+  /**
+   * Optional tool description
+   */
+  description?: string | undefined;
+  /**
+   * Static tool configuration set at design time. Merged over LLM-provided arguments at execution time.
+   */
+  configuration?: { [k: string]: any } | undefined;
+  requiresApproval: boolean;
+  /**
+   * Nested tool ID for MCP tools (identifies specific tool within MCP server)
+   */
+  toolId?: string | undefined;
+  conditions?: Array<RetrieveAgentRequestConditions> | undefined;
+  /**
+   * Tool execution timeout in seconds for this agent (max: 10 minutes). Overrides the timeout configured on the tool definition.
+   */
+  timeout?: number | undefined;
+};
+
+/**
+ * Determines whether the evaluator runs on the agent input (user message) or output (agent response).
+ */
+export const RetrieveAgentRequestExecuteOn = {
+  Input: "input",
+  Output: "output",
+} as const;
+/**
+ * Determines whether the evaluator runs on the agent input (user message) or output (agent response).
+ */
+export type RetrieveAgentRequestExecuteOn = ClosedEnum<
+  typeof RetrieveAgentRequestExecuteOn
+>;
+
+export type RetrieveAgentRequestEvaluators = {
+  /**
+   * Unique key or identifier of the evaluator
+   */
+  id: string;
+  /**
+   * The percentage of executions to evaluate with this evaluator (1-100). For example, a value of 50 means the evaluator will run on approximately half of the executions.
+   */
+  sampleRate: number;
+  /**
+   * Determines whether the evaluator runs on the agent input (user message) or output (agent response).
+   */
+  executeOn: RetrieveAgentRequestExecuteOn;
+  /**
+   * Evaluator-specific configuration, passed through to the evaluator at run time. For orq_pii_detection this carries regions, entities, entity_thresholds, language and threshold, and is validated against PIIDetectionGuardrailOptions: regions and entities are two mutually exclusive coverage modes, and every entity_thresholds key must also appear in entities. on_failure is rejected: an evaluator acting as a guardrail always fails closed.
+   */
+  options?: { [k: string]: any } | undefined;
+};
+
+/**
+ * Determines whether the evaluator runs on the agent input (user message) or output (agent response).
+ */
+export const RetrieveAgentRequestAgentsExecuteOn = {
+  Input: "input",
+  Output: "output",
+} as const;
+/**
+ * Determines whether the evaluator runs on the agent input (user message) or output (agent response).
+ */
+export type RetrieveAgentRequestAgentsExecuteOn = ClosedEnum<
+  typeof RetrieveAgentRequestAgentsExecuteOn
+>;
+
+export type RetrieveAgentRequestGuardrails = {
+  /**
+   * Unique key or identifier of the evaluator
+   */
+  id: string;
+  /**
+   * The percentage of executions to evaluate with this evaluator (1-100). For example, a value of 50 means the evaluator will run on approximately half of the executions.
+   */
+  sampleRate: number;
+  /**
+   * Determines whether the evaluator runs on the agent input (user message) or output (agent response).
+   */
+  executeOn: RetrieveAgentRequestAgentsExecuteOn;
+  /**
+   * Evaluator-specific configuration, passed through to the evaluator at run time. For orq_pii_detection this carries regions, entities, entity_thresholds, language and threshold, and is validated against PIIDetectionGuardrailOptions: regions and entities are two mutually exclusive coverage modes, and every entity_thresholds key must also appear in entities. on_failure is rejected: an evaluator acting as a guardrail always fails closed.
+   */
+  options?: { [k: string]: any } | undefined;
+};
+
+export type RetrieveAgentRequestSettings = {
+  /**
+   * Maximum iterations(llm calls) before the agent will stop executing.
+   */
+  maxIterations: number;
+  /**
+   * Maximum time (in seconds) for the agent thinking process. This does not include the time for tool calls and sub agent calls. It will be loosely enforced, the in progress LLM calls will not be terminated and the last assistant message will be returned.
+   */
+  maxExecutionTime: number;
+  /**
+   * Maximum cost in USD for the agent execution. When the accumulated cost exceeds this limit, the agent will stop executing. Set to 0 for unlimited. Only supported in v3 responses
+   */
+  maxCost: number;
+  /**
+   * If all, the agent will require approval for all tools. If respect_tool, the agent will require approval for tools that have the requires_approval flag set to true. If none, the agent will not require approval for any tools.
+   */
+  toolApprovalRequired: RetrieveAgentRequestToolApprovalRequired;
+  /**
+   * When enabled, this agent is exposed as a selectable target in AI Chat for users to consume.
+   */
+  chatExposed?: boolean | undefined;
+  tools?: Array<RetrieveAgentRequestTools> | undefined;
+  /**
+   * Configuration for an evaluator applied to the agent
+   */
+  evaluators?: Array<RetrieveAgentRequestEvaluators> | undefined;
+  /**
+   * Configuration for a guardrail applied to the agent. sample_rate has no effect here: a guardrail is a gate rather than a measurement, so it runs on every request.
+   */
+  guardrails?: Array<RetrieveAgentRequestGuardrails> | undefined;
+};
+
+export type RetrieveAgentRequestResponseFormatJsonSchema = {
+  /**
+   * A description of what the response format is for, used by the model to determine how to respond in the format.
+   */
+  description?: string | undefined;
+  /**
+   * The name of the response format. Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64.
+   */
+  name: string;
+  /**
+   * The schema for the response format, described as a JSON Schema object.
+   */
+  schema?: any | undefined;
+  /**
+   * Whether to enable strict schema adherence when generating the output. If set to true, the model will always follow the exact schema defined in the schema field. Only a subset of JSON Schema is supported when strict is true.
+   */
+  strict: boolean;
+};
+
+/**
+ * @remarks
+ *
+ * JSON Schema response format. Used to generate structured JSON responses
+ */
+export type RetrieveAgentRequestResponseFormatAgentsJSONSchema = {
+  type: "json_schema";
+  jsonSchema: RetrieveAgentRequestResponseFormatJsonSchema;
+};
+
+/**
+ * @remarks
+ *
+ * JSON object response format. An older method of generating JSON responses. Using `json_schema` is recommended for models that support it. Note that the model will not generate JSON without a system or user message instructing it to do so.
+ */
+export type RetrieveAgentRequestResponseFormatJSONObject = {
+  type: "json_object";
+};
+
+/**
+ * @remarks
+ *
+ * Default response format. Used to generate text responses
+ */
+export type RetrieveAgentRequestResponseFormatText = {
+  type: "text";
+};
+
+/**
+ * An object specifying the format that the model must output
+ */
+export type RetrieveAgentRequestResponseFormat =
+  | RetrieveAgentRequestResponseFormatText
+  | RetrieveAgentRequestResponseFormatJSONObject
+  | RetrieveAgentRequestResponseFormatAgentsJSONSchema;
+
+/**
+ * Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
+ *
+ * @remarks
+ *
+ * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all reasoning values in gpt-5.1.
+ * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support `none`.
+ * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
+ * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+ *
+ * Any of "none", "minimal", "low", "medium", "high", "xhigh", "max".
+ */
+export const RetrieveAgentRequestReasoningEffort = {
+  None: "none",
+  Minimal: "minimal",
+  Low: "low",
+  Medium: "medium",
+  High: "high",
+  Xhigh: "xhigh",
+  Max: "max",
+} as const;
+/**
+ * Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
+ *
+ * @remarks
+ *
+ * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all reasoning values in gpt-5.1.
+ * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support `none`.
+ * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
+ * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+ *
+ * Any of "none", "minimal", "low", "medium", "high", "xhigh", "max".
+ */
+export type RetrieveAgentRequestReasoningEffort = ClosedEnum<
+  typeof RetrieveAgentRequestReasoningEffort
+>;
+
+/**
+ * Up to 4 sequences where the API will stop generating further tokens.
+ */
+export type RetrieveAgentRequestStop = string | Array<string>;
+
+export type RetrieveAgentRequestThinking =
+  | components.ThinkingConfigDisabledSchema
+  | components.ThinkingConfigEnabledSchema
+  | components.ThinkingConfigAdaptiveSchema;
+
+/**
+ * The type of the tool. Currently, only function is supported.
+ */
+export const RetrieveAgentRequestToolChoiceType = {
+  Function: "function",
+} as const;
+/**
+ * The type of the tool. Currently, only function is supported.
+ */
+export type RetrieveAgentRequestToolChoiceType = ClosedEnum<
+  typeof RetrieveAgentRequestToolChoiceType
+>;
+
+export type RetrieveAgentRequestToolChoiceFunction = {
+  /**
+   * The name of the function to call.
+   */
+  name: string;
+};
+
+export type RetrieveAgentRequestToolChoice2 = {
+  /**
+   * The type of the tool. Currently, only function is supported.
+   */
+  type?: RetrieveAgentRequestToolChoiceType | undefined;
+  function: RetrieveAgentRequestToolChoiceFunction;
+};
+
+export const RetrieveAgentRequestToolChoice1 = {
+  None: "none",
+  Auto: "auto",
+  Required: "required",
+} as const;
+export type RetrieveAgentRequestToolChoice1 = ClosedEnum<
+  typeof RetrieveAgentRequestToolChoice1
+>;
+
+/**
+ * Controls which (if any) tool is called by the model.
+ */
+export type RetrieveAgentRequestToolChoice =
+  | RetrieveAgentRequestToolChoice2
+  | RetrieveAgentRequestToolChoice1;
+
+export const RetrieveAgentRequestModalities = {
+  Text: "text",
+  Audio: "audio",
+} as const;
+export type RetrieveAgentRequestModalities = ClosedEnum<
+  typeof RetrieveAgentRequestModalities
+>;
+
+/**
+ * The key of the guardrail.
+ */
+export const RetrieveAgentRequestId1 = {
+  OrqPiiDetection: "orq_pii_detection",
+  OrqSecretDetection: "orq_secret_detection",
+  OrqSexualModeration: "orq_sexual_moderation",
+  OrqHarmfulModeration: "orq_harmful_moderation",
+} as const;
+/**
+ * The key of the guardrail.
+ */
+export type RetrieveAgentRequestId1 = ClosedEnum<
+  typeof RetrieveAgentRequestId1
+>;
+
+export type RetrieveAgentRequestId = RetrieveAgentRequestId1 | string;
+
+/**
+ * Determines whether the guardrail runs on the input (user message) or output (model response).
+ */
+export const RetrieveAgentRequestAgentsResponseExecuteOn = {
+  Input: "input",
+  Output: "output",
+} as const;
+/**
+ * Determines whether the guardrail runs on the input (user message) or output (model response).
+ */
+export type RetrieveAgentRequestAgentsResponseExecuteOn = ClosedEnum<
+  typeof RetrieveAgentRequestAgentsResponseExecuteOn
+>;
+
+export type RetrieveAgentRequestAgentsGuardrails = {
+  id: RetrieveAgentRequestId1 | string;
+  /**
+   * Determines whether the guardrail runs on the input (user message) or output (model response).
+   */
+  executeOn: RetrieveAgentRequestAgentsResponseExecuteOn;
+};
+
+export type RetrieveAgentRequestPlugins =
+  | (components.PIIRedactionPlugin & { id: "pii_redaction" })
+  | components.ResponseHealingPlugin
+  | components.TraceScrubbingPlugin;
+
+export type RetrieveAgentRequestFallbacks = {
+  /**
+   * Fallback model identifier
+   */
+  model: string;
+};
+
+export const RetrieveAgentRequestAgentsType = {
+  ExactMatch: "exact_match",
+} as const;
+export type RetrieveAgentRequestAgentsType = ClosedEnum<
+  typeof RetrieveAgentRequestAgentsType
+>;
+
+/**
+ * Cache configuration for the request.
+ */
+export type RetrieveAgentRequestCache = {
+  /**
+   * Time to live for cached responses in seconds. Maximum 259200 seconds (3 days).
+   */
+  ttl: number;
+  type: RetrieveAgentRequestAgentsType;
+};
+
+export const RetrieveAgentRequestLoadBalancerType = {
+  WeightBased: "weight_based",
+} as const;
+export type RetrieveAgentRequestLoadBalancerType = ClosedEnum<
+  typeof RetrieveAgentRequestLoadBalancerType
+>;
+
+export type RetrieveAgentRequestLoadBalancerModels = {
+  /**
+   * Model identifier for load balancing
+   */
+  model: string;
+  /**
+   * Weight assigned to this model for load balancing
+   */
+  weight: number;
+};
+
+export type RetrieveAgentRequestLoadBalancer1 = {
+  type: RetrieveAgentRequestLoadBalancerType;
+  models: Array<RetrieveAgentRequestLoadBalancerModels>;
+};
+
+/**
+ * Load balancer configuration for the request.
+ */
+export type RetrieveAgentRequestLoadBalancer =
+  RetrieveAgentRequestLoadBalancer1;
+
+/**
+ * Timeout configuration to apply to the request. If the request exceeds the timeout, it will be retried or fallback to the next model if configured.
+ */
+export type RetrieveAgentRequestTimeout = {
+  /**
+   * Timeout value in milliseconds
+   */
+  callTimeout: number;
+};
+
+/**
+ * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+ */
+export const RetrieveAgentRequestAgentsResponseType = {
+  Ephemeral: "ephemeral",
+} as const;
+/**
+ * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+ */
+export type RetrieveAgentRequestAgentsResponseType = ClosedEnum<
+  typeof RetrieveAgentRequestAgentsResponseType
+>;
+
+/**
+ * The time-to-live for the cache control breakpoint. This may be one of the following values:
+ *
+ * @remarks
+ *
+ * - `5m`: 5 minutes
+ * - `1h`: 1 hour
+ *
+ * Defaults to `5m`. Only supported by `Anthropic` Claude models.
+ */
+export const RetrieveAgentRequestTtl = {
+  Fivem: "5m",
+  Oneh: "1h",
+} as const;
+/**
+ * The time-to-live for the cache control breakpoint. This may be one of the following values:
+ *
+ * @remarks
+ *
+ * - `5m`: 5 minutes
+ * - `1h`: 1 hour
+ *
+ * Defaults to `5m`. Only supported by `Anthropic` Claude models.
+ */
+export type RetrieveAgentRequestTtl = ClosedEnum<
+  typeof RetrieveAgentRequestTtl
+>;
+
+/**
+ * Provider-level prompt caching configuration applied to the request. Creates a cache control breakpoint covering the request content. Only supported by `Anthropic` Claude models.
+ */
+export type RetrieveAgentRequestCacheControl = {
+  /**
+   * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+   */
+  type: RetrieveAgentRequestAgentsResponseType;
+  /**
+   * The time-to-live for the cache control breakpoint. This may be one of the following values:
+   *
+   * @remarks
+   *
+   * - `5m`: 5 minutes
+   * - `1h`: 1 hour
+   *
+   * Defaults to `5m`. Only supported by `Anthropic` Claude models.
+   */
+  ttl: RetrieveAgentRequestTtl;
+};
+
+/**
+ * Model behavior parameters (snake_case) stored as part of the agent configuration. These become the default parameters used when the agent is executed. Commonly used: temperature (0-1, controls randomness), max_completion_tokens (response length), top_p (nucleus sampling). Advanced: frequency_penalty, presence_penalty, response_format (JSON/structured output), reasoning_effort (for o1/thinking models), seed (reproducibility), stop sequences. Model-specific support varies. Runtime parameters in agent execution requests can override these defaults.
+ */
+export type RetrieveAgentRequestParameters = {
+  /**
+   * The name to display on the trace. If not specified, the default system name will be used.
+   */
+  name?: string | undefined;
+  /**
+   * Number between -2.0 and 2.0. Positive values penalize new tokens based on their existing frequency in the text so far, decreasing the model's likelihood to repeat the same line verbatim.
+   */
+  frequencyPenalty?: number | null | undefined;
+  /**
+   * `[Deprecated]`. The maximum number of tokens that can be generated in the chat completion. This value can be used to control costs for text generated via API.
+   *
+   * @remarks
+   *
+   *  This value is now `deprecated` in favor of `max_completion_tokens`, and is not compatible with o1 series models.
+   */
+  maxTokens?: number | null | undefined;
+  /**
+   * An upper bound for the number of tokens that can be generated for a completion, including visible output tokens and reasoning tokens
+   */
+  maxCompletionTokens?: number | null | undefined;
+  /**
+   * Number between -2.0 and 2.0. Positive values penalize new tokens based on whether they appear in the text so far, increasing the model's likelihood to talk about new topics.
+   */
+  presencePenalty?: number | null | undefined;
+  /**
+   * An object specifying the format that the model must output
+   */
+  responseFormat?:
+    | RetrieveAgentRequestResponseFormatText
+    | RetrieveAgentRequestResponseFormatJSONObject
+    | RetrieveAgentRequestResponseFormatAgentsJSONSchema
+    | undefined;
+  /**
+   * Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
+   *
+   * @remarks
+   *
+   * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all reasoning values in gpt-5.1.
+   * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support `none`.
+   * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
+   * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+   *
+   * Any of "none", "minimal", "low", "medium", "high", "xhigh", "max".
+   */
+  reasoningEffort?: RetrieveAgentRequestReasoningEffort | undefined;
+  /**
+   * Adjusts response verbosity. Lower levels yield shorter answers.
+   */
+  verbosity?: string | undefined;
+  /**
+   * If specified, our system will make a best effort to sample deterministically, such that repeated requests with the same seed and parameters should return the same result.
+   */
+  seed?: number | null | undefined;
+  /**
+   * Up to 4 sequences where the API will stop generating further tokens.
+   */
+  stop?: string | Array<string> | null | undefined;
+  thinking?:
+    | components.ThinkingConfigDisabledSchema
+    | components.ThinkingConfigEnabledSchema
+    | components.ThinkingConfigAdaptiveSchema
+    | undefined;
+  /**
+   * What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic.
+   */
+  temperature?: number | null | undefined;
+  /**
+   * An alternative to sampling with temperature, called nucleus sampling, where the model considers the results of the tokens with top_p probability mass.
+   */
+  topP?: number | null | undefined;
+  /**
+   * Limits the model to consider only the top k most likely tokens at each step.
+   */
+  topK?: number | null | undefined;
+  /**
+   * Controls which (if any) tool is called by the model.
+   */
+  toolChoice?:
+    | RetrieveAgentRequestToolChoice2
+    | RetrieveAgentRequestToolChoice1
+    | undefined;
+  /**
+   * Whether to enable parallel function calling during tool use.
+   */
+  parallelToolCalls?: boolean | undefined;
+  /**
+   * Output types that you would like the model to generate. Most models are capable of generating text, which is the default: ["text"]. The gpt-4o-audio-preview model can also be used to generate audio. To request that this model generate both text and audio responses, you can use: ["text", "audio"].
+   */
+  modalities?: Array<RetrieveAgentRequestModalities> | null | undefined;
+  /**
+   * A list of guardrails to apply to the request.
+   */
+  guardrails?: Array<RetrieveAgentRequestAgentsGuardrails> | undefined;
+  /**
+   * Request-scoped transforms applied to the text exchanged with the model. Supports `pii_redaction`, which replaces PII with placeholders before the provider sees it and restores the original values in the response, and `response_healing`, which repairs malformed JSON in non-streaming output.
+   */
+  plugins?:
+    | Array<
+      | (components.PIIRedactionPlugin & { id: "pii_redaction" })
+      | components.ResponseHealingPlugin
+      | components.TraceScrubbingPlugin
+    >
+    | undefined;
+  /**
+   * Array of fallback models to use if primary model fails
+   */
+  fallbacks?: Array<RetrieveAgentRequestFallbacks> | undefined;
+  /**
+   * Cache configuration for the request.
+   */
+  cache?: RetrieveAgentRequestCache | undefined;
+  /**
+   * Load balancer configuration for the request.
+   */
+  loadBalancer?: RetrieveAgentRequestLoadBalancer1 | undefined;
+  /**
+   * Timeout configuration to apply to the request. If the request exceeds the timeout, it will be retried or fallback to the next model if configured.
+   */
+  timeout?: RetrieveAgentRequestTimeout | undefined;
+  /**
+   * Provider-level prompt caching configuration applied to the request. Creates a cache control breakpoint covering the request content. Only supported by `Anthropic` Claude models.
+   */
+  cacheControl?: RetrieveAgentRequestCacheControl | undefined;
+  /**
+   * Used by OpenAI to cache responses for similar requests to optimize your cache hit rates. Replaces the legacy `user` field for prompt caching.
+   */
+  promptCacheKey?: string | undefined;
+};
+
+/**
+ * Retry configuration for model requests. Allows customizing retry count (1-5) and HTTP status codes that trigger retries. Default codes: [429]. Common codes: 500 (internal error), 429 (rate limit), 502/503/504 (gateway errors).
+ */
+export type RetrieveAgentRequestRetry = {
+  /**
+   * Number of retry attempts (1-5)
+   */
+  count: number;
+  /**
+   * HTTP status codes that trigger retry logic
+   */
+  onCodes?: Array<number> | undefined;
+};
+
+export type RetrieveAgentRequestResponseFormatAgentsResponseJsonSchema = {
+  /**
+   * A description of what the response format is for, used by the model to determine how to respond in the format.
+   */
+  description?: string | undefined;
+  /**
+   * The name of the response format. Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64.
+   */
+  name: string;
+  /**
+   * The schema for the response format, described as a JSON Schema object.
+   */
+  schema?: any | undefined;
+  /**
+   * Whether to enable strict schema adherence when generating the output. If set to true, the model will always follow the exact schema defined in the schema field. Only a subset of JSON Schema is supported when strict is true.
+   */
+  strict: boolean;
+};
+
+/**
+ * @remarks
+ *
+ * JSON Schema response format. Used to generate structured JSON responses
+ */
+export type RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema = {
+  type: "json_schema";
+  jsonSchema: RetrieveAgentRequestResponseFormatAgentsResponseJsonSchema;
+};
+
+/**
+ * @remarks
+ *
+ * JSON object response format. An older method of generating JSON responses. Using `json_schema` is recommended for models that support it. Note that the model will not generate JSON without a system or user message instructing it to do so.
+ */
+export type RetrieveAgentRequestResponseFormatAgentsJSONObject = {
+  type: "json_object";
+};
+
+/**
+ * @remarks
+ *
+ * Default response format. Used to generate text responses
+ */
+export type RetrieveAgentRequestResponseFormatAgentsText = {
+  type: "text";
+};
+
+/**
+ * An object specifying the format that the model must output
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationResponseFormat =
+  | RetrieveAgentRequestResponseFormatAgentsText
+  | RetrieveAgentRequestResponseFormatAgentsJSONObject
+  | RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema;
+
+/**
+ * Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
+ *
+ * @remarks
+ *
+ * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all reasoning values in gpt-5.1.
+ * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support `none`.
+ * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
+ * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+ *
+ * Any of "none", "minimal", "low", "medium", "high", "xhigh", "max".
+ */
+export const RetrieveAgentRequestFallbackModelConfigurationReasoningEffort = {
+  None: "none",
+  Minimal: "minimal",
+  Low: "low",
+  Medium: "medium",
+  High: "high",
+  Xhigh: "xhigh",
+  Max: "max",
+} as const;
+/**
+ * Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
+ *
+ * @remarks
+ *
+ * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all reasoning values in gpt-5.1.
+ * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support `none`.
+ * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
+ * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+ *
+ * Any of "none", "minimal", "low", "medium", "high", "xhigh", "max".
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationReasoningEffort =
+  ClosedEnum<
+    typeof RetrieveAgentRequestFallbackModelConfigurationReasoningEffort
+  >;
+
+/**
+ * Up to 4 sequences where the API will stop generating further tokens.
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationStop =
+  | string
+  | Array<string>;
+
+export type RetrieveAgentRequestFallbackModelConfigurationThinking =
+  | components.ThinkingConfigDisabledSchema
+  | components.ThinkingConfigEnabledSchema
+  | components.ThinkingConfigAdaptiveSchema;
+
+/**
+ * The type of the tool. Currently, only function is supported.
+ */
+export const RetrieveAgentRequestToolChoiceAgentsType = {
+  Function: "function",
+} as const;
+/**
+ * The type of the tool. Currently, only function is supported.
+ */
+export type RetrieveAgentRequestToolChoiceAgentsType = ClosedEnum<
+  typeof RetrieveAgentRequestToolChoiceAgentsType
+>;
+
+export type RetrieveAgentRequestToolChoiceAgentsFunction = {
+  /**
+   * The name of the function to call.
+   */
+  name: string;
+};
+
+export type RetrieveAgentRequestToolChoiceAgents2 = {
+  /**
+   * The type of the tool. Currently, only function is supported.
+   */
+  type?: RetrieveAgentRequestToolChoiceAgentsType | undefined;
+  function: RetrieveAgentRequestToolChoiceAgentsFunction;
+};
+
+export const RetrieveAgentRequestToolChoiceAgents1 = {
+  None: "none",
+  Auto: "auto",
+  Required: "required",
+} as const;
+export type RetrieveAgentRequestToolChoiceAgents1 = ClosedEnum<
+  typeof RetrieveAgentRequestToolChoiceAgents1
+>;
+
+/**
+ * Controls which (if any) tool is called by the model.
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationToolChoice =
+  | RetrieveAgentRequestToolChoiceAgents2
+  | RetrieveAgentRequestToolChoiceAgents1;
+
+export const RetrieveAgentRequestFallbackModelConfigurationModalities = {
+  Text: "text",
+  Audio: "audio",
+} as const;
+export type RetrieveAgentRequestFallbackModelConfigurationModalities =
+  ClosedEnum<typeof RetrieveAgentRequestFallbackModelConfigurationModalities>;
+
+/**
+ * The key of the guardrail.
+ */
+export const RetrieveAgentRequestIdAgents1 = {
+  OrqPiiDetection: "orq_pii_detection",
+  OrqSecretDetection: "orq_secret_detection",
+  OrqSexualModeration: "orq_sexual_moderation",
+  OrqHarmfulModeration: "orq_harmful_moderation",
+} as const;
+/**
+ * The key of the guardrail.
+ */
+export type RetrieveAgentRequestIdAgents1 = ClosedEnum<
+  typeof RetrieveAgentRequestIdAgents1
+>;
+
+export type RetrieveAgentRequestFallbackModelConfigurationId =
+  | RetrieveAgentRequestIdAgents1
+  | string;
+
+/**
+ * Determines whether the guardrail runs on the input (user message) or output (model response).
+ */
+export const RetrieveAgentRequestFallbackModelConfigurationExecuteOn = {
+  Input: "input",
+  Output: "output",
+} as const;
+/**
+ * Determines whether the guardrail runs on the input (user message) or output (model response).
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationExecuteOn =
+  ClosedEnum<typeof RetrieveAgentRequestFallbackModelConfigurationExecuteOn>;
+
+export type RetrieveAgentRequestFallbackModelConfigurationGuardrails = {
+  id: RetrieveAgentRequestIdAgents1 | string;
+  /**
+   * Determines whether the guardrail runs on the input (user message) or output (model response).
+   */
+  executeOn: RetrieveAgentRequestFallbackModelConfigurationExecuteOn;
+};
+
+export type RetrieveAgentRequestFallbackModelConfigurationPlugins =
+  | (components.PIIRedactionPlugin & { id: "pii_redaction" })
+  | components.ResponseHealingPlugin
+  | components.TraceScrubbingPlugin;
+
+export type RetrieveAgentRequestFallbackModelConfigurationFallbacks = {
+  /**
+   * Fallback model identifier
+   */
+  model: string;
+};
+
+export const RetrieveAgentRequestFallbackModelConfigurationType = {
+  ExactMatch: "exact_match",
+} as const;
+export type RetrieveAgentRequestFallbackModelConfigurationType = ClosedEnum<
+  typeof RetrieveAgentRequestFallbackModelConfigurationType
+>;
+
+/**
+ * Cache configuration for the request.
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationCache = {
+  /**
+   * Time to live for cached responses in seconds. Maximum 259200 seconds (3 days).
+   */
+  ttl: number;
+  type: RetrieveAgentRequestFallbackModelConfigurationType;
+};
+
+export const RetrieveAgentRequestLoadBalancerAgentsType = {
+  WeightBased: "weight_based",
+} as const;
+export type RetrieveAgentRequestLoadBalancerAgentsType = ClosedEnum<
+  typeof RetrieveAgentRequestLoadBalancerAgentsType
+>;
+
+export type RetrieveAgentRequestLoadBalancerAgentsModels = {
+  /**
+   * Model identifier for load balancing
+   */
+  model: string;
+  /**
+   * Weight assigned to this model for load balancing
+   */
+  weight: number;
+};
+
+export type RetrieveAgentRequestLoadBalancerAgents1 = {
+  type: RetrieveAgentRequestLoadBalancerAgentsType;
+  models: Array<RetrieveAgentRequestLoadBalancerAgentsModels>;
+};
+
+/**
+ * Load balancer configuration for the request.
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationLoadBalancer =
+  RetrieveAgentRequestLoadBalancerAgents1;
+
+/**
+ * Timeout configuration to apply to the request. If the request exceeds the timeout, it will be retried or fallback to the next model if configured.
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationTimeout = {
+  /**
+   * Timeout value in milliseconds
+   */
+  callTimeout: number;
+};
+
+/**
+ * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+ */
+export const RetrieveAgentRequestFallbackModelConfigurationAgentsType = {
+  Ephemeral: "ephemeral",
+} as const;
+/**
+ * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationAgentsType =
+  ClosedEnum<typeof RetrieveAgentRequestFallbackModelConfigurationAgentsType>;
+
+/**
+ * The time-to-live for the cache control breakpoint. This may be one of the following values:
+ *
+ * @remarks
+ *
+ * - `5m`: 5 minutes
+ * - `1h`: 1 hour
+ *
+ * Defaults to `5m`. Only supported by `Anthropic` Claude models.
+ */
+export const RetrieveAgentRequestFallbackModelConfigurationTtl = {
+  Fivem: "5m",
+  Oneh: "1h",
+} as const;
+/**
+ * The time-to-live for the cache control breakpoint. This may be one of the following values:
+ *
+ * @remarks
+ *
+ * - `5m`: 5 minutes
+ * - `1h`: 1 hour
+ *
+ * Defaults to `5m`. Only supported by `Anthropic` Claude models.
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationTtl = ClosedEnum<
+  typeof RetrieveAgentRequestFallbackModelConfigurationTtl
+>;
+
+/**
+ * Provider-level prompt caching configuration applied to the request. Creates a cache control breakpoint covering the request content. Only supported by `Anthropic` Claude models.
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationCacheControl = {
+  /**
+   * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+   */
+  type: RetrieveAgentRequestFallbackModelConfigurationAgentsType;
+  /**
+   * The time-to-live for the cache control breakpoint. This may be one of the following values:
+   *
+   * @remarks
+   *
+   * - `5m`: 5 minutes
+   * - `1h`: 1 hour
+   *
+   * Defaults to `5m`. Only supported by `Anthropic` Claude models.
+   */
+  ttl: RetrieveAgentRequestFallbackModelConfigurationTtl;
+};
+
+/**
+ * Optional model parameters specific to this fallback model. Overrides primary model parameters if this fallback is used.
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationParameters = {
+  /**
+   * The name to display on the trace. If not specified, the default system name will be used.
+   */
+  name?: string | undefined;
+  /**
+   * Number between -2.0 and 2.0. Positive values penalize new tokens based on their existing frequency in the text so far, decreasing the model's likelihood to repeat the same line verbatim.
+   */
+  frequencyPenalty?: number | null | undefined;
+  /**
+   * `[Deprecated]`. The maximum number of tokens that can be generated in the chat completion. This value can be used to control costs for text generated via API.
+   *
+   * @remarks
+   *
+   *  This value is now `deprecated` in favor of `max_completion_tokens`, and is not compatible with o1 series models.
+   */
+  maxTokens?: number | null | undefined;
+  /**
+   * An upper bound for the number of tokens that can be generated for a completion, including visible output tokens and reasoning tokens
+   */
+  maxCompletionTokens?: number | null | undefined;
+  /**
+   * Number between -2.0 and 2.0. Positive values penalize new tokens based on whether they appear in the text so far, increasing the model's likelihood to talk about new topics.
+   */
+  presencePenalty?: number | null | undefined;
+  /**
+   * An object specifying the format that the model must output
+   */
+  responseFormat?:
+    | RetrieveAgentRequestResponseFormatAgentsText
+    | RetrieveAgentRequestResponseFormatAgentsJSONObject
+    | RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema
+    | undefined;
+  /**
+   * Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
+   *
+   * @remarks
+   *
+   * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all reasoning values in gpt-5.1.
+   * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support `none`.
+   * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
+   * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+   *
+   * Any of "none", "minimal", "low", "medium", "high", "xhigh", "max".
+   */
+  reasoningEffort?:
+    | RetrieveAgentRequestFallbackModelConfigurationReasoningEffort
+    | undefined;
+  /**
+   * Adjusts response verbosity. Lower levels yield shorter answers.
+   */
+  verbosity?: string | undefined;
+  /**
+   * If specified, our system will make a best effort to sample deterministically, such that repeated requests with the same seed and parameters should return the same result.
+   */
+  seed?: number | null | undefined;
+  /**
+   * Up to 4 sequences where the API will stop generating further tokens.
+   */
+  stop?: string | Array<string> | null | undefined;
+  thinking?:
+    | components.ThinkingConfigDisabledSchema
+    | components.ThinkingConfigEnabledSchema
+    | components.ThinkingConfigAdaptiveSchema
+    | undefined;
+  /**
+   * What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic.
+   */
+  temperature?: number | null | undefined;
+  /**
+   * An alternative to sampling with temperature, called nucleus sampling, where the model considers the results of the tokens with top_p probability mass.
+   */
+  topP?: number | null | undefined;
+  /**
+   * Limits the model to consider only the top k most likely tokens at each step.
+   */
+  topK?: number | null | undefined;
+  /**
+   * Controls which (if any) tool is called by the model.
+   */
+  toolChoice?:
+    | RetrieveAgentRequestToolChoiceAgents2
+    | RetrieveAgentRequestToolChoiceAgents1
+    | undefined;
+  /**
+   * Whether to enable parallel function calling during tool use.
+   */
+  parallelToolCalls?: boolean | undefined;
+  /**
+   * Output types that you would like the model to generate. Most models are capable of generating text, which is the default: ["text"]. The gpt-4o-audio-preview model can also be used to generate audio. To request that this model generate both text and audio responses, you can use: ["text", "audio"].
+   */
+  modalities?:
+    | Array<RetrieveAgentRequestFallbackModelConfigurationModalities>
+    | null
+    | undefined;
+  /**
+   * A list of guardrails to apply to the request.
+   */
+  guardrails?:
+    | Array<RetrieveAgentRequestFallbackModelConfigurationGuardrails>
+    | undefined;
+  /**
+   * Request-scoped transforms applied to the text exchanged with the model. Supports `pii_redaction`, which replaces PII with placeholders before the provider sees it and restores the original values in the response, and `response_healing`, which repairs malformed JSON in non-streaming output.
+   */
+  plugins?:
+    | Array<
+      | (components.PIIRedactionPlugin & { id: "pii_redaction" })
+      | components.ResponseHealingPlugin
+      | components.TraceScrubbingPlugin
+    >
+    | undefined;
+  /**
+   * Array of fallback models to use if primary model fails
+   */
+  fallbacks?:
+    | Array<RetrieveAgentRequestFallbackModelConfigurationFallbacks>
+    | undefined;
+  /**
+   * Cache configuration for the request.
+   */
+  cache?: RetrieveAgentRequestFallbackModelConfigurationCache | undefined;
+  /**
+   * Load balancer configuration for the request.
+   */
+  loadBalancer?: RetrieveAgentRequestLoadBalancerAgents1 | undefined;
+  /**
+   * Timeout configuration to apply to the request. If the request exceeds the timeout, it will be retried or fallback to the next model if configured.
+   */
+  timeout?: RetrieveAgentRequestFallbackModelConfigurationTimeout | undefined;
+  /**
+   * Provider-level prompt caching configuration applied to the request. Creates a cache control breakpoint covering the request content. Only supported by `Anthropic` Claude models.
+   */
+  cacheControl?:
+    | RetrieveAgentRequestFallbackModelConfigurationCacheControl
+    | undefined;
+  /**
+   * Used by OpenAI to cache responses for similar requests to optimize your cache hit rates. Replaces the legacy `user` field for prompt caching.
+   */
+  promptCacheKey?: string | undefined;
+};
+
+/**
+ * Retry configuration for this fallback model. Allows customizing retry count (1-5) and HTTP status codes that trigger retries.
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationRetry = {
+  /**
+   * Number of retry attempts (1-5)
+   */
+  count: number;
+  /**
+   * HTTP status codes that trigger retry logic
+   */
+  onCodes?: Array<number> | undefined;
+};
+
+/**
+ * Fallback model configuration with optional parameters and retry settings.
+ */
+export type RetrieveAgentRequestFallbackModelConfiguration2 = {
+  /**
+   * A fallback model ID string. Must support tool calling.
+   */
+  id: string;
+  /**
+   * Optional model parameters specific to this fallback model. Overrides primary model parameters if this fallback is used.
+   */
+  parameters?:
+    | RetrieveAgentRequestFallbackModelConfigurationParameters
+    | undefined;
+  /**
+   * Retry configuration for this fallback model. Allows customizing retry count (1-5) and HTTP status codes that trigger retries.
+   */
+  retry?: RetrieveAgentRequestFallbackModelConfigurationRetry | undefined;
+};
+
+/**
+ * Fallback model for automatic failover when primary model request fails. Supports optional parameter overrides. Can be a simple model ID string or a configuration object with model-specific parameters. Fallbacks are tried in order.
+ */
+export type RetrieveAgentRequestFallbackModelConfiguration =
+  | RetrieveAgentRequestFallbackModelConfiguration2
+  | string;
+
+export type RetrieveAgentRequestModel = {
+  /**
+   * The database ID of the primary model
+   */
+  id: string;
+  /**
+   * Optional integration ID for custom model configurations
+   */
+  integrationId?: string | null | undefined;
+  /**
+   * Model behavior parameters (snake_case) stored as part of the agent configuration. These become the default parameters used when the agent is executed. Commonly used: temperature (0-1, controls randomness), max_completion_tokens (response length), top_p (nucleus sampling). Advanced: frequency_penalty, presence_penalty, response_format (JSON/structured output), reasoning_effort (for o1/thinking models), seed (reproducibility), stop sequences. Model-specific support varies. Runtime parameters in agent execution requests can override these defaults.
+   */
+  parameters?: RetrieveAgentRequestParameters | null | undefined;
+  /**
+   * Retry configuration for model requests. Allows customizing retry count (1-5) and HTTP status codes that trigger retries. Default codes: [429]. Common codes: 500 (internal error), 429 (rate limit), 502/503/504 (gateway errors).
+   */
+  retry?: RetrieveAgentRequestRetry | undefined;
+  /**
+   * Optional array of fallback models (string IDs or config objects) that will be used automatically in order if the primary model fails
+   */
+  fallbackModels?:
+    | Array<RetrieveAgentRequestFallbackModelConfiguration2 | string>
+    | null
+    | undefined;
+};
+
+/**
+ * Agent successfully retrieved. Returns the complete agent manifest with all configuration details, including models, tools, knowledge bases, and execution settings.
+ */
+export type RetrieveAgentRequestResponseBody = {
+  id: string;
+  /**
+   * Unique identifier for the agent within the workspace
+   */
+  key: string;
+  displayName?: string | undefined;
+  projectId: string;
+  createdById?: string | null | undefined;
+  updatedById?: string | null | undefined;
+  created?: string | undefined;
+  updated?: string | undefined;
+  /**
+   * The status of the agent. `Live` is the latest version of the agent. `Draft` is a version that is not yet published. `Pending` is a version that is pending approval. `Published` is a version that was live and has been replaced by a new version.
+   */
+  status: RetrieveAgentRequestStatus;
+  /**
+   * Current semantic version of the agent manifest.
+   */
+  version?: string | undefined;
+  /**
+   * Entity storage path.
+   *
+   * @remarks
+   *
+   * With workspace-level API keys, use the format `project/folder/subfolder/...`. The first element must be the display name of an existing project, followed by nested folders (auto-created as needed). Example: `Default Project/agents`.
+   *
+   * With project-level API keys, the project is predetermined by the API key, so the path is relative to that project. Example: `agents`. For backward compatibility, a leading project name is ignored when it matches the scoped project.
+   */
+  path: string;
+  /**
+   * Array of memory store identifiers. Accepts both memory store IDs and keys.
+   */
+  memoryStores?: Array<string> | undefined;
+  /**
+   * The agents that are accessible to this orchestrator. The main agent can hand off to these agents to perform tasks.
+   */
+  teamOfAgents?: Array<RetrieveAgentRequestTeamOfAgents> | undefined;
+  /**
+   * List of skills that the agent can utilize. This field allows you to specify which skills the agent has access to, enabling more complex and dynamic behavior.
+   */
+  skills?: Array<string> | undefined;
+  metrics?: RetrieveAgentRequestMetrics | undefined;
+  /**
+   * Extracted variables from agent instructions
+   */
+  variables?: { [k: string]: any } | undefined;
+  /**
+   * Agent knowledge bases reference
+   */
+  knowledgeBases?: Array<RetrieveAgentRequestKnowledgeBases> | undefined;
+  source?: RetrieveAgentRequestSource | undefined;
+  engine: RetrieveAgentRequestEngine;
+  /**
+   * Agent type: internal (Orquesta-managed) or a2a (external A2A-compliant)
+   */
+  type: RetrieveAgentRequestType;
+  role: string;
+  description: string;
+  systemPrompt?: string | null | undefined;
+  instructions: string;
+  settings?: RetrieveAgentRequestSettings | undefined;
+  model: RetrieveAgentRequestModel;
+};
+
+/** @internal */
+export type RetrieveAgentRequestRequest$Outbound = {
+  agent_key: string;
+};
+
+/** @internal */
+export const RetrieveAgentRequestRequest$outboundSchema: z.ZodType<
+  RetrieveAgentRequestRequest$Outbound,
+  z.ZodTypeDef,
+  RetrieveAgentRequestRequest
+> = z.object({
+  agentKey: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    agentKey: "agent_key",
+  });
+});
+
+export function retrieveAgentRequestRequestToJSON(
+  retrieveAgentRequestRequest: RetrieveAgentRequestRequest,
+): string {
+  return JSON.stringify(
+    RetrieveAgentRequestRequest$outboundSchema.parse(
+      retrieveAgentRequestRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestStatus$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestStatus
+> = z.nativeEnum(RetrieveAgentRequestStatus);
+
+/** @internal */
+export const RetrieveAgentRequestTeamOfAgents$inboundSchema: z.ZodType<
+  RetrieveAgentRequestTeamOfAgents,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  key: z.string(),
+  role: z.string().optional(),
+});
+
+export function retrieveAgentRequestTeamOfAgentsFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestTeamOfAgents, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestTeamOfAgents$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestTeamOfAgents' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestMetrics$inboundSchema: z.ZodType<
+  RetrieveAgentRequestMetrics,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  total_cost: z.number().default(0),
+}).transform((v) => {
+  return remap$(v, {
+    "total_cost": "totalCost",
+  });
+});
+
+export function retrieveAgentRequestMetricsFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestMetrics, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestMetrics$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestMetrics' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestKnowledgeBases$inboundSchema: z.ZodType<
+  RetrieveAgentRequestKnowledgeBases,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  knowledge_id: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "knowledge_id": "knowledgeId",
+  });
+});
+
+export function retrieveAgentRequestKnowledgeBasesFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestKnowledgeBases, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestKnowledgeBases$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestKnowledgeBases' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestSource$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestSource
+> = z.nativeEnum(RetrieveAgentRequestSource);
+
+/** @internal */
+export const RetrieveAgentRequestEngine$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestEngine
+> = z.nativeEnum(RetrieveAgentRequestEngine);
+
+/** @internal */
+export const RetrieveAgentRequestType$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestType
+> = z.nativeEnum(RetrieveAgentRequestType);
+
+/** @internal */
+export const RetrieveAgentRequestToolApprovalRequired$inboundSchema:
+  z.ZodNativeEnum<typeof RetrieveAgentRequestToolApprovalRequired> = z
+    .nativeEnum(RetrieveAgentRequestToolApprovalRequired);
+
+/** @internal */
+export const RetrieveAgentRequestConditions$inboundSchema: z.ZodType<
+  RetrieveAgentRequestConditions,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  condition: z.string(),
+  operator: z.string(),
+  value: z.string(),
+});
+
+export function retrieveAgentRequestConditionsFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestConditions, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestConditions$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestConditions' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestTools$inboundSchema: z.ZodType<
+  RetrieveAgentRequestTools,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  key: z.string().optional(),
+  action_type: z.string(),
+  display_name: z.string().optional(),
+  description: z.string().optional(),
+  configuration: z.record(z.any()).optional(),
+  requires_approval: z.boolean().default(false),
+  tool_id: z.string().optional(),
+  conditions: z.array(
+    z.lazy(() => RetrieveAgentRequestConditions$inboundSchema),
+  ).optional(),
+  timeout: z.number().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "action_type": "actionType",
+    "display_name": "displayName",
+    "requires_approval": "requiresApproval",
+    "tool_id": "toolId",
+  });
+});
+
+export function retrieveAgentRequestToolsFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestTools, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestTools$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestTools' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestExecuteOn$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestExecuteOn
+> = z.nativeEnum(RetrieveAgentRequestExecuteOn);
+
+/** @internal */
+export const RetrieveAgentRequestEvaluators$inboundSchema: z.ZodType<
+  RetrieveAgentRequestEvaluators,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  sample_rate: z.number().default(50),
+  execute_on: RetrieveAgentRequestExecuteOn$inboundSchema,
+  options: z.record(z.any()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "sample_rate": "sampleRate",
+    "execute_on": "executeOn",
+  });
+});
+
+export function retrieveAgentRequestEvaluatorsFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestEvaluators, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestEvaluators$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestEvaluators' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestAgentsExecuteOn$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestAgentsExecuteOn
+> = z.nativeEnum(RetrieveAgentRequestAgentsExecuteOn);
+
+/** @internal */
+export const RetrieveAgentRequestGuardrails$inboundSchema: z.ZodType<
+  RetrieveAgentRequestGuardrails,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  sample_rate: z.number().default(50),
+  execute_on: RetrieveAgentRequestAgentsExecuteOn$inboundSchema,
+  options: z.record(z.any()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "sample_rate": "sampleRate",
+    "execute_on": "executeOn",
+  });
+});
+
+export function retrieveAgentRequestGuardrailsFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestGuardrails, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestGuardrails$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestGuardrails' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestSettings$inboundSchema: z.ZodType<
+  RetrieveAgentRequestSettings,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  max_iterations: z.number().int().default(100),
+  max_execution_time: z.number().int().default(600),
+  max_cost: z.number().default(0),
+  tool_approval_required: RetrieveAgentRequestToolApprovalRequired$inboundSchema
+    .default("respect_tool"),
+  chat_exposed: z.boolean().optional(),
+  tools: z.array(z.lazy(() => RetrieveAgentRequestTools$inboundSchema))
+    .optional(),
+  evaluators: z.array(
+    z.lazy(() => RetrieveAgentRequestEvaluators$inboundSchema),
+  ).optional(),
+  guardrails: z.array(
+    z.lazy(() => RetrieveAgentRequestGuardrails$inboundSchema),
+  ).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "max_iterations": "maxIterations",
+    "max_execution_time": "maxExecutionTime",
+    "max_cost": "maxCost",
+    "tool_approval_required": "toolApprovalRequired",
+    "chat_exposed": "chatExposed",
+  });
+});
+
+export function retrieveAgentRequestSettingsFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestSettings, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestSettings$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestSettings' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestResponseFormatJsonSchema$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestResponseFormatJsonSchema,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    description: z.string().optional(),
+    name: z.string(),
+    schema: z.any().optional(),
+    strict: z.boolean().default(false),
+  });
+
+export function retrieveAgentRequestResponseFormatJsonSchemaFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestResponseFormatJsonSchema,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestResponseFormatJsonSchema$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestResponseFormatJsonSchema' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestResponseFormatAgentsJSONSchema$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestResponseFormatAgentsJSONSchema,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    type: z.literal("json_schema"),
+    json_schema: z.lazy(() =>
+      RetrieveAgentRequestResponseFormatJsonSchema$inboundSchema
+    ),
+  }).transform((v) => {
+    return remap$(v, {
+      "json_schema": "jsonSchema",
+    });
+  });
+
+export function retrieveAgentRequestResponseFormatAgentsJSONSchemaFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestResponseFormatAgentsJSONSchema,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestResponseFormatAgentsJSONSchema$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestResponseFormatAgentsJSONSchema' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestResponseFormatJSONObject$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestResponseFormatJSONObject,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    type: z.literal("json_object"),
+  });
+
+export function retrieveAgentRequestResponseFormatJSONObjectFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestResponseFormatJSONObject,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestResponseFormatJSONObject$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestResponseFormatJSONObject' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestResponseFormatText$inboundSchema: z.ZodType<
+  RetrieveAgentRequestResponseFormatText,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  type: z.literal("text"),
+});
+
+export function retrieveAgentRequestResponseFormatTextFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestResponseFormatText, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestResponseFormatText$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestResponseFormatText' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestResponseFormat$inboundSchema: z.ZodType<
+  RetrieveAgentRequestResponseFormat,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  z.lazy(() => RetrieveAgentRequestResponseFormatText$inboundSchema),
+  z.lazy(() => RetrieveAgentRequestResponseFormatJSONObject$inboundSchema),
+  z.lazy(() =>
+    RetrieveAgentRequestResponseFormatAgentsJSONSchema$inboundSchema
+  ),
+]);
+
+export function retrieveAgentRequestResponseFormatFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestResponseFormat, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestResponseFormat$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestResponseFormat' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestReasoningEffort$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestReasoningEffort
+> = z.nativeEnum(RetrieveAgentRequestReasoningEffort);
+
+/** @internal */
+export const RetrieveAgentRequestStop$inboundSchema: z.ZodType<
+  RetrieveAgentRequestStop,
+  z.ZodTypeDef,
+  unknown
+> = z.union([z.string(), z.array(z.string())]);
+
+export function retrieveAgentRequestStopFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestStop, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestStop$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestStop' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestThinking$inboundSchema: z.ZodType<
+  RetrieveAgentRequestThinking,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  components.ThinkingConfigDisabledSchema$inboundSchema,
+  components.ThinkingConfigEnabledSchema$inboundSchema,
+  components.ThinkingConfigAdaptiveSchema$inboundSchema,
+]);
+
+export function retrieveAgentRequestThinkingFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestThinking, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestThinking$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestThinking' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestToolChoiceType$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestToolChoiceType
+> = z.nativeEnum(RetrieveAgentRequestToolChoiceType);
+
+/** @internal */
+export const RetrieveAgentRequestToolChoiceFunction$inboundSchema: z.ZodType<
+  RetrieveAgentRequestToolChoiceFunction,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string(),
+});
+
+export function retrieveAgentRequestToolChoiceFunctionFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestToolChoiceFunction, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestToolChoiceFunction$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestToolChoiceFunction' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestToolChoice2$inboundSchema: z.ZodType<
+  RetrieveAgentRequestToolChoice2,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  type: RetrieveAgentRequestToolChoiceType$inboundSchema.optional(),
+  function: z.lazy(() => RetrieveAgentRequestToolChoiceFunction$inboundSchema),
+});
+
+export function retrieveAgentRequestToolChoice2FromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestToolChoice2, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestToolChoice2$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestToolChoice2' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestToolChoice1$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestToolChoice1
+> = z.nativeEnum(RetrieveAgentRequestToolChoice1);
+
+/** @internal */
+export const RetrieveAgentRequestToolChoice$inboundSchema: z.ZodType<
+  RetrieveAgentRequestToolChoice,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  z.lazy(() => RetrieveAgentRequestToolChoice2$inboundSchema),
+  RetrieveAgentRequestToolChoice1$inboundSchema,
+]);
+
+export function retrieveAgentRequestToolChoiceFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestToolChoice, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestToolChoice$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestToolChoice' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestModalities$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestModalities
+> = z.nativeEnum(RetrieveAgentRequestModalities);
+
+/** @internal */
+export const RetrieveAgentRequestId1$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestId1
+> = z.nativeEnum(RetrieveAgentRequestId1);
+
+/** @internal */
+export const RetrieveAgentRequestId$inboundSchema: z.ZodType<
+  RetrieveAgentRequestId,
+  z.ZodTypeDef,
+  unknown
+> = z.union([RetrieveAgentRequestId1$inboundSchema, z.string()]);
+
+export function retrieveAgentRequestIdFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestId, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestId$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestId' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestAgentsResponseExecuteOn$inboundSchema:
+  z.ZodNativeEnum<typeof RetrieveAgentRequestAgentsResponseExecuteOn> = z
+    .nativeEnum(RetrieveAgentRequestAgentsResponseExecuteOn);
+
+/** @internal */
+export const RetrieveAgentRequestAgentsGuardrails$inboundSchema: z.ZodType<
+  RetrieveAgentRequestAgentsGuardrails,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.union([RetrieveAgentRequestId1$inboundSchema, z.string()]),
+  execute_on: RetrieveAgentRequestAgentsResponseExecuteOn$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "execute_on": "executeOn",
+  });
+});
+
+export function retrieveAgentRequestAgentsGuardrailsFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestAgentsGuardrails, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestAgentsGuardrails$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestAgentsGuardrails' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestPlugins$inboundSchema: z.ZodType<
+  RetrieveAgentRequestPlugins,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  components.PIIRedactionPlugin$inboundSchema.and(
+    z.object({ id: z.literal("pii_redaction") }),
+  ),
+  components.ResponseHealingPlugin$inboundSchema,
+  components.TraceScrubbingPlugin$inboundSchema,
+]);
+
+export function retrieveAgentRequestPluginsFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestPlugins, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestPlugins$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestPlugins' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbacks$inboundSchema: z.ZodType<
+  RetrieveAgentRequestFallbacks,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  model: z.string(),
+});
+
+export function retrieveAgentRequestFallbacksFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestFallbacks, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestFallbacks$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestFallbacks' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestAgentsType$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestAgentsType
+> = z.nativeEnum(RetrieveAgentRequestAgentsType);
+
+/** @internal */
+export const RetrieveAgentRequestCache$inboundSchema: z.ZodType<
+  RetrieveAgentRequestCache,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  ttl: z.number().default(1800),
+  type: RetrieveAgentRequestAgentsType$inboundSchema,
+});
+
+export function retrieveAgentRequestCacheFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestCache, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestCache$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestCache' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestLoadBalancerType$inboundSchema:
+  z.ZodNativeEnum<typeof RetrieveAgentRequestLoadBalancerType> = z.nativeEnum(
+    RetrieveAgentRequestLoadBalancerType,
+  );
+
+/** @internal */
+export const RetrieveAgentRequestLoadBalancerModels$inboundSchema: z.ZodType<
+  RetrieveAgentRequestLoadBalancerModels,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  model: z.string(),
+  weight: z.number().default(0.5),
+});
+
+export function retrieveAgentRequestLoadBalancerModelsFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestLoadBalancerModels, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestLoadBalancerModels$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestLoadBalancerModels' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestLoadBalancer1$inboundSchema: z.ZodType<
+  RetrieveAgentRequestLoadBalancer1,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  type: RetrieveAgentRequestLoadBalancerType$inboundSchema,
+  models: z.array(
+    z.lazy(() => RetrieveAgentRequestLoadBalancerModels$inboundSchema),
+  ),
+});
+
+export function retrieveAgentRequestLoadBalancer1FromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestLoadBalancer1, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestLoadBalancer1$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestLoadBalancer1' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestLoadBalancer$inboundSchema: z.ZodType<
+  RetrieveAgentRequestLoadBalancer,
+  z.ZodTypeDef,
+  unknown
+> = z.lazy(() => RetrieveAgentRequestLoadBalancer1$inboundSchema);
+
+export function retrieveAgentRequestLoadBalancerFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestLoadBalancer, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestLoadBalancer$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestLoadBalancer' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestTimeout$inboundSchema: z.ZodType<
+  RetrieveAgentRequestTimeout,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  call_timeout: z.number(),
+}).transform((v) => {
+  return remap$(v, {
+    "call_timeout": "callTimeout",
+  });
+});
+
+export function retrieveAgentRequestTimeoutFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestTimeout, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestTimeout$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestTimeout' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestAgentsResponseType$inboundSchema:
+  z.ZodNativeEnum<typeof RetrieveAgentRequestAgentsResponseType> = z.nativeEnum(
+    RetrieveAgentRequestAgentsResponseType,
+  );
+
+/** @internal */
+export const RetrieveAgentRequestTtl$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestTtl
+> = z.nativeEnum(RetrieveAgentRequestTtl);
+
+/** @internal */
+export const RetrieveAgentRequestCacheControl$inboundSchema: z.ZodType<
+  RetrieveAgentRequestCacheControl,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  type: RetrieveAgentRequestAgentsResponseType$inboundSchema,
+  ttl: RetrieveAgentRequestTtl$inboundSchema.default("5m"),
+});
+
+export function retrieveAgentRequestCacheControlFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestCacheControl, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestCacheControl$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestCacheControl' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestParameters$inboundSchema: z.ZodType<
+  RetrieveAgentRequestParameters,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string().optional(),
+  frequency_penalty: z.nullable(z.number()).optional(),
+  max_tokens: z.nullable(z.number().int()).optional(),
+  max_completion_tokens: z.nullable(z.number().int()).optional(),
+  presence_penalty: z.nullable(z.number()).optional(),
+  response_format: z.union([
+    z.lazy(() => RetrieveAgentRequestResponseFormatText$inboundSchema),
+    z.lazy(() => RetrieveAgentRequestResponseFormatJSONObject$inboundSchema),
+    z.lazy(() =>
+      RetrieveAgentRequestResponseFormatAgentsJSONSchema$inboundSchema
+    ),
+  ]).optional(),
+  reasoning_effort: RetrieveAgentRequestReasoningEffort$inboundSchema
+    .optional(),
+  verbosity: z.string().optional(),
+  seed: z.nullable(z.number()).optional(),
+  stop: z.nullable(z.union([z.string(), z.array(z.string())])).optional(),
+  thinking: z.union([
+    components.ThinkingConfigDisabledSchema$inboundSchema,
+    components.ThinkingConfigEnabledSchema$inboundSchema,
+    components.ThinkingConfigAdaptiveSchema$inboundSchema,
+  ]).optional(),
+  temperature: z.nullable(z.number()).optional(),
+  top_p: z.nullable(z.number()).optional(),
+  top_k: z.nullable(z.number()).optional(),
+  tool_choice: z.union([
+    z.lazy(() => RetrieveAgentRequestToolChoice2$inboundSchema),
+    RetrieveAgentRequestToolChoice1$inboundSchema,
+  ]).optional(),
+  parallel_tool_calls: z.boolean().optional(),
+  modalities: z.nullable(z.array(RetrieveAgentRequestModalities$inboundSchema))
+    .optional(),
+  guardrails: z.array(
+    z.lazy(() => RetrieveAgentRequestAgentsGuardrails$inboundSchema),
+  ).optional(),
+  plugins: z.array(
+    z.union([
+      components.PIIRedactionPlugin$inboundSchema.and(
+        z.object({ id: z.literal("pii_redaction") }),
+      ),
+      components.ResponseHealingPlugin$inboundSchema,
+      components.TraceScrubbingPlugin$inboundSchema,
+    ]),
+  ).optional(),
+  fallbacks: z.array(z.lazy(() => RetrieveAgentRequestFallbacks$inboundSchema))
+    .optional(),
+  cache: z.lazy(() => RetrieveAgentRequestCache$inboundSchema).optional(),
+  load_balancer: z.lazy(() => RetrieveAgentRequestLoadBalancer1$inboundSchema)
+    .optional(),
+  timeout: z.lazy(() => RetrieveAgentRequestTimeout$inboundSchema).optional(),
+  cache_control: z.lazy(() => RetrieveAgentRequestCacheControl$inboundSchema)
+    .optional(),
+  prompt_cache_key: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "frequency_penalty": "frequencyPenalty",
+    "max_tokens": "maxTokens",
+    "max_completion_tokens": "maxCompletionTokens",
+    "presence_penalty": "presencePenalty",
+    "response_format": "responseFormat",
+    "reasoning_effort": "reasoningEffort",
+    "top_p": "topP",
+    "top_k": "topK",
+    "tool_choice": "toolChoice",
+    "parallel_tool_calls": "parallelToolCalls",
+    "load_balancer": "loadBalancer",
+    "cache_control": "cacheControl",
+    "prompt_cache_key": "promptCacheKey",
+  });
+});
+
+export function retrieveAgentRequestParametersFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestParameters, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestParameters$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestParameters' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestRetry$inboundSchema: z.ZodType<
+  RetrieveAgentRequestRetry,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  count: z.number().default(3),
+  on_codes: z.array(z.number()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "on_codes": "onCodes",
+  });
+});
+
+export function retrieveAgentRequestRetryFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestRetry, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestRetry$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestRetry' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestResponseFormatAgentsResponseJsonSchema$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestResponseFormatAgentsResponseJsonSchema,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    description: z.string().optional(),
+    name: z.string(),
+    schema: z.any().optional(),
+    strict: z.boolean().default(false),
+  });
+
+export function retrieveAgentRequestResponseFormatAgentsResponseJsonSchemaFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestResponseFormatAgentsResponseJsonSchema,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestResponseFormatAgentsResponseJsonSchema$inboundSchema
+        .parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestResponseFormatAgentsResponseJsonSchema' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    type: z.literal("json_schema"),
+    json_schema: z.lazy(() =>
+      RetrieveAgentRequestResponseFormatAgentsResponseJsonSchema$inboundSchema
+    ),
+  }).transform((v) => {
+    return remap$(v, {
+      "json_schema": "jsonSchema",
+    });
+  });
+
+export function retrieveAgentRequestResponseFormatAgentsResponse200JSONSchemaFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema$inboundSchema
+        .parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestResponseFormatAgentsJSONObject$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestResponseFormatAgentsJSONObject,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    type: z.literal("json_object"),
+  });
+
+export function retrieveAgentRequestResponseFormatAgentsJSONObjectFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestResponseFormatAgentsJSONObject,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestResponseFormatAgentsJSONObject$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestResponseFormatAgentsJSONObject' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestResponseFormatAgentsText$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestResponseFormatAgentsText,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    type: z.literal("text"),
+  });
+
+export function retrieveAgentRequestResponseFormatAgentsTextFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestResponseFormatAgentsText,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestResponseFormatAgentsText$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestResponseFormatAgentsText' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationResponseFormat$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationResponseFormat,
+    z.ZodTypeDef,
+    unknown
+  > = z.union([
+    z.lazy(() => RetrieveAgentRequestResponseFormatAgentsText$inboundSchema),
+    z.lazy(() =>
+      RetrieveAgentRequestResponseFormatAgentsJSONObject$inboundSchema
+    ),
+    z.lazy(() =>
+      RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema$inboundSchema
+    ),
+  ]);
+
+export function retrieveAgentRequestFallbackModelConfigurationResponseFormatFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationResponseFormat,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationResponseFormat$inboundSchema
+        .parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationResponseFormat' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationReasoningEffort$inboundSchema:
+  z.ZodNativeEnum<
+    typeof RetrieveAgentRequestFallbackModelConfigurationReasoningEffort
+  > = z.nativeEnum(
+    RetrieveAgentRequestFallbackModelConfigurationReasoningEffort,
+  );
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationStop$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationStop,
+    z.ZodTypeDef,
+    unknown
+  > = z.union([z.string(), z.array(z.string())]);
+
+export function retrieveAgentRequestFallbackModelConfigurationStopFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationStop,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationStop$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationStop' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationThinking$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationThinking,
+    z.ZodTypeDef,
+    unknown
+  > = z.union([
+    components.ThinkingConfigDisabledSchema$inboundSchema,
+    components.ThinkingConfigEnabledSchema$inboundSchema,
+    components.ThinkingConfigAdaptiveSchema$inboundSchema,
+  ]);
+
+export function retrieveAgentRequestFallbackModelConfigurationThinkingFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationThinking,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationThinking$inboundSchema
+        .parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationThinking' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestToolChoiceAgentsType$inboundSchema:
+  z.ZodNativeEnum<typeof RetrieveAgentRequestToolChoiceAgentsType> = z
+    .nativeEnum(RetrieveAgentRequestToolChoiceAgentsType);
+
+/** @internal */
+export const RetrieveAgentRequestToolChoiceAgentsFunction$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestToolChoiceAgentsFunction,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    name: z.string(),
+  });
+
+export function retrieveAgentRequestToolChoiceAgentsFunctionFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestToolChoiceAgentsFunction,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestToolChoiceAgentsFunction$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestToolChoiceAgentsFunction' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestToolChoiceAgents2$inboundSchema: z.ZodType<
+  RetrieveAgentRequestToolChoiceAgents2,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  type: RetrieveAgentRequestToolChoiceAgentsType$inboundSchema.optional(),
+  function: z.lazy(() =>
+    RetrieveAgentRequestToolChoiceAgentsFunction$inboundSchema
+  ),
+});
+
+export function retrieveAgentRequestToolChoiceAgents2FromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestToolChoiceAgents2, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestToolChoiceAgents2$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestToolChoiceAgents2' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestToolChoiceAgents1$inboundSchema:
+  z.ZodNativeEnum<typeof RetrieveAgentRequestToolChoiceAgents1> = z.nativeEnum(
+    RetrieveAgentRequestToolChoiceAgents1,
+  );
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationToolChoice$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationToolChoice,
+    z.ZodTypeDef,
+    unknown
+  > = z.union([
+    z.lazy(() => RetrieveAgentRequestToolChoiceAgents2$inboundSchema),
+    RetrieveAgentRequestToolChoiceAgents1$inboundSchema,
+  ]);
+
+export function retrieveAgentRequestFallbackModelConfigurationToolChoiceFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationToolChoice,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationToolChoice$inboundSchema
+        .parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationToolChoice' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationModalities$inboundSchema:
+  z.ZodNativeEnum<
+    typeof RetrieveAgentRequestFallbackModelConfigurationModalities
+  > = z.nativeEnum(RetrieveAgentRequestFallbackModelConfigurationModalities);
+
+/** @internal */
+export const RetrieveAgentRequestIdAgents1$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestIdAgents1
+> = z.nativeEnum(RetrieveAgentRequestIdAgents1);
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationId$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationId,
+    z.ZodTypeDef,
+    unknown
+  > = z.union([RetrieveAgentRequestIdAgents1$inboundSchema, z.string()]);
+
+export function retrieveAgentRequestFallbackModelConfigurationIdFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationId,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationId$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationId' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationExecuteOn$inboundSchema:
+  z.ZodNativeEnum<
+    typeof RetrieveAgentRequestFallbackModelConfigurationExecuteOn
+  > = z.nativeEnum(RetrieveAgentRequestFallbackModelConfigurationExecuteOn);
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationGuardrails$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationGuardrails,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    id: z.union([RetrieveAgentRequestIdAgents1$inboundSchema, z.string()]),
+    execute_on:
+      RetrieveAgentRequestFallbackModelConfigurationExecuteOn$inboundSchema,
+  }).transform((v) => {
+    return remap$(v, {
+      "execute_on": "executeOn",
+    });
+  });
+
+export function retrieveAgentRequestFallbackModelConfigurationGuardrailsFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationGuardrails,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationGuardrails$inboundSchema
+        .parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationGuardrails' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationPlugins$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationPlugins,
+    z.ZodTypeDef,
+    unknown
+  > = z.union([
+    components.PIIRedactionPlugin$inboundSchema.and(
+      z.object({ id: z.literal("pii_redaction") }),
+    ),
+    components.ResponseHealingPlugin$inboundSchema,
+    components.TraceScrubbingPlugin$inboundSchema,
+  ]);
+
+export function retrieveAgentRequestFallbackModelConfigurationPluginsFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationPlugins,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationPlugins$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationPlugins' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationFallbacks$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationFallbacks,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    model: z.string(),
+  });
+
+export function retrieveAgentRequestFallbackModelConfigurationFallbacksFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationFallbacks,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationFallbacks$inboundSchema
+        .parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationFallbacks' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationType$inboundSchema:
+  z.ZodNativeEnum<typeof RetrieveAgentRequestFallbackModelConfigurationType> = z
+    .nativeEnum(RetrieveAgentRequestFallbackModelConfigurationType);
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationCache$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationCache,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    ttl: z.number().default(1800),
+    type: RetrieveAgentRequestFallbackModelConfigurationType$inboundSchema,
+  });
+
+export function retrieveAgentRequestFallbackModelConfigurationCacheFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationCache,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationCache$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationCache' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestLoadBalancerAgentsType$inboundSchema:
+  z.ZodNativeEnum<typeof RetrieveAgentRequestLoadBalancerAgentsType> = z
+    .nativeEnum(RetrieveAgentRequestLoadBalancerAgentsType);
+
+/** @internal */
+export const RetrieveAgentRequestLoadBalancerAgentsModels$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestLoadBalancerAgentsModels,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    model: z.string(),
+    weight: z.number().default(0.5),
+  });
+
+export function retrieveAgentRequestLoadBalancerAgentsModelsFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestLoadBalancerAgentsModels,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestLoadBalancerAgentsModels$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestLoadBalancerAgentsModels' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestLoadBalancerAgents1$inboundSchema: z.ZodType<
+  RetrieveAgentRequestLoadBalancerAgents1,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  type: RetrieveAgentRequestLoadBalancerAgentsType$inboundSchema,
+  models: z.array(
+    z.lazy(() => RetrieveAgentRequestLoadBalancerAgentsModels$inboundSchema),
+  ),
+});
+
+export function retrieveAgentRequestLoadBalancerAgents1FromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestLoadBalancerAgents1,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestLoadBalancerAgents1$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestLoadBalancerAgents1' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationLoadBalancer$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationLoadBalancer,
+    z.ZodTypeDef,
+    unknown
+  > = z.lazy(() => RetrieveAgentRequestLoadBalancerAgents1$inboundSchema);
+
+export function retrieveAgentRequestFallbackModelConfigurationLoadBalancerFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationLoadBalancer,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationLoadBalancer$inboundSchema
+        .parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationLoadBalancer' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationTimeout$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationTimeout,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    call_timeout: z.number(),
+  }).transform((v) => {
+    return remap$(v, {
+      "call_timeout": "callTimeout",
+    });
+  });
+
+export function retrieveAgentRequestFallbackModelConfigurationTimeoutFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationTimeout,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationTimeout$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationTimeout' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationAgentsType$inboundSchema:
+  z.ZodNativeEnum<
+    typeof RetrieveAgentRequestFallbackModelConfigurationAgentsType
+  > = z.nativeEnum(RetrieveAgentRequestFallbackModelConfigurationAgentsType);
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationTtl$inboundSchema:
+  z.ZodNativeEnum<typeof RetrieveAgentRequestFallbackModelConfigurationTtl> = z
+    .nativeEnum(RetrieveAgentRequestFallbackModelConfigurationTtl);
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationCacheControl$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationCacheControl,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    type:
+      RetrieveAgentRequestFallbackModelConfigurationAgentsType$inboundSchema,
+    ttl: RetrieveAgentRequestFallbackModelConfigurationTtl$inboundSchema
+      .default("5m"),
+  });
+
+export function retrieveAgentRequestFallbackModelConfigurationCacheControlFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationCacheControl,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationCacheControl$inboundSchema
+        .parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationCacheControl' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationParameters$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationParameters,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    name: z.string().optional(),
+    frequency_penalty: z.nullable(z.number()).optional(),
+    max_tokens: z.nullable(z.number().int()).optional(),
+    max_completion_tokens: z.nullable(z.number().int()).optional(),
+    presence_penalty: z.nullable(z.number()).optional(),
+    response_format: z.union([
+      z.lazy(() => RetrieveAgentRequestResponseFormatAgentsText$inboundSchema),
+      z.lazy(() =>
+        RetrieveAgentRequestResponseFormatAgentsJSONObject$inboundSchema
+      ),
+      z.lazy(() =>
+        RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema$inboundSchema
+      ),
+    ]).optional(),
+    reasoning_effort:
+      RetrieveAgentRequestFallbackModelConfigurationReasoningEffort$inboundSchema
+        .optional(),
+    verbosity: z.string().optional(),
+    seed: z.nullable(z.number()).optional(),
+    stop: z.nullable(z.union([z.string(), z.array(z.string())])).optional(),
+    thinking: z.union([
+      components.ThinkingConfigDisabledSchema$inboundSchema,
+      components.ThinkingConfigEnabledSchema$inboundSchema,
+      components.ThinkingConfigAdaptiveSchema$inboundSchema,
+    ]).optional(),
+    temperature: z.nullable(z.number()).optional(),
+    top_p: z.nullable(z.number()).optional(),
+    top_k: z.nullable(z.number()).optional(),
+    tool_choice: z.union([
+      z.lazy(() => RetrieveAgentRequestToolChoiceAgents2$inboundSchema),
+      RetrieveAgentRequestToolChoiceAgents1$inboundSchema,
+    ]).optional(),
+    parallel_tool_calls: z.boolean().optional(),
+    modalities: z.nullable(
+      z.array(
+        RetrieveAgentRequestFallbackModelConfigurationModalities$inboundSchema,
+      ),
+    ).optional(),
+    guardrails: z.array(
+      z.lazy(() =>
+        RetrieveAgentRequestFallbackModelConfigurationGuardrails$inboundSchema
+      ),
+    ).optional(),
+    plugins: z.array(
+      z.union([
+        components.PIIRedactionPlugin$inboundSchema.and(
+          z.object({ id: z.literal("pii_redaction") }),
+        ),
+        components.ResponseHealingPlugin$inboundSchema,
+        components.TraceScrubbingPlugin$inboundSchema,
+      ]),
+    ).optional(),
+    fallbacks: z.array(
+      z.lazy(() =>
+        RetrieveAgentRequestFallbackModelConfigurationFallbacks$inboundSchema
+      ),
+    ).optional(),
+    cache: z.lazy(() =>
+      RetrieveAgentRequestFallbackModelConfigurationCache$inboundSchema
+    ).optional(),
+    load_balancer: z.lazy(() =>
+      RetrieveAgentRequestLoadBalancerAgents1$inboundSchema
+    ).optional(),
+    timeout: z.lazy(() =>
+      RetrieveAgentRequestFallbackModelConfigurationTimeout$inboundSchema
+    ).optional(),
+    cache_control: z.lazy(() =>
+      RetrieveAgentRequestFallbackModelConfigurationCacheControl$inboundSchema
+    ).optional(),
+    prompt_cache_key: z.string().optional(),
+  }).transform((v) => {
+    return remap$(v, {
+      "frequency_penalty": "frequencyPenalty",
+      "max_tokens": "maxTokens",
+      "max_completion_tokens": "maxCompletionTokens",
+      "presence_penalty": "presencePenalty",
+      "response_format": "responseFormat",
+      "reasoning_effort": "reasoningEffort",
+      "top_p": "topP",
+      "top_k": "topK",
+      "tool_choice": "toolChoice",
+      "parallel_tool_calls": "parallelToolCalls",
+      "load_balancer": "loadBalancer",
+      "cache_control": "cacheControl",
+      "prompt_cache_key": "promptCacheKey",
+    });
+  });
+
+export function retrieveAgentRequestFallbackModelConfigurationParametersFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationParameters,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationParameters$inboundSchema
+        .parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationParameters' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationRetry$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationRetry,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    count: z.number().default(3),
+    on_codes: z.array(z.number()).optional(),
+  }).transform((v) => {
+    return remap$(v, {
+      "on_codes": "onCodes",
+    });
+  });
+
+export function retrieveAgentRequestFallbackModelConfigurationRetryFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfigurationRetry,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfigurationRetry$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfigurationRetry' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfiguration2$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfiguration2,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    id: z.string(),
+    parameters: z.lazy(() =>
+      RetrieveAgentRequestFallbackModelConfigurationParameters$inboundSchema
+    ).optional(),
+    retry: z.lazy(() =>
+      RetrieveAgentRequestFallbackModelConfigurationRetry$inboundSchema
+    ).optional(),
+  });
+
+export function retrieveAgentRequestFallbackModelConfiguration2FromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfiguration2,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfiguration2$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfiguration2' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfiguration$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfiguration,
+    z.ZodTypeDef,
+    unknown
+  > = z.union([
+    z.lazy(() => RetrieveAgentRequestFallbackModelConfiguration2$inboundSchema),
+    z.string(),
+  ]);
+
+export function retrieveAgentRequestFallbackModelConfigurationFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveAgentRequestFallbackModelConfiguration,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveAgentRequestFallbackModelConfiguration$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'RetrieveAgentRequestFallbackModelConfiguration' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestModel$inboundSchema: z.ZodType<
+  RetrieveAgentRequestModel,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  integration_id: z.nullable(z.string()).optional(),
+  parameters: z.nullable(
+    z.lazy(() => RetrieveAgentRequestParameters$inboundSchema),
+  ).optional(),
+  retry: z.lazy(() => RetrieveAgentRequestRetry$inboundSchema).optional(),
+  fallback_models: z.nullable(
+    z.array(z.union([
+      z.lazy(() =>
+        RetrieveAgentRequestFallbackModelConfiguration2$inboundSchema
+      ),
+      z.string(),
+    ])),
+  ).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "integration_id": "integrationId",
+    "fallback_models": "fallbackModels",
+  });
+});
+
+export function retrieveAgentRequestModelFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestModel, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestModel$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestModel' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveAgentRequestResponseBody$inboundSchema: z.ZodType<
+  RetrieveAgentRequestResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  _id: z.string(),
+  key: z.string(),
+  display_name: z.string().optional(),
+  project_id: z.string(),
+  created_by_id: z.nullable(z.string()).optional(),
+  updated_by_id: z.nullable(z.string()).optional(),
+  created: z.string().optional(),
+  updated: z.string().optional(),
+  status: RetrieveAgentRequestStatus$inboundSchema,
+  version: z.string().optional(),
+  path: z.string(),
+  memory_stores: z.array(z.string()).optional(),
+  team_of_agents: z.array(
+    z.lazy(() => RetrieveAgentRequestTeamOfAgents$inboundSchema),
+  ).optional(),
+  skills: z.array(z.string()).optional(),
+  metrics: z.lazy(() => RetrieveAgentRequestMetrics$inboundSchema).optional(),
+  variables: z.record(z.any()).optional(),
+  knowledge_bases: z.array(
+    z.lazy(() => RetrieveAgentRequestKnowledgeBases$inboundSchema),
+  ).optional(),
+  source: RetrieveAgentRequestSource$inboundSchema.optional(),
+  engine: RetrieveAgentRequestEngine$inboundSchema.default("text"),
+  type: RetrieveAgentRequestType$inboundSchema.default("internal"),
+  role: z.string(),
+  description: z.string(),
+  system_prompt: z.nullable(z.string()).optional(),
+  instructions: z.string(),
+  settings: z.lazy(() => RetrieveAgentRequestSettings$inboundSchema).optional(),
+  model: z.lazy(() => RetrieveAgentRequestModel$inboundSchema),
+}).transform((v) => {
+  return remap$(v, {
+    "_id": "id",
+    "display_name": "displayName",
+    "project_id": "projectId",
+    "created_by_id": "createdById",
+    "updated_by_id": "updatedById",
+    "memory_stores": "memoryStores",
+    "team_of_agents": "teamOfAgents",
+    "knowledge_bases": "knowledgeBases",
+    "system_prompt": "systemPrompt",
+  });
+});
+
+export function retrieveAgentRequestResponseBodyFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveAgentRequestResponseBody, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveAgentRequestResponseBody$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveAgentRequestResponseBody' from JSON`,
+  );
+}