@getzep/zep-cloud 3.0.0 → 3.0.2

package/dist/cjs/wrapper/ontology.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entityFields = exports.EdgeTypeSchema = exports.EntityTypeSchema = exports.EntityFields = exports.EntityTypeFieldSchema = exports.EntityTypeBooleanFieldSchema = exports.EntityTypeFloatFieldSchema = exports.EntityTypeIntFieldSchema = exports.EntityTypeTextFieldSchema = exports.EntityTypeBaseField = exports.EntityPropertyType = void 0;
+exports.entityModelToAPISchema = entityModelToAPISchema;
+exports.edgeModelToAPISchema = edgeModelToAPISchema;
+const zod_1 = require("zod");
+var EntityPropertyType;
+(function (EntityPropertyType) {
+    EntityPropertyType["Text"] = "Text";
+    EntityPropertyType["Int"] = "Int";
+    EntityPropertyType["Float"] = "Float";
+    EntityPropertyType["Boolean"] = "Boolean";
+})(EntityPropertyType || (exports.EntityPropertyType = EntityPropertyType = {}));
+exports.EntityTypeBaseField = zod_1.z.object({
+    type: zod_1.z.nativeEnum(EntityPropertyType),
+    description: zod_1.z.string(),
+});
+exports.EntityTypeTextFieldSchema = exports.EntityTypeBaseField.extend({
+    type: zod_1.z.literal(EntityPropertyType.Text),
+    value: zod_1.z.string().optional(),
+});
+exports.EntityTypeIntFieldSchema = exports.EntityTypeBaseField.extend({
+    type: zod_1.z.literal(EntityPropertyType.Int),
+    value: zod_1.z.number().int().optional(),
+});
+exports.EntityTypeFloatFieldSchema = exports.EntityTypeBaseField.extend({
+    type: zod_1.z.literal(EntityPropertyType.Float),
+    value: zod_1.z.number().optional(),
+});
+exports.EntityTypeBooleanFieldSchema = exports.EntityTypeBaseField.extend({
+    type: zod_1.z.literal(EntityPropertyType.Boolean),
+    value: zod_1.z.boolean().optional(),
+});
+exports.EntityTypeFieldSchema = zod_1.z.union([
+    exports.EntityTypeTextFieldSchema,
+    exports.EntityTypeIntFieldSchema,
+    exports.EntityTypeFloatFieldSchema,
+    exports.EntityTypeBooleanFieldSchema,
+]);
+exports.EntityFields = zod_1.z.record(exports.EntityTypeFieldSchema);
+exports.EntityTypeSchema = zod_1.z.object({
+    description: zod_1.z.string().default(""),
+    fields: zod_1.z.record(exports.EntityTypeFieldSchema),
+});
+const EdgeSourceTarget = zod_1.z.object({
+    source: zod_1.z.string().optional(),
+    target: zod_1.z.string().optional(),
+});
+exports.EdgeTypeSchema = exports.EntityTypeSchema.extend({
+    sourceTargets: zod_1.z.array(EdgeSourceTarget).optional(),
+});
+exports.entityFields = {
+    text: (description) => {
+        return exports.EntityTypeTextFieldSchema.parse({
+            type: EntityPropertyType.Text,
+            description,
+        });
+    },
+    integer: (description) => {
+        return exports.EntityTypeIntFieldSchema.parse({
+            type: EntityPropertyType.Int,
+            description,
+        });
+    },
+    float: (description) => {
+        return exports.EntityTypeFloatFieldSchema.parse({
+            type: EntityPropertyType.Float,
+            description,
+        });
+    },
+    boolean: (description) => {
+        return exports.EntityTypeBooleanFieldSchema.parse({
+            type: EntityPropertyType.Boolean,
+            description,
+        });
+    },
+};
+function entityModelToAPISchema(entityType, name) {
+    return {
+        name,
+        description: entityType.description,
+        properties: Object.entries(entityType.fields).map(([fieldName, fieldDef]) => ({
+            name: fieldName,
+            type: fieldDef.type,
+            description: fieldDef.description,
+        })),
+    };
+}
+function edgeModelToAPISchema(entityType, name) {
+    return {
+        name,
+        description: entityType.description,
+        sourceTargets: entityType.sourceTargets,
+        properties: Object.entries(entityType.fields).map(([fieldName, fieldDef]) => ({
+            name: fieldName,
+            type: fieldDef.type,
+            description: fieldDef.description,
+        })),
+    };
+}

package/dist/esm/Client.d.mts

@@ -0,0 +1,39 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "./environments.mjs";
+import * as core from "./core/index.mjs";
+import { Graph } from "./api/resources/graph/client/Client.mjs";
+import { Thread } from "./api/resources/thread/client/Client.mjs";
+import { User } from "./api/resources/user/client/Client.mjs";
+export declare namespace ZepClient {
+    interface Options {
+        environment?: core.Supplier<environments.ZepEnvironment | string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        apiKey?: core.Supplier<string | undefined>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    }
+}
+export declare class ZepClient {
+    protected readonly _options: ZepClient.Options;
+    protected _graph: Graph | undefined;
+    protected _thread: Thread | undefined;
+    protected _user: User | undefined;
+    constructor(_options?: ZepClient.Options);
+    get graph(): Graph;
+    get thread(): Thread;
+    get user(): User;
+}

package/dist/esm/Client.mjs

@@ -0,0 +1,32 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "./core/index.mjs";
+import { mergeHeaders } from "./core/headers.mjs";
+import { Graph } from "./api/resources/graph/client/Client.mjs";
+import { Thread } from "./api/resources/thread/client/Client.mjs";
+import { User } from "./api/resources/user/client/Client.mjs";
+export class ZepClient {
+    constructor(_options = {}) {
+        this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
+                "X-Fern-Language": "JavaScript",
+                "X-Fern-SDK-Name": "zep-cloud",
+                "X-Fern-SDK-Version": "3.0.0",
+                "User-Agent": "zep-cloud/3.0.0",
+                "X-Fern-Runtime": core.RUNTIME.type,
+                "X-Fern-Runtime-Version": core.RUNTIME.version,
+            }, _options === null || _options === void 0 ? void 0 : _options.headers) });
+    }
+    get graph() {
+        var _a;
+        return ((_a = this._graph) !== null && _a !== void 0 ? _a : (this._graph = new Graph(this._options)));
+    }
+    get thread() {
+        var _a;
+        return ((_a = this._thread) !== null && _a !== void 0 ? _a : (this._thread = new Thread(this._options)));
+    }
+    get user() {
+        var _a;
+        return ((_a = this._user) !== null && _a !== void 0 ? _a : (this._user = new User(this._options)));
+    }
+}

package/dist/esm/api/errors/BadRequestError.d.mts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index.mjs";
+import * as Zep from "../index.mjs";
+import * as core from "../../core/index.mjs";
+export declare class BadRequestError extends errors.ZepError {
+    constructor(body: Zep.ApiError, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/errors/BadRequestError.mjs

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index.mjs";
+export class BadRequestError extends errors.ZepError {
+    constructor(body, rawResponse) {
+        super({
+            message: "BadRequestError",
+            statusCode: 400,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, BadRequestError.prototype);
+    }
+}

package/dist/esm/api/errors/InternalServerError.d.mts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index.mjs";
+import * as Zep from "../index.mjs";
+import * as core from "../../core/index.mjs";
+export declare class InternalServerError extends errors.ZepError {
+    constructor(body: Zep.ApiError, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/errors/InternalServerError.mjs

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index.mjs";
+export class InternalServerError extends errors.ZepError {
+    constructor(body, rawResponse) {
+        super({
+            message: "InternalServerError",
+            statusCode: 500,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, InternalServerError.prototype);
+    }
+}

package/dist/esm/api/errors/NotFoundError.d.mts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index.mjs";
+import * as Zep from "../index.mjs";
+import * as core from "../../core/index.mjs";
+export declare class NotFoundError extends errors.ZepError {
+    constructor(body: Zep.ApiError, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/errors/NotFoundError.mjs

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index.mjs";
+export class NotFoundError extends errors.ZepError {
+    constructor(body, rawResponse) {
+        super({
+            message: "NotFoundError",
+            statusCode: 404,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, NotFoundError.prototype);
+    }
+}

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

@@ -0,0 +1,3 @@
+export * from "./NotFoundError.mjs";
+export * from "./InternalServerError.mjs";
+export * from "./BadRequestError.mjs";

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

@@ -0,0 +1,3 @@
+export * from "./NotFoundError.mjs";
+export * from "./InternalServerError.mjs";
+export * from "./BadRequestError.mjs";

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

@@ -0,0 +1,3 @@
+export * from "./resources/index.mjs";
+export * from "./types/index.mjs";
+export * from "./errors/index.mjs";

package/dist/esm/api/index.mjs

@@ -0,0 +1,3 @@
+export * from "./resources/index.mjs";
+export * from "./types/index.mjs";
+export * from "./errors/index.mjs";

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

@@ -0,0 +1,229 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../environments.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Zep from "../../../index.mjs";
+import { Edge } from "../resources/edge/client/Client.mjs";
+import { Episode } from "../resources/episode/client/Client.mjs";
+import { Node } from "../resources/node/client/Client.mjs";
+export declare namespace Graph {
+    interface Options {
+        environment?: core.Supplier<environments.ZepEnvironment | string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        apiKey?: core.Supplier<string | undefined>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    }
+}
+export declare class Graph {
+    protected readonly _options: Graph.Options;
+    protected _edge: Edge | undefined;
+    protected _episode: Episode | undefined;
+    protected _node: Node | undefined;
+    constructor(_options?: Graph.Options);
+    get edge(): Edge;
+    get episode(): Episode;
+    get node(): Node;
+    /**
+     * Returns all entity types for a project.
+     *
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.listEntityTypes()
+     */
+    listEntityTypes(requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.EntityTypeResponse>;
+    private __listEntityTypes;
+    /**
+     * Sets the entity types for a project, replacing any existing ones.
+     *
+     * @param {Zep.EntityTypeRequest} request
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.setEntityTypesInternal()
+     */
+    setEntityTypesInternal(request?: Zep.EntityTypeRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.SuccessResponse>;
+    private __setEntityTypesInternal;
+    /**
+     * 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 client.graph.add({
+     *         data: "data",
+     *         type: "text"
+     *     })
+     */
+    add(request: Zep.AddDataRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.Episode>;
+    private __add;
+    /**
+     * Add data to the graph in batch mode, processing episodes concurrently. Use only for data that is insensitive to processing order.
+     *
+     * @param {Zep.AddDataBatchRequest} request
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.addBatch({
+     *         episodes: [{
+     *                 data: "data",
+     *                 type: "text"
+     *             }]
+     *     })
+     */
+    addBatch(request: Zep.AddDataBatchRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.Episode[]>;
+    private __addBatch;
+    /**
+     * Add a fact triple for a user or group
+     *
+     * @param {Zep.AddTripleRequest} request
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.addFactTriple({
+     *         fact: "fact",
+     *         factName: "fact_name",
+     *         targetNodeName: "target_node_name"
+     *     })
+     */
+    addFactTriple(request: Zep.AddTripleRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.AddTripleResponse>;
+    private __addFactTriple;
+    /**
+     * Clone a user or group graph.
+     *
+     * @param {Zep.CloneGraphRequest} request
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.clone()
+     */
+    clone(request?: Zep.CloneGraphRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.CloneGraphResponse>;
+    private __clone;
+    /**
+     * 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 client.graph.search({
+     *         query: "query"
+     *     })
+     */
+    search(request: Zep.GraphSearchQuery, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.GraphSearchResults>;
+    private __search;
+    /**
+     * Creates a new graph.
+     *
+     * @param {Zep.CreateGraphRequest} request
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.create({
+     *         graphId: "graph_id"
+     *     })
+     */
+    create(request: Zep.CreateGraphRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.Graph>;
+    private __create;
+    /**
+     * Returns all graphs.
+     *
+     * @param {Zep.GraphListAllRequest} request
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.listAll()
+     */
+    listAll(request?: Zep.GraphListAllRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.GraphListResponse>;
+    private __listAll;
+    /**
+     * Returns a graph.
+     *
+     * @param {string} graphId - The graph_id of the graph to get.
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.get("graphId")
+     */
+    get(graphId: string, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.Graph>;
+    private __get;
+    /**
+     * Deletes a graph. If you would like to delete a user graph, make sure to use user.delete instead.
+     *
+     * @param {string} graphId - Graph ID
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.delete("graphId")
+     */
+    delete(graphId: string, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.SuccessResponse>;
+    private __delete;
+    /**
+     * Updates information about a graph.
+     *
+     * @param {string} graphId - Graph ID
+     * @param {Zep.UpdateGraphRequest} request
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.update("graphId")
+     */
+    update(graphId: string, request?: Zep.UpdateGraphRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.Graph>;
+    private __update;
+    protected _getCustomAuthorizationHeaders(): Promise<{
+        Authorization: string;
+    }>;
+}