@getzep/zep-cloud 3.2.0 → 3.4.1

package/dist/cjs/Client.js

@@ -47,8 +47,8 @@ class ZepClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "zep-cloud",
-                "X-Fern-SDK-Version": "3.2.0",
-                "User-Agent": "zep-cloud/3.2.0",
+                "X-Fern-SDK-Version": "3.4.1",
+                "User-Agent": "zep-cloud/3.4.1",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/resources/graph/client/Client.d.ts

@@ -151,7 +151,7 @@ export declare class Graph {
     create(request: Zep.CreateGraphRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.Graph>;
     private __create;
     /**
-     * List all graphs. In order to list users, use user.list_ordered instead
+     * Returns all graphs. In order to list users, use user.list_ordered instead
      *
      * @param {Zep.GraphListAllRequest} request
      * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/graph/client/Client.js

@@ -707,7 +707,7 @@ class Graph {
         });
     }
     /**
-     * List all graphs. In order to list users, use user.list_ordered instead
+     * Returns all graphs. In order to list users, use user.list_ordered instead
      *
      * @param {Zep.GraphListAllRequest} request
      * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/thread/client/Client.d.ts

@@ -74,9 +74,9 @@ export declare class Thread {
     delete(threadId: string, requestOptions?: Thread.RequestOptions): core.HttpResponsePromise<Zep.SuccessResponse>;
     private __delete;
     /**
-     * Returns most relevant context for a given thread.
+     * Returns most relevant context from the user graph (including memory from any/all past threads) based on the content of the past few messages of the given thread.
      *
-     * @param {string} threadId - The ID of the thread for which to retrieve context.
+     * @param {string} threadId - The ID of the current thread (for which context is being retrieved).
      * @param {Zep.ThreadGetUserContextRequest} request
      * @param {Thread.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -122,6 +122,25 @@ export declare class Thread {
      */
     addMessages(threadId: string, request: Zep.AddThreadMessagesRequest, requestOptions?: Thread.RequestOptions): core.HttpResponsePromise<Zep.AddThreadMessagesResponse>;
     private __addMessages;
+    /**
+     * Add messages to a thread in batch mode. This will process messages concurrently, which is useful for data migrations.
+     *
+     * @param {string} threadId - The ID of the thread to which messages should be added.
+     * @param {Zep.AddThreadMessagesRequest} request
+     * @param {Thread.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.thread.addMessagesBatch("threadId", {
+     *         messages: [{
+     *                 content: "content",
+     *                 role: "norole"
+     *             }]
+     *     })
+     */
+    addMessagesBatch(threadId: string, request: Zep.AddThreadMessagesRequest, requestOptions?: Thread.RequestOptions): core.HttpResponsePromise<Zep.AddThreadMessagesResponse>;
+    private __addMessagesBatch;
     protected _getCustomAuthorizationHeaders(): Promise<{
         Authorization: string;
     }>;

package/dist/cjs/api/resources/thread/client/Client.js

@@ -324,9 +324,9 @@ class Thread {
         });
     }
     /**
-     * Returns most relevant context for a given thread.
+     * Returns most relevant context from the user graph (including memory from any/all past threads) based on the content of the past few messages of the given thread.
      *
-     * @param {string} threadId - The ID of the thread for which to retrieve context.
+     * @param {string} threadId - The ID of the current thread (for which context is being retrieved).
      * @param {Zep.ThreadGetUserContextRequest} request
      * @param {Thread.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -595,6 +595,90 @@ class Thread {
             }
         });
     }
+    /**
+     * Add messages to a thread in batch mode. This will process messages concurrently, which is useful for data migrations.
+     *
+     * @param {string} threadId - The ID of the thread to which messages should be added.
+     * @param {Zep.AddThreadMessagesRequest} request
+     * @param {Thread.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.thread.addMessagesBatch("threadId", {
+     *         messages: [{
+     *                 content: "content",
+     *                 role: "norole"
+     *             }]
+     *     })
+     */
+    addMessagesBatch(threadId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__addMessagesBatch(threadId, request, requestOptions));
+    }
+    __addMessagesBatch(threadId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ZepEnvironment.Default, `threads/${encodeURIComponent(threadId)}/messages-batch`),
+                method: "POST",
+                headers: (0, headers_js_1.mergeHeaders)((_d = this._options) === null || _d === void 0 ? void 0 : _d.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.AddThreadMessagesRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.AddThreadMessagesResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 500:
+                        throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.ZepError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.ZepError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.ZepTimeoutError("Timeout exceeded when calling POST /threads/{threadId}/messages-batch.");
+                case "unknown":
+                    throw new errors.ZepError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getCustomAuthorizationHeaders() {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;

package/dist/cjs/api/resources/thread/client/requests/index.d.ts

@@ -2,4 +2,3 @@ export { type ThreadListAllRequest } from "./ThreadListAllRequest.js";
 export { type CreateThreadRequest } from "./CreateThreadRequest.js";
 export { type ThreadGetUserContextRequest } from "./ThreadGetUserContextRequest.js";
 export { type ThreadGetRequest } from "./ThreadGetRequest.js";
-export { type AddThreadMessagesRequest } from "./AddThreadMessagesRequest.js";

package/dist/cjs/api/{resources/thread/client/requests → types}/AddThreadMessagesRequest.d.ts

@@ -1,16 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as Zep from "../../../../index.js";
-/**
- * @example
- *     {
- *         messages: [{
- *                 content: "content",
- *                 role: "norole"
- *             }]
- *     }
- */
+import * as Zep from "../index.js";
 export interface AddThreadMessagesRequest {
     /**
      * Optional list of role types to ignore when adding messages to graph memory.
@@ -20,6 +11,6 @@ export interface AddThreadMessagesRequest {
     ignoreRoles?: Zep.RoleType[];
     /** A list of message objects, where each message contains a role and content. */
     messages: Zep.Message[];
-    /** Optionally return memory context relevant to the most recent messages. */
+    /** Optionally return context block relevant to the most recent messages. */
     returnContext?: boolean;
 }

package/dist/cjs/api/types/AddThreadMessagesResponse.d.ts

@@ -3,4 +3,5 @@
  */
 export interface AddThreadMessagesResponse {
     context?: string;
+    messageUuids?: string[];
 }

package/dist/cjs/api/types/ThreadContextResponse.d.ts

@@ -2,6 +2,6 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 export interface ThreadContextResponse {
-    /** Memory context containing relevant facts and entities for the session. Can be put into the prompt directly. */
+    /** Context block containing relevant facts, entities, and messages/episodes from the user graph. Meant to be replaced in the system prompt on every chat turn. */
     context?: string;
 }

package/dist/cjs/api/types/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./ApiError.js";
+export * from "./AddThreadMessagesRequest.js";
 export * from "./AddThreadMessagesResponse.js";
 export * from "./CloneGraphResponse.js";
 export * from "./EdgeType.js";

package/dist/cjs/api/types/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ApiError.js"), exports);
+__exportStar(require("./AddThreadMessagesRequest.js"), exports);
 __exportStar(require("./AddThreadMessagesResponse.js"), exports);
 __exportStar(require("./CloneGraphResponse.js"), exports);
 __exportStar(require("./EdgeType.js"), exports);

package/dist/cjs/contextString.d.ts

@@ -1,4 +1,4 @@
-import { EntityEdge, EntityNode } from "./api/index.js";
+import { EntityEdge, EntityNode, Episode } from "./api/index.js";
 /**
  * Format the date range of an entity edge.
  *
@@ -7,10 +7,11 @@ import { EntityEdge, EntityNode } from "./api/index.js";
  */
 export declare function formatEdgeDateRange(edge: EntityEdge): string;
 /**
- * Compose a search context from entity edges and nodes.
+ * Compose a search context from entity edges, nodes, and episodes.
  *
  * @param edges - List of entity edges.
  * @param nodes - List of entity nodes.
- * @returns A formatted string containing facts and entities.
+ * @param episodes - List of episodes.
+ * @returns A formatted string containing facts, entities, and episodes.
  */
-export declare function composeContextString(edges: EntityEdge[], nodes: EntityNode[]): string;
+export declare function composeContextString(edges: EntityEdge[], nodes: EntityNode[], episodes?: Episode[]): string;

package/dist/cjs/contextString.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatEdgeDateRange = formatEdgeDateRange;
 exports.composeContextString = composeContextString;
 const TEMPLATE_STRING = `
-FACTS and ENTITIES represent relevant context to the current conversation.
+FACTS and ENTITIES%episodesHeader% represent relevant context to the current conversation.
 
 # These are the most relevant facts and their valid date ranges
 # format: FACT (Date range: from - to)
@@ -12,10 +12,15 @@ FACTS and ENTITIES represent relevant context to the current conversation.
 </FACTS>
 
 # These are the most relevant entities
-# ENTITY_NAME: entity summary
+# Name: ENTITY_NAME
+# Label: entity_label (if present)
+# Attributes: (if present)
+#   attr_name: attr_value
+# Summary: entity summary
 <ENTITIES>
 %entities%
 </ENTITIES>
+%episodesSection%
 `;
 /**
  * Format the date range of an entity edge.
@@ -56,20 +61,72 @@ function formatDate(date) {
         .replace(/^(\d{2})-(\d{2})-(\d{4})/, "$3-$1-$2");
 }
 /**
- * Compose a search context from entity edges and nodes.
+ * Compose a search context from entity edges, nodes, and episodes.
  *
  * @param edges - List of entity edges.
  * @param nodes - List of entity nodes.
- * @returns A formatted string containing facts and entities.
+ * @param episodes - List of episodes.
+ * @returns A formatted string containing facts, entities, and episodes.
  */
-function composeContextString(edges, nodes) {
+function composeContextString(edges, nodes, episodes = []) {
     const facts = edges.map((edge) => {
-        return `  - ${edge.fact} (${formatEdgeDateRange(edge)})`;
+        return `  - ${edge.fact} (Date range: ${formatEdgeDateRange(edge)})`;
     });
     const entities = nodes.map((node) => {
-        return `  - ${node.name}: ${node.summary}`;
+        const entityParts = [`Name: ${node.name}`];
+        if (node.labels && node.labels.length > 0) {
+            const labels = [...node.labels];
+            const entityIndex = labels.indexOf('Entity');
+            if (entityIndex > -1) {
+                labels.splice(entityIndex, 1);
+            }
+            if (labels.length > 0) {
+                entityParts.push(`Label: ${labels[0]}`);
+            }
+        }
+        if (node.attributes && Object.keys(node.attributes).length > 0) {
+            const filteredAttributes = Object.assign({}, node.attributes);
+            delete filteredAttributes.labels;
+            if (Object.keys(filteredAttributes).length > 0) {
+                entityParts.push('Attributes:');
+                Object.entries(filteredAttributes).forEach(([key, value]) => {
+                    entityParts.push(`  ${key}: ${value}`);
+                });
+            }
+        }
+        if (node.summary && node.summary.trim()) {
+            entityParts.push(`Summary: ${node.summary}`);
+        }
+        return entityParts.join('\n');
     });
+    const episodesList = [];
+    if (episodes.length > 0) {
+        episodes.forEach((episode) => {
+            let rolePrefix = "";
+            if (episode.role && episode.roleType) {
+                rolePrefix = `${episode.role} (${episode.roleType}): `;
+            }
+            else if (episode.role) {
+                rolePrefix = `${episode.role}: `;
+            }
+            else if (episode.roleType) {
+                rolePrefix = `(${episode.roleType}): `;
+            }
+            const timestamp = formatDate(new Date(episode.createdAt));
+            const episodeStr = `  - ${rolePrefix}${episode.content} (${timestamp})`;
+            episodesList.push(episodeStr);
+        });
+    }
     const factsStr = facts.join("\n");
     const entitiesStr = entities.join("\n");
-    return TEMPLATE_STRING.replace("%facts%", factsStr).replace("%entities%", entitiesStr);
+    const episodesStr = episodesList.join("\n");
+    const episodesHeader = episodes.length > 0 ? ", and EPISODES" : "";
+    const episodesSection = episodes.length > 0
+        ? `\n# These are the most relevant episodes\n<EPISODES>\n${episodesStr}\n</EPISODES>`
+        : "";
+    return TEMPLATE_STRING
+        .replace("%episodesHeader%", episodesHeader)
+        .replace("%facts%", factsStr)
+        .replace("%entities%", entitiesStr)
+        .replace("%episodesSection%", episodesSection);
 }

package/dist/cjs/serialization/resources/thread/client/requests/index.d.ts

@@ -1,2 +1 @@
 export { CreateThreadRequest } from "./CreateThreadRequest.js";
-export { AddThreadMessagesRequest } from "./AddThreadMessagesRequest.js";

package/dist/cjs/serialization/resources/thread/client/requests/index.js

@@ -1,7 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AddThreadMessagesRequest = exports.CreateThreadRequest = void 0;
+exports.CreateThreadRequest = void 0;
 var CreateThreadRequest_js_1 = require("./CreateThreadRequest.js");
 Object.defineProperty(exports, "CreateThreadRequest", { enumerable: true, get: function () { return CreateThreadRequest_js_1.CreateThreadRequest; } });
-var AddThreadMessagesRequest_js_1 = require("./AddThreadMessagesRequest.js");
-Object.defineProperty(exports, "AddThreadMessagesRequest", { enumerable: true, get: function () { return AddThreadMessagesRequest_js_1.AddThreadMessagesRequest; } });

package/dist/cjs/serialization/types/AddThreadMessagesRequest.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as serializers from "../index.js";
+import * as Zep from "../../api/index.js";
+import * as core from "../../core/index.js";
+import { RoleType } from "./RoleType.js";
+import { Message } from "./Message.js";
+export declare const AddThreadMessagesRequest: core.serialization.ObjectSchema<serializers.AddThreadMessagesRequest.Raw, Zep.AddThreadMessagesRequest>;
+export declare namespace AddThreadMessagesRequest {
+    interface Raw {
+        ignore_roles?: RoleType.Raw[] | null;
+        messages: Message.Raw[];
+        return_context?: boolean | null;
+    }
+}

package/dist/cjs/serialization/{resources/thread/client/requests → types}/AddThreadMessagesRequest.js

@@ -37,9 +37,9 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AddThreadMessagesRequest = void 0;
-const core = __importStar(require("../../../../../core/index.js"));
-const RoleType_js_1 = require("../../../../types/RoleType.js");
-const Message_js_1 = require("../../../../types/Message.js");
+const core = __importStar(require("../../core/index.js"));
+const RoleType_js_1 = require("./RoleType.js");
+const Message_js_1 = require("./Message.js");
 exports.AddThreadMessagesRequest = core.serialization.object({
     ignoreRoles: core.serialization.property("ignore_roles", core.serialization.list(RoleType_js_1.RoleType).optional()),
     messages: core.serialization.list(Message_js_1.Message),

package/dist/cjs/serialization/types/AddThreadMessagesResponse.d.ts

@@ -8,5 +8,6 @@ export declare const AddThreadMessagesResponse: core.serialization.ObjectSchema<
 export declare namespace AddThreadMessagesResponse {
     interface Raw {
         context?: string | null;
+        message_uuids?: string[] | null;
     }
 }

package/dist/cjs/serialization/types/AddThreadMessagesResponse.js

@@ -40,4 +40,5 @@ exports.AddThreadMessagesResponse = void 0;
 const core = __importStar(require("../../core/index.js"));
 exports.AddThreadMessagesResponse = core.serialization.object({
     context: core.serialization.string().optional(),
+    messageUuids: core.serialization.property("message_uuids", core.serialization.list(core.serialization.string()).optional()),
 });

package/dist/cjs/serialization/types/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./ApiError.js";
+export * from "./AddThreadMessagesRequest.js";
 export * from "./AddThreadMessagesResponse.js";
 export * from "./CloneGraphResponse.js";
 export * from "./EdgeType.js";

package/dist/cjs/serialization/types/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ApiError.js"), exports);
+__exportStar(require("./AddThreadMessagesRequest.js"), exports);
 __exportStar(require("./AddThreadMessagesResponse.js"), exports);
 __exportStar(require("./CloneGraphResponse.js"), exports);
 __exportStar(require("./EdgeType.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.2.0";
+export declare const SDK_VERSION = "3.4.1";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "3.2.0";
+exports.SDK_VERSION = "3.4.1";

package/dist/esm/Client.mjs

@@ -11,8 +11,8 @@ export class ZepClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "zep-cloud",
-                "X-Fern-SDK-Version": "3.2.0",
-                "User-Agent": "zep-cloud/3.2.0",
+                "X-Fern-SDK-Version": "3.4.1",
+                "User-Agent": "zep-cloud/3.4.1",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/resources/graph/client/Client.d.mts

@@ -151,7 +151,7 @@ export declare class Graph {
     create(request: Zep.CreateGraphRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.Graph>;
     private __create;
     /**
-     * List all graphs. In order to list users, use user.list_ordered instead
+     * Returns all graphs. In order to list users, use user.list_ordered instead
      *
      * @param {Zep.GraphListAllRequest} request
      * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/graph/client/Client.mjs

@@ -671,7 +671,7 @@ export class Graph {
         });
     }
     /**
-     * List all graphs. In order to list users, use user.list_ordered instead
+     * Returns all graphs. In order to list users, use user.list_ordered instead
      *
      * @param {Zep.GraphListAllRequest} request
      * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/thread/client/Client.d.mts

@@ -74,9 +74,9 @@ export declare class Thread {
     delete(threadId: string, requestOptions?: Thread.RequestOptions): core.HttpResponsePromise<Zep.SuccessResponse>;
     private __delete;
     /**
-     * Returns most relevant context for a given thread.
+     * Returns most relevant context from the user graph (including memory from any/all past threads) based on the content of the past few messages of the given thread.
      *
-     * @param {string} threadId - The ID of the thread for which to retrieve context.
+     * @param {string} threadId - The ID of the current thread (for which context is being retrieved).
      * @param {Zep.ThreadGetUserContextRequest} request
      * @param {Thread.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -122,6 +122,25 @@ export declare class Thread {
      */
     addMessages(threadId: string, request: Zep.AddThreadMessagesRequest, requestOptions?: Thread.RequestOptions): core.HttpResponsePromise<Zep.AddThreadMessagesResponse>;
     private __addMessages;
+    /**
+     * Add messages to a thread in batch mode. This will process messages concurrently, which is useful for data migrations.
+     *
+     * @param {string} threadId - The ID of the thread to which messages should be added.
+     * @param {Zep.AddThreadMessagesRequest} request
+     * @param {Thread.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.thread.addMessagesBatch("threadId", {
+     *         messages: [{
+     *                 content: "content",
+     *                 role: "norole"
+     *             }]
+     *     })
+     */
+    addMessagesBatch(threadId: string, request: Zep.AddThreadMessagesRequest, requestOptions?: Thread.RequestOptions): core.HttpResponsePromise<Zep.AddThreadMessagesResponse>;
+    private __addMessagesBatch;
     protected _getCustomAuthorizationHeaders(): Promise<{
         Authorization: string;
     }>;

package/dist/esm/api/resources/thread/client/Client.mjs

@@ -288,9 +288,9 @@ export class Thread {
         });
     }
     /**
-     * Returns most relevant context for a given thread.
+     * Returns most relevant context from the user graph (including memory from any/all past threads) based on the content of the past few messages of the given thread.
      *
-     * @param {string} threadId - The ID of the thread for which to retrieve context.
+     * @param {string} threadId - The ID of the current thread (for which context is being retrieved).
      * @param {Zep.ThreadGetUserContextRequest} request
      * @param {Thread.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -559,6 +559,90 @@ export class Thread {
             }
         });
     }
+    /**
+     * Add messages to a thread in batch mode. This will process messages concurrently, which is useful for data migrations.
+     *
+     * @param {string} threadId - The ID of the thread to which messages should be added.
+     * @param {Zep.AddThreadMessagesRequest} request
+     * @param {Thread.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.thread.addMessagesBatch("threadId", {
+     *         messages: [{
+     *                 content: "content",
+     *                 role: "norole"
+     *             }]
+     *     })
+     */
+    addMessagesBatch(threadId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__addMessagesBatch(threadId, request, requestOptions));
+    }
+    __addMessagesBatch(threadId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ZepEnvironment.Default, `threads/${encodeURIComponent(threadId)}/messages-batch`),
+                method: "POST",
+                headers: mergeHeaders((_d = this._options) === null || _d === void 0 ? void 0 : _d.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.AddThreadMessagesRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.AddThreadMessagesResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 500:
+                        throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.ZepError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.ZepError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.ZepTimeoutError("Timeout exceeded when calling POST /threads/{threadId}/messages-batch.");
+                case "unknown":
+                    throw new errors.ZepError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getCustomAuthorizationHeaders() {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;

package/dist/esm/api/resources/thread/client/requests/index.d.mts

@@ -2,4 +2,3 @@ export { type ThreadListAllRequest } from "./ThreadListAllRequest.mjs";
 export { type CreateThreadRequest } from "./CreateThreadRequest.mjs";
 export { type ThreadGetUserContextRequest } from "./ThreadGetUserContextRequest.mjs";
 export { type ThreadGetRequest } from "./ThreadGetRequest.mjs";
-export { type AddThreadMessagesRequest } from "./AddThreadMessagesRequest.mjs";

package/dist/esm/api/{resources/thread/client/requests → types}/AddThreadMessagesRequest.d.mts

@@ -1,16 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as Zep from "../../../../index.mjs";
-/**
- * @example
- *     {
- *         messages: [{
- *                 content: "content",
- *                 role: "norole"
- *             }]
- *     }
- */
+import * as Zep from "../index.mjs";
 export interface AddThreadMessagesRequest {
     /**
      * Optional list of role types to ignore when adding messages to graph memory.
@@ -20,6 +11,6 @@ export interface AddThreadMessagesRequest {
     ignoreRoles?: Zep.RoleType[];
     /** A list of message objects, where each message contains a role and content. */
     messages: Zep.Message[];
-    /** Optionally return memory context relevant to the most recent messages. */
+    /** Optionally return context block relevant to the most recent messages. */
     returnContext?: boolean;
 }

package/dist/esm/api/types/AddThreadMessagesResponse.d.mts

@@ -3,4 +3,5 @@
  */
 export interface AddThreadMessagesResponse {
     context?: string;
+    messageUuids?: string[];
 }

package/dist/esm/api/types/ThreadContextResponse.d.mts

@@ -2,6 +2,6 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 export interface ThreadContextResponse {
-    /** Memory context containing relevant facts and entities for the session. Can be put into the prompt directly. */
+    /** Context block containing relevant facts, entities, and messages/episodes from the user graph. Meant to be replaced in the system prompt on every chat turn. */
     context?: string;
 }

package/dist/esm/api/types/index.d.mts

@@ -1,4 +1,5 @@
 export * from "./ApiError.mjs";
+export * from "./AddThreadMessagesRequest.mjs";
 export * from "./AddThreadMessagesResponse.mjs";
 export * from "./CloneGraphResponse.mjs";
 export * from "./EdgeType.mjs";

package/dist/esm/api/types/index.mjs

@@ -1,4 +1,5 @@
 export * from "./ApiError.mjs";
+export * from "./AddThreadMessagesRequest.mjs";
 export * from "./AddThreadMessagesResponse.mjs";
 export * from "./CloneGraphResponse.mjs";
 export * from "./EdgeType.mjs";

package/dist/esm/contextString.d.mts

@@ -1,4 +1,4 @@
-import { EntityEdge, EntityNode } from "./api/index.mjs";
+import { EntityEdge, EntityNode, Episode } from "./api/index.mjs";
 /**
  * Format the date range of an entity edge.
  *
@@ -7,10 +7,11 @@ import { EntityEdge, EntityNode } from "./api/index.mjs";
  */
 export declare function formatEdgeDateRange(edge: EntityEdge): string;
 /**
- * Compose a search context from entity edges and nodes.
+ * Compose a search context from entity edges, nodes, and episodes.
  *
  * @param edges - List of entity edges.
  * @param nodes - List of entity nodes.
- * @returns A formatted string containing facts and entities.
+ * @param episodes - List of episodes.
+ * @returns A formatted string containing facts, entities, and episodes.
  */
-export declare function composeContextString(edges: EntityEdge[], nodes: EntityNode[]): string;
+export declare function composeContextString(edges: EntityEdge[], nodes: EntityNode[], episodes?: Episode[]): string;

package/dist/esm/contextString.mjs

@@ -1,5 +1,5 @@
 const TEMPLATE_STRING = `
-FACTS and ENTITIES represent relevant context to the current conversation.
+FACTS and ENTITIES%episodesHeader% represent relevant context to the current conversation.
 
 # These are the most relevant facts and their valid date ranges
 # format: FACT (Date range: from - to)
@@ -8,10 +8,15 @@ FACTS and ENTITIES represent relevant context to the current conversation.
 </FACTS>
 
 # These are the most relevant entities
-# ENTITY_NAME: entity summary
+# Name: ENTITY_NAME
+# Label: entity_label (if present)
+# Attributes: (if present)
+#   attr_name: attr_value
+# Summary: entity summary
 <ENTITIES>
 %entities%
 </ENTITIES>
+%episodesSection%
 `;
 /**
  * Format the date range of an entity edge.
@@ -52,20 +57,72 @@ function formatDate(date) {
         .replace(/^(\d{2})-(\d{2})-(\d{4})/, "$3-$1-$2");
 }
 /**
- * Compose a search context from entity edges and nodes.
+ * Compose a search context from entity edges, nodes, and episodes.
  *
  * @param edges - List of entity edges.
  * @param nodes - List of entity nodes.
- * @returns A formatted string containing facts and entities.
+ * @param episodes - List of episodes.
+ * @returns A formatted string containing facts, entities, and episodes.
  */
-export function composeContextString(edges, nodes) {
+export function composeContextString(edges, nodes, episodes = []) {
     const facts = edges.map((edge) => {
-        return `  - ${edge.fact} (${formatEdgeDateRange(edge)})`;
+        return `  - ${edge.fact} (Date range: ${formatEdgeDateRange(edge)})`;
     });
     const entities = nodes.map((node) => {
-        return `  - ${node.name}: ${node.summary}`;
+        const entityParts = [`Name: ${node.name}`];
+        if (node.labels && node.labels.length > 0) {
+            const labels = [...node.labels];
+            const entityIndex = labels.indexOf('Entity');
+            if (entityIndex > -1) {
+                labels.splice(entityIndex, 1);
+            }
+            if (labels.length > 0) {
+                entityParts.push(`Label: ${labels[0]}`);
+            }
+        }
+        if (node.attributes && Object.keys(node.attributes).length > 0) {
+            const filteredAttributes = Object.assign({}, node.attributes);
+            delete filteredAttributes.labels;
+            if (Object.keys(filteredAttributes).length > 0) {
+                entityParts.push('Attributes:');
+                Object.entries(filteredAttributes).forEach(([key, value]) => {
+                    entityParts.push(`  ${key}: ${value}`);
+                });
+            }
+        }
+        if (node.summary && node.summary.trim()) {
+            entityParts.push(`Summary: ${node.summary}`);
+        }
+        return entityParts.join('\n');
     });
+    const episodesList = [];
+    if (episodes.length > 0) {
+        episodes.forEach((episode) => {
+            let rolePrefix = "";
+            if (episode.role && episode.roleType) {
+                rolePrefix = `${episode.role} (${episode.roleType}): `;
+            }
+            else if (episode.role) {
+                rolePrefix = `${episode.role}: `;
+            }
+            else if (episode.roleType) {
+                rolePrefix = `(${episode.roleType}): `;
+            }
+            const timestamp = formatDate(new Date(episode.createdAt));
+            const episodeStr = `  - ${rolePrefix}${episode.content} (${timestamp})`;
+            episodesList.push(episodeStr);
+        });
+    }
     const factsStr = facts.join("\n");
     const entitiesStr = entities.join("\n");
-    return TEMPLATE_STRING.replace("%facts%", factsStr).replace("%entities%", entitiesStr);
+    const episodesStr = episodesList.join("\n");
+    const episodesHeader = episodes.length > 0 ? ", and EPISODES" : "";
+    const episodesSection = episodes.length > 0
+        ? `\n# These are the most relevant episodes\n<EPISODES>\n${episodesStr}\n</EPISODES>`
+        : "";
+    return TEMPLATE_STRING
+        .replace("%episodesHeader%", episodesHeader)
+        .replace("%facts%", factsStr)
+        .replace("%entities%", entitiesStr)
+        .replace("%episodesSection%", episodesSection);
 }

package/dist/esm/serialization/resources/thread/client/requests/index.d.mts

@@ -1,2 +1 @@
 export { CreateThreadRequest } from "./CreateThreadRequest.mjs";
-export { AddThreadMessagesRequest } from "./AddThreadMessagesRequest.mjs";

package/dist/esm/serialization/resources/thread/client/requests/index.mjs

@@ -1,2 +1 @@
 export { CreateThreadRequest } from "./CreateThreadRequest.mjs";
-export { AddThreadMessagesRequest } from "./AddThreadMessagesRequest.mjs";

package/dist/esm/serialization/types/AddThreadMessagesRequest.d.mts

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as serializers from "../index.mjs";
+import * as Zep from "../../api/index.mjs";
+import * as core from "../../core/index.mjs";
+import { RoleType } from "./RoleType.mjs";
+import { Message } from "./Message.mjs";
+export declare const AddThreadMessagesRequest: core.serialization.ObjectSchema<serializers.AddThreadMessagesRequest.Raw, Zep.AddThreadMessagesRequest>;
+export declare namespace AddThreadMessagesRequest {
+    interface Raw {
+        ignore_roles?: RoleType.Raw[] | null;
+        messages: Message.Raw[];
+        return_context?: boolean | null;
+    }
+}

package/dist/esm/serialization/{resources/thread/client/requests → types}/AddThreadMessagesRequest.mjs

@@ -1,9 +1,9 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as core from "../../../../../core/index.mjs";
-import { RoleType } from "../../../../types/RoleType.mjs";
-import { Message } from "../../../../types/Message.mjs";
+import * as core from "../../core/index.mjs";
+import { RoleType } from "./RoleType.mjs";
+import { Message } from "./Message.mjs";
 export const AddThreadMessagesRequest = core.serialization.object({
     ignoreRoles: core.serialization.property("ignore_roles", core.serialization.list(RoleType).optional()),
     messages: core.serialization.list(Message),

package/dist/esm/serialization/types/AddThreadMessagesResponse.d.mts

@@ -8,5 +8,6 @@ export declare const AddThreadMessagesResponse: core.serialization.ObjectSchema<
 export declare namespace AddThreadMessagesResponse {
     interface Raw {
         context?: string | null;
+        message_uuids?: string[] | null;
     }
 }

package/dist/esm/serialization/types/AddThreadMessagesResponse.mjs

@@ -4,4 +4,5 @@
 import * as core from "../../core/index.mjs";
 export const AddThreadMessagesResponse = core.serialization.object({
     context: core.serialization.string().optional(),
+    messageUuids: core.serialization.property("message_uuids", core.serialization.list(core.serialization.string()).optional()),
 });

package/dist/esm/serialization/types/index.d.mts

@@ -1,4 +1,5 @@
 export * from "./ApiError.mjs";
+export * from "./AddThreadMessagesRequest.mjs";
 export * from "./AddThreadMessagesResponse.mjs";
 export * from "./CloneGraphResponse.mjs";
 export * from "./EdgeType.mjs";

package/dist/esm/serialization/types/index.mjs

@@ -1,4 +1,5 @@
 export * from "./ApiError.mjs";
+export * from "./AddThreadMessagesRequest.mjs";
 export * from "./AddThreadMessagesResponse.mjs";
 export * from "./CloneGraphResponse.mjs";
 export * from "./EdgeType.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.2.0";
+export declare const SDK_VERSION = "3.4.1";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "3.2.0";
+export const SDK_VERSION = "3.4.1";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@getzep/zep-cloud",
-    "version": "3.2.0",
+    "version": "3.4.1",
     "private": false,
     "repository": "https://github.com/getzep/zep-js",
     "description": "Zep: Fast, scalable building blocks for production LLM apps",

package/reference.md

@@ -471,7 +471,7 @@ await client.graph.create({
 <dl>
 <dd>
 
-List all graphs. In order to list users, use user.list_ordered instead
+Returns all graphs. In order to list users, use user.list_ordered instead
 
 </dd>
 </dl>
@@ -990,7 +990,7 @@ await client.thread.delete("threadId");
 <dl>
 <dd>
 
-Returns most relevant context for a given thread.
+Returns most relevant context from the user graph (including memory from any/all past threads) based on the content of the past few messages of the given thread.
 
 </dd>
 </dl>
@@ -1022,7 +1022,7 @@ await client.thread.getUserContext("threadId");
 <dl>
 <dd>
 
-**threadId:** `string` — The ID of the thread for which to retrieve context.
+**threadId:** `string` — The ID of the current thread (for which context is being retrieved).
 
 </dd>
 </dl>
@@ -1198,6 +1198,84 @@ await client.thread.addMessages("threadId", {
 </dl>
 </details>
 
+<details><summary><code>client.thread.<a href="/src/api/resources/thread/client/Client.ts">addMessagesBatch</a>(threadId, { ...params }) -> Zep.AddThreadMessagesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Add messages to a thread in batch mode. This will process messages concurrently, which is useful for data migrations.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.thread.addMessagesBatch("threadId", {
+    messages: [
+        {
+            content: "content",
+            role: "norole",
+        },
+    ],
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**threadId:** `string` — The ID of the thread to which messages should be added.
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Zep.AddThreadMessagesRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Thread.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 ## User
 
 <details><summary><code>client.user.<a href="/src/api/resources/user/client/Client.ts">add</a>({ ...params }) -> Zep.User</code></summary>

package/dist/cjs/serialization/resources/thread/client/requests/AddThreadMessagesRequest.d.ts

@@ -1,16 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as serializers from "../../../../index.js";
-import * as Zep from "../../../../../api/index.js";
-import * as core from "../../../../../core/index.js";
-import { RoleType } from "../../../../types/RoleType.js";
-import { Message } from "../../../../types/Message.js";
-export declare const AddThreadMessagesRequest: core.serialization.Schema<serializers.AddThreadMessagesRequest.Raw, Zep.AddThreadMessagesRequest>;
-export declare namespace AddThreadMessagesRequest {
-    interface Raw {
-        ignore_roles?: RoleType.Raw[] | null;
-        messages: Message.Raw[];
-        return_context?: boolean | null;
-    }
-}

package/dist/esm/serialization/resources/thread/client/requests/AddThreadMessagesRequest.d.mts

@@ -1,16 +0,0 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as serializers from "../../../../index.mjs";
-import * as Zep from "../../../../../api/index.mjs";
-import * as core from "../../../../../core/index.mjs";
-import { RoleType } from "../../../../types/RoleType.mjs";
-import { Message } from "../../../../types/Message.mjs";
-export declare const AddThreadMessagesRequest: core.serialization.Schema<serializers.AddThreadMessagesRequest.Raw, Zep.AddThreadMessagesRequest>;
-export declare namespace AddThreadMessagesRequest {
-    interface Raw {
-        ignore_roles?: RoleType.Raw[] | null;
-        messages: Message.Raw[];
-        return_context?: boolean | null;
-    }
-}