@orq-ai/node 4.1.9 → 4.1.11

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

@@ -718,6 +718,38 @@ export type Prompt = {
   version: Version;
 };
 
+/**
+ * @deprecated Use identity instead. Information about the contact making the request.
+ *
+ * @deprecated class: This will be removed in a future release, please migrate away from it as soon as possible.
+ */
+export type CreateChatCompletionContact = {
+  /**
+   * Unique identifier for the contact
+   */
+  id: string;
+  /**
+   * Display name of the contact
+   */
+  displayName?: string | undefined;
+  /**
+   * Email address of the contact
+   */
+  email?: string | undefined;
+  /**
+   * A hash of key/value pairs containing any other data about the contact
+   */
+  metadata?: Array<{ [k: string]: any }> | undefined;
+  /**
+   * URL to the contact's avatar or logo
+   */
+  logoUrl?: string | undefined;
+  /**
+   * A list of tags associated with the contact
+   */
+  tags?: Array<string> | undefined;
+};
+
 /**
  * Thread information to group related requests
  */
@@ -1211,7 +1243,7 @@ export type Timeout = {
 };
 
 /**
- * Leverage Orq's intelligent routing capabilities to enhance your AI application with enterprise-grade reliability and observability. Orq provides automatic request management including retries on failures, model fallbacks for high availability, contact-level analytics tracking, conversation threading, and dynamic prompt templating with variable substitution.
+ * Leverage Orq's intelligent routing capabilities to enhance your AI application with enterprise-grade reliability and observability. Orq provides automatic request management including retries on failures, model fallbacks for high availability, identity-level analytics tracking, conversation threading, and dynamic prompt templating with variable substitution.
  */
 export type Orq = {
   /**
@@ -1231,9 +1263,10 @@ export type Orq = {
    */
   prompt?: Prompt | undefined;
   /**
-   * Information about the contact making the request. If the contact does not exist, it will be created automatically.
+   * Information about the identity making the request. If the identity does not exist, it will be created automatically.
    */
-  contact?: components.PublicContact | undefined;
+  identity?: components.PublicContact | undefined;
+  contact?: CreateChatCompletionContact | undefined;
   /**
    * Thread information to group related requests
    */
@@ -1389,7 +1422,7 @@ export type CreateChatCompletionRequestBody = {
    */
   guardrails?: Array<CreateChatCompletionGuardrails> | undefined;
   /**
-   * Leverage Orq's intelligent routing capabilities to enhance your AI application with enterprise-grade reliability and observability. Orq provides automatic request management including retries on failures, model fallbacks for high availability, contact-level analytics tracking, conversation threading, and dynamic prompt templating with variable substitution.
+   * Leverage Orq's intelligent routing capabilities to enhance your AI application with enterprise-grade reliability and observability. Orq provides automatic request management including retries on failures, model fallbacks for high availability, identity-level analytics tracking, conversation threading, and dynamic prompt templating with variable substitution.
    */
   orq?: Orq | undefined;
   stream?: boolean | undefined;
@@ -4220,6 +4253,72 @@ export function promptFromJSON(
   );
 }
 
+/** @internal */
+export const CreateChatCompletionContact$inboundSchema: z.ZodType<
+  CreateChatCompletionContact,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  display_name: z.string().optional(),
+  email: z.string().optional(),
+  metadata: z.array(z.record(z.any())).optional(),
+  logo_url: z.string().optional(),
+  tags: z.array(z.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "display_name": "displayName",
+    "logo_url": "logoUrl",
+  });
+});
+/** @internal */
+export type CreateChatCompletionContact$Outbound = {
+  id: string;
+  display_name?: string | undefined;
+  email?: string | undefined;
+  metadata?: Array<{ [k: string]: any }> | undefined;
+  logo_url?: string | undefined;
+  tags?: Array<string> | undefined;
+};
+
+/** @internal */
+export const CreateChatCompletionContact$outboundSchema: z.ZodType<
+  CreateChatCompletionContact$Outbound,
+  z.ZodTypeDef,
+  CreateChatCompletionContact
+> = z.object({
+  id: z.string(),
+  displayName: z.string().optional(),
+  email: z.string().optional(),
+  metadata: z.array(z.record(z.any())).optional(),
+  logoUrl: z.string().optional(),
+  tags: z.array(z.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    displayName: "display_name",
+    logoUrl: "logo_url",
+  });
+});
+
+export function createChatCompletionContactToJSON(
+  createChatCompletionContact: CreateChatCompletionContact,
+): string {
+  return JSON.stringify(
+    CreateChatCompletionContact$outboundSchema.parse(
+      createChatCompletionContact,
+    ),
+  );
+}
+export function createChatCompletionContactFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateChatCompletionContact, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateChatCompletionContact$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateChatCompletionContact' from JSON`,
+  );
+}
+
 /** @internal */
 export const CreateChatCompletionThread$inboundSchema: z.ZodType<
   CreateChatCompletionThread,
@@ -6746,7 +6845,8 @@ export const Orq$inboundSchema: z.ZodType<Orq, z.ZodTypeDef, unknown> = z
     retry: z.lazy(() => CreateChatCompletionRetry$inboundSchema).optional(),
     fallbacks: z.array(z.lazy(() => Fallbacks$inboundSchema)).optional(),
     prompt: z.lazy(() => Prompt$inboundSchema).optional(),
-    contact: components.PublicContact$inboundSchema.optional(),
+    identity: components.PublicContact$inboundSchema.optional(),
+    contact: z.lazy(() => CreateChatCompletionContact$inboundSchema).optional(),
     thread: z.lazy(() => CreateChatCompletionThread$inboundSchema).optional(),
     inputs: z.union([
       z.record(z.any()),
@@ -6771,7 +6871,8 @@ export type Orq$Outbound = {
   retry?: CreateChatCompletionRetry$Outbound | undefined;
   fallbacks?: Array<Fallbacks$Outbound> | undefined;
   prompt?: Prompt$Outbound | undefined;
-  contact?: components.PublicContact$Outbound | undefined;
+  identity?: components.PublicContact$Outbound | undefined;
+  contact?: CreateChatCompletionContact$Outbound | undefined;
   thread?: CreateChatCompletionThread$Outbound | undefined;
   inputs?: { [k: string]: any } | Array<Inputs2$Outbound> | undefined;
   cache?: Cache$Outbound | undefined;
@@ -6789,7 +6890,9 @@ export const Orq$outboundSchema: z.ZodType<Orq$Outbound, z.ZodTypeDef, Orq> = z
     retry: z.lazy(() => CreateChatCompletionRetry$outboundSchema).optional(),
     fallbacks: z.array(z.lazy(() => Fallbacks$outboundSchema)).optional(),
     prompt: z.lazy(() => Prompt$outboundSchema).optional(),
-    contact: components.PublicContact$outboundSchema.optional(),
+    identity: components.PublicContact$outboundSchema.optional(),
+    contact: z.lazy(() => CreateChatCompletionContact$outboundSchema)
+      .optional(),
     thread: z.lazy(() => CreateChatCompletionThread$outboundSchema).optional(),
     inputs: z.union([
       z.record(z.any()),

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

@@ -167,7 +167,7 @@ export const CreateContactResponseBody$inboundSchema: z.ZodType<
   created: z.string().datetime({ offset: true }).transform(v => new Date(v))
     .optional(),
   updated: z.string().datetime({ offset: true }).default(
-    "2026-01-07T04:59:57.150Z",
+    "2026-01-13T10:29:20.072Z",
   ).transform(v => new Date(v)),
 }).transform((v) => {
   return remap$(v, {
@@ -207,7 +207,7 @@ export const CreateContactResponseBody$outboundSchema: z.ZodType<
   tags: z.array(z.string()).optional(),
   metadata: z.record(z.any()).optional(),
   created: z.date().transform(v => v.toISOString()).optional(),
-  updated: z.date().default(() => new Date("2026-01-07T04:59:57.150Z"))
+  updated: z.date().default(() => new Date("2026-01-13T10:29:20.072Z"))
     .transform(v => v.toISOString()),
 }).transform((v) => {
   return remap$(v, {

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

@@ -9,45 +9,66 @@ import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
+/**
+ * Optional metadata to attach to the conversation.
+ */
 export type CreateConversationMetadata = {
+  /**
+   * Set to `true` to indicate the title is being auto-generated.
+   */
   generatingTitle?: boolean | undefined;
   /**
-   * Identifier of the parent entity (agent, deployment, etc.) this conversation belongs to.
+   * Parent entity identifier to associate the conversation with. Omit or set to `null` for standalone conversations.
    */
-  entityId: string;
+  entityId?: string | null | undefined;
+  /**
+   * Model identifier in `provider/model_id` format for standalone conversations. Omit or set to `null` for entity-bound conversations.
+   */
+  model?: string | null | undefined;
 };
 
 export type CreateConversationRequestBody = {
   /**
-   * Display name for the conversation. Defaults to "Untitled" if not provided.
+   * Human-readable name for the conversation. Defaults to "Untitled" if omitted.
    */
   displayName?: string | undefined;
-  metadata: CreateConversationMetadata;
+  /**
+   * Project identifier to associate the conversation with.
+   */
+  projectId: string;
+  /**
+   * Optional metadata to attach to the conversation.
+   */
+  metadata?: CreateConversationMetadata | undefined;
 };
 
 /**
- * Type discriminator indicating this is a conversation
+ * Resource type discriminator.
  */
 export const CreateConversationKind = {
   Conversation: "conversation",
 } as const;
 /**
- * Type discriminator indicating this is a conversation
+ * Resource type discriminator.
  */
 export type CreateConversationKind = ClosedEnum<typeof CreateConversationKind>;
 
 /**
- * Optional metadata associated with the conversation.
+ * Additional conversation metadata.
  */
 export type CreateConversationConversationsMetadata = {
   /**
-   * Indicates whether the conversation title is currently being generated by AI.
+   * When `true`, indicates the conversation title is being auto-generated.
    */
   generatingTitle?: boolean | undefined;
   /**
-   * Identifier of the parent entity (agent, deployment, etc.) this conversation belongs to. Used for filtering conversations by entity.
+   * Parent entity identifier (e.g., agent or deployment). Set to `null` for standalone conversations.
    */
-  entityId?: string | undefined;
+  entityId?: string | null | undefined;
+  /**
+   * Model identifier for standalone conversations in `provider/model_id` format. Set to `null` for entity-bound conversations.
+   */
+  model?: string | null | undefined;
 };
 
 /**
@@ -55,39 +76,35 @@ export type CreateConversationConversationsMetadata = {
  */
 export type CreateConversationResponseBody = {
   /**
-   * Unique ULID (Universally Unique Lexicographically Sortable Identifier) for the conversation, prefixed with "conv_"
+   * Unique conversation identifier with `conv_` prefix.
    */
   id?: string | undefined;
   /**
-   * Identifier of the parent entity (agent, deployment, etc.) this conversation belongs to.
-   */
-  entityId: string;
-  /**
-   * Type discriminator indicating this is a conversation
+   * Resource type discriminator.
    */
   kind: CreateConversationKind;
   /**
-   * Display name for the conversation. Can be auto-generated or set by the user.
+   * Human-readable name for the conversation. Maximum 100 characters.
    */
   displayName: string;
   /**
-   * Unix timestamp (in milliseconds) when the conversation was created
+   * Unix timestamp in milliseconds when the conversation was created.
    */
   createdAt: number;
   /**
-   * Unix timestamp (in milliseconds) when the conversation was last updated
+   * Unix timestamp in milliseconds when the conversation was last modified.
    */
   updatedAt: number;
   /**
-   * Optional identifier of the user or agent that created the conversation
+   * Identifier of the user or system that created the conversation.
    */
   createdById?: string | undefined;
   /**
-   * Optional identifier of the user or agent that last updated the conversation
+   * Identifier of the user or system that last modified the conversation.
    */
   updatedById?: string | undefined;
   /**
-   * Optional metadata associated with the conversation.
+   * Additional conversation metadata.
    */
   metadata?: CreateConversationConversationsMetadata | undefined;
 };
@@ -99,12 +116,14 @@ export const CreateConversationMetadata$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   generatingTitle: z.boolean().optional(),
-  entityId: z.string(),
+  entityId: z.nullable(z.string()).optional(),
+  model: z.nullable(z.string()).optional(),
 });
 /** @internal */
 export type CreateConversationMetadata$Outbound = {
   generatingTitle?: boolean | undefined;
-  entityId: string;
+  entityId?: string | null | undefined;
+  model?: string | null | undefined;
 };
 
 /** @internal */
@@ -114,7 +133,8 @@ export const CreateConversationMetadata$outboundSchema: z.ZodType<
   CreateConversationMetadata
 > = z.object({
   generatingTitle: z.boolean().optional(),
-  entityId: z.string(),
+  entityId: z.nullable(z.string()).optional(),
+  model: z.nullable(z.string()).optional(),
 });
 
 export function createConversationMetadataToJSON(
@@ -141,12 +161,14 @@ export const CreateConversationRequestBody$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   displayName: z.string().default("Untitled"),
-  metadata: z.lazy(() => CreateConversationMetadata$inboundSchema),
+  projectId: z.string(),
+  metadata: z.lazy(() => CreateConversationMetadata$inboundSchema).optional(),
 });
 /** @internal */
 export type CreateConversationRequestBody$Outbound = {
   displayName: string;
-  metadata: CreateConversationMetadata$Outbound;
+  projectId: string;
+  metadata?: CreateConversationMetadata$Outbound | undefined;
 };
 
 /** @internal */
@@ -156,7 +178,8 @@ export const CreateConversationRequestBody$outboundSchema: z.ZodType<
   CreateConversationRequestBody
 > = z.object({
   displayName: z.string().default("Untitled"),
-  metadata: z.lazy(() => CreateConversationMetadata$outboundSchema),
+  projectId: z.string(),
+  metadata: z.lazy(() => CreateConversationMetadata$outboundSchema).optional(),
 });
 
 export function createConversationRequestBodyToJSON(
@@ -194,12 +217,14 @@ export const CreateConversationConversationsMetadata$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   generatingTitle: z.boolean().optional(),
-  entityId: z.string().optional(),
+  entityId: z.nullable(z.string()).optional(),
+  model: z.nullable(z.string()).optional(),
 });
 /** @internal */
 export type CreateConversationConversationsMetadata$Outbound = {
   generatingTitle?: boolean | undefined;
-  entityId?: string | undefined;
+  entityId?: string | null | undefined;
+  model?: string | null | undefined;
 };
 
 /** @internal */
@@ -209,7 +234,8 @@ export const CreateConversationConversationsMetadata$outboundSchema: z.ZodType<
   CreateConversationConversationsMetadata
 > = z.object({
   generatingTitle: z.boolean().optional(),
-  entityId: z.string().optional(),
+  entityId: z.nullable(z.string()).optional(),
+  model: z.nullable(z.string()).optional(),
 });
 
 export function createConversationConversationsMetadataToJSON(
@@ -244,8 +270,7 @@ export const CreateConversationResponseBody$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("conv_01kebd76qdfdddzex75339szmn"),
-  entityId: z.string(),
+  _id: z.string().default("conv_01keveeqc66by3b4g2n3cs72hj"),
   kind: CreateConversationKind$inboundSchema,
   displayName: z.string(),
   createdAt: z.number(),
@@ -262,7 +287,6 @@ export const CreateConversationResponseBody$inboundSchema: z.ZodType<
 /** @internal */
 export type CreateConversationResponseBody$Outbound = {
   _id: string;
-  entityId: string;
   kind: string;
   displayName: string;
   createdAt: number;
@@ -278,8 +302,7 @@ export const CreateConversationResponseBody$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   CreateConversationResponseBody
 > = z.object({
-  id: z.string().default("conv_01kebd76qdfdddzex75339szmn"),
-  entityId: z.string(),
+  id: z.string().default("conv_01keveeqc66by3b4g2n3cs72hj"),
   kind: CreateConversationKind$outboundSchema,
   displayName: z.string(),
   createdAt: z.number(),