@orq-ai/node 4.2.0-rc.13 → 4.2.0-rc.21

package/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_01kergt7zemjn0dy6m47k8xkym"),
   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_01kergt7zemjn0dy6m47k8xkym"),
   kind: CreateConversationKind$outboundSchema,
   displayName: z.string(),
   createdAt: z.number(),