@orq-ai/node 4.11.0-rc.3 → 4.11.0-rc.31

package/models/operations/updateagent.d.ts

@@ -208,6 +208,61 @@ export type ModelConfigurationTimeout = {
      */
     callTimeout: number;
 };
+/**
+ * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+ */
+export declare const UpdateAgentModelConfigurationAgentsType: {
+    readonly Ephemeral: "ephemeral";
+};
+/**
+ * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+ */
+export type UpdateAgentModelConfigurationAgentsType = ClosedEnum<typeof UpdateAgentModelConfigurationAgentsType>;
+/**
+ * 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 declare const UpdateAgentModelConfigurationTtl: {
+    readonly Fivem: "5m";
+    readonly Oneh: "1h";
+};
+/**
+ * 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 UpdateAgentModelConfigurationTtl = ClosedEnum<typeof UpdateAgentModelConfigurationTtl>;
+/**
+ * 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 UpdateAgentModelConfigurationCacheControl = {
+    /**
+     * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+     */
+    type: UpdateAgentModelConfigurationAgentsType;
+    /**
+     * 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?: UpdateAgentModelConfigurationTtl | undefined;
+};
 /**
  * Model behavior parameters that control how the model generates responses. Common parameters: `temperature` (0-1, randomness), `max_completion_tokens` (max output length), `top_p` (sampling diversity). Advanced: `frequency_penalty`, `presence_penalty`, `response_format` (JSON/structured), `reasoning_effort`, `seed` (reproducibility). Support varies by model - consult AI Gateway documentation.
  */
@@ -310,6 +365,14 @@ export type ModelConfigurationParameters = {
      * 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?: ModelConfigurationTimeout | 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?: UpdateAgentModelConfigurationCacheControl | 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. Retries are triggered for specific HTTP status codes (e.g., 500, 429, 502, 503, 504). Supports configurable retry count (1-5) and custom status codes.
@@ -552,6 +615,61 @@ export type UpdateAgentFallbackModelConfigurationTimeout = {
      */
     callTimeout: number;
 };
+/**
+ * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+ */
+export declare const UpdateAgentFallbackModelConfigurationAgentsType: {
+    readonly Ephemeral: "ephemeral";
+};
+/**
+ * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+ */
+export type UpdateAgentFallbackModelConfigurationAgentsType = ClosedEnum<typeof UpdateAgentFallbackModelConfigurationAgentsType>;
+/**
+ * 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 declare const UpdateAgentFallbackModelConfigurationTtl: {
+    readonly Fivem: "5m";
+    readonly Oneh: "1h";
+};
+/**
+ * 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 UpdateAgentFallbackModelConfigurationTtl = ClosedEnum<typeof UpdateAgentFallbackModelConfigurationTtl>;
+/**
+ * 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 UpdateAgentFallbackModelConfigurationCacheControl = {
+    /**
+     * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+     */
+    type: UpdateAgentFallbackModelConfigurationAgentsType;
+    /**
+     * 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?: UpdateAgentFallbackModelConfigurationTtl | undefined;
+};
 /**
  * Optional model parameters specific to this fallback model. Overrides primary model parameters if this fallback is used.
  */
@@ -654,6 +772,14 @@ export type UpdateAgentFallbackModelConfigurationParameters = {
      * 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?: UpdateAgentFallbackModelConfigurationTimeout | 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?: UpdateAgentFallbackModelConfigurationCacheControl | 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.
@@ -1582,6 +1708,61 @@ export type UpdateAgentTimeout = {
      */
     callTimeout: number;
 };
+/**
+ * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+ */
+export declare const UpdateAgentAgentsResponseType: {
+    readonly Ephemeral: "ephemeral";
+};
+/**
+ * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+ */
+export type UpdateAgentAgentsResponseType = ClosedEnum<typeof UpdateAgentAgentsResponseType>;
+/**
+ * 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 declare const UpdateAgentTtl: {
+    readonly Fivem: "5m";
+    readonly Oneh: "1h";
+};
+/**
+ * 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 UpdateAgentTtl = ClosedEnum<typeof UpdateAgentTtl>;
+/**
+ * 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 UpdateAgentCacheControl = {
+    /**
+     * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+     */
+    type: UpdateAgentAgentsResponseType;
+    /**
+     * 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: UpdateAgentTtl;
+};
 /**
  * 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.
  */
@@ -1684,6 +1865,14 @@ export type UpdateAgentParameters = {
      * 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?: UpdateAgentTimeout | 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?: UpdateAgentCacheControl | 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).
@@ -1858,10 +2047,10 @@ export type UpdateAgentFallbackModelConfigurationAgentsFallbacks = {
      */
     model: string;
 };
-export declare const UpdateAgentFallbackModelConfigurationAgentsType: {
+export declare const UpdateAgentFallbackModelConfigurationAgentsResponseType: {
     readonly ExactMatch: "exact_match";
 };
-export type UpdateAgentFallbackModelConfigurationAgentsType = ClosedEnum<typeof UpdateAgentFallbackModelConfigurationAgentsType>;
+export type UpdateAgentFallbackModelConfigurationAgentsResponseType = ClosedEnum<typeof UpdateAgentFallbackModelConfigurationAgentsResponseType>;
 /**
  * Cache configuration for the request.
  */
@@ -1870,7 +2059,7 @@ export type UpdateAgentFallbackModelConfigurationAgentsCache = {
      * Time to live for cached responses in seconds. Maximum 259200 seconds (3 days).
      */
     ttl: number;
-    type: UpdateAgentFallbackModelConfigurationAgentsType;
+    type: UpdateAgentFallbackModelConfigurationAgentsResponseType;
 };
 export declare const UpdateAgentLoadBalancerAgentsResponse200Type: {
     readonly WeightBased: "weight_based";
@@ -1903,6 +2092,61 @@ export type UpdateAgentFallbackModelConfigurationAgentsTimeout = {
      */
     callTimeout: number;
 };
+/**
+ * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+ */
+export declare const UpdateAgentFallbackModelConfigurationAgentsResponse200Type: {
+    readonly Ephemeral: "ephemeral";
+};
+/**
+ * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+ */
+export type UpdateAgentFallbackModelConfigurationAgentsResponse200Type = ClosedEnum<typeof UpdateAgentFallbackModelConfigurationAgentsResponse200Type>;
+/**
+ * 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 declare const UpdateAgentFallbackModelConfigurationAgentsTtl: {
+    readonly Fivem: "5m";
+    readonly Oneh: "1h";
+};
+/**
+ * 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 UpdateAgentFallbackModelConfigurationAgentsTtl = ClosedEnum<typeof UpdateAgentFallbackModelConfigurationAgentsTtl>;
+/**
+ * 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 UpdateAgentFallbackModelConfigurationAgentsCacheControl = {
+    /**
+     * Create a cache control breakpoint at this content block. Accepts only the value "ephemeral".
+     */
+    type: UpdateAgentFallbackModelConfigurationAgentsResponse200Type;
+    /**
+     * 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: UpdateAgentFallbackModelConfigurationAgentsTtl;
+};
 /**
  * Optional model parameters specific to this fallback model. Overrides primary model parameters if this fallback is used.
  */
@@ -2005,6 +2249,14 @@ export type UpdateAgentFallbackModelConfigurationAgentsParameters = {
      * 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?: UpdateAgentFallbackModelConfigurationAgentsTimeout | 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?: UpdateAgentFallbackModelConfigurationAgentsCacheControl | 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.
@@ -2271,6 +2523,18 @@ export type ModelConfigurationTimeout$Outbound = {
 export declare const ModelConfigurationTimeout$outboundSchema: z.ZodType<ModelConfigurationTimeout$Outbound, z.ZodTypeDef, ModelConfigurationTimeout>;
 export declare function modelConfigurationTimeoutToJSON(modelConfigurationTimeout: ModelConfigurationTimeout): string;
 /** @internal */
+export declare const UpdateAgentModelConfigurationAgentsType$outboundSchema: z.ZodNativeEnum<typeof UpdateAgentModelConfigurationAgentsType>;
+/** @internal */
+export declare const UpdateAgentModelConfigurationTtl$outboundSchema: z.ZodNativeEnum<typeof UpdateAgentModelConfigurationTtl>;
+/** @internal */
+export type UpdateAgentModelConfigurationCacheControl$Outbound = {
+    type: string;
+    ttl: string;
+};
+/** @internal */
+export declare const UpdateAgentModelConfigurationCacheControl$outboundSchema: z.ZodType<UpdateAgentModelConfigurationCacheControl$Outbound, z.ZodTypeDef, UpdateAgentModelConfigurationCacheControl>;
+export declare function updateAgentModelConfigurationCacheControlToJSON(updateAgentModelConfigurationCacheControl: UpdateAgentModelConfigurationCacheControl): string;
+/** @internal */
 export type ModelConfigurationParameters$Outbound = {
     name?: string | undefined;
     frequency_penalty?: number | null | undefined;
@@ -2294,6 +2558,8 @@ export type ModelConfigurationParameters$Outbound = {
     cache?: ModelConfigurationCache$Outbound | undefined;
     load_balancer?: UpdateAgentLoadBalancer1$Outbound | undefined;
     timeout?: ModelConfigurationTimeout$Outbound | undefined;
+    cache_control?: UpdateAgentModelConfigurationCacheControl$Outbound | undefined;
+    prompt_cache_key?: string | undefined;
 };
 /** @internal */
 export declare const ModelConfigurationParameters$outboundSchema: z.ZodType<ModelConfigurationParameters$Outbound, z.ZodTypeDef, ModelConfigurationParameters>;
@@ -2460,6 +2726,18 @@ export type UpdateAgentFallbackModelConfigurationTimeout$Outbound = {
 export declare const UpdateAgentFallbackModelConfigurationTimeout$outboundSchema: z.ZodType<UpdateAgentFallbackModelConfigurationTimeout$Outbound, z.ZodTypeDef, UpdateAgentFallbackModelConfigurationTimeout>;
 export declare function updateAgentFallbackModelConfigurationTimeoutToJSON(updateAgentFallbackModelConfigurationTimeout: UpdateAgentFallbackModelConfigurationTimeout): string;
 /** @internal */
+export declare const UpdateAgentFallbackModelConfigurationAgentsType$outboundSchema: z.ZodNativeEnum<typeof UpdateAgentFallbackModelConfigurationAgentsType>;
+/** @internal */
+export declare const UpdateAgentFallbackModelConfigurationTtl$outboundSchema: z.ZodNativeEnum<typeof UpdateAgentFallbackModelConfigurationTtl>;
+/** @internal */
+export type UpdateAgentFallbackModelConfigurationCacheControl$Outbound = {
+    type: string;
+    ttl: string;
+};
+/** @internal */
+export declare const UpdateAgentFallbackModelConfigurationCacheControl$outboundSchema: z.ZodType<UpdateAgentFallbackModelConfigurationCacheControl$Outbound, z.ZodTypeDef, UpdateAgentFallbackModelConfigurationCacheControl>;
+export declare function updateAgentFallbackModelConfigurationCacheControlToJSON(updateAgentFallbackModelConfigurationCacheControl: UpdateAgentFallbackModelConfigurationCacheControl): string;
+/** @internal */
 export type UpdateAgentFallbackModelConfigurationParameters$Outbound = {
     name?: string | undefined;
     frequency_penalty?: number | null | undefined;
@@ -2483,6 +2761,8 @@ export type UpdateAgentFallbackModelConfigurationParameters$Outbound = {
     cache?: UpdateAgentFallbackModelConfigurationCache$Outbound | undefined;
     load_balancer?: UpdateAgentLoadBalancerAgents1$Outbound | undefined;
     timeout?: UpdateAgentFallbackModelConfigurationTimeout$Outbound | undefined;
+    cache_control?: UpdateAgentFallbackModelConfigurationCacheControl$Outbound | undefined;
+    prompt_cache_key?: string | undefined;
 };
 /** @internal */
 export declare const UpdateAgentFallbackModelConfigurationParameters$outboundSchema: z.ZodType<UpdateAgentFallbackModelConfigurationParameters$Outbound, z.ZodTypeDef, UpdateAgentFallbackModelConfigurationParameters>;
@@ -2893,6 +3173,13 @@ export declare function updateAgentLoadBalancerFromJSON(jsonString: string): Saf
 export declare const UpdateAgentTimeout$inboundSchema: z.ZodType<UpdateAgentTimeout, z.ZodTypeDef, unknown>;
 export declare function updateAgentTimeoutFromJSON(jsonString: string): SafeParseResult<UpdateAgentTimeout, SDKValidationError>;
 /** @internal */
+export declare const UpdateAgentAgentsResponseType$inboundSchema: z.ZodNativeEnum<typeof UpdateAgentAgentsResponseType>;
+/** @internal */
+export declare const UpdateAgentTtl$inboundSchema: z.ZodNativeEnum<typeof UpdateAgentTtl>;
+/** @internal */
+export declare const UpdateAgentCacheControl$inboundSchema: z.ZodType<UpdateAgentCacheControl, z.ZodTypeDef, unknown>;
+export declare function updateAgentCacheControlFromJSON(jsonString: string): SafeParseResult<UpdateAgentCacheControl, SDKValidationError>;
+/** @internal */
 export declare const UpdateAgentParameters$inboundSchema: z.ZodType<UpdateAgentParameters, z.ZodTypeDef, unknown>;
 export declare function updateAgentParametersFromJSON(jsonString: string): SafeParseResult<UpdateAgentParameters, SDKValidationError>;
 /** @internal */
@@ -2950,7 +3237,7 @@ export declare function updateAgentFallbackModelConfigurationAgentsGuardrailsFro
 export declare const UpdateAgentFallbackModelConfigurationAgentsFallbacks$inboundSchema: z.ZodType<UpdateAgentFallbackModelConfigurationAgentsFallbacks, z.ZodTypeDef, unknown>;
 export declare function updateAgentFallbackModelConfigurationAgentsFallbacksFromJSON(jsonString: string): SafeParseResult<UpdateAgentFallbackModelConfigurationAgentsFallbacks, SDKValidationError>;
 /** @internal */
-export declare const UpdateAgentFallbackModelConfigurationAgentsType$inboundSchema: z.ZodNativeEnum<typeof UpdateAgentFallbackModelConfigurationAgentsType>;
+export declare const UpdateAgentFallbackModelConfigurationAgentsResponseType$inboundSchema: z.ZodNativeEnum<typeof UpdateAgentFallbackModelConfigurationAgentsResponseType>;
 /** @internal */
 export declare const UpdateAgentFallbackModelConfigurationAgentsCache$inboundSchema: z.ZodType<UpdateAgentFallbackModelConfigurationAgentsCache, z.ZodTypeDef, unknown>;
 export declare function updateAgentFallbackModelConfigurationAgentsCacheFromJSON(jsonString: string): SafeParseResult<UpdateAgentFallbackModelConfigurationAgentsCache, SDKValidationError>;
@@ -2969,6 +3256,13 @@ export declare function updateAgentFallbackModelConfigurationAgentsLoadBalancerF
 export declare const UpdateAgentFallbackModelConfigurationAgentsTimeout$inboundSchema: z.ZodType<UpdateAgentFallbackModelConfigurationAgentsTimeout, z.ZodTypeDef, unknown>;
 export declare function updateAgentFallbackModelConfigurationAgentsTimeoutFromJSON(jsonString: string): SafeParseResult<UpdateAgentFallbackModelConfigurationAgentsTimeout, SDKValidationError>;
 /** @internal */
+export declare const UpdateAgentFallbackModelConfigurationAgentsResponse200Type$inboundSchema: z.ZodNativeEnum<typeof UpdateAgentFallbackModelConfigurationAgentsResponse200Type>;
+/** @internal */
+export declare const UpdateAgentFallbackModelConfigurationAgentsTtl$inboundSchema: z.ZodNativeEnum<typeof UpdateAgentFallbackModelConfigurationAgentsTtl>;
+/** @internal */
+export declare const UpdateAgentFallbackModelConfigurationAgentsCacheControl$inboundSchema: z.ZodType<UpdateAgentFallbackModelConfigurationAgentsCacheControl, z.ZodTypeDef, unknown>;
+export declare function updateAgentFallbackModelConfigurationAgentsCacheControlFromJSON(jsonString: string): SafeParseResult<UpdateAgentFallbackModelConfigurationAgentsCacheControl, SDKValidationError>;
+/** @internal */
 export declare const UpdateAgentFallbackModelConfigurationAgentsParameters$inboundSchema: z.ZodType<UpdateAgentFallbackModelConfigurationAgentsParameters, z.ZodTypeDef, unknown>;
 export declare function updateAgentFallbackModelConfigurationAgentsParametersFromJSON(jsonString: string): SafeParseResult<UpdateAgentFallbackModelConfigurationAgentsParameters, SDKValidationError>;
 /** @internal */