@getzep/zep-cloud 3.13.0 → 3.14.0

package/README.md

@@ -8,7 +8,7 @@
 </p>
 
 <h1 align="center">
-Zep: Long-Term Memory for ‍AI Assistants.
+Zep: Context Engineering for AI Assistants.
 </h1>
 <h2 align="center">Recall, understand, and extract data from chat histories. Power personalized AI experiences.</h2>
 <br />
@@ -21,7 +21,7 @@ Zep: Long-Term Memory for ‍AI Assistants.
 </p>
 
 ## What is Zep? 💬
-Zep is a long-term memory service for AI Assistant apps. With Zep, you can provide AI assistants with the ability to recall past conversations, no matter how distant, while also reducing hallucinations, latency, and cost.
+Zep is a context engineering platform for AI Assistant apps. With Zep, you can provide AI assistants with the right context from past conversations, no matter how distant, while also reducing hallucinations, latency, and cost.
 
 ### Cloud Installation
 You can install the Zep Cloud SDK by running:
@@ -50,7 +50,7 @@ npm install @getzep/zep-js@^0.10.0
 
 Zep persists and recalls chat histories, and automatically generates summaries and other artifacts from these chat histories. It also embeds messages and summaries, enabling you to search Zep for relevant context from past conversations. Zep does all of this asynchronously, ensuring these operations don't impact your user's chat experience. Data is persisted to database, allowing you to scale out when growth demands.
 
-Zep also provides a simple, easy to use abstraction for document vector search called Document Collections. This is designed to complement Zep's core memory features, but is not designed to be a general purpose vector database.
+Zep also provides a simple, easy to use abstraction for document vector search called Document Collections. This is designed to complement Zep's core context features, but is not designed to be a general purpose vector database.
 
 Zep allows you to be more intentional about constructing your prompt:
 1. automatically adding a few recent messages, with the number customized for your app;

package/dist/cjs/Client.js

@@ -50,8 +50,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.13.0",
-                "User-Agent": "zep-cloud/3.13.0",
+                "X-Fern-SDK-Version": "3.14.0",
+                "User-Agent": "zep-cloud/3.14.0",
                 "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

@@ -117,9 +117,7 @@ export declare class Graph {
      * @example
      *     await client.graph.addFactTriple({
      *         fact: "fact",
-     *         factName: "fact_name",
-     *         sourceNodeName: "source_node_name",
-     *         targetNodeName: "target_node_name"
+     *         factName: "fact_name"
      *     })
      */
     addFactTriple(request: Zep.AddTripleRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.AddTripleResponse>;

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

@@ -454,9 +454,7 @@ class Graph {
      * @example
      *     await client.graph.addFactTriple({
      *         fact: "fact",
-     *         factName: "fact_name",
-     *         sourceNodeName: "source_node_name",
-     *         targetNodeName: "target_node_name"
+     *         factName: "fact_name"
      *     })
      */
     addFactTriple(request, requestOptions) {

package/dist/cjs/api/resources/graph/client/requests/AddTripleRequest.d.ts

@@ -5,14 +5,17 @@
  * @example
  *     {
  *         fact: "fact",
- *         factName: "fact_name",
- *         sourceNodeName: "source_node_name",
- *         targetNodeName: "target_node_name"
+ *         factName: "fact_name"
  *     }
  */
 export interface AddTripleRequest {
     /** The timestamp of the message */
     createdAt?: string;
+    /**
+     * Additional attributes of the edge. Values must be scalar types (string, number, boolean, or null).
+     * Nested objects and arrays are not allowed.
+     */
+    edgeAttributes?: Record<string, unknown>;
     /** The time (if any) at which the edge expires */
     expiredAt?: string;
     /** The fact relating the two nodes that this edge represents */
@@ -24,14 +27,24 @@ export interface AddTripleRequest {
     graphId?: string;
     /** The time (if any) at which the fact stops being true */
     invalidAt?: string;
+    /**
+     * Additional attributes of the source node. Values must be scalar types (string, number, boolean, or null).
+     * Nested objects and arrays are not allowed.
+     */
+    sourceNodeAttributes?: Record<string, unknown>;
     /** The name of the source node to add */
-    sourceNodeName: string;
+    sourceNodeName?: string;
     /** The summary of the source node to add */
     sourceNodeSummary?: string;
     /** The source node uuid */
     sourceNodeUuid?: string;
+    /**
+     * Additional attributes of the target node. Values must be scalar types (string, number, boolean, or null).
+     * Nested objects and arrays are not allowed.
+     */
+    targetNodeAttributes?: Record<string, unknown>;
     /** The name of the target node to add */
-    targetNodeName: string;
+    targetNodeName?: string;
     /** The summary of the target node to add */
     targetNodeSummary?: string;
     /** The target node uuid */

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

@@ -101,6 +101,20 @@ export declare class Node {
      */
     get(uuid: string, requestOptions?: Node.RequestOptions): core.HttpResponsePromise<Zep.EntityNode>;
     private __get;
+    /**
+     * Deletes a node by UUID.
+     *
+     * @param {string} uuid - Node UUID
+     * @param {Node.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.node.delete("uuid")
+     */
+    delete(uuid: string, requestOptions?: Node.RequestOptions): core.HttpResponsePromise<Zep.SuccessResponse>;
+    private __delete;
     protected _getCustomAuthorizationHeaders(): Promise<{
         Authorization: string;
     }>;

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

@@ -484,6 +484,87 @@ class Node {
             }
         });
     }
+    /**
+     * Deletes a node by UUID.
+     *
+     * @param {string} uuid - Node UUID
+     * @param {Node.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.node.delete("uuid")
+     */
+    delete(uuid, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__delete(uuid, requestOptions));
+    }
+    __delete(uuid, 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, `graph/node/${encodeURIComponent(uuid)}`),
+                method: "DELETE",
+                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),
+                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.SuccessResponse.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 400:
+                        throw new Zep.BadRequestError(serializers.ApiError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    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 DELETE /graph/node/{uuid}.");
+                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/ThreadGetUserContextRequest.d.ts

@@ -12,7 +12,7 @@ import * as Zep from "../../../../index.js";
  */
 export interface ThreadGetUserContextRequest {
     /**
-     * The minimum rating by which to filter relevant facts.
+     * Deprecated, this field will be removed in a future release. The minimum rating by which to filter relevant facts.
      */
     minRating?: number;
     /**

package/dist/cjs/api/resources/user/client/requests/CreateUserRequest.d.ts

@@ -13,7 +13,7 @@ export interface CreateUserRequest {
     disableDefaultOntology?: boolean;
     /** The email address of the user. */
     email?: string;
-    /** Optional instruction to use for fact rating. */
+    /** Deprecated: this field will be removed in a future release. Optional instruction to use for fact rating. */
     factRatingInstruction?: Zep.FactRatingInstruction;
     /** The first name of the user. */
     firstName?: string;

package/dist/cjs/api/resources/user/client/requests/UpdateUserRequest.d.ts

@@ -11,7 +11,7 @@ export interface UpdateUserRequest {
     disableDefaultOntology?: boolean;
     /** The email address of the user. */
     email?: string;
-    /** Optional instruction to use for fact rating. */
+    /** Deprecated: this field will be removed in a future release. Optional instruction to use for fact rating. */
     factRatingInstruction?: Zep.FactRatingInstruction;
     /** The first name of the user. */
     firstName?: string;

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

@@ -5,6 +5,9 @@ import * as Zep from "../index.js";
 export interface DateFilter {
     /** Comparison operator for date filter */
     comparisonOperator: Zep.ComparisonOperator;
-    /** Date to filter on */
-    date: string;
+    /**
+     * Date to filter on. Required for non-null operators (=, <>, >, <, >=, <=).
+     * Should be omitted for IS NULL and IS NOT NULL operators.
+     */
+    date?: string;
 }

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

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../index.js";
+export interface PropertyFilter {
+    /** Comparison operator for property filter */
+    comparisonOperator: Zep.ComparisonOperator;
+    /** Property name to filter on */
+    propertyName: string;
+    /**
+     * Property value to match on. Accepted types: string, int, float64, bool, or nil.
+     * Invalid types (e.g., arrays, objects) will be rejected by validation.
+     * Must be non-nil for non-null operators (=, <>, >, <, >=, <=).
+     */
+    propertyValue?: unknown;
+}

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

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -13,6 +13,8 @@ export interface SearchFilters {
     createdAt?: Zep.DateFilter[][];
     /** List of edge types to filter on */
     edgeTypes?: string[];
+    /** List of edge UUIDs to filter on */
+    edgeUuids?: string[];
     /** List of edge types to exclude from results */
     excludeEdgeTypes?: string[];
     /** List of node labels to exclude from results */
@@ -35,6 +37,8 @@ export interface SearchFilters {
     invalidAt?: Zep.DateFilter[][];
     /** List of node labels to filter on */
     nodeLabels?: string[];
+    /** List of property filters to apply to nodes and edges */
+    propertyFilters?: Zep.PropertyFilter[];
     /**
      * 2D array of date filters for the valid_at field.
      * The outer array elements are combined with OR logic.

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

@@ -43,6 +43,7 @@ export * from "./DateFilter.js";
 export * from "./EntityEdge.js";
 export * from "./EntityNode.js";
 export * from "./GraphSearchScope.js";
+export * from "./PropertyFilter.js";
 export * from "./Reranker.js";
 export * from "./SearchFilters.js";
 export * from "./EntityPropertyType.js";

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

@@ -59,6 +59,7 @@ __exportStar(require("./DateFilter.js"), exports);
 __exportStar(require("./EntityEdge.js"), exports);
 __exportStar(require("./EntityNode.js"), exports);
 __exportStar(require("./GraphSearchScope.js"), exports);
+__exportStar(require("./PropertyFilter.js"), exports);
 __exportStar(require("./Reranker.js"), exports);
 __exportStar(require("./SearchFilters.js"), exports);
 __exportStar(require("./EntityPropertyType.js"), exports);

package/dist/cjs/serialization/resources/graph/client/requests/AddTripleRequest.d.ts

@@ -8,16 +8,19 @@ export declare const AddTripleRequest: core.serialization.Schema<serializers.Add
 export declare namespace AddTripleRequest {
     interface Raw {
         created_at?: string | null;
+        edge_attributes?: Record<string, unknown> | null;
         expired_at?: string | null;
         fact: string;
         fact_name: string;
         fact_uuid?: string | null;
         graph_id?: string | null;
         invalid_at?: string | null;
-        source_node_name: string;
+        source_node_attributes?: Record<string, unknown> | null;
+        source_node_name?: string | null;
         source_node_summary?: string | null;
         source_node_uuid?: string | null;
-        target_node_name: string;
+        target_node_attributes?: Record<string, unknown> | null;
+        target_node_name?: string | null;
         target_node_summary?: string | null;
         target_node_uuid?: string | null;
         user_id?: string | null;

package/dist/cjs/serialization/resources/graph/client/requests/AddTripleRequest.js

@@ -40,16 +40,19 @@ exports.AddTripleRequest = void 0;
 const core = __importStar(require("../../../../../core/index.js"));
 exports.AddTripleRequest = core.serialization.object({
     createdAt: core.serialization.property("created_at", core.serialization.string().optional()),
+    edgeAttributes: core.serialization.property("edge_attributes", core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional()),
     expiredAt: core.serialization.property("expired_at", core.serialization.string().optional()),
     fact: core.serialization.string(),
     factName: core.serialization.property("fact_name", core.serialization.string()),
     factUuid: core.serialization.property("fact_uuid", core.serialization.string().optional()),
     graphId: core.serialization.property("graph_id", core.serialization.string().optional()),
     invalidAt: core.serialization.property("invalid_at", core.serialization.string().optional()),
-    sourceNodeName: core.serialization.property("source_node_name", core.serialization.string()),
+    sourceNodeAttributes: core.serialization.property("source_node_attributes", core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional()),
+    sourceNodeName: core.serialization.property("source_node_name", core.serialization.string().optional()),
     sourceNodeSummary: core.serialization.property("source_node_summary", core.serialization.string().optional()),
     sourceNodeUuid: core.serialization.property("source_node_uuid", core.serialization.string().optional()),
-    targetNodeName: core.serialization.property("target_node_name", core.serialization.string()),
+    targetNodeAttributes: core.serialization.property("target_node_attributes", core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional()),
+    targetNodeName: core.serialization.property("target_node_name", core.serialization.string().optional()),
     targetNodeSummary: core.serialization.property("target_node_summary", core.serialization.string().optional()),
     targetNodeUuid: core.serialization.property("target_node_uuid", core.serialization.string().optional()),
     userId: core.serialization.property("user_id", core.serialization.string().optional()),

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

@@ -9,6 +9,6 @@ export declare const DateFilter: core.serialization.ObjectSchema<serializers.Dat
 export declare namespace DateFilter {
     interface Raw {
         comparison_operator: ComparisonOperator.Raw;
-        date: string;
+        date?: string | null;
     }
 }

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

@@ -41,5 +41,5 @@ const core = __importStar(require("../../core/index.js"));
 const ComparisonOperator_js_1 = require("./ComparisonOperator.js");
 exports.DateFilter = core.serialization.object({
     comparisonOperator: core.serialization.property("comparison_operator", ComparisonOperator_js_1.ComparisonOperator),
-    date: core.serialization.string(),
+    date: core.serialization.string().optional(),
 });

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

@@ -0,0 +1,15 @@
+/**
+ * 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 { ComparisonOperator } from "./ComparisonOperator.js";
+export declare const PropertyFilter: core.serialization.ObjectSchema<serializers.PropertyFilter.Raw, Zep.PropertyFilter>;
+export declare namespace PropertyFilter {
+    interface Raw {
+        comparison_operator: ComparisonOperator.Raw;
+        property_name: string;
+        property_value?: unknown | null;
+    }
+}

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

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertyFilter = void 0;
+const core = __importStar(require("../../core/index.js"));
+const ComparisonOperator_js_1 = require("./ComparisonOperator.js");
+exports.PropertyFilter = core.serialization.object({
+    comparisonOperator: core.serialization.property("comparison_operator", ComparisonOperator_js_1.ComparisonOperator),
+    propertyName: core.serialization.property("property_name", core.serialization.string()),
+    propertyValue: core.serialization.property("property_value", core.serialization.unknown().optional()),
+});

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

@@ -5,16 +5,19 @@ import * as serializers from "../index.js";
 import * as Zep from "../../api/index.js";
 import * as core from "../../core/index.js";
 import { DateFilter } from "./DateFilter.js";
+import { PropertyFilter } from "./PropertyFilter.js";
 export declare const SearchFilters: core.serialization.ObjectSchema<serializers.SearchFilters.Raw, Zep.SearchFilters>;
 export declare namespace SearchFilters {
     interface Raw {
         created_at?: DateFilter.Raw[][] | null;
         edge_types?: string[] | null;
+        edge_uuids?: string[] | null;
         exclude_edge_types?: string[] | null;
         exclude_node_labels?: string[] | null;
         expired_at?: DateFilter.Raw[][] | null;
         invalid_at?: DateFilter.Raw[][] | null;
         node_labels?: string[] | null;
+        property_filters?: PropertyFilter.Raw[] | null;
         valid_at?: DateFilter.Raw[][] | null;
     }
 }

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

@@ -39,13 +39,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SearchFilters = void 0;
 const core = __importStar(require("../../core/index.js"));
 const DateFilter_js_1 = require("./DateFilter.js");
+const PropertyFilter_js_1 = require("./PropertyFilter.js");
 exports.SearchFilters = core.serialization.object({
     createdAt: core.serialization.property("created_at", core.serialization.list(core.serialization.list(DateFilter_js_1.DateFilter)).optional()),
     edgeTypes: core.serialization.property("edge_types", core.serialization.list(core.serialization.string()).optional()),
+    edgeUuids: core.serialization.property("edge_uuids", core.serialization.list(core.serialization.string()).optional()),
     excludeEdgeTypes: core.serialization.property("exclude_edge_types", core.serialization.list(core.serialization.string()).optional()),
     excludeNodeLabels: core.serialization.property("exclude_node_labels", core.serialization.list(core.serialization.string()).optional()),
     expiredAt: core.serialization.property("expired_at", core.serialization.list(core.serialization.list(DateFilter_js_1.DateFilter)).optional()),
     invalidAt: core.serialization.property("invalid_at", core.serialization.list(core.serialization.list(DateFilter_js_1.DateFilter)).optional()),
     nodeLabels: core.serialization.property("node_labels", core.serialization.list(core.serialization.string()).optional()),
+    propertyFilters: core.serialization.property("property_filters", core.serialization.list(PropertyFilter_js_1.PropertyFilter).optional()),
     validAt: core.serialization.property("valid_at", core.serialization.list(core.serialization.list(DateFilter_js_1.DateFilter)).optional()),
 });

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

@@ -43,6 +43,7 @@ export * from "./DateFilter.js";
 export * from "./EntityEdge.js";
 export * from "./EntityNode.js";
 export * from "./GraphSearchScope.js";
+export * from "./PropertyFilter.js";
 export * from "./Reranker.js";
 export * from "./SearchFilters.js";
 export * from "./EntityPropertyType.js";

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

@@ -59,6 +59,7 @@ __exportStar(require("./DateFilter.js"), exports);
 __exportStar(require("./EntityEdge.js"), exports);
 __exportStar(require("./EntityNode.js"), exports);
 __exportStar(require("./GraphSearchScope.js"), exports);
+__exportStar(require("./PropertyFilter.js"), exports);
 __exportStar(require("./Reranker.js"), exports);
 __exportStar(require("./SearchFilters.js"), exports);
 __exportStar(require("./EntityPropertyType.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.13.0";
+export declare const SDK_VERSION = "3.14.0";

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.13.0";
+exports.SDK_VERSION = "3.14.0";

package/dist/esm/Client.mjs

@@ -14,8 +14,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.13.0",
-                "User-Agent": "zep-cloud/3.13.0",
+                "X-Fern-SDK-Version": "3.14.0",
+                "User-Agent": "zep-cloud/3.14.0",
                 "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

@@ -117,9 +117,7 @@ export declare class Graph {
      * @example
      *     await client.graph.addFactTriple({
      *         fact: "fact",
-     *         factName: "fact_name",
-     *         sourceNodeName: "source_node_name",
-     *         targetNodeName: "target_node_name"
+     *         factName: "fact_name"
      *     })
      */
     addFactTriple(request: Zep.AddTripleRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.AddTripleResponse>;

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

@@ -418,9 +418,7 @@ export class Graph {
      * @example
      *     await client.graph.addFactTriple({
      *         fact: "fact",
-     *         factName: "fact_name",
-     *         sourceNodeName: "source_node_name",
-     *         targetNodeName: "target_node_name"
+     *         factName: "fact_name"
      *     })
      */
     addFactTriple(request, requestOptions) {

package/dist/esm/api/resources/graph/client/requests/AddTripleRequest.d.mts

@@ -5,14 +5,17 @@
  * @example
  *     {
  *         fact: "fact",
- *         factName: "fact_name",
- *         sourceNodeName: "source_node_name",
- *         targetNodeName: "target_node_name"
+ *         factName: "fact_name"
  *     }
  */
 export interface AddTripleRequest {
     /** The timestamp of the message */
     createdAt?: string;
+    /**
+     * Additional attributes of the edge. Values must be scalar types (string, number, boolean, or null).
+     * Nested objects and arrays are not allowed.
+     */
+    edgeAttributes?: Record<string, unknown>;
     /** The time (if any) at which the edge expires */
     expiredAt?: string;
     /** The fact relating the two nodes that this edge represents */
@@ -24,14 +27,24 @@ export interface AddTripleRequest {
     graphId?: string;
     /** The time (if any) at which the fact stops being true */
     invalidAt?: string;
+    /**
+     * Additional attributes of the source node. Values must be scalar types (string, number, boolean, or null).
+     * Nested objects and arrays are not allowed.
+     */
+    sourceNodeAttributes?: Record<string, unknown>;
     /** The name of the source node to add */
-    sourceNodeName: string;
+    sourceNodeName?: string;
     /** The summary of the source node to add */
     sourceNodeSummary?: string;
     /** The source node uuid */
     sourceNodeUuid?: string;
+    /**
+     * Additional attributes of the target node. Values must be scalar types (string, number, boolean, or null).
+     * Nested objects and arrays are not allowed.
+     */
+    targetNodeAttributes?: Record<string, unknown>;
     /** The name of the target node to add */
-    targetNodeName: string;
+    targetNodeName?: string;
     /** The summary of the target node to add */
     targetNodeSummary?: string;
     /** The target node uuid */

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

@@ -101,6 +101,20 @@ export declare class Node {
      */
     get(uuid: string, requestOptions?: Node.RequestOptions): core.HttpResponsePromise<Zep.EntityNode>;
     private __get;
+    /**
+     * Deletes a node by UUID.
+     *
+     * @param {string} uuid - Node UUID
+     * @param {Node.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.node.delete("uuid")
+     */
+    delete(uuid: string, requestOptions?: Node.RequestOptions): core.HttpResponsePromise<Zep.SuccessResponse>;
+    private __delete;
     protected _getCustomAuthorizationHeaders(): Promise<{
         Authorization: string;
     }>;

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

@@ -448,6 +448,87 @@ export class Node {
             }
         });
     }
+    /**
+     * Deletes a node by UUID.
+     *
+     * @param {string} uuid - Node UUID
+     * @param {Node.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.node.delete("uuid")
+     */
+    delete(uuid, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__delete(uuid, requestOptions));
+    }
+    __delete(uuid, 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, `graph/node/${encodeURIComponent(uuid)}`),
+                method: "DELETE",
+                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),
+                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.SuccessResponse.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 400:
+                        throw new Zep.BadRequestError(serializers.ApiError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    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 DELETE /graph/node/{uuid}.");
+                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/ThreadGetUserContextRequest.d.mts

@@ -12,7 +12,7 @@ import * as Zep from "../../../../index.mjs";
  */
 export interface ThreadGetUserContextRequest {
     /**
-     * The minimum rating by which to filter relevant facts.
+     * Deprecated, this field will be removed in a future release. The minimum rating by which to filter relevant facts.
      */
     minRating?: number;
     /**

package/dist/esm/api/resources/user/client/requests/CreateUserRequest.d.mts

@@ -13,7 +13,7 @@ export interface CreateUserRequest {
     disableDefaultOntology?: boolean;
     /** The email address of the user. */
     email?: string;
-    /** Optional instruction to use for fact rating. */
+    /** Deprecated: this field will be removed in a future release. Optional instruction to use for fact rating. */
     factRatingInstruction?: Zep.FactRatingInstruction;
     /** The first name of the user. */
     firstName?: string;

package/dist/esm/api/resources/user/client/requests/UpdateUserRequest.d.mts

@@ -11,7 +11,7 @@ export interface UpdateUserRequest {
     disableDefaultOntology?: boolean;
     /** The email address of the user. */
     email?: string;
-    /** Optional instruction to use for fact rating. */
+    /** Deprecated: this field will be removed in a future release. Optional instruction to use for fact rating. */
     factRatingInstruction?: Zep.FactRatingInstruction;
     /** The first name of the user. */
     firstName?: string;

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

@@ -5,6 +5,9 @@ import * as Zep from "../index.mjs";
 export interface DateFilter {
     /** Comparison operator for date filter */
     comparisonOperator: Zep.ComparisonOperator;
-    /** Date to filter on */
-    date: string;
+    /**
+     * Date to filter on. Required for non-null operators (=, <>, >, <, >=, <=).
+     * Should be omitted for IS NULL and IS NOT NULL operators.
+     */
+    date?: string;
 }

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

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../index.mjs";
+export interface PropertyFilter {
+    /** Comparison operator for property filter */
+    comparisonOperator: Zep.ComparisonOperator;
+    /** Property name to filter on */
+    propertyName: string;
+    /**
+     * Property value to match on. Accepted types: string, int, float64, bool, or nil.
+     * Invalid types (e.g., arrays, objects) will be rejected by validation.
+     * Must be non-nil for non-null operators (=, <>, >, <, >=, <=).
+     */
+    propertyValue?: unknown;
+}

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

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

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

@@ -13,6 +13,8 @@ export interface SearchFilters {
     createdAt?: Zep.DateFilter[][];
     /** List of edge types to filter on */
     edgeTypes?: string[];
+    /** List of edge UUIDs to filter on */
+    edgeUuids?: string[];
     /** List of edge types to exclude from results */
     excludeEdgeTypes?: string[];
     /** List of node labels to exclude from results */
@@ -35,6 +37,8 @@ export interface SearchFilters {
     invalidAt?: Zep.DateFilter[][];
     /** List of node labels to filter on */
     nodeLabels?: string[];
+    /** List of property filters to apply to nodes and edges */
+    propertyFilters?: Zep.PropertyFilter[];
     /**
      * 2D array of date filters for the valid_at field.
      * The outer array elements are combined with OR logic.

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

@@ -43,6 +43,7 @@ export * from "./DateFilter.mjs";
 export * from "./EntityEdge.mjs";
 export * from "./EntityNode.mjs";
 export * from "./GraphSearchScope.mjs";
+export * from "./PropertyFilter.mjs";
 export * from "./Reranker.mjs";
 export * from "./SearchFilters.mjs";
 export * from "./EntityPropertyType.mjs";

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

@@ -43,6 +43,7 @@ export * from "./DateFilter.mjs";
 export * from "./EntityEdge.mjs";
 export * from "./EntityNode.mjs";
 export * from "./GraphSearchScope.mjs";
+export * from "./PropertyFilter.mjs";
 export * from "./Reranker.mjs";
 export * from "./SearchFilters.mjs";
 export * from "./EntityPropertyType.mjs";

package/dist/esm/serialization/resources/graph/client/requests/AddTripleRequest.d.mts

@@ -8,16 +8,19 @@ export declare const AddTripleRequest: core.serialization.Schema<serializers.Add
 export declare namespace AddTripleRequest {
     interface Raw {
         created_at?: string | null;
+        edge_attributes?: Record<string, unknown> | null;
         expired_at?: string | null;
         fact: string;
         fact_name: string;
         fact_uuid?: string | null;
         graph_id?: string | null;
         invalid_at?: string | null;
-        source_node_name: string;
+        source_node_attributes?: Record<string, unknown> | null;
+        source_node_name?: string | null;
         source_node_summary?: string | null;
         source_node_uuid?: string | null;
-        target_node_name: string;
+        target_node_attributes?: Record<string, unknown> | null;
+        target_node_name?: string | null;
         target_node_summary?: string | null;
         target_node_uuid?: string | null;
         user_id?: string | null;

package/dist/esm/serialization/resources/graph/client/requests/AddTripleRequest.mjs

@@ -4,16 +4,19 @@
 import * as core from "../../../../../core/index.mjs";
 export const AddTripleRequest = core.serialization.object({
     createdAt: core.serialization.property("created_at", core.serialization.string().optional()),
+    edgeAttributes: core.serialization.property("edge_attributes", core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional()),
     expiredAt: core.serialization.property("expired_at", core.serialization.string().optional()),
     fact: core.serialization.string(),
     factName: core.serialization.property("fact_name", core.serialization.string()),
     factUuid: core.serialization.property("fact_uuid", core.serialization.string().optional()),
     graphId: core.serialization.property("graph_id", core.serialization.string().optional()),
     invalidAt: core.serialization.property("invalid_at", core.serialization.string().optional()),
-    sourceNodeName: core.serialization.property("source_node_name", core.serialization.string()),
+    sourceNodeAttributes: core.serialization.property("source_node_attributes", core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional()),
+    sourceNodeName: core.serialization.property("source_node_name", core.serialization.string().optional()),
     sourceNodeSummary: core.serialization.property("source_node_summary", core.serialization.string().optional()),
     sourceNodeUuid: core.serialization.property("source_node_uuid", core.serialization.string().optional()),
-    targetNodeName: core.serialization.property("target_node_name", core.serialization.string()),
+    targetNodeAttributes: core.serialization.property("target_node_attributes", core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional()),
+    targetNodeName: core.serialization.property("target_node_name", core.serialization.string().optional()),
     targetNodeSummary: core.serialization.property("target_node_summary", core.serialization.string().optional()),
     targetNodeUuid: core.serialization.property("target_node_uuid", core.serialization.string().optional()),
     userId: core.serialization.property("user_id", core.serialization.string().optional()),

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

@@ -9,6 +9,6 @@ export declare const DateFilter: core.serialization.ObjectSchema<serializers.Dat
 export declare namespace DateFilter {
     interface Raw {
         comparison_operator: ComparisonOperator.Raw;
-        date: string;
+        date?: string | null;
     }
 }

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

@@ -5,5 +5,5 @@ import * as core from "../../core/index.mjs";
 import { ComparisonOperator } from "./ComparisonOperator.mjs";
 export const DateFilter = core.serialization.object({
     comparisonOperator: core.serialization.property("comparison_operator", ComparisonOperator),
-    date: core.serialization.string(),
+    date: core.serialization.string().optional(),
 });

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

@@ -0,0 +1,15 @@
+/**
+ * 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 { ComparisonOperator } from "./ComparisonOperator.mjs";
+export declare const PropertyFilter: core.serialization.ObjectSchema<serializers.PropertyFilter.Raw, Zep.PropertyFilter>;
+export declare namespace PropertyFilter {
+    interface Raw {
+        comparison_operator: ComparisonOperator.Raw;
+        property_name: string;
+        property_value?: unknown | null;
+    }
+}

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

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../../core/index.mjs";
+import { ComparisonOperator } from "./ComparisonOperator.mjs";
+export const PropertyFilter = core.serialization.object({
+    comparisonOperator: core.serialization.property("comparison_operator", ComparisonOperator),
+    propertyName: core.serialization.property("property_name", core.serialization.string()),
+    propertyValue: core.serialization.property("property_value", core.serialization.unknown().optional()),
+});

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

@@ -5,16 +5,19 @@ import * as serializers from "../index.mjs";
 import * as Zep from "../../api/index.mjs";
 import * as core from "../../core/index.mjs";
 import { DateFilter } from "./DateFilter.mjs";
+import { PropertyFilter } from "./PropertyFilter.mjs";
 export declare const SearchFilters: core.serialization.ObjectSchema<serializers.SearchFilters.Raw, Zep.SearchFilters>;
 export declare namespace SearchFilters {
     interface Raw {
         created_at?: DateFilter.Raw[][] | null;
         edge_types?: string[] | null;
+        edge_uuids?: string[] | null;
         exclude_edge_types?: string[] | null;
         exclude_node_labels?: string[] | null;
         expired_at?: DateFilter.Raw[][] | null;
         invalid_at?: DateFilter.Raw[][] | null;
         node_labels?: string[] | null;
+        property_filters?: PropertyFilter.Raw[] | null;
         valid_at?: DateFilter.Raw[][] | null;
     }
 }

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

@@ -3,13 +3,16 @@
  */
 import * as core from "../../core/index.mjs";
 import { DateFilter } from "./DateFilter.mjs";
+import { PropertyFilter } from "./PropertyFilter.mjs";
 export const SearchFilters = core.serialization.object({
     createdAt: core.serialization.property("created_at", core.serialization.list(core.serialization.list(DateFilter)).optional()),
     edgeTypes: core.serialization.property("edge_types", core.serialization.list(core.serialization.string()).optional()),
+    edgeUuids: core.serialization.property("edge_uuids", core.serialization.list(core.serialization.string()).optional()),
     excludeEdgeTypes: core.serialization.property("exclude_edge_types", core.serialization.list(core.serialization.string()).optional()),
     excludeNodeLabels: core.serialization.property("exclude_node_labels", core.serialization.list(core.serialization.string()).optional()),
     expiredAt: core.serialization.property("expired_at", core.serialization.list(core.serialization.list(DateFilter)).optional()),
     invalidAt: core.serialization.property("invalid_at", core.serialization.list(core.serialization.list(DateFilter)).optional()),
     nodeLabels: core.serialization.property("node_labels", core.serialization.list(core.serialization.string()).optional()),
+    propertyFilters: core.serialization.property("property_filters", core.serialization.list(PropertyFilter).optional()),
     validAt: core.serialization.property("valid_at", core.serialization.list(core.serialization.list(DateFilter)).optional()),
 });

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

@@ -43,6 +43,7 @@ export * from "./DateFilter.mjs";
 export * from "./EntityEdge.mjs";
 export * from "./EntityNode.mjs";
 export * from "./GraphSearchScope.mjs";
+export * from "./PropertyFilter.mjs";
 export * from "./Reranker.mjs";
 export * from "./SearchFilters.mjs";
 export * from "./EntityPropertyType.mjs";

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

@@ -43,6 +43,7 @@ export * from "./DateFilter.mjs";
 export * from "./EntityEdge.mjs";
 export * from "./EntityNode.mjs";
 export * from "./GraphSearchScope.mjs";
+export * from "./PropertyFilter.mjs";
 export * from "./Reranker.mjs";
 export * from "./SearchFilters.mjs";
 export * from "./EntityPropertyType.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.13.0";
+export declare const SDK_VERSION = "3.14.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "3.13.0";
+export const SDK_VERSION = "3.14.0";

package/package.json

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

package/reference.md

@@ -620,8 +620,6 @@ Add a fact triple for a user or group
 await client.graph.addFactTriple({
     fact: "fact",
     factName: "fact_name",
-    sourceNodeName: "source_node_name",
-    targetNodeName: "target_node_name",
 });
 ```
 
@@ -3397,6 +3395,69 @@ await client.graph.node.get("uuid");
 </dl>
 </details>
 
+<details><summary><code>client.graph.node.<a href="/src/api/resources/graph/resources/node/client/Client.ts">delete</a>(uuid) -> Zep.SuccessResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Deletes a node by UUID.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.graph.node.delete("uuid");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**uuid:** `string` — Node UUID
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Node.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 ## Thread Message
 
 <details><summary><code>client.thread.message.<a href="/src/api/resources/thread/resources/message/client/Client.ts">update</a>(messageUuid, { ...params }) -> Zep.Message</code></summary>