@nexusm/sdk 3.0.0 → 5.0.0

package/dist/index.mjs

@@ -1022,7 +1022,7 @@ import { z as z3 } from "zod";
 var messageRoleSchema = z3.enum(["user", "assistant", "system", "tool"]);
 var conversationCreateSchema = z3.object({
   user_id: z3.string().min(1),
-  session_id: z3.string().optional(),
+  agent_id: z3.string().max(255).optional(),
   metadata: z3.record(z3.unknown()).optional()
 });
 var messageCreateSchema = z3.object({
@@ -1056,10 +1056,14 @@ var ConversationService = class extends BaseService {
     return this.http.get("/conversations", params, options?.signal);
   }
   /**
-   * Retrieve a conversation with its messages included.
+   * Retrieve a conversation.
    *
-   * @param conversationId - UUID of the conversation to retrieve.
-   * @returns Conversation detail including the full message list.
+   * v4.0.0 BREAKING: returns `Conversation` — the backend response has no
+   * `messages` array (the previous `ConversationDetail` shape was a
+   * phantom). Fetch messages via {@link getMessages}.
+   *
+   * @param conversationId - Compound conversation ID to retrieve.
+   * @returns The conversation record.
    * @throws {ApiError} 404 if the conversation does not exist.
    */
   async get(conversationId, options) {
@@ -1068,11 +1072,11 @@ var ConversationService = class extends BaseService {
   /**
    * Add a message to an existing conversation.
    *
-   * The message is appended to the conversation's message sequence.
-   * Zep will asynchronously update the conversation summary after
-   * new messages are added.
+   * The message is appended to the conversation's message sequence. The
+   * backend SummaryWorker asynchronously updates the conversation summary
+   * after new messages are added.
    *
-   * @param conversationId - UUID of the target conversation.
+   * @param conversationId - Compound conversation ID ("tenant::user::session").
    * @param message - Message payload including role and content.
    * @returns The newly created message with generated ID and sequence number.
    * @throws {ApiError} 404 if the conversation does not exist.
@@ -1089,7 +1093,7 @@ var ConversationService = class extends BaseService {
    *
    * Messages are returned in chronological order (oldest first).
    *
-   * @param conversationId - UUID of the conversation.
+   * @param conversationId - Compound conversation ID ("tenant::user::session").
    * @param params - Optional pagination controls (limit, offset).
    * @returns Paginated list of messages.
    * @throws {ApiError} 404 if the conversation does not exist.
@@ -1104,23 +1108,26 @@ var ConversationService = class extends BaseService {
   /**
    * Retrieve the auto-generated summary of a conversation.
    *
-   * Summaries are produced by Zep OSS temporal graph analysis and
-   * include key points extracted from the conversation history.
+   * Summaries are produced incrementally by the backend SummaryWorker from
+   * the conversation history.
    *
-   * @param conversationId - UUID of the conversation.
-   * @returns The conversation summary with key points and generation timestamp.
+   * @param conversationId - Compound conversation ID ("tenant::user::session").
+   * @returns The conversation summary ({@link ConversationSummary}: summary
+   *   text + message counts + created_at). Note: no "key points" or
+   *   "generated_at" fields — those were phantom (removed in v4.0.0).
    * @throws {ApiError} 404 if the conversation does not exist.
    */
   async getSummary(conversationId, options) {
     return this.http.get(`/conversations/${conversationId}/summary`, void 0, options?.signal);
   }
   /**
-   * Delete a conversation and all its messages.
+   * Delete a conversation.
    *
-   * This operation is irreversible. The conversation, all associated
-   * messages, and the generated summary will be permanently removed.
+   * Soft-delete: the backend sets `deleted_at` (the conversation stops
+   * appearing in list/get) rather than physically removing the row and its
+   * messages.
    *
-   * @param conversationId - UUID of the conversation to delete.
+   * @param conversationId - Compound conversation ID ("tenant::user::session").
    * @throws {ApiError} 404 if the conversation does not exist.
    */
   async delete(conversationId, options) {