@nexusm/sdk 4.0.0 → 5.1.0

package/dist/index.mjs

@@ -727,6 +727,30 @@ var HttpClient = class {
     this.cache.invalidate(path.split("/").filter(Boolean)[0] ?? path);
     return result;
   }
+  /**
+   * Send a GET request and return the raw response body as a string.
+   *
+   * Intended for file-download endpoints (e.g. `GET /dashboard/export`) that
+   * return `text/csv` or `application/json` as a raw file stream rather than a
+   * JSON-parsed object.  The retry and auth interceptors still apply; the
+   * response cache is intentionally bypassed (export payloads are not cacheable
+   * at the SDK layer).
+   *
+   * @param path   - URL path relative to the base URL (e.g. `/dashboard/export`).
+   * @param params - Optional query parameters.
+   * @param signal - Optional {@link AbortSignal} to cancel the request.
+   * @returns The raw response body as a string.
+   */
+  async getText(path, params, signal) {
+    return this.retry.execute(async () => {
+      const response = await this.axios.get(path, {
+        params,
+        signal,
+        responseType: "text"
+      });
+      return response.data;
+    });
+  }
   /**
    * Send a DELETE request.
    *
@@ -1022,7 +1046,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({
@@ -1072,11 +1096,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.
@@ -1093,7 +1117,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.
@@ -1108,23 +1132,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) {
@@ -1340,6 +1367,35 @@ var ErrorService = class extends BaseService {
   }
 };
 
+// src/services/dashboard.ts
+var DashboardService = class extends BaseService {
+  /**
+   * Export a dashboard dataset as raw file content.
+   *
+   * Sends `GET /dashboard/export` with the given query parameters and returns
+   * the raw response body as a string.  The string is exactly the file the
+   * server would send for a browser download:
+   * - `format: 'csv'` (default) → comma-separated text
+   * - `format: 'json'`          → JSON text (not parsed into an object)
+   *
+   * @param params  - Dataset selection and format options.
+   * @param options - Optional request options (e.g. AbortSignal).
+   * @returns Raw file body string.
+   *
+   * @throws {ApiError} HTTP 401 — missing or invalid API key.
+   * @throws {ApiError} HTTP 403 — `target_tenant_id` requires admin scope.
+   * @throws {ApiError} HTTP 422 — `dataset` is not one of the six whitelisted values.
+   */
+  async export(params, options) {
+    const query = { dataset: params.dataset };
+    if (params.format !== void 0) query["format"] = params.format;
+    if (params.target_tenant_id !== void 0) {
+      query["target_tenant_id"] = params.target_tenant_id;
+    }
+    return this.http.getText("/dashboard/export", query, options?.signal);
+  }
+};
+
 // src/client.ts
 var NexusClient = class {
   /**
@@ -1361,6 +1417,7 @@ var NexusClient = class {
     this.tenants = new TenantService(this.http);
     this.feedback = new FeedbackService(this.http);
     this.errors = new ErrorService(this.http);
+    this.dashboard = new DashboardService(this.http);
     if (resolved.autoErrorReport) {
       this.http.onApiError = (statusCode, method, url, detail) => {
         this.errors.submit({