@orq-ai/node 4.12.0-rc.8 → 4.13.0-rc.0

package/src/models/operations/retrievedatapoint.ts

@@ -373,6 +373,125 @@ export type RetrieveDatapointMessages =
   | RetrieveDatapointMessagesAssistantMessage
   | RetrieveDatapointMessagesToolMessage;
 
+/**
+ * The type of evaluation
+ */
+export const RetrieveDatapointEvaluationsDatasetsResponse200EvaluationType = {
+  HumanReview: "human_review",
+} as const;
+/**
+ * The type of evaluation
+ */
+export type RetrieveDatapointEvaluationsDatasetsResponse200EvaluationType =
+  ClosedEnum<
+    typeof RetrieveDatapointEvaluationsDatasetsResponse200EvaluationType
+  >;
+
+export const RetrieveDatapointEvaluationsDatasetsResponse200Source = {
+  Orq: "orq",
+  External: "external",
+} as const;
+export type RetrieveDatapointEvaluationsDatasetsResponse200Source = ClosedEnum<
+  typeof RetrieveDatapointEvaluationsDatasetsResponse200Source
+>;
+
+/**
+ * The kind of annotator that produced the evaluation
+ */
+export const RetrieveDatapointEvaluationsDatasetsResponse200Kind = {
+  Llm: "llm",
+  Code: "code",
+  Human: "human",
+  Automation: "automation",
+} as const;
+/**
+ * The kind of annotator that produced the evaluation
+ */
+export type RetrieveDatapointEvaluationsDatasetsResponse200Kind = ClosedEnum<
+  typeof RetrieveDatapointEvaluationsDatasetsResponse200Kind
+>;
+
+/**
+ * The annotator that produced this evaluation. Optional during the dual-write deprecation window.
+ */
+export type RetrieveDatapointEvaluationsDatasetsResponse200Annotator = {
+  /**
+   * The kind of annotator that produced the evaluation
+   */
+  kind: RetrieveDatapointEvaluationsDatasetsResponse200Kind;
+  /**
+   * Who/what produced this annotation. User/contact id for human, evaluator eval span id for llm/code, automation rule id for automation.
+   */
+  actorId: string;
+};
+
+/**
+ * The expected shape of the value. Derived from the human review type, or inherited from the parent annotation for corrections.
+ */
+export const RetrieveDatapointEvaluationsDatasetsResponse200OutputSchema = {
+  Boolean: "boolean",
+  Number: "number",
+  Categorical: "categorical",
+  String: "string",
+} as const;
+/**
+ * The expected shape of the value. Derived from the human review type, or inherited from the parent annotation for corrections.
+ */
+export type RetrieveDatapointEvaluationsDatasetsResponse200OutputSchema =
+  ClosedEnum<
+    typeof RetrieveDatapointEvaluationsDatasetsResponse200OutputSchema
+  >;
+
+export type RetrieveDatapointEvaluations4 = {
+  /**
+   * The unique identifier of the human evaluation
+   */
+  id: string;
+  /**
+   * The type of evaluation
+   */
+  evaluationType: RetrieveDatapointEvaluationsDatasetsResponse200EvaluationType;
+  /**
+   * The unique identifier of the human review. Omitted on corrections, which inherit the parent evaluator output schema.
+   */
+  humanReviewId?: string | undefined;
+  source: RetrieveDatapointEvaluationsDatasetsResponse200Source;
+  /**
+   * The annotator that produced this evaluation. Optional during the dual-write deprecation window.
+   */
+  annotator?:
+    | RetrieveDatapointEvaluationsDatasetsResponse200Annotator
+    | undefined;
+  /**
+   * The expected shape of the value. Derived from the human review type, or inherited from the parent annotation for corrections.
+   */
+  outputSchema?:
+    | RetrieveDatapointEvaluationsDatasetsResponse200OutputSchema
+    | undefined;
+  /**
+   * When present, references the id of the annotation this entry corrects. Presence of this field marks the entry as a correction.
+   */
+  parentAnnotationId?: string | undefined;
+  /**
+   * Optional free-text explanation of the value
+   */
+  explanation?: string | undefined;
+  /**
+   * Deprecated: use annotator.actor_id. The unique identifier of the user who reviewed the item.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
+   */
+  reviewedById: string;
+  /**
+   * Deprecated. The date and time the item was reviewed
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
+   */
+  reviewedAt: Date;
+  type: "string_array";
+  values: Array<string>;
+};
+
 /**
  * The type of evaluation
  */
@@ -482,8 +601,8 @@ export type RetrieveDatapointEvaluations3 = {
    * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
    */
   reviewedAt: Date;
-  type: "string_array";
-  values: Array<string>;
+  type: "boolean";
+  value: boolean;
 };
 
 /**
@@ -715,7 +834,8 @@ export type RetrieveDatapointEvaluations1 = {
 export type RetrieveDatapointEvaluations =
   | RetrieveDatapointEvaluations1
   | RetrieveDatapointEvaluations2
-  | RetrieveDatapointEvaluations3;
+  | RetrieveDatapointEvaluations3
+  | RetrieveDatapointEvaluations4;
 
 /**
  * Datapoint retrieved.
@@ -754,6 +874,7 @@ export type RetrieveDatapointResponseBody = {
       | RetrieveDatapointEvaluations1
       | RetrieveDatapointEvaluations2
       | RetrieveDatapointEvaluations3
+      | RetrieveDatapointEvaluations4
     >
     | undefined;
   /**
@@ -1381,6 +1502,108 @@ export function retrieveDatapointMessagesFromJSON(
   );
 }
 
+/** @internal */
+export const RetrieveDatapointEvaluationsDatasetsResponse200EvaluationType$inboundSchema:
+  z.ZodNativeEnum<
+    typeof RetrieveDatapointEvaluationsDatasetsResponse200EvaluationType
+  > = z.nativeEnum(
+    RetrieveDatapointEvaluationsDatasetsResponse200EvaluationType,
+  );
+
+/** @internal */
+export const RetrieveDatapointEvaluationsDatasetsResponse200Source$inboundSchema:
+  z.ZodNativeEnum<
+    typeof RetrieveDatapointEvaluationsDatasetsResponse200Source
+  > = z.nativeEnum(RetrieveDatapointEvaluationsDatasetsResponse200Source);
+
+/** @internal */
+export const RetrieveDatapointEvaluationsDatasetsResponse200Kind$inboundSchema:
+  z.ZodNativeEnum<typeof RetrieveDatapointEvaluationsDatasetsResponse200Kind> =
+    z.nativeEnum(RetrieveDatapointEvaluationsDatasetsResponse200Kind);
+
+/** @internal */
+export const RetrieveDatapointEvaluationsDatasetsResponse200Annotator$inboundSchema:
+  z.ZodType<
+    RetrieveDatapointEvaluationsDatasetsResponse200Annotator,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    kind: RetrieveDatapointEvaluationsDatasetsResponse200Kind$inboundSchema,
+    actor_id: z.string(),
+  }).transform((v) => {
+    return remap$(v, {
+      "actor_id": "actorId",
+    });
+  });
+
+export function retrieveDatapointEvaluationsDatasetsResponse200AnnotatorFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  RetrieveDatapointEvaluationsDatasetsResponse200Annotator,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      RetrieveDatapointEvaluationsDatasetsResponse200Annotator$inboundSchema
+        .parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveDatapointEvaluationsDatasetsResponse200Annotator' from JSON`,
+  );
+}
+
+/** @internal */
+export const RetrieveDatapointEvaluationsDatasetsResponse200OutputSchema$inboundSchema:
+  z.ZodNativeEnum<
+    typeof RetrieveDatapointEvaluationsDatasetsResponse200OutputSchema
+  > = z.nativeEnum(RetrieveDatapointEvaluationsDatasetsResponse200OutputSchema);
+
+/** @internal */
+export const RetrieveDatapointEvaluations4$inboundSchema: z.ZodType<
+  RetrieveDatapointEvaluations4,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  evaluation_type:
+    RetrieveDatapointEvaluationsDatasetsResponse200EvaluationType$inboundSchema,
+  human_review_id: z.string().optional(),
+  source: RetrieveDatapointEvaluationsDatasetsResponse200Source$inboundSchema
+    .default("orq"),
+  annotator: z.lazy(() =>
+    RetrieveDatapointEvaluationsDatasetsResponse200Annotator$inboundSchema
+  ).optional(),
+  output_schema:
+    RetrieveDatapointEvaluationsDatasetsResponse200OutputSchema$inboundSchema
+      .optional(),
+  parent_annotation_id: z.string().optional(),
+  explanation: z.string().optional(),
+  reviewed_by_id: z.string(),
+  reviewed_at: z.string().datetime({ offset: true }).default(
+    "2026-07-22T22:32:55.224Z",
+  ).transform(v => new Date(v)),
+  type: z.literal("string_array"),
+  values: z.array(z.string()),
+}).transform((v) => {
+  return remap$(v, {
+    "evaluation_type": "evaluationType",
+    "human_review_id": "humanReviewId",
+    "output_schema": "outputSchema",
+    "parent_annotation_id": "parentAnnotationId",
+    "reviewed_by_id": "reviewedById",
+    "reviewed_at": "reviewedAt",
+  });
+});
+
+export function retrieveDatapointEvaluations4FromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveDatapointEvaluations4, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveDatapointEvaluations4$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveDatapointEvaluations4' from JSON`,
+  );
+}
+
 /** @internal */
 export const RetrieveDatapointEvaluationsDatasetsResponseEvaluationType$inboundSchema:
   z.ZodNativeEnum<
@@ -1456,10 +1679,10 @@ export const RetrieveDatapointEvaluations3$inboundSchema: z.ZodType<
   explanation: z.string().optional(),
   reviewed_by_id: z.string(),
   reviewed_at: z.string().datetime({ offset: true }).default(
-    "2026-07-08T12:34:58.400Z",
+    "2026-07-22T22:32:55.222Z",
   ).transform(v => new Date(v)),
-  type: z.literal("string_array"),
-  values: z.array(z.string()),
+  type: z.literal("boolean"),
+  value: z.boolean(),
 }).transform((v) => {
   return remap$(v, {
     "evaluation_type": "evaluationType",
@@ -1554,7 +1777,7 @@ export const RetrieveDatapointEvaluations2$inboundSchema: z.ZodType<
   explanation: z.string().optional(),
   reviewed_by_id: z.string(),
   reviewed_at: z.string().datetime({ offset: true }).default(
-    "2026-07-08T12:34:58.398Z",
+    "2026-07-22T22:32:55.220Z",
   ).transform(v => new Date(v)),
   type: z.literal("number"),
   value: z.number(),
@@ -1642,7 +1865,7 @@ export const RetrieveDatapointEvaluations1$inboundSchema: z.ZodType<
   explanation: z.string().optional(),
   reviewed_by_id: z.string(),
   reviewed_at: z.string().datetime({ offset: true }).default(
-    "2026-07-08T12:34:58.397Z",
+    "2026-07-22T22:32:55.218Z",
   ).transform(v => new Date(v)),
   type: z.literal("string"),
   value: z.string(),
@@ -1676,6 +1899,7 @@ export const RetrieveDatapointEvaluations$inboundSchema: z.ZodType<
   z.lazy(() => RetrieveDatapointEvaluations1$inboundSchema),
   z.lazy(() => RetrieveDatapointEvaluations2$inboundSchema),
   z.lazy(() => RetrieveDatapointEvaluations3$inboundSchema),
+  z.lazy(() => RetrieveDatapointEvaluations4$inboundSchema),
 ]);
 
 export function retrieveDatapointEvaluationsFromJSON(
@@ -1712,6 +1936,7 @@ export const RetrieveDatapointResponseBody$inboundSchema: z.ZodType<
       z.lazy(() => RetrieveDatapointEvaluations1$inboundSchema),
       z.lazy(() => RetrieveDatapointEvaluations2$inboundSchema),
       z.lazy(() => RetrieveDatapointEvaluations3$inboundSchema),
+      z.lazy(() => RetrieveDatapointEvaluations4$inboundSchema),
     ]),
   ).optional(),
   dataset_id: z.string(),
@@ -1721,7 +1946,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-07-08T12:34:32.945Z",
+    "2026-07-22T22:32:36.266Z",
   ).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-07-08T12:34:32.945Z",
+    "2026-07-22T22:32:36.266Z",
   ).transform(v => new Date(v)),
 }).transform((v) => {
   return remap$(v, {

package/src/models/operations/retrievedatasource.ts

@@ -4,7 +4,10 @@
 
 import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
-import { safeParse } from "../../lib/schemas.js";
+import {
+  collectExtraKeys as collectExtraKeys$,
+  safeParse,
+} from "../../lib/schemas.js";
 import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
@@ -31,6 +34,34 @@ export type RetrieveDatasourceStatus = ClosedEnum<
   typeof RetrieveDatasourceStatus
 >;
 
+export type RetrieveDatasourceMetadata = {
+  /**
+   * Number of words in the text
+   */
+  wordsCount?: number | undefined;
+  /**
+   * Number of sentences in the text
+   */
+  sentencesCount?: number | undefined;
+  /**
+   * Number of paragraphs in the text
+   */
+  paragraphsCount?: number | undefined;
+  /**
+   * Number of tokens in the text
+   */
+  tokensCount?: number | undefined;
+  /**
+   * Number of characters in the text
+   */
+  charactersCount?: number | undefined;
+  /**
+   * Number of total chunks
+   */
+  chunksCount?: number | undefined;
+  additionalProperties?: { [k: string]: any } | undefined;
+};
+
 /**
  * Datasource successfully retrieved
  */
@@ -76,6 +107,7 @@ export type RetrieveDatasourceResponseBody = {
    * The number of chunks in the datasource
    */
   chunksCount: number;
+  metadata: RetrieveDatasourceMetadata;
 };
 
 /** @internal */
@@ -112,13 +144,50 @@ export const RetrieveDatasourceStatus$inboundSchema: z.ZodNativeEnum<
   typeof RetrieveDatasourceStatus
 > = z.nativeEnum(RetrieveDatasourceStatus);
 
+/** @internal */
+export const RetrieveDatasourceMetadata$inboundSchema: z.ZodType<
+  RetrieveDatasourceMetadata,
+  z.ZodTypeDef,
+  unknown
+> = collectExtraKeys$(
+  z.object({
+    words_count: z.number().optional(),
+    sentences_count: z.number().optional(),
+    paragraphs_count: z.number().optional(),
+    tokens_count: z.number().optional(),
+    characters_count: z.number().optional(),
+    chunks_count: z.number().optional(),
+  }).catchall(z.any()),
+  "additionalProperties",
+  true,
+).transform((v) => {
+  return remap$(v, {
+    "words_count": "wordsCount",
+    "sentences_count": "sentencesCount",
+    "paragraphs_count": "paragraphsCount",
+    "tokens_count": "tokensCount",
+    "characters_count": "charactersCount",
+    "chunks_count": "chunksCount",
+  });
+});
+
+export function retrieveDatasourceMetadataFromJSON(
+  jsonString: string,
+): SafeParseResult<RetrieveDatasourceMetadata, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RetrieveDatasourceMetadata$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RetrieveDatasourceMetadata' from JSON`,
+  );
+}
+
 /** @internal */
 export const RetrieveDatasourceResponseBody$inboundSchema: z.ZodType<
   RetrieveDatasourceResponseBody,
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("01KX0VJTKWAED6M7DK3ZNW61VY"),
+  _id: z.string().default("01KY5ZBRJKRQ6JRPHPYT4J147P"),
   display_name: z.string(),
   description: z.nullable(z.string()).optional(),
   status: RetrieveDatasourceStatus$inboundSchema,
@@ -129,6 +198,7 @@ export const RetrieveDatasourceResponseBody$inboundSchema: z.ZodType<
   update_by_id: z.nullable(z.string()).optional(),
   knowledge_id: z.string(),
   chunks_count: z.number(),
+  metadata: z.lazy(() => RetrieveDatasourceMetadata$inboundSchema),
 }).transform((v) => {
   return remap$(v, {
     "_id": "id",

package/src/models/operations/retrieveresponse.ts

@@ -53,10 +53,10 @@ export type RetrieveResponseResponseBody = {
   completedAt: number | null;
   conversation?: components.ConversationParam | undefined;
   createdAt: number;
-  error: components.ResponseError;
+  error: components.ResponseError | null;
   frequencyPenalty: number;
   id: string;
-  incompleteDetails: components.IncompleteDetails;
+  incompleteDetails: components.IncompleteDetails | null;
   /**
    * Array of input items (messages, function call outputs, etc.)
    */
@@ -83,7 +83,7 @@ export type RetrieveResponseResponseBody = {
   previousResponseId: string | null;
   promptCacheKey: string | null;
   promptCacheRetention: string | null;
-  reasoning: components.Reasoning;
+  reasoning: components.Reasoning | null;
   safetyIdentifier: string | null;
   serviceTier: RetrieveResponseServiceTier;
   status: RetrieveResponseStatus;
@@ -104,7 +104,7 @@ export type RetrieveResponseResponseBody = {
   topLogprobs: number;
   topP: number;
   truncation: RetrieveResponseTruncation;
-  usage: components.PublicUsage;
+  usage: components.PublicUsage | null;
   user: string | null;
   variables?: { [k: string]: any } | undefined;
 };
@@ -160,10 +160,10 @@ export const RetrieveResponseResponseBody$inboundSchema: z.ZodType<
   completed_at: z.nullable(z.number().int()),
   conversation: components.ConversationParam$inboundSchema.optional(),
   created_at: z.number().int(),
-  error: components.ResponseError$inboundSchema,
+  error: z.nullable(components.ResponseError$inboundSchema),
   frequency_penalty: z.number(),
   id: z.string(),
-  incomplete_details: components.IncompleteDetails$inboundSchema,
+  incomplete_details: z.nullable(components.IncompleteDetails$inboundSchema),
   input: z.nullable(z.array(z.any())),
   instructions: z.nullable(z.string()),
   max_output_tokens: z.nullable(z.number().int()),
@@ -178,7 +178,7 @@ export const RetrieveResponseResponseBody$inboundSchema: z.ZodType<
   previous_response_id: z.nullable(z.string()),
   prompt_cache_key: z.nullable(z.string()),
   prompt_cache_retention: z.nullable(z.string()),
-  reasoning: components.Reasoning$inboundSchema,
+  reasoning: z.nullable(components.Reasoning$inboundSchema),
   safety_identifier: z.nullable(z.string()),
   service_tier: RetrieveResponseServiceTier$inboundSchema,
   status: RetrieveResponseStatus$inboundSchema,
@@ -190,7 +190,7 @@ export const RetrieveResponseResponseBody$inboundSchema: z.ZodType<
   top_logprobs: z.number().int(),
   top_p: z.number(),
   truncation: RetrieveResponseTruncation$inboundSchema,
-  usage: components.PublicUsage$inboundSchema,
+  usage: z.nullable(components.PublicUsage$inboundSchema),
   user: z.nullable(z.string()),
   variables: z.record(z.any()).optional(),
 }).transform((v) => {

package/src/models/operations/retrievetool.ts

@@ -319,6 +319,10 @@ export type RetrieveToolResponseBodyBlueprint = {
    * The body to send with the request.
    */
   body?: { [k: string]: any } | undefined;
+  /**
+   * The request timeout in seconds. Defaults to 60 seconds when not set. When used in an agent, tool executions are also bound by the agent run `limits.tool_timeout` (default 5 minutes), so raise that limit for longer-running tools.
+   */
+  timeout?: number | undefined;
 };
 
 /**
@@ -753,7 +757,7 @@ export const RetrieveToolResponseBodyCodeExecutionTool$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("tool_01KX0VJTFA1WJEXJBZ8574VX8S"),
+  _id: z.string().default("tool_01KY5ZBRF6DW4FM09SGBT9YPRH"),
   path: z.string(),
   key: z.string(),
   display_name: z.string().optional(),
@@ -859,7 +863,7 @@ export const RetrieveToolResponseBodyTools$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  id: z.string().default("01KX0VJTF9Y5Q7RC71BRJJ5TW1"),
+  id: z.string().default("01KY5ZBRF5M1CYGHFRX7W0ARBX"),
   name: z.string(),
   description: z.string().optional(),
   schema: z.lazy(() => RetrieveToolResponseBodyToolsSchema$inboundSchema),
@@ -917,7 +921,7 @@ export const RetrieveToolResponseBodyMCPTool$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("tool_01KX0VJTF7XDFC5QDMJZS31WYP"),
+  _id: z.string().default("tool_01KY5ZBRF3FRAGGAHXJR2T84YF"),
   path: z.string(),
   key: z.string(),
   display_name: z.string().optional(),
@@ -1014,6 +1018,7 @@ export const RetrieveToolResponseBodyBlueprint$inboundSchema: z.ZodType<
     z.union([z.lazy(() => RetrieveToolHeaders2$inboundSchema), z.string()]),
   ).optional(),
   body: z.record(z.any()).optional(),
+  timeout: z.number().optional(),
 });
 
 export function retrieveToolResponseBodyBlueprintFromJSON(
@@ -1108,7 +1113,7 @@ export const RetrieveToolResponseBodyHTTPTool$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("tool_01KX0VJTF4BGCZ8SS2V3ZDA2TG"),
+  _id: z.string().default("tool_01KY5ZBRF04AEEWCB7R0JYCP9J"),
   path: z.string(),
   key: z.string(),
   display_name: z.string().optional(),
@@ -1204,7 +1209,7 @@ export const RetrieveToolResponseBodyJSONSchemaTool$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("tool_01KX0VJTF1ZGBYNCCS3P2E3ZDH"),
+  _id: z.string().default("tool_01KY5ZBREYAJSRTBPYK9JKFW4T"),
   path: z.string(),
   key: z.string(),
   display_name: z.string().optional(),
@@ -1310,7 +1315,7 @@ export const RetrieveToolResponseBodyFunctionTool$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("tool_01KX0VJTEZBPAQXCSF3ND7NRB6"),
+  _id: z.string().default("tool_01KY5ZBREW5YNF87121Z014400"),
   path: z.string(),
   key: z.string(),
   display_name: z.string().optional(),