@dremio/js-sdk 0.45.1 → 0.45.3

package/README.md

@@ -360,6 +360,43 @@ const history = await conversation.history();
 console.log(`Conversation has ${history.length} events`);
 ```
 
+#### Stop a Run
+
+Stop the currently active run for a conversation:
+
+```typescript
+await conversation.stopRun(runId);
+```
+
+Note: Only one run can be active per conversation at a time.
+
+#### Clone a Conversation
+
+Create a copy of the conversation instance:
+
+```typescript
+const conversationCopy = conversation.clone();
+```
+
+#### Serialize Conversation
+
+Convert the conversation to a plain JSON object:
+
+```typescript
+const json = conversation.toJSON();
+console.log(json);
+// {
+//   id: "...",
+//   title: "...",
+//   createdAt: Temporal.Instant,
+//   modifiedAt: Temporal.Instant,
+//   currentRunId: "..." | null,
+//   modelName: "..." | null,
+//   modelProviderId: "..." | null,
+//   tag: "..."
+// }
+```
+
 ### Working with Chat Events
 
 The state of a conversation is represented as a stream of `ChatEvent` objects. These events include user messages, tool call requests and results, and Agent replies. While the event stream enables incremental UI updates, it contains implicit relationships that need to be made explicit for easier consumption.
@@ -371,16 +408,36 @@ The state of a conversation is represented as a stream of `ChatEvent` objects. T
 - `toolRequest` - A request to execute a tool (tool calls can run in parallel)
 - `toolResponse` - The result of a tool execution
 - `error` - An error message
+- `conversationUpdate` - Updates to conversation metadata (title, summary)
+- `endOfStream` - Marks the end of a run's event stream
 
 #### Building a Conversation Snapshot
 
-The `AgentConversation.reduceChatEvents()` method transforms a stream of chat events into a structured snapshot that makes implicit relationships explicit:
+The `AgentConversation.reduceChatEvents()` method is a pure reducer function that transforms a stream of chat events into a structured snapshot that makes implicit relationships explicit.
+
+**Function Signature:**
+
+```typescript
+function reduceChatEvents(
+  state: ConversationExchange[],
+  chatEvents: ChatEvent[],
+): ConversationExchange[];
+```
+
+**What it does:**
 
 - **Groups events by exchange** - Each user-agent interaction (identified by `runId`) becomes a separate exchange
 - **Pairs tool calls** - Tool requests and responses are matched by `callId` and combined into a single object
-- **Derives tool state** - Automatically determines if a tool call is `pending`, `success`, or `error`
-- **Handles duplicates** - Efficiently filters duplicate events when merging history and live streams
-- **Preserves order** - Maintains insertion order for messages and tool calls
+- **Derives tool state** - Automatically determines if a tool call is `pending`, `success`, `error`, or `canceled`
+  - `pending` - Tool request received but no response yet
+  - `success` - Tool response received without error
+  - `error` - Tool response received with error message
+  - `canceled` - End of stream reached without receiving a response
+- **Handles duplicates** - Efficiently filters duplicate events when merging history and live streams (events with the same `id` are deduplicated)
+- **Preserves order** - Maintains insertion order for messages and tool calls using `Map` data structures
+- **Immutable updates** - Uses structural sharing to efficiently create new snapshots without mutating the original state
+
+**Basic Usage:**
 
 ```typescript
 import { AgentConversation } from "@dremio/js-sdk/enterprise/ai";
@@ -404,12 +461,53 @@ type ConversationExchange = {
   submittedUserMessage?: UserChatMessage;
 };
 
+type ConversationExchangeMessage =
+  | ChatEventWithChunkType<"error">
+  | ChatEventWithChunkType<"model">
+  | ChatEventWithChunkType<"userMessage">;
+
 type AgentToolCall = {
   id: string;
-  state: "error" | "pending" | "success";
+  state: "canceled" | "error" | "pending" | "success";
   request: ChatEventWithChunkType<"toolRequest"> | undefined;
   result: ChatEventWithChunkType<"toolResponse"> | undefined;
 };
+
+// ChatEvent is the base type for all events in the stream
+type ChatEvent = {
+  id: string;
+  conversationId: string;
+  runId: string;
+  createdAt: Temporal.Instant;
+  modelName: string;
+  modelProviderId: string;
+  role: "agent" | "user";
+  content:
+    | { chunkType: "conversationUpdate"; title?: string; summary?: string }
+    | { chunkType: "endOfStream" }
+    | { chunkType: "error"; message: string }
+    | { chunkType: "model"; name: string; result: Record<string, unknown> }
+    | {
+        chunkType: "toolRequest";
+        callId: string;
+        name: string;
+        arguments: Record<string, unknown>;
+        commentary?: string;
+        summarizedTitle?: string;
+      }
+    | {
+        chunkType: "toolResponse";
+        callId: string;
+        name: string;
+        result: Record<string, unknown>;
+        commentary?: string;
+      }
+    | { chunkType: "userMessage"; text: string };
+};
+
+// ChatEventWithChunkType is a helper type to extract events by their chunk type
+type ChatEventWithChunkType<T extends ChatEvent["content"]["chunkType"]> =
+  Extract<ChatEvent, { content: { chunkType: T } }>;
 ```
 
 #### Incremental Updates
@@ -504,16 +602,60 @@ actor.send({
 - `uninitialized` - Initial state before conversation is created
 - `creating_conversation` - Creating a new conversation
 - `retrieving_history` - Fetching conversation history
+- `retrieve_history_failed` - Error state when history retrieval fails
 - `idle` - Ready to accept new messages
 - `submitting_message` - Sending a user message
-- `streaming` - Receiving agent responses
-- `retrieve_history_failed` - Error state when history retrieval fails
+- `submitting_message_failed` - Error state when message submission fails
+- `streaming` - Receiving agent responses (with substates: `monitoring_replies`, `stopping`)
 
 #### Machine Events
 
-- `SUBMIT_USER_MESSAGE` - Send a new message
+- `SUBMIT_USER_MESSAGE` - Send a new message with a `UserChatMessage`
+- `RETRY_MESSAGE` - Retry sending the last failed message
 - `REFRESH_HISTORY` - Reload conversation history
-- `CANCEL_RUN` - Cancel the current run
+- `STOP_RUN` - Stop the current run
+
+#### Machine Context
+
+The machine maintains the following context:
+
+```typescript
+type ConversationMachineContext = {
+  conversationId: string | null;
+  conversationSnapshot?: ConversationExchange[];
+  currentRunId?: string | null;
+  lastError?: unknown;
+  messageAttempt?: UserChatMessage;
+};
+```
+
+#### Machine Emitted Events
+
+The machine emits the following events that can be subscribed to:
+
+```typescript
+type ConversationMachineEmitted =
+  | { type: "apiError"; error: HttpError }
+  | { type: "chatEventReceived"; chatEvent: ChatEvent }
+  | { type: "conversationCreated"; id: string };
+```
+
+Subscribe to emitted events:
+
+```typescript
+actor.subscribe((snapshot) => {
+  // Access emitted events through snapshot
+  console.log("State:", snapshot.value);
+  console.log("Context:", snapshot.context);
+});
+
+// Or use the system to listen for specific events
+actor.system.subscribe((event) => {
+  if (event.type === "chatEventReceived") {
+    console.log("New chat event:", event.chatEvent);
+  }
+});
+```
 
 ## Catalog
 

package/dist/cloud/ai/AIResource.d.ts

@@ -96,7 +96,7 @@ export declare class AIResource {
             modelProviderId: string | null;
             modifiedAt: import("temporal-polyfill").Temporal.Instant;
             tag: string;
-            title: string;
+            title: string | null;
         }, {
             conversationId: string;
         }, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<{
@@ -204,7 +204,7 @@ export declare class AIResource {
                 modelProviderId: string | null;
                 modifiedAt: import("temporal-polyfill").Temporal.Instant;
                 tag: string;
-                title: string;
+                title: string | null;
             };
             history: {
                 data: ({
@@ -312,7 +312,7 @@ export declare class AIResource {
                 modelProviderId: string | null;
                 modifiedAt: import("temporal-polyfill").Temporal.Instant;
                 tag: string;
-                title: string;
+                title: string | null;
             };
             currentRunId: string;
         }, {
@@ -435,7 +435,7 @@ export declare class AIResource {
             modelProviderId: string | null;
             modifiedAt: import("temporal-polyfill").Temporal.Instant;
             tag: string;
-            title: string;
+            title: string | null;
         }, {
             conversationId: string;
         }, import("xstate").EventObject>;
@@ -551,7 +551,7 @@ export declare class AIResource {
                 modelProviderId: string | null;
                 modifiedAt: import("temporal-polyfill").Temporal.Instant;
                 tag: string;
-                title: string;
+                title: string | null;
             };
             history: {
                 data: ({
@@ -663,7 +663,7 @@ export declare class AIResource {
                 modelProviderId: string | null;
                 modifiedAt: import("temporal-polyfill").Temporal.Instant;
                 tag: string;
-                title: string;
+                title: string | null;
             };
             currentRunId: string;
         }, {
@@ -823,7 +823,7 @@ export declare class AIResource {
         modelProviderId: string | null;
         modifiedAt: import("temporal-polyfill").Temporal.Instant;
         tag: string;
-        title: string;
+        title: string | null;
     }, HttpError>;
     retrieveConversationHistory(id: string): {
         data(): AsyncGenerator<ChatEvent, void, HttpError>;

package/dist/enterprise/ai/AIResource.d.ts

@@ -38,7 +38,7 @@ export declare class AIResource {
             modelProviderId: string | null;
             modifiedAt: import("temporal-polyfill").Temporal.Instant;
             tag: string;
-            title: string;
+            title: string | null;
         }, {
             conversationId: string;
         }, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<{
@@ -146,7 +146,7 @@ export declare class AIResource {
                 modelProviderId: string | null;
                 modifiedAt: import("temporal-polyfill").Temporal.Instant;
                 tag: string;
-                title: string;
+                title: string | null;
             };
             history: {
                 data: ({
@@ -254,7 +254,7 @@ export declare class AIResource {
                 modelProviderId: string | null;
                 modifiedAt: import("temporal-polyfill").Temporal.Instant;
                 tag: string;
-                title: string;
+                title: string | null;
             };
             currentRunId: string;
         }, {
@@ -377,7 +377,7 @@ export declare class AIResource {
             modelProviderId: string | null;
             modifiedAt: import("temporal-polyfill").Temporal.Instant;
             tag: string;
-            title: string;
+            title: string | null;
         }, {
             conversationId: string;
         }, import("xstate").EventObject>;
@@ -493,7 +493,7 @@ export declare class AIResource {
                 modelProviderId: string | null;
                 modifiedAt: import("temporal-polyfill").Temporal.Instant;
                 tag: string;
-                title: string;
+                title: string | null;
             };
             history: {
                 data: ({
@@ -605,7 +605,7 @@ export declare class AIResource {
                 modelProviderId: string | null;
                 modifiedAt: import("temporal-polyfill").Temporal.Instant;
                 tag: string;
-                title: string;
+                title: string | null;
             };
             currentRunId: string;
         }, {

package/dist/enterprise/ai/conversations/AgentConversation.d.ts

@@ -20,7 +20,7 @@ export declare class AgentConversation implements AgentConversationProperties {
     get modelProviderId(): string | null;
     get modifiedAt(): import("temporal-polyfill").Temporal.Instant;
     get tag(): string;
-    get title(): string;
+    get title(): string | null;
     clone(): AgentConversation;
     /**
      * Permanently deletes this conversation.

package/dist/enterprise/ai/conversations/AgentConversation.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentConversation.js","sourceRoot":"","sources":["../../../../src/enterprise/ai/conversations/AgentConversation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC/F,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAEvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAKzD;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACnB,OAAO,CAAgB;IACvB,SAAS,CAA2C;IACpD,EAAE,CAAoC;IAC/C,aAAa,CAA8C;IAC3D,UAAU,CAA2C;IACrD,gBAAgB,CAAiD;IACjE,WAAW,CAA4C;IACvD,IAAI,CAAS;IACb,MAAM,CAAS;IAEf,YAAY,MAAqB,EAAE,UAAuC;QACxE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,YAAY,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC;QACvC,IAAI,CAAC,gBAAgB,GAAG,UAAU,CAAC,eAAe,CAAC;QACnD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;IACjC,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK;QACH,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,MAAM,CACJ,UAA0D,EAC1D,UAKI,EAAE;QAEN,MAAM,EAAE,UAAU,GAAG,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC;QAC5C,OAAO,IAAI,WAAW,CACpB,CAAC,KAAK,IAAI,EAAE;YACV,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,GAAG,CACxF,CAAC,UAAU,EAAE,EAAE;gBACb,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YACrC,CAAC,CACF,CAAC;YAEF,IACE,OAAO,CAAC,KAAK,EAAE;gBACf,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC7B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,yDAAyD,EACtF,CAAC;gBACD,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACvE,IAAI,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;oBACxB,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;oBACvE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC;oBAC9E,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;wBACtB,OAAO,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,GAAG,CACxE,CAAC,UAAU,EAAE,EAAE;4BACb,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;wBACrC,CAAC,CACF,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,EAAE,CACL,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,EAAE,MAAM,KAAkB,EAAE;QAClC,OAAO,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,CACvE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAC5B,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,KAAa;QACtB,OAAO,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CACxC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAC9E,CAAC,IAAI,CACJ,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACZ,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAmC,CAAC,CACnF,CACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,UAAmD;QAC1D,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAEzE,WAAW;aACR,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClB,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEnB,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,EAAU;QAChB,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAE/D,WAAW;aACR,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,aAAa,KAAK,EAAE,EAAE,CAAC;gBAC/C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEnB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,UAA0E;QAC1F,IAAI,UAAU,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,YAAY,CAAC;QAC/C,CAAC;QAED,IAAI,UAAU,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC;QACzC,CAAC;QAED,IAAI,UAAU,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YAC7C,IAAI,CAAC,gBAAgB,GAAG,UAAU,CAAC,eAAe,CAAC;QACrD,CAAC;QAED,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC;QAC3C,CAAC;QAED,IAAI,UAAU,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC;QAC7B,CAAC;QAED,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;QACjC,CAAC;IACH,CAAC;IAED,MAAM,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,MAAM,CAAC,YAAY,GAAG,wBAAwB,CAAC","sourcesContent":["/*\n * Copyright (C) 2024-2025 Dremio Corporation\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as z from \"zod/mini\";\nimport { conversationPropertiesCodec } from \"./conversationPropertiesCodec.ts\";\nimport type { SonarV4Config } from \"../../../common/Config.ts\";\nimport { createExchangeRun } from \"./methods/createExchangeRun.ts\";\nimport { deleteConversation } from \"./methods/deleteConversation.ts\";\nimport { conversationUpdateSchema, updateConversation } from \"./methods/updateConversation.ts\";\nimport { map } from \"rxjs\";\nimport { stopExchangeRun } from \"./methods/stopExchangeRun.ts\";\nimport { chatEventCodec } from \"../chat/chatEventSchema.ts\";\nimport { fromTextEventStream } from \"../../../common/fromTextEventStream.ts\";\nimport { streamRunEvents } from \"./methods/streamRunEvents.ts\";\nimport { retrieveConversationHistory } from \"./methods/retrieveConversationHistory.ts\";\nimport type { SignalParam } from \"../../../common/Params.ts\";\nimport { reduceChatEvents } from \"./reduceChatEvents.ts\";\nimport type { ConflictResolver } from \"../../../common/ConflictResolver.ts\";\nimport { AsyncResult } from \"ts-results-es\";\nimport { retrieveConversation } from \"./methods/retrieveConversation.ts\";\nimport { isProblem } from \"../../../common/HttpError.ts\";\nimport type { createConversationCodec } from \"./methods/createConversation.ts\";\n\nexport type AgentConversationProperties = z.output<typeof conversationPropertiesCodec>;\n\n/**\n * Represents a saved conversation with the Dremio AI Agent.\n */\nexport class AgentConversation implements AgentConversationProperties {\n  readonly #config: SonarV4Config;\n  readonly createdAt: AgentConversationProperties[\"createdAt\"];\n  readonly id: AgentConversationProperties[\"id\"];\n  #currentRunId: AgentConversationProperties[\"currentRunId\"];\n  #modelName: AgentConversationProperties[\"modelName\"];\n  #modelProviderId: AgentConversationProperties[\"modelProviderId\"];\n  #modifiedAt: AgentConversationProperties[\"modifiedAt\"];\n  #tag: string;\n  #title: string;\n\n  constructor(config: SonarV4Config, properties: AgentConversationProperties) {\n    this.#config = config;\n    this.createdAt = properties.createdAt;\n    this.id = properties.id;\n    this.#currentRunId = properties.currentRunId;\n    this.#modelName = properties.modelName;\n    this.#modelProviderId = properties.modelProviderId;\n    this.#modifiedAt = properties.modifiedAt;\n    this.#tag = properties.tag;\n    this.#title = properties.title;\n  }\n\n  get currentRunId() {\n    return this.#currentRunId;\n  }\n\n  get modelName() {\n    return this.#modelName;\n  }\n\n  get modelProviderId() {\n    return this.#modelProviderId;\n  }\n\n  get modifiedAt() {\n    return this.#modifiedAt;\n  }\n\n  get tag() {\n    return this.#tag;\n  }\n\n  get title() {\n    return this.#title;\n  }\n\n  clone() {\n    return new AgentConversation(this.#config, this);\n  }\n\n  /**\n   * Permanently deletes this conversation.\n   */\n  delete() {\n    return deleteConversation(this.#config)(this.id);\n  }\n\n  /**\n   * Patches properties for this `AgentConversation`, mutating instance properties after\n   * a successful commit.\n   */\n  update(\n    properties: z.infer<typeof AgentConversation.updateSchema>,\n    options: {\n      onConflict?: ConflictResolver<\n        AgentConversationProperties,\n        z.infer<typeof AgentConversation.updateSchema>\n      >;\n    } = {},\n  ) {\n    const { onConflict = () => null } = options;\n    return new AsyncResult(\n      (async () => {\n        const attempt = await updateConversation(this.#config)(this.id, this.#tag, properties).map(\n          (properties) => {\n            this.#updateProperties(properties);\n          },\n        );\n\n        if (\n          attempt.isErr() &&\n          isProblem(attempt.error.body) &&\n          attempt.error.body.title === \"https://api.dremio.dev/problems/concurrent-modification\"\n        ) {\n          const remoteResult = await retrieveConversation(this.#config)(this.id);\n          if (remoteResult.isOk()) {\n            const remote = new AgentConversation(this.#config, remoteResult.value);\n            const resolved = await onConflict(this.toJSON(), remote.toJSON(), properties);\n            if (resolved !== null) {\n              return updateConversation(this.#config)(this.id, remote.tag, resolved).map(\n                (properties) => {\n                  this.#updateProperties(properties);\n                },\n              );\n            }\n          }\n        }\n\n        return attempt;\n      })(),\n    );\n  }\n\n  history({ signal }: SignalParam = {}) {\n    return retrieveConversationHistory(this.#config)(this.id, { signal }).map(\n      (response) => response.data,\n    );\n  }\n\n  runEvents$(runId: string) {\n    return fromTextEventStream(({ signal }) =>\n      streamRunEvents(this.#config)({ conversationId: this.id, runId }, { signal }),\n    ).pipe(\n      map((event) =>\n        z.decode(chatEventCodec, JSON.parse(event.data) as z.input<typeof chatEventCodec>),\n      ),\n    );\n  }\n\n  /**\n   * Sends a message to the Agent, initiating a new run process.\n   * @returns An `AsyncResult` containing the `runId` for the newly created run.\n   */\n  startRun(properties: z.input<typeof createConversationCodec>) {\n    const asyncResult = createExchangeRun(this.#config)(this.id, properties);\n\n    asyncResult\n      .then((result) => {\n        if (result.isOk()) {\n          this.#updateProperties(result.value.conversationProperties);\n        }\n      })\n      .catch(() => {});\n\n    return asyncResult.map((properties) => properties.currentRunId);\n  }\n\n  /**\n   * Only a single run can be active for a conversation, so for now\n   * this method is kept private.\n   */\n  stopRun(id: string) {\n    const asyncResult = stopExchangeRun(this.#config)(this.id, id);\n\n    asyncResult\n      .then((result) => {\n        if (result.isOk() && this.#currentRunId === id) {\n          this.#currentRunId = null;\n        }\n      })\n      .catch(() => {});\n\n    return asyncResult;\n  }\n\n  toJSON(): AgentConversationProperties {\n    return {\n      createdAt: this.createdAt,\n      currentRunId: this.currentRunId,\n      id: this.id,\n      modelName: this.modelName,\n      modelProviderId: this.modelProviderId,\n      modifiedAt: this.modifiedAt,\n      tag: this.tag,\n      title: this.title,\n    };\n  }\n\n  #updateProperties(properties: Partial<Omit<AgentConversationProperties, \"createdAt\" | \"id\">>) {\n    if (properties.currentRunId !== undefined) {\n      this.#currentRunId = properties.currentRunId;\n    }\n\n    if (properties.modelName !== undefined) {\n      this.#modelName = properties.modelName;\n    }\n\n    if (properties.modelProviderId !== undefined) {\n      this.#modelProviderId = properties.modelProviderId;\n    }\n\n    if (properties.modifiedAt !== undefined) {\n      this.#modifiedAt = properties.modifiedAt;\n    }\n\n    if (properties.tag !== undefined) {\n      this.#tag = properties.tag;\n    }\n\n    if (properties.title !== undefined) {\n      this.#title = properties.title;\n    }\n  }\n\n  static reduceChatEvents = reduceChatEvents;\n  static updateSchema = conversationUpdateSchema;\n}\n"]}
+{"version":3,"file":"AgentConversation.js","sourceRoot":"","sources":["../../../../src/enterprise/ai/conversations/AgentConversation.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (C) 2024-2025 Dremio Corporation\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as z from \"zod/mini\";\nimport { conversationPropertiesCodec } from \"./conversationPropertiesCodec.ts\";\nimport type { SonarV4Config } from \"../../../common/Config.ts\";\nimport { createExchangeRun } from \"./methods/createExchangeRun.ts\";\nimport { deleteConversation } from \"./methods/deleteConversation.ts\";\nimport { conversationUpdateSchema, updateConversation } from \"./methods/updateConversation.ts\";\nimport { map } from \"rxjs\";\nimport { stopExchangeRun } from \"./methods/stopExchangeRun.ts\";\nimport { chatEventCodec } from \"../chat/chatEventSchema.ts\";\nimport { fromTextEventStream } from \"../../../common/fromTextEventStream.ts\";\nimport { streamRunEvents } from \"./methods/streamRunEvents.ts\";\nimport { retrieveConversationHistory } from \"./methods/retrieveConversationHistory.ts\";\nimport type { SignalParam } from \"../../../common/Params.ts\";\nimport { reduceChatEvents } from \"./reduceChatEvents.ts\";\nimport type { ConflictResolver } from \"../../../common/ConflictResolver.ts\";\nimport { AsyncResult } from \"ts-results-es\";\nimport { retrieveConversation } from \"./methods/retrieveConversation.ts\";\nimport { isProblem } from \"../../../common/HttpError.ts\";\nimport type { createConversationCodec } from \"./methods/createConversation.ts\";\n\nexport type AgentConversationProperties = z.output<typeof conversationPropertiesCodec>;\n\n/**\n * Represents a saved conversation with the Dremio AI Agent.\n */\nexport class AgentConversation implements AgentConversationProperties {\n  readonly #config: SonarV4Config;\n  readonly createdAt: AgentConversationProperties[\"createdAt\"];\n  readonly id: AgentConversationProperties[\"id\"];\n  #currentRunId: AgentConversationProperties[\"currentRunId\"];\n  #modelName: AgentConversationProperties[\"modelName\"];\n  #modelProviderId: AgentConversationProperties[\"modelProviderId\"];\n  #modifiedAt: AgentConversationProperties[\"modifiedAt\"];\n  #tag: string;\n  #title: string | null;\n\n  constructor(config: SonarV4Config, properties: AgentConversationProperties) {\n    this.#config = config;\n    this.createdAt = properties.createdAt;\n    this.id = properties.id;\n    this.#currentRunId = properties.currentRunId;\n    this.#modelName = properties.modelName;\n    this.#modelProviderId = properties.modelProviderId;\n    this.#modifiedAt = properties.modifiedAt;\n    this.#tag = properties.tag;\n    this.#title = properties.title;\n  }\n\n  get currentRunId() {\n    return this.#currentRunId;\n  }\n\n  get modelName() {\n    return this.#modelName;\n  }\n\n  get modelProviderId() {\n    return this.#modelProviderId;\n  }\n\n  get modifiedAt() {\n    return this.#modifiedAt;\n  }\n\n  get tag() {\n    return this.#tag;\n  }\n\n  get title() {\n    return this.#title;\n  }\n\n  clone() {\n    return new AgentConversation(this.#config, this);\n  }\n\n  /**\n   * Permanently deletes this conversation.\n   */\n  delete() {\n    return deleteConversation(this.#config)(this.id);\n  }\n\n  /**\n   * Patches properties for this `AgentConversation`, mutating instance properties after\n   * a successful commit.\n   */\n  update(\n    properties: z.infer<typeof AgentConversation.updateSchema>,\n    options: {\n      onConflict?: ConflictResolver<\n        AgentConversationProperties,\n        z.infer<typeof AgentConversation.updateSchema>\n      >;\n    } = {},\n  ) {\n    const { onConflict = () => null } = options;\n    return new AsyncResult(\n      (async () => {\n        const attempt = await updateConversation(this.#config)(this.id, this.#tag, properties).map(\n          (properties) => {\n            this.#updateProperties(properties);\n          },\n        );\n\n        if (\n          attempt.isErr() &&\n          isProblem(attempt.error.body) &&\n          attempt.error.body.title === \"https://api.dremio.dev/problems/concurrent-modification\"\n        ) {\n          const remoteResult = await retrieveConversation(this.#config)(this.id);\n          if (remoteResult.isOk()) {\n            const remote = new AgentConversation(this.#config, remoteResult.value);\n            const resolved = await onConflict(this.toJSON(), remote.toJSON(), properties);\n            if (resolved !== null) {\n              return updateConversation(this.#config)(this.id, remote.tag, resolved).map(\n                (properties) => {\n                  this.#updateProperties(properties);\n                },\n              );\n            }\n          }\n        }\n\n        return attempt;\n      })(),\n    );\n  }\n\n  history({ signal }: SignalParam = {}) {\n    return retrieveConversationHistory(this.#config)(this.id, { signal }).map(\n      (response) => response.data,\n    );\n  }\n\n  runEvents$(runId: string) {\n    return fromTextEventStream(({ signal }) =>\n      streamRunEvents(this.#config)({ conversationId: this.id, runId }, { signal }),\n    ).pipe(\n      map((event) =>\n        z.decode(chatEventCodec, JSON.parse(event.data) as z.input<typeof chatEventCodec>),\n      ),\n    );\n  }\n\n  /**\n   * Sends a message to the Agent, initiating a new run process.\n   * @returns An `AsyncResult` containing the `runId` for the newly created run.\n   */\n  startRun(properties: z.input<typeof createConversationCodec>) {\n    const asyncResult = createExchangeRun(this.#config)(this.id, properties);\n\n    asyncResult\n      .then((result) => {\n        if (result.isOk()) {\n          this.#updateProperties(result.value.conversationProperties);\n        }\n      })\n      .catch(() => {});\n\n    return asyncResult.map((properties) => properties.currentRunId);\n  }\n\n  /**\n   * Only a single run can be active for a conversation, so for now\n   * this method is kept private.\n   */\n  stopRun(id: string) {\n    const asyncResult = stopExchangeRun(this.#config)(this.id, id);\n\n    asyncResult\n      .then((result) => {\n        if (result.isOk() && this.#currentRunId === id) {\n          this.#currentRunId = null;\n        }\n      })\n      .catch(() => {});\n\n    return asyncResult;\n  }\n\n  toJSON(): AgentConversationProperties {\n    return {\n      createdAt: this.createdAt,\n      currentRunId: this.currentRunId,\n      id: this.id,\n      modelName: this.modelName,\n      modelProviderId: this.modelProviderId,\n      modifiedAt: this.modifiedAt,\n      tag: this.tag,\n      title: this.title,\n    };\n  }\n\n  #updateProperties(properties: Partial<Omit<AgentConversationProperties, \"createdAt\" | \"id\">>) {\n    if (properties.currentRunId !== undefined) {\n      this.#currentRunId = properties.currentRunId;\n    }\n\n    if (properties.modelName !== undefined) {\n      this.#modelName = properties.modelName;\n    }\n\n    if (properties.modelProviderId !== undefined) {\n      this.#modelProviderId = properties.modelProviderId;\n    }\n\n    if (properties.modifiedAt !== undefined) {\n      this.#modifiedAt = properties.modifiedAt;\n    }\n\n    if (properties.tag !== undefined) {\n      this.#tag = properties.tag;\n    }\n\n    if (properties.title !== undefined) {\n      this.#title = properties.title;\n    }\n  }\n\n  static reduceChatEvents = reduceChatEvents;\n  static updateSchema = conversationUpdateSchema;\n}\n"]}

package/dist/enterprise/ai/conversations/conversationPropertiesCodec.d.ts

@@ -8,7 +8,7 @@ export declare const conversationPropertiesCodec: z.ZodMiniCodec<z.ZodMiniObject
     modelProviderId: z.ZodMiniOptional<z.ZodMiniString<string>>;
     modifiedAt: z.iso.ZodMiniISODateTime;
     tag: z.ZodMiniString<string>;
-    title: z.ZodMiniString<string>;
+    title: z.ZodMiniNullable<z.ZodMiniString<string>>;
 }, z.core.$strip>, z.ZodMiniObject<{
     createdAt: z.ZodMiniCustom<Temporal.Instant, Temporal.Instant>;
     currentRunId: z.ZodMiniNullable<z.ZodMiniString<string>>;
@@ -17,6 +17,6 @@ export declare const conversationPropertiesCodec: z.ZodMiniCodec<z.ZodMiniObject
     modelProviderId: z.ZodMiniNullable<z.ZodMiniString<string>>;
     modifiedAt: z.ZodMiniCustom<Temporal.Instant, Temporal.Instant>;
     tag: z.ZodMiniString<string>;
-    title: z.ZodMiniString<string>;
+    title: z.ZodMiniNullable<z.ZodMiniString<string>>;
 }, z.core.$strip>>;
 export type ConversationEntity = z.input<typeof conversationPropertiesCodec>;

package/dist/enterprise/ai/conversations/conversationPropertiesCodec.js

@@ -23,7 +23,7 @@ export const conversationPropertiesCodec = z.codec(z.object({
     modelProviderId: z.optional(z.string()),
     modifiedAt: z.iso.datetime(),
     tag: z.string(),
-    title: z.string(),
+    title: z.nullable(z.string()),
 }), z.object({
     createdAt: z.instanceof(Temporal.Instant),
     currentRunId: z.nullable(z.string()),
@@ -32,7 +32,7 @@ export const conversationPropertiesCodec = z.codec(z.object({
     modelProviderId: z.nullable(z.string()),
     modifiedAt: z.instanceof(Temporal.Instant),
     tag: z.string(),
-    title: z.string(),
+    title: z.nullable(z.string()),
 }), {
     decode(v) {
         return {

package/dist/enterprise/ai/conversations/conversationPropertiesCodec.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversationPropertiesCodec.js","sourceRoot":"","sources":["../../../../src/enterprise/ai/conversations/conversationPropertiesCodec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAChD,CAAC,CAAC,MAAM,CAAC;IACP,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC3B,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC5B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,EACF,CAAC,CAAC,MAAM,CAAC;IACP,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC1C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,EACF;IACE,MAAM,CAAC,CAAC;QACN,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7C,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,IAAI;YACpC,EAAE,EAAE,CAAC,CAAC,cAAc;YACpB,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;YAC9B,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,IAAI;YAC1C,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;YAC/C,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,CAAC;QACN,OAAO;YACL,cAAc,EAAE,CAAC,CAAC,EAAE;YACpB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE;YACjC,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,SAAS;YACzC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,SAAS;YACnC,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,SAAS;YAC/C,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE;YACnC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC;IACJ,CAAC;CACF,CACF,CAAC","sourcesContent":["/*\n * Copyright (C) 2024-2025 Dremio Corporation\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Temporal } from \"temporal-polyfill\";\nimport * as z from \"zod/mini\";\n\nexport const conversationPropertiesCodec = z.codec(\n  z.object({\n    conversationId: z.string(),\n    createdAt: z.iso.datetime(),\n    currentRunId: z.optional(z.string()),\n    modelName: z.optional(z.string()),\n    modelProviderId: z.optional(z.string()),\n    modifiedAt: z.iso.datetime(),\n    tag: z.string(),\n    title: z.string(),\n  }),\n  z.object({\n    createdAt: z.instanceof(Temporal.Instant),\n    currentRunId: z.nullable(z.string()),\n    id: z.string(),\n    modelName: z.nullable(z.string()),\n    modelProviderId: z.nullable(z.string()),\n    modifiedAt: z.instanceof(Temporal.Instant),\n    tag: z.string(),\n    title: z.string(),\n  }),\n  {\n    decode(v) {\n      return {\n        createdAt: Temporal.Instant.from(v.createdAt),\n        currentRunId: v.currentRunId || null,\n        id: v.conversationId,\n        modelName: v.modelName || null,\n        modelProviderId: v.modelProviderId || null,\n        modifiedAt: Temporal.Instant.from(v.modifiedAt),\n        tag: v.tag,\n        title: v.title,\n      };\n    },\n    encode(v) {\n      return {\n        conversationId: v.id,\n        createdAt: v.createdAt.toString(),\n        currentRunId: v.currentRunId || undefined,\n        modelName: v.modelName || undefined,\n        modelProviderId: v.modelProviderId || undefined,\n        modifiedAt: v.modifiedAt.toString(),\n        tag: v.tag,\n        title: v.title,\n      };\n    },\n  },\n);\n\nexport type ConversationEntity = z.input<typeof conversationPropertiesCodec>;\n"]}
+{"version":3,"file":"conversationPropertiesCodec.js","sourceRoot":"","sources":["../../../../src/enterprise/ai/conversations/conversationPropertiesCodec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAChD,CAAC,CAAC,MAAM,CAAC;IACP,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC3B,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC5B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,EACF,CAAC,CAAC,MAAM,CAAC;IACP,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC1C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,EACF;IACE,MAAM,CAAC,CAAC;QACN,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7C,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,IAAI;YACpC,EAAE,EAAE,CAAC,CAAC,cAAc;YACpB,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;YAC9B,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,IAAI;YAC1C,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;YAC/C,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,CAAC;QACN,OAAO;YACL,cAAc,EAAE,CAAC,CAAC,EAAE;YACpB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE;YACjC,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,SAAS;YACzC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,SAAS;YACnC,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,SAAS;YAC/C,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE;YACnC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC;IACJ,CAAC;CACF,CACF,CAAC","sourcesContent":["/*\n * Copyright (C) 2024-2025 Dremio Corporation\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Temporal } from \"temporal-polyfill\";\nimport * as z from \"zod/mini\";\n\nexport const conversationPropertiesCodec = z.codec(\n  z.object({\n    conversationId: z.string(),\n    createdAt: z.iso.datetime(),\n    currentRunId: z.optional(z.string()),\n    modelName: z.optional(z.string()),\n    modelProviderId: z.optional(z.string()),\n    modifiedAt: z.iso.datetime(),\n    tag: z.string(),\n    title: z.nullable(z.string()),\n  }),\n  z.object({\n    createdAt: z.instanceof(Temporal.Instant),\n    currentRunId: z.nullable(z.string()),\n    id: z.string(),\n    modelName: z.nullable(z.string()),\n    modelProviderId: z.nullable(z.string()),\n    modifiedAt: z.instanceof(Temporal.Instant),\n    tag: z.string(),\n    title: z.nullable(z.string()),\n  }),\n  {\n    decode(v) {\n      return {\n        createdAt: Temporal.Instant.from(v.createdAt),\n        currentRunId: v.currentRunId || null,\n        id: v.conversationId,\n        modelName: v.modelName || null,\n        modelProviderId: v.modelProviderId || null,\n        modifiedAt: Temporal.Instant.from(v.modifiedAt),\n        tag: v.tag,\n        title: v.title,\n      };\n    },\n    encode(v) {\n      return {\n        conversationId: v.id,\n        createdAt: v.createdAt.toString(),\n        currentRunId: v.currentRunId || undefined,\n        modelName: v.modelName || undefined,\n        modelProviderId: v.modelProviderId || undefined,\n        modifiedAt: v.modifiedAt.toString(),\n        tag: v.tag,\n        title: v.title,\n      };\n    },\n  },\n);\n\nexport type ConversationEntity = z.input<typeof conversationPropertiesCodec>;\n"]}

package/dist/enterprise/ai/conversations/createConversationMachine.d.ts

@@ -56,7 +56,7 @@ export declare const createConversationMachine: (config: SonarV4Config) => impor
         modelProviderId: string | null;
         modifiedAt: import("temporal-polyfill").Temporal.Instant;
         tag: string;
-        title: string;
+        title: string | null;
     }, {
         conversationId: string;
     }, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<{
@@ -164,7 +164,7 @@ export declare const createConversationMachine: (config: SonarV4Config) => impor
             modelProviderId: string | null;
             modifiedAt: import("temporal-polyfill").Temporal.Instant;
             tag: string;
-            title: string;
+            title: string | null;
         };
         history: {
             data: ({
@@ -272,7 +272,7 @@ export declare const createConversationMachine: (config: SonarV4Config) => impor
             modelProviderId: string | null;
             modifiedAt: import("temporal-polyfill").Temporal.Instant;
             tag: string;
-            title: string;
+            title: string | null;
         };
         currentRunId: string;
     }, {
@@ -395,7 +395,7 @@ export declare const createConversationMachine: (config: SonarV4Config) => impor
         modelProviderId: string | null;
         modifiedAt: import("temporal-polyfill").Temporal.Instant;
         tag: string;
-        title: string;
+        title: string | null;
     }, {
         conversationId: string;
     }, import("xstate").EventObject>;
@@ -511,7 +511,7 @@ export declare const createConversationMachine: (config: SonarV4Config) => impor
             modelProviderId: string | null;
             modifiedAt: import("temporal-polyfill").Temporal.Instant;
             tag: string;
-            title: string;
+            title: string | null;
         };
         history: {
             data: ({
@@ -623,7 +623,7 @@ export declare const createConversationMachine: (config: SonarV4Config) => impor
             modelProviderId: string | null;
             modifiedAt: import("temporal-polyfill").Temporal.Instant;
             tag: string;
-            title: string;
+            title: string | null;
         };
         currentRunId: string;
     }, {

package/dist/enterprise/ai/conversations/methods/createExchangeRun.d.ts

@@ -10,7 +10,7 @@ export declare const createExchangeRun: (config: SonarV4Config) => (conversation
         modelProviderId: string | null;
         modifiedAt: import("temporal-polyfill").Temporal.Instant;
         tag: string;
-        title: string;
+        title: string | null;
     };
     currentRunId: string;
 }, import("../../../index.ts").HttpError>;

package/dist/enterprise/ai/conversations/methods/retrieveConversation.d.ts

@@ -8,5 +8,5 @@ export declare const retrieveConversation: (config: SonarV4Config) => (id: strin
     modelProviderId: string | null;
     modifiedAt: import("temporal-polyfill").Temporal.Instant;
     tag: string;
-    title: string;
+    title: string | null;
 }, import("../../../index.ts").HttpError>;

package/dist/enterprise/ai/conversations/methods/updateConversation.d.ts

@@ -8,7 +8,7 @@ export declare const updateConversation: (config: SonarV4Config) => (id: string,
     modelProviderId: string | null;
     modifiedAt: import("temporal-polyfill").Temporal.Instant;
     tag: string;
-    title: string;
+    title: string | null;
 }, import("../../../index.ts").HttpError>;
 export declare const conversationUpdateSchema: z.ZodMiniObject<{
     title: z.ZodMiniOptional<z.ZodMiniString<string>>;

package/dist-iife/cloud.js

@@ -24616,7 +24616,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     modelProviderId: optional(string2()),
     modifiedAt: iso_exports.datetime(),
     tag: string2(),
-    title: string2()
+    title: nullable(string2())
   }), object({
     createdAt: _instanceof(Xn.Instant),
     currentRunId: nullable(string2()),
@@ -24625,7 +24625,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     modelProviderId: nullable(string2()),
     modifiedAt: _instanceof(Xn.Instant),
     tag: string2(),
-    title: string2()
+    title: nullable(string2())
   }), {
     decode(v2) {
       return {

package/dist-iife/enterprise.js

@@ -25279,7 +25279,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     modelProviderId: optional(string2()),
     modifiedAt: iso_exports.datetime(),
     tag: string2(),
-    title: string2()
+    title: nullable(string2())
   }), object({
     createdAt: _instanceof(Xn.Instant),
     currentRunId: nullable(string2()),
@@ -25288,7 +25288,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     modelProviderId: nullable(string2()),
     modifiedAt: _instanceof(Xn.Instant),
     tag: string2(),
-    title: string2()
+    title: nullable(string2())
   }), {
     decode(v2) {
       return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dremio/js-sdk",
-  "version": "0.45.1",
+  "version": "0.45.3",
   "description": "JavaScript library for the Dremio API",
   "keywords": [
     "dremio",