@orq-ai/node 4.1.0 → 4.1.3

package/src/models/operations/retrieveagentrequest.ts

@@ -7,6 +7,7 @@ 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 = {
@@ -275,6 +276,42 @@ export type RetrieveAgentRequestResponseFormat =
   | 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`, and `xhigh`. 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".
+ */
+export const RetrieveAgentRequestReasoningEffort = {
+  None: "none",
+  Minimal: "minimal",
+  Low: "low",
+  Medium: "medium",
+  High: "high",
+  Xhigh: "xhigh",
+} 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`, and `xhigh`. 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".
+ */
+export type RetrieveAgentRequestReasoningEffort = ClosedEnum<
+  typeof RetrieveAgentRequestReasoningEffort
+>;
+
 /**
  * Up to 4 sequences where the API will stop generating further tokens.
  */
@@ -290,48 +327,9 @@ export type RetrieveAgentRequestStreamOptions = {
   includeUsage?: boolean | undefined;
 };
 
-/**
- * Enables or disables the thinking mode capability
- */
-export const RetrieveAgentRequestType = {
-  Enabled: "enabled",
-  Disabled: "disabled",
-} as const;
-/**
- * Enables or disables the thinking mode capability
- */
-export type RetrieveAgentRequestType = ClosedEnum<
-  typeof RetrieveAgentRequestType
->;
-
-/**
- * The level of reasoning the model should use. This setting is supported only by `gemini-3` models. If budget_tokens is specified and `thinking_level` is available, `budget_tokens` will be ignored.
- */
-export const RetrieveAgentRequestThinkingLevel = {
-  Low: "low",
-  High: "high",
-} as const;
-/**
- * The level of reasoning the model should use. This setting is supported only by `gemini-3` models. If budget_tokens is specified and `thinking_level` is available, `budget_tokens` will be ignored.
- */
-export type RetrieveAgentRequestThinkingLevel = ClosedEnum<
-  typeof RetrieveAgentRequestThinkingLevel
->;
-
-export type RetrieveAgentRequestThinking = {
-  /**
-   * Enables or disables the thinking mode capability
-   */
-  type: RetrieveAgentRequestType;
-  /**
-   * Determines how many tokens the model can use for its internal reasoning process. Larger budgets can enable more thorough analysis for complex problems, improving response quality. Must be ≥1024 and less than `max_tokens`.
-   */
-  budgetTokens: number;
-  /**
-   * The level of reasoning the model should use. This setting is supported only by `gemini-3` models. If budget_tokens is specified and `thinking_level` is available, `budget_tokens` will be ignored.
-   */
-  thinkingLevel?: RetrieveAgentRequestThinkingLevel | undefined;
-};
+export type RetrieveAgentRequestThinking =
+  | components.ThinkingConfigDisabledSchema
+  | components.ThinkingConfigEnabledSchema;
 
 /**
  * The type of the tool. Currently, only function is supported.
@@ -385,6 +383,45 @@ export type RetrieveAgentRequestModalities = ClosedEnum<
   typeof RetrieveAgentRequestModalities
 >;
 
+/**
+ * The key of the guardrail.
+ */
+export const RetrieveAgentRequestId1 = {
+  OrqPiiDetection: "orq_pii_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;
+};
+
 /**
  * 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.
  */
@@ -434,9 +471,18 @@ export type RetrieveAgentRequestParameters = {
     | RetrieveAgentRequestResponseFormatAgentsJSONSchema
     | undefined;
   /**
-   * Constrains effort on reasoning for reasoning models. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
+   * Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. 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".
    */
-  reasoningEffort?: string | undefined;
+  reasoningEffort?: RetrieveAgentRequestReasoningEffort | undefined;
   /**
    * Adjusts response verbosity. Lower levels yield shorter answers.
    */
@@ -453,7 +499,10 @@ export type RetrieveAgentRequestParameters = {
    * Options for streaming response. Only set this when you set stream: true.
    */
   streamOptions?: RetrieveAgentRequestStreamOptions | null | undefined;
-  thinking?: RetrieveAgentRequestThinking | undefined;
+  thinking?:
+    | components.ThinkingConfigDisabledSchema
+    | components.ThinkingConfigEnabledSchema
+    | 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.
    */
@@ -481,6 +530,10 @@ export type RetrieveAgentRequestParameters = {
    * 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;
 };
 
 /**
@@ -601,6 +654,43 @@ export type RetrieveAgentRequestFallbackModelConfigurationResponseFormat =
   | 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`, and `xhigh`. 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".
+ */
+export const RetrieveAgentRequestFallbackModelConfigurationReasoningEffort = {
+  None: "none",
+  Minimal: "minimal",
+  Low: "low",
+  Medium: "medium",
+  High: "high",
+  Xhigh: "xhigh",
+} 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`, and `xhigh`. 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".
+ */
+export type RetrieveAgentRequestFallbackModelConfigurationReasoningEffort =
+  ClosedEnum<
+    typeof RetrieveAgentRequestFallbackModelConfigurationReasoningEffort
+  >;
+
 /**
  * Up to 4 sequences where the API will stop generating further tokens.
  */
@@ -618,51 +708,9 @@ export type RetrieveAgentRequestFallbackModelConfigurationStreamOptions = {
   includeUsage?: boolean | undefined;
 };
 
-/**
- * Enables or disables the thinking mode capability
- */
-export const RetrieveAgentRequestFallbackModelConfigurationType = {
-  Enabled: "enabled",
-  Disabled: "disabled",
-} as const;
-/**
- * Enables or disables the thinking mode capability
- */
-export type RetrieveAgentRequestFallbackModelConfigurationType = ClosedEnum<
-  typeof RetrieveAgentRequestFallbackModelConfigurationType
->;
-
-/**
- * The level of reasoning the model should use. This setting is supported only by `gemini-3` models. If budget_tokens is specified and `thinking_level` is available, `budget_tokens` will be ignored.
- */
-export const RetrieveAgentRequestFallbackModelConfigurationThinkingLevel = {
-  Low: "low",
-  High: "high",
-} as const;
-/**
- * The level of reasoning the model should use. This setting is supported only by `gemini-3` models. If budget_tokens is specified and `thinking_level` is available, `budget_tokens` will be ignored.
- */
-export type RetrieveAgentRequestFallbackModelConfigurationThinkingLevel =
-  ClosedEnum<
-    typeof RetrieveAgentRequestFallbackModelConfigurationThinkingLevel
-  >;
-
-export type RetrieveAgentRequestFallbackModelConfigurationThinking = {
-  /**
-   * Enables or disables the thinking mode capability
-   */
-  type: RetrieveAgentRequestFallbackModelConfigurationType;
-  /**
-   * Determines how many tokens the model can use for its internal reasoning process. Larger budgets can enable more thorough analysis for complex problems, improving response quality. Must be ≥1024 and less than `max_tokens`.
-   */
-  budgetTokens: number;
-  /**
-   * The level of reasoning the model should use. This setting is supported only by `gemini-3` models. If budget_tokens is specified and `thinking_level` is available, `budget_tokens` will be ignored.
-   */
-  thinkingLevel?:
-    | RetrieveAgentRequestFallbackModelConfigurationThinkingLevel
-    | undefined;
-};
+export type RetrieveAgentRequestFallbackModelConfigurationThinking =
+  | components.ThinkingConfigDisabledSchema
+  | components.ThinkingConfigEnabledSchema;
 
 /**
  * The type of the tool. Currently, only function is supported.
@@ -715,6 +763,46 @@ export const RetrieveAgentRequestFallbackModelConfigurationModalities = {
 export type RetrieveAgentRequestFallbackModelConfigurationModalities =
   ClosedEnum<typeof RetrieveAgentRequestFallbackModelConfigurationModalities>;
 
+/**
+ * The key of the guardrail.
+ */
+export const RetrieveAgentRequestIdAgents1 = {
+  OrqPiiDetection: "orq_pii_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;
+};
+
 /**
  * Optional model parameters specific to this fallback model. Overrides primary model parameters if this fallback is used.
  */
@@ -767,9 +855,20 @@ export type RetrieveAgentRequestFallbackModelConfigurationParameters = {
     | RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema
     | undefined;
   /**
-   * Constrains effort on reasoning for reasoning models. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
+   * Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. 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".
    */
-  reasoningEffort?: string | undefined;
+  reasoningEffort?:
+    | RetrieveAgentRequestFallbackModelConfigurationReasoningEffort
+    | undefined;
   /**
    * Adjusts response verbosity. Lower levels yield shorter answers.
    */
@@ -789,7 +888,10 @@ export type RetrieveAgentRequestFallbackModelConfigurationParameters = {
     | RetrieveAgentRequestFallbackModelConfigurationStreamOptions
     | null
     | undefined;
-  thinking?: RetrieveAgentRequestFallbackModelConfigurationThinking | undefined;
+  thinking?:
+    | components.ThinkingConfigDisabledSchema
+    | components.ThinkingConfigEnabledSchema
+    | 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.
    */
@@ -820,6 +922,12 @@ export type RetrieveAgentRequestFallbackModelConfigurationParameters = {
     | Array<RetrieveAgentRequestFallbackModelConfigurationModalities>
     | null
     | undefined;
+  /**
+   * A list of guardrails to apply to the request.
+   */
+  guardrails?:
+    | Array<RetrieveAgentRequestFallbackModelConfigurationGuardrails>
+    | undefined;
 };
 
 /**
@@ -1283,7 +1391,7 @@ export const RetrieveAgentRequestSettings$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   max_iterations: z.number().int().default(100),
-  max_execution_time: z.number().int().default(300),
+  max_execution_time: z.number().int().default(600),
   tool_approval_required: RetrieveAgentRequestToolApprovalRequired$inboundSchema
     .default("respect_tool"),
   tools: z.array(z.lazy(() => RetrieveAgentRequestTools$inboundSchema))
@@ -1318,7 +1426,7 @@ export const RetrieveAgentRequestSettings$outboundSchema: z.ZodType<
   RetrieveAgentRequestSettings
 > = z.object({
   maxIterations: z.number().int().default(100),
-  maxExecutionTime: z.number().int().default(300),
+  maxExecutionTime: z.number().int().default(600),
   toolApprovalRequired: RetrieveAgentRequestToolApprovalRequired$outboundSchema
     .default("respect_tool"),
   tools: z.array(z.lazy(() => RetrieveAgentRequestTools$outboundSchema))
@@ -1684,6 +1792,15 @@ export function retrieveAgentRequestResponseFormatFromJSON(
   );
 }
 
+/** @internal */
+export const RetrieveAgentRequestReasoningEffort$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestReasoningEffort
+> = z.nativeEnum(RetrieveAgentRequestReasoningEffort);
+/** @internal */
+export const RetrieveAgentRequestReasoningEffort$outboundSchema:
+  z.ZodNativeEnum<typeof RetrieveAgentRequestReasoningEffort> =
+    RetrieveAgentRequestReasoningEffort$inboundSchema;
+
 /** @internal */
 export const RetrieveAgentRequestStop$inboundSchema: z.ZodType<
   RetrieveAgentRequestStop,
@@ -1766,61 +1883,29 @@ export function retrieveAgentRequestStreamOptionsFromJSON(
   );
 }
 
-/** @internal */
-export const RetrieveAgentRequestType$inboundSchema: z.ZodNativeEnum<
-  typeof RetrieveAgentRequestType
-> = z.nativeEnum(RetrieveAgentRequestType);
-/** @internal */
-export const RetrieveAgentRequestType$outboundSchema: z.ZodNativeEnum<
-  typeof RetrieveAgentRequestType
-> = RetrieveAgentRequestType$inboundSchema;
-
-/** @internal */
-export const RetrieveAgentRequestThinkingLevel$inboundSchema: z.ZodNativeEnum<
-  typeof RetrieveAgentRequestThinkingLevel
-> = z.nativeEnum(RetrieveAgentRequestThinkingLevel);
-/** @internal */
-export const RetrieveAgentRequestThinkingLevel$outboundSchema: z.ZodNativeEnum<
-  typeof RetrieveAgentRequestThinkingLevel
-> = RetrieveAgentRequestThinkingLevel$inboundSchema;
-
 /** @internal */
 export const RetrieveAgentRequestThinking$inboundSchema: z.ZodType<
   RetrieveAgentRequestThinking,
   z.ZodTypeDef,
   unknown
-> = z.object({
-  type: RetrieveAgentRequestType$inboundSchema,
-  budget_tokens: z.number(),
-  thinking_level: RetrieveAgentRequestThinkingLevel$inboundSchema.optional(),
-}).transform((v) => {
-  return remap$(v, {
-    "budget_tokens": "budgetTokens",
-    "thinking_level": "thinkingLevel",
-  });
-});
+> = z.union([
+  components.ThinkingConfigDisabledSchema$inboundSchema,
+  components.ThinkingConfigEnabledSchema$inboundSchema,
+]);
 /** @internal */
-export type RetrieveAgentRequestThinking$Outbound = {
-  type: string;
-  budget_tokens: number;
-  thinking_level?: string | undefined;
-};
+export type RetrieveAgentRequestThinking$Outbound =
+  | components.ThinkingConfigDisabledSchema$Outbound
+  | components.ThinkingConfigEnabledSchema$Outbound;
 
 /** @internal */
 export const RetrieveAgentRequestThinking$outboundSchema: z.ZodType<
   RetrieveAgentRequestThinking$Outbound,
   z.ZodTypeDef,
   RetrieveAgentRequestThinking
-> = z.object({
-  type: RetrieveAgentRequestType$outboundSchema,
-  budgetTokens: z.number(),
-  thinkingLevel: RetrieveAgentRequestThinkingLevel$outboundSchema.optional(),
-}).transform((v) => {
-  return remap$(v, {
-    budgetTokens: "budget_tokens",
-    thinkingLevel: "thinking_level",
-  });
-});
+> = z.union([
+  components.ThinkingConfigDisabledSchema$outboundSchema,
+  components.ThinkingConfigEnabledSchema$outboundSchema,
+]);
 
 export function retrieveAgentRequestThinkingToJSON(
   retrieveAgentRequestThinking: RetrieveAgentRequestThinking,
@@ -1998,6 +2083,110 @@ export const RetrieveAgentRequestModalities$outboundSchema: z.ZodNativeEnum<
   typeof RetrieveAgentRequestModalities
 > = RetrieveAgentRequestModalities$inboundSchema;
 
+/** @internal */
+export const RetrieveAgentRequestId1$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestId1
+> = z.nativeEnum(RetrieveAgentRequestId1);
+/** @internal */
+export const RetrieveAgentRequestId1$outboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestId1
+> = RetrieveAgentRequestId1$inboundSchema;
+
+/** @internal */
+export const RetrieveAgentRequestId$inboundSchema: z.ZodType<
+  RetrieveAgentRequestId,
+  z.ZodTypeDef,
+  unknown
+> = z.union([RetrieveAgentRequestId1$inboundSchema, z.string()]);
+/** @internal */
+export type RetrieveAgentRequestId$Outbound = string | string;
+
+/** @internal */
+export const RetrieveAgentRequestId$outboundSchema: z.ZodType<
+  RetrieveAgentRequestId$Outbound,
+  z.ZodTypeDef,
+  RetrieveAgentRequestId
+> = z.union([RetrieveAgentRequestId1$outboundSchema, z.string()]);
+
+export function retrieveAgentRequestIdToJSON(
+  retrieveAgentRequestId: RetrieveAgentRequestId,
+): string {
+  return JSON.stringify(
+    RetrieveAgentRequestId$outboundSchema.parse(retrieveAgentRequestId),
+  );
+}
+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 RetrieveAgentRequestAgentsResponseExecuteOn$outboundSchema:
+  z.ZodNativeEnum<typeof RetrieveAgentRequestAgentsResponseExecuteOn> =
+    RetrieveAgentRequestAgentsResponseExecuteOn$inboundSchema;
+
+/** @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",
+  });
+});
+/** @internal */
+export type RetrieveAgentRequestAgentsGuardrails$Outbound = {
+  id: string | string;
+  execute_on: string;
+};
+
+/** @internal */
+export const RetrieveAgentRequestAgentsGuardrails$outboundSchema: z.ZodType<
+  RetrieveAgentRequestAgentsGuardrails$Outbound,
+  z.ZodTypeDef,
+  RetrieveAgentRequestAgentsGuardrails
+> = z.object({
+  id: z.union([RetrieveAgentRequestId1$outboundSchema, z.string()]),
+  executeOn: RetrieveAgentRequestAgentsResponseExecuteOn$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    executeOn: "execute_on",
+  });
+});
+
+export function retrieveAgentRequestAgentsGuardrailsToJSON(
+  retrieveAgentRequestAgentsGuardrails: RetrieveAgentRequestAgentsGuardrails,
+): string {
+  return JSON.stringify(
+    RetrieveAgentRequestAgentsGuardrails$outboundSchema.parse(
+      retrieveAgentRequestAgentsGuardrails,
+    ),
+  );
+}
+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 RetrieveAgentRequestParameters$inboundSchema: z.ZodType<
   RetrieveAgentRequestParameters,
@@ -2020,14 +2209,18 @@ export const RetrieveAgentRequestParameters$inboundSchema: z.ZodType<
       RetrieveAgentRequestResponseFormatAgentsJSONSchema$inboundSchema
     ),
   ]).optional(),
-  reasoning_effort: z.string().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(),
   stream_options: z.nullable(
     z.lazy(() => RetrieveAgentRequestStreamOptions$inboundSchema),
   ).optional(),
-  thinking: z.lazy(() => RetrieveAgentRequestThinking$inboundSchema).optional(),
+  thinking: z.union([
+    components.ThinkingConfigDisabledSchema$inboundSchema,
+    components.ThinkingConfigEnabledSchema$inboundSchema,
+  ]).optional(),
   temperature: z.nullable(z.number()).optional(),
   top_p: z.nullable(z.number()).optional(),
   top_k: z.nullable(z.number()).optional(),
@@ -2038,6 +2231,9 @@ export const RetrieveAgentRequestParameters$inboundSchema: z.ZodType<
   parallel_tool_calls: z.boolean().optional(),
   modalities: z.nullable(z.array(RetrieveAgentRequestModalities$inboundSchema))
     .optional(),
+  guardrails: z.array(
+    z.lazy(() => RetrieveAgentRequestAgentsGuardrails$inboundSchema),
+  ).optional(),
 }).transform((v) => {
   return remap$(v, {
     "frequency_penalty": "frequencyPenalty",
@@ -2077,13 +2273,17 @@ export type RetrieveAgentRequestParameters$Outbound = {
     | RetrieveAgentRequestStreamOptions$Outbound
     | null
     | undefined;
-  thinking?: RetrieveAgentRequestThinking$Outbound | undefined;
+  thinking?:
+    | components.ThinkingConfigDisabledSchema$Outbound
+    | components.ThinkingConfigEnabledSchema$Outbound
+    | undefined;
   temperature?: number | null | undefined;
   top_p?: number | null | undefined;
   top_k?: number | null | undefined;
   tool_choice?: RetrieveAgentRequestToolChoice2$Outbound | string | undefined;
   parallel_tool_calls?: boolean | undefined;
   modalities?: Array<string> | null | undefined;
+  guardrails?: Array<RetrieveAgentRequestAgentsGuardrails$Outbound> | undefined;
 };
 
 /** @internal */
@@ -2108,15 +2308,18 @@ export const RetrieveAgentRequestParameters$outboundSchema: z.ZodType<
       RetrieveAgentRequestResponseFormatAgentsJSONSchema$outboundSchema
     ),
   ]).optional(),
-  reasoningEffort: z.string().optional(),
+  reasoningEffort: RetrieveAgentRequestReasoningEffort$outboundSchema
+    .optional(),
   verbosity: z.string().optional(),
   seed: z.nullable(z.number()).optional(),
   stop: z.nullable(z.union([z.string(), z.array(z.string())])).optional(),
   streamOptions: z.nullable(
     z.lazy(() => RetrieveAgentRequestStreamOptions$outboundSchema),
   ).optional(),
-  thinking: z.lazy(() => RetrieveAgentRequestThinking$outboundSchema)
-    .optional(),
+  thinking: z.union([
+    components.ThinkingConfigDisabledSchema$outboundSchema,
+    components.ThinkingConfigEnabledSchema$outboundSchema,
+  ]).optional(),
   temperature: z.nullable(z.number()).optional(),
   topP: z.nullable(z.number()).optional(),
   topK: z.nullable(z.number()).optional(),
@@ -2127,6 +2330,9 @@ export const RetrieveAgentRequestParameters$outboundSchema: z.ZodType<
   parallelToolCalls: z.boolean().optional(),
   modalities: z.nullable(z.array(RetrieveAgentRequestModalities$outboundSchema))
     .optional(),
+  guardrails: z.array(
+    z.lazy(() => RetrieveAgentRequestAgentsGuardrails$outboundSchema),
+  ).optional(),
 }).transform((v) => {
   return remap$(v, {
     frequencyPenalty: "frequency_penalty",
@@ -2568,6 +2774,20 @@ export function retrieveAgentRequestFallbackModelConfigurationResponseFormatFrom
   );
 }
 
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationReasoningEffort$inboundSchema:
+  z.ZodNativeEnum<
+    typeof RetrieveAgentRequestFallbackModelConfigurationReasoningEffort
+  > = z.nativeEnum(
+    RetrieveAgentRequestFallbackModelConfigurationReasoningEffort,
+  );
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationReasoningEffort$outboundSchema:
+  z.ZodNativeEnum<
+    typeof RetrieveAgentRequestFallbackModelConfigurationReasoningEffort
+  > =
+    RetrieveAgentRequestFallbackModelConfigurationReasoningEffort$inboundSchema;
+
 /** @internal */
 export const RetrieveAgentRequestFallbackModelConfigurationStop$inboundSchema:
   z.ZodType<
@@ -2671,50 +2891,20 @@ export function retrieveAgentRequestFallbackModelConfigurationStreamOptionsFromJ
   );
 }
 
-/** @internal */
-export const RetrieveAgentRequestFallbackModelConfigurationType$inboundSchema:
-  z.ZodNativeEnum<typeof RetrieveAgentRequestFallbackModelConfigurationType> = z
-    .nativeEnum(RetrieveAgentRequestFallbackModelConfigurationType);
-/** @internal */
-export const RetrieveAgentRequestFallbackModelConfigurationType$outboundSchema:
-  z.ZodNativeEnum<typeof RetrieveAgentRequestFallbackModelConfigurationType> =
-    RetrieveAgentRequestFallbackModelConfigurationType$inboundSchema;
-
-/** @internal */
-export const RetrieveAgentRequestFallbackModelConfigurationThinkingLevel$inboundSchema:
-  z.ZodNativeEnum<
-    typeof RetrieveAgentRequestFallbackModelConfigurationThinkingLevel
-  > = z.nativeEnum(RetrieveAgentRequestFallbackModelConfigurationThinkingLevel);
-/** @internal */
-export const RetrieveAgentRequestFallbackModelConfigurationThinkingLevel$outboundSchema:
-  z.ZodNativeEnum<
-    typeof RetrieveAgentRequestFallbackModelConfigurationThinkingLevel
-  > = RetrieveAgentRequestFallbackModelConfigurationThinkingLevel$inboundSchema;
-
 /** @internal */
 export const RetrieveAgentRequestFallbackModelConfigurationThinking$inboundSchema:
   z.ZodType<
     RetrieveAgentRequestFallbackModelConfigurationThinking,
     z.ZodTypeDef,
     unknown
-  > = z.object({
-    type: RetrieveAgentRequestFallbackModelConfigurationType$inboundSchema,
-    budget_tokens: z.number(),
-    thinking_level:
-      RetrieveAgentRequestFallbackModelConfigurationThinkingLevel$inboundSchema
-        .optional(),
-  }).transform((v) => {
-    return remap$(v, {
-      "budget_tokens": "budgetTokens",
-      "thinking_level": "thinkingLevel",
-    });
-  });
+  > = z.union([
+    components.ThinkingConfigDisabledSchema$inboundSchema,
+    components.ThinkingConfigEnabledSchema$inboundSchema,
+  ]);
 /** @internal */
-export type RetrieveAgentRequestFallbackModelConfigurationThinking$Outbound = {
-  type: string;
-  budget_tokens: number;
-  thinking_level?: string | undefined;
-};
+export type RetrieveAgentRequestFallbackModelConfigurationThinking$Outbound =
+  | components.ThinkingConfigDisabledSchema$Outbound
+  | components.ThinkingConfigEnabledSchema$Outbound;
 
 /** @internal */
 export const RetrieveAgentRequestFallbackModelConfigurationThinking$outboundSchema:
@@ -2722,18 +2912,10 @@ export const RetrieveAgentRequestFallbackModelConfigurationThinking$outboundSche
     RetrieveAgentRequestFallbackModelConfigurationThinking$Outbound,
     z.ZodTypeDef,
     RetrieveAgentRequestFallbackModelConfigurationThinking
-  > = z.object({
-    type: RetrieveAgentRequestFallbackModelConfigurationType$outboundSchema,
-    budgetTokens: z.number(),
-    thinkingLevel:
-      RetrieveAgentRequestFallbackModelConfigurationThinkingLevel$outboundSchema
-        .optional(),
-  }).transform((v) => {
-    return remap$(v, {
-      budgetTokens: "budget_tokens",
-      thinkingLevel: "thinking_level",
-    });
-  });
+  > = z.union([
+    components.ThinkingConfigDisabledSchema$outboundSchema,
+    components.ThinkingConfigEnabledSchema$outboundSchema,
+  ]);
 
 export function retrieveAgentRequestFallbackModelConfigurationThinkingToJSON(
   retrieveAgentRequestFallbackModelConfigurationThinking:
@@ -2939,6 +3121,134 @@ export const RetrieveAgentRequestFallbackModelConfigurationModalities$outboundSc
     typeof RetrieveAgentRequestFallbackModelConfigurationModalities
   > = RetrieveAgentRequestFallbackModelConfigurationModalities$inboundSchema;
 
+/** @internal */
+export const RetrieveAgentRequestIdAgents1$inboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestIdAgents1
+> = z.nativeEnum(RetrieveAgentRequestIdAgents1);
+/** @internal */
+export const RetrieveAgentRequestIdAgents1$outboundSchema: z.ZodNativeEnum<
+  typeof RetrieveAgentRequestIdAgents1
+> = RetrieveAgentRequestIdAgents1$inboundSchema;
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationId$inboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationId,
+    z.ZodTypeDef,
+    unknown
+  > = z.union([RetrieveAgentRequestIdAgents1$inboundSchema, z.string()]);
+/** @internal */
+export type RetrieveAgentRequestFallbackModelConfigurationId$Outbound =
+  | string
+  | string;
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationId$outboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationId$Outbound,
+    z.ZodTypeDef,
+    RetrieveAgentRequestFallbackModelConfigurationId
+  > = z.union([RetrieveAgentRequestIdAgents1$outboundSchema, z.string()]);
+
+export function retrieveAgentRequestFallbackModelConfigurationIdToJSON(
+  retrieveAgentRequestFallbackModelConfigurationId:
+    RetrieveAgentRequestFallbackModelConfigurationId,
+): string {
+  return JSON.stringify(
+    RetrieveAgentRequestFallbackModelConfigurationId$outboundSchema.parse(
+      retrieveAgentRequestFallbackModelConfigurationId,
+    ),
+  );
+}
+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 RetrieveAgentRequestFallbackModelConfigurationExecuteOn$outboundSchema:
+  z.ZodNativeEnum<
+    typeof RetrieveAgentRequestFallbackModelConfigurationExecuteOn
+  > = RetrieveAgentRequestFallbackModelConfigurationExecuteOn$inboundSchema;
+
+/** @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",
+    });
+  });
+/** @internal */
+export type RetrieveAgentRequestFallbackModelConfigurationGuardrails$Outbound =
+  {
+    id: string | string;
+    execute_on: string;
+  };
+
+/** @internal */
+export const RetrieveAgentRequestFallbackModelConfigurationGuardrails$outboundSchema:
+  z.ZodType<
+    RetrieveAgentRequestFallbackModelConfigurationGuardrails$Outbound,
+    z.ZodTypeDef,
+    RetrieveAgentRequestFallbackModelConfigurationGuardrails
+  > = z.object({
+    id: z.union([RetrieveAgentRequestIdAgents1$outboundSchema, z.string()]),
+    executeOn:
+      RetrieveAgentRequestFallbackModelConfigurationExecuteOn$outboundSchema,
+  }).transform((v) => {
+    return remap$(v, {
+      executeOn: "execute_on",
+    });
+  });
+
+export function retrieveAgentRequestFallbackModelConfigurationGuardrailsToJSON(
+  retrieveAgentRequestFallbackModelConfigurationGuardrails:
+    RetrieveAgentRequestFallbackModelConfigurationGuardrails,
+): string {
+  return JSON.stringify(
+    RetrieveAgentRequestFallbackModelConfigurationGuardrails$outboundSchema
+      .parse(retrieveAgentRequestFallbackModelConfigurationGuardrails),
+  );
+}
+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 RetrieveAgentRequestFallbackModelConfigurationParameters$inboundSchema:
   z.ZodType<
@@ -2967,7 +3277,9 @@ export const RetrieveAgentRequestFallbackModelConfigurationParameters$inboundSch
         RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema$inboundSchema
       ),
     ]).optional(),
-    reasoning_effort: z.string().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(),
@@ -2976,9 +3288,10 @@ export const RetrieveAgentRequestFallbackModelConfigurationParameters$inboundSch
         RetrieveAgentRequestFallbackModelConfigurationStreamOptions$inboundSchema
       ),
     ).optional(),
-    thinking: z.lazy(() =>
-      RetrieveAgentRequestFallbackModelConfigurationThinking$inboundSchema
-    ).optional(),
+    thinking: z.union([
+      components.ThinkingConfigDisabledSchema$inboundSchema,
+      components.ThinkingConfigEnabledSchema$inboundSchema,
+    ]).optional(),
     temperature: z.nullable(z.number()).optional(),
     top_p: z.nullable(z.number()).optional(),
     top_k: z.nullable(z.number()).optional(),
@@ -2992,6 +3305,11 @@ export const RetrieveAgentRequestFallbackModelConfigurationParameters$inboundSch
         RetrieveAgentRequestFallbackModelConfigurationModalities$inboundSchema,
       ),
     ).optional(),
+    guardrails: z.array(
+      z.lazy(() =>
+        RetrieveAgentRequestFallbackModelConfigurationGuardrails$inboundSchema
+      ),
+    ).optional(),
   }).transform((v) => {
     return remap$(v, {
       "frequency_penalty": "frequencyPenalty",
@@ -3036,7 +3354,8 @@ export type RetrieveAgentRequestFallbackModelConfigurationParameters$Outbound =
       | null
       | undefined;
     thinking?:
-      | RetrieveAgentRequestFallbackModelConfigurationThinking$Outbound
+      | components.ThinkingConfigDisabledSchema$Outbound
+      | components.ThinkingConfigEnabledSchema$Outbound
       | undefined;
     temperature?: number | null | undefined;
     top_p?: number | null | undefined;
@@ -3047,6 +3366,9 @@ export type RetrieveAgentRequestFallbackModelConfigurationParameters$Outbound =
       | undefined;
     parallel_tool_calls?: boolean | undefined;
     modalities?: Array<string> | null | undefined;
+    guardrails?:
+      | Array<RetrieveAgentRequestFallbackModelConfigurationGuardrails$Outbound>
+      | undefined;
   };
 
 /** @internal */
@@ -3077,7 +3399,9 @@ export const RetrieveAgentRequestFallbackModelConfigurationParameters$outboundSc
         RetrieveAgentRequestResponseFormatAgentsResponse200JSONSchema$outboundSchema
       ),
     ]).optional(),
-    reasoningEffort: z.string().optional(),
+    reasoningEffort:
+      RetrieveAgentRequestFallbackModelConfigurationReasoningEffort$outboundSchema
+        .optional(),
     verbosity: z.string().optional(),
     seed: z.nullable(z.number()).optional(),
     stop: z.nullable(z.union([z.string(), z.array(z.string())])).optional(),
@@ -3086,9 +3410,10 @@ export const RetrieveAgentRequestFallbackModelConfigurationParameters$outboundSc
         RetrieveAgentRequestFallbackModelConfigurationStreamOptions$outboundSchema
       ),
     ).optional(),
-    thinking: z.lazy(() =>
-      RetrieveAgentRequestFallbackModelConfigurationThinking$outboundSchema
-    ).optional(),
+    thinking: z.union([
+      components.ThinkingConfigDisabledSchema$outboundSchema,
+      components.ThinkingConfigEnabledSchema$outboundSchema,
+    ]).optional(),
     temperature: z.nullable(z.number()).optional(),
     topP: z.nullable(z.number()).optional(),
     topK: z.nullable(z.number()).optional(),
@@ -3102,6 +3427,11 @@ export const RetrieveAgentRequestFallbackModelConfigurationParameters$outboundSc
         RetrieveAgentRequestFallbackModelConfigurationModalities$outboundSchema,
       ),
     ).optional(),
+    guardrails: z.array(
+      z.lazy(() =>
+        RetrieveAgentRequestFallbackModelConfigurationGuardrails$outboundSchema
+      ),
+    ).optional(),
   }).transform((v) => {
     return remap$(v, {
       frequencyPenalty: "frequency_penalty",