@getzep/zep-cloud 1.0.12 → 2.0.0-rc.2

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

@@ -0,0 +1,225 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Graph = void 0;
+const environments = __importStar(require("../../../../environments"));
+const core = __importStar(require("../../../../core"));
+const Zep = __importStar(require("../../../index"));
+const serializers = __importStar(require("../../../../serialization/index"));
+const url_join_1 = __importDefault(require("url-join"));
+const errors = __importStar(require("../../../../errors/index"));
+const Client_1 = require("../resources/edge/client/Client");
+const Client_2 = require("../resources/episode/client/Client");
+const Client_3 = require("../resources/node/client/Client");
+class Graph {
+    constructor(_options = {}) {
+        this._options = _options;
+    }
+    /**
+     * Add data to the graph
+     *
+     * @param {Zep.AddDataRequest} request
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await zep.graph.add()
+     */
+    add(request = {}, requestOptions) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ZepEnvironment.Default, "graph"),
+                method: "POST",
+                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "2.0.0-rc.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                contentType: "application/json",
+                body: yield serializers.AddDataRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                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 yield serializers.SuccessResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                });
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Zep.BadRequestError(yield serializers.ApiError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    case 500:
+                        throw new Zep.InternalServerError(yield serializers.ApiError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    default:
+                        throw new errors.ZepError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.ZepError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                    });
+                case "timeout":
+                    throw new errors.ZepTimeoutError();
+                case "unknown":
+                    throw new errors.ZepError({
+                        message: _response.error.errorMessage,
+                    });
+            }
+        });
+    }
+    /**
+     * Perform a graph search query
+     *
+     * @param {Zep.GraphSearchQuery} request
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await zep.graph.search({
+     *         query: "query"
+     *     })
+     */
+    search(request, requestOptions) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ZepEnvironment.Default, "graph/search"),
+                method: "POST",
+                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "2.0.0-rc.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                contentType: "application/json",
+                body: yield serializers.GraphSearchQuery.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                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 yield serializers.GraphSearchResults.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                });
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Zep.BadRequestError(yield serializers.ApiError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    case 500:
+                        throw new Zep.InternalServerError(yield serializers.ApiError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    default:
+                        throw new errors.ZepError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.ZepError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                    });
+                case "timeout":
+                    throw new errors.ZepTimeoutError();
+                case "unknown":
+                    throw new errors.ZepError({
+                        message: _response.error.errorMessage,
+                    });
+            }
+        });
+    }
+    get edge() {
+        var _a;
+        return ((_a = this._edge) !== null && _a !== void 0 ? _a : (this._edge = new Client_1.Edge(this._options)));
+    }
+    get episode() {
+        var _a;
+        return ((_a = this._episode) !== null && _a !== void 0 ? _a : (this._episode = new Client_2.Episode(this._options)));
+    }
+    get node() {
+        var _a;
+        return ((_a = this._node) !== null && _a !== void 0 ? _a : (this._node = new Client_3.Node(this._options)));
+    }
+    _getCustomAuthorizationHeaders() {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const apiKeyValue = (_a = (yield core.Supplier.get(this._options.apiKey))) !== null && _a !== void 0 ? _a : process === null || process === void 0 ? void 0 : process.env["ZEP_API_KEY"];
+            return { Authorization: `Api-Key ${apiKeyValue}` };
+        });
+    }
+}
+exports.Graph = Graph;

package/api/resources/graph/client/index.d.ts

@@ -0,0 +1 @@
+export * from "./requests";

package/{dist/langchain → api/resources/graph/client}/index.js

@@ -14,6 +14,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./message_history"), exports);
-__exportStar(require("./vector_store"), exports);
-__exportStar(require("./zep_memory"), exports);
+__exportStar(require("./requests"), exports);

package/api/resources/graph/client/requests/AddDataRequest.d.ts

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../../../../index";
+/**
+ * @example
+ *     {}
+ */
+export interface AddDataRequest {
+    data?: string;
+    groupId?: string;
+    type?: Zep.GraphDataType;
+    userId?: string;
+}

package/api/resources/graph/client/requests/GraphSearchQuery.d.ts

@@ -0,0 +1,30 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../../../../index";
+/**
+ * @example
+ *     {
+ *         query: "query"
+ *     }
+ */
+export interface GraphSearchQuery {
+    /** Node to rerank around for node distance reranking */
+    centerNodeUuid?: string;
+    /** one of user_id or group_id must be provided */
+    groupId?: string;
+    /** The maximum number of facts to retrieve */
+    limit?: number;
+    /** minimum similarity score for a result to be returned */
+    minScore?: number;
+    /** weighting for maximal marginal relevance */
+    mmrLambda?: number;
+    /** The string to search for (required) */
+    query: string;
+    /** Defaults to RRF */
+    reranker?: Zep.Reranker;
+    /** Defaults to Edges. Nodes and Communities will be added in the future. */
+    scope?: Zep.GraphSearchScope;
+    /** one of user_id or group_id must be provided */
+    userId?: string;
+}

package/api/resources/graph/client/requests/index.d.ts

@@ -0,0 +1,2 @@
+export { type AddDataRequest } from "./AddDataRequest";
+export { type GraphSearchQuery } from "./GraphSearchQuery";

package/api/resources/graph/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/resources/graph/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./client";
+export * from "./resources";

package/{langchain → api/resources/graph}/index.js

@@ -14,6 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./message_history"), exports);
-__exportStar(require("./vector_store"), exports);
-__exportStar(require("./zep_memory"), exports);
+__exportStar(require("./client"), exports);
+__exportStar(require("./resources"), exports);

package/api/resources/graph/resources/edge/client/Client.d.ts

@@ -0,0 +1,78 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../../../environments";
+import * as core from "../../../../../../core";
+import * as Zep from "../../../../../index";
+export declare namespace Edge {
+    interface Options {
+        environment?: core.Supplier<environments.ZepEnvironment | string>;
+        apiKey?: core.Supplier<string | undefined>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        timeoutInSeconds?: number;
+        maxRetries?: number;
+        abortSignal?: AbortSignal;
+    }
+}
+export declare class Edge {
+    protected readonly _options: Edge.Options;
+    constructor(_options?: Edge.Options);
+    /**
+     * Get all edges for a group
+     *
+     * @param {string} groupId - Group ID
+     * @param {Edge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await zep.graph.edge.getByGroupId("group_id")
+     */
+    getByGroupId(groupId: string, requestOptions?: Edge.RequestOptions): Promise<Zep.EntityEdge[]>;
+    /**
+     * Get all edges for a user
+     *
+     * @param {string} userId - User ID
+     * @param {Edge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await zep.graph.edge.getByUserId("user_id")
+     */
+    getByUserId(userId: string, requestOptions?: Edge.RequestOptions): Promise<Zep.EntityEdge[]>;
+    /**
+     * Get a specific edge by its UUID
+     *
+     * @param {string} uuid - Edge UUID
+     * @param {Edge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await zep.graph.edge.get("uuid")
+     */
+    get(uuid: string, requestOptions?: Edge.RequestOptions): Promise<Zep.EntityEdge>;
+    /**
+     * Delete an edge by UUID
+     *
+     * @param {string} uuid - Edge UUID
+     * @param {Edge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await zep.graph.edge.delete("uuid")
+     */
+    delete(uuid: string, requestOptions?: Edge.RequestOptions): Promise<Zep.SuccessResponse>;
+    protected _getCustomAuthorizationHeaders(): Promise<{
+        Authorization: string;
+    }>;
+}