@orq-ai/node 4.11.0-rc.2 → 4.11.0-rc.20

package/src/models/operations/retrieveagentrequest.ts

@@ -486,6 +486,68 @@ export type RetrieveAgentRequestTimeout = {
   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.
  */
@@ -599,6 +661,14 @@ export type RetrieveAgentRequestParameters = {
    * 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;
 };
 
 /**
@@ -874,6 +944,67 @@ export type RetrieveAgentRequestFallbackModelConfigurationTimeout = {
   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.
  */
@@ -996,6 +1127,16 @@ export type RetrieveAgentRequestFallbackModelConfigurationParameters = {
    * 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;
 };
 
 /**
@@ -1845,6 +1986,37 @@ export function retrieveAgentRequestTimeoutFromJSON(
   );
 }
 
+/** @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,
@@ -1892,6 +2064,9 @@ export const RetrieveAgentRequestParameters$inboundSchema: z.ZodType<
   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",
@@ -1905,6 +2080,8 @@ export const RetrieveAgentRequestParameters$inboundSchema: z.ZodType<
     "tool_choice": "toolChoice",
     "parallel_tool_calls": "parallelToolCalls",
     "load_balancer": "loadBalancer",
+    "cache_control": "cacheControl",
+    "prompt_cache_key": "promptCacheKey",
   });
 });
 
@@ -2472,6 +2649,45 @@ export function retrieveAgentRequestFallbackModelConfigurationTimeoutFromJSON(
   );
 }
 
+/** @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<
@@ -2536,6 +2752,10 @@ export const RetrieveAgentRequestFallbackModelConfigurationParameters$inboundSch
     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",
@@ -2549,6 +2769,8 @@ export const RetrieveAgentRequestFallbackModelConfigurationParameters$inboundSch
       "tool_choice": "toolChoice",
       "parallel_tool_calls": "parallelToolCalls",
       "load_balancer": "loadBalancer",
+      "cache_control": "cacheControl",
+      "prompt_cache_key": "promptCacheKey",
     });
   });
 

package/src/models/operations/retrievedatapoint.ts

@@ -1207,7 +1207,7 @@ export const RetrieveDatapointEvaluations3$inboundSchema: z.ZodType<
     .default("orq"),
   reviewed_by_id: z.string(),
   reviewed_at: z.string().datetime({ offset: true }).default(
-    "2026-06-08T05:34:42.550Z",
+    "2026-06-15T08:56:18.237Z",
   ).transform(v => new Date(v)),
   type: z.literal("string_array"),
   values: z.array(z.string()),
@@ -1255,7 +1255,7 @@ export const RetrieveDatapointEvaluations2$inboundSchema: z.ZodType<
   ),
   reviewed_by_id: z.string(),
   reviewed_at: z.string().datetime({ offset: true }).default(
-    "2026-06-08T05:34:42.549Z",
+    "2026-06-15T08:56:18.236Z",
   ).transform(v => new Date(v)),
   type: z.literal("number"),
   value: z.number(),
@@ -1300,7 +1300,7 @@ export const RetrieveDatapointEvaluations1$inboundSchema: z.ZodType<
   source: RetrieveDatapointEvaluationsSource$inboundSchema.default("orq"),
   reviewed_by_id: z.string(),
   reviewed_at: z.string().datetime({ offset: true }).default(
-    "2026-06-08T05:34:42.548Z",
+    "2026-06-15T08:56:18.236Z",
   ).transform(v => new Date(v)),
   type: z.literal("string"),
   value: z.string(),
@@ -1377,7 +1377,7 @@ export const RetrieveDatapointResponseBody$inboundSchema: z.ZodType<
   created: z.string().datetime({ offset: true }).transform(v => new Date(v))
     .optional(),
   updated: z.string().datetime({ offset: true }).default(
-    "2026-06-08T05:34:18.893Z",
+    "2026-06-15T08:55:55.775Z",
   ).transform(v => new Date(v)),
 }).transform((v) => {
   return remap$(v, {

package/src/models/operations/retrievedataset.ts

@@ -126,7 +126,7 @@ export const RetrieveDatasetResponseBody$inboundSchema: z.ZodType<
   created: z.string().datetime({ offset: true }).transform(v => new Date(v))
     .optional(),
   updated: z.string().datetime({ offset: true }).default(
-    "2026-06-08T05:34:18.893Z",
+    "2026-06-15T08:55:55.775Z",
   ).transform(v => new Date(v)),
 }).transform((v) => {
   return remap$(v, {

package/src/models/operations/retrievedatasource.ts

@@ -118,7 +118,7 @@ export const RetrieveDatasourceResponseBody$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("01KTJVKQSJ9EQX96R7AQB0ZHY1"),
+  _id: z.string().default("01KV57XWZM8CEYVX4WW6E1DPQT"),
   display_name: z.string(),
   description: z.nullable(z.string()).optional(),
   status: RetrieveDatasourceStatus$inboundSchema,

package/src/models/operations/retrievememorystore.ts

@@ -57,7 +57,7 @@ export type RetrieveMemoryStoreResponseBody = {
   /**
    * The default time to live of every memory document created within the memory store. Useful to control if the documents in the memory should be store for short or long term.
    */
-  ttl?: number | undefined;
+  ttl?: number | null | undefined;
   embeddingConfig: RetrieveMemoryStoreEmbeddingConfig;
 };
 
@@ -120,7 +120,7 @@ export const RetrieveMemoryStoreResponseBody$inboundSchema: z.ZodType<
   updated_by_id: z.nullable(z.string()).optional(),
   created: z.string(),
   updated: z.string(),
-  ttl: z.number().optional(),
+  ttl: z.nullable(z.number()).optional(),
   embedding_config: z.lazy(() =>
     RetrieveMemoryStoreEmbeddingConfig$inboundSchema
   ),

package/src/models/operations/retrievetool.ts

@@ -115,11 +115,11 @@ export type RetrieveToolResponseBodyCodeExecutionTool = {
   /**
    * The id of the user that created the tool
    */
-  createdById?: string | undefined;
+  createdById?: string | null | undefined;
   /**
    * The id of the user that last updated the tool
    */
-  updatedById?: string | undefined;
+  updatedById?: string | null | undefined;
   projectId: string;
   workspaceId: string;
   created: string;
@@ -241,11 +241,11 @@ export type RetrieveToolResponseBodyMCPTool = {
   /**
    * The id of the user that created the tool
    */
-  createdById?: string | undefined;
+  createdById?: string | null | undefined;
   /**
    * The id of the user that last updated the tool
    */
-  updatedById?: string | undefined;
+  updatedById?: string | null | undefined;
   projectId: string;
   workspaceId: string;
   created: string;
@@ -402,11 +402,11 @@ export type RetrieveToolResponseBodyHTTPTool = {
   /**
    * The id of the user that created the tool
    */
-  createdById?: string | undefined;
+  createdById?: string | null | undefined;
   /**
    * The id of the user that last updated the tool
    */
-  updatedById?: string | undefined;
+  updatedById?: string | null | undefined;
   projectId: string;
   workspaceId: string;
   created: string;
@@ -503,11 +503,11 @@ export type RetrieveToolResponseBodyJSONSchemaTool = {
   /**
    * The id of the user that created the tool
    */
-  createdById?: string | undefined;
+  createdById?: string | null | undefined;
   /**
    * The id of the user that last updated the tool
    */
-  updatedById?: string | undefined;
+  updatedById?: string | null | undefined;
   projectId: string;
   workspaceId: string;
   created: string;
@@ -618,11 +618,11 @@ export type RetrieveToolResponseBodyFunctionTool = {
   /**
    * The id of the user that created the tool
    */
-  createdById?: string | undefined;
+  createdById?: string | null | undefined;
   /**
    * The id of the user that last updated the tool
    */
-  updatedById?: string | undefined;
+  updatedById?: string | null | undefined;
   projectId: string;
   workspaceId: string;
   created: string;
@@ -753,13 +753,13 @@ export const RetrieveToolResponseBodyCodeExecutionTool$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("tool_01KTJVKQP951RKHG017G39HFMK"),
+  _id: z.string().default("tool_01KV57XWVWK1XANXKHV4988S8Q"),
   path: z.string(),
   key: z.string(),
   display_name: z.string().optional(),
   description: z.string(),
-  created_by_id: z.string().optional(),
-  updated_by_id: z.string().optional(),
+  created_by_id: z.nullable(z.string()).optional(),
+  updated_by_id: z.nullable(z.string()).optional(),
   project_id: z.string(),
   workspace_id: z.string(),
   created: z.string(),
@@ -859,7 +859,7 @@ export const RetrieveToolResponseBodyTools$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  id: z.string().default("01KTJVKQP88E83VAF201WB954A"),
+  id: z.string().default("01KV57XWVVKQ011WHQ2KEEDSMK"),
   name: z.string(),
   description: z.string().optional(),
   schema: z.lazy(() => RetrieveToolResponseBodyToolsSchema$inboundSchema),
@@ -917,13 +917,13 @@ export const RetrieveToolResponseBodyMCPTool$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("tool_01KTJVKQP7JZYYR6Z1YTRWEZWX"),
+  _id: z.string().default("tool_01KV57XWVTJBF0W4DHCJS6S8K7"),
   path: z.string(),
   key: z.string(),
   display_name: z.string().optional(),
   description: z.string(),
-  created_by_id: z.string().optional(),
-  updated_by_id: z.string().optional(),
+  created_by_id: z.nullable(z.string()).optional(),
+  updated_by_id: z.nullable(z.string()).optional(),
   project_id: z.string(),
   workspace_id: z.string(),
   created: z.string(),
@@ -1108,13 +1108,13 @@ export const RetrieveToolResponseBodyHTTPTool$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("tool_01KTJVKQP5AAZJ0X4DSFWY8VM1"),
+  _id: z.string().default("tool_01KV57XWVQRX3Z7V0DWG32DB17"),
   path: z.string(),
   key: z.string(),
   display_name: z.string().optional(),
   description: z.string(),
-  created_by_id: z.string().optional(),
-  updated_by_id: z.string().optional(),
+  created_by_id: z.nullable(z.string()).optional(),
+  updated_by_id: z.nullable(z.string()).optional(),
   project_id: z.string(),
   workspace_id: z.string(),
   created: z.string(),
@@ -1204,13 +1204,13 @@ export const RetrieveToolResponseBodyJSONSchemaTool$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("tool_01KTJVKQP3GD00QDQSNG0ZMKPQ"),
+  _id: z.string().default("tool_01KV57XWVP2ZPT01TBKEJP613E"),
   path: z.string(),
   key: z.string(),
   display_name: z.string().optional(),
   description: z.string(),
-  created_by_id: z.string().optional(),
-  updated_by_id: z.string().optional(),
+  created_by_id: z.nullable(z.string()).optional(),
+  updated_by_id: z.nullable(z.string()).optional(),
   project_id: z.string(),
   workspace_id: z.string(),
   created: z.string(),
@@ -1310,13 +1310,13 @@ export const RetrieveToolResponseBodyFunctionTool$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("tool_01KTJVKQP287VVYXZH4K6R4F26"),
+  _id: z.string().default("tool_01KV57XWVMN1MRNYJJ2BE2R5H0"),
   path: z.string(),
   key: z.string(),
   display_name: z.string().optional(),
   description: z.string(),
-  created_by_id: z.string().optional(),
-  updated_by_id: z.string().optional(),
+  created_by_id: z.nullable(z.string()).optional(),
+  updated_by_id: z.nullable(z.string()).optional(),
   project_id: z.string(),
   workspace_id: z.string(),
   created: z.string(),