@getzep/zep-cloud 3.17.0 → 3.22.0

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

@@ -6,6 +6,7 @@
  *     {
  *         pageNumber: 1,
  *         pageSize: 1,
+ *         search: "search",
  *         orderBy: "order_by",
  *         asc: true
  *     }
@@ -19,6 +20,10 @@ export interface GraphListAllRequest {
      * Number of graphs to retrieve per page.
      */
     pageSize?: number;
+    /**
+     * Search term for filtering graphs by graph_id.
+     */
+    search?: string;
     /**
      * Column to sort by (created_at, group_id, name).
      */

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

@@ -17,13 +17,25 @@ export interface GraphSearchQuery {
     graphId?: string;
     /** The maximum number of facts to retrieve. Defaults to 10. Limited to 50. */
     limit?: number;
+    /** Maximum total characters across all selected results when scope=auto. Defaults to 2500. Limited to 50000. */
+    maxCharacters?: number;
     /** weighting for maximal marginal relevance */
     mmrLambda?: number;
     /** The string to search for (required) */
     query: string;
-    /** Defaults to RRF */
+    /**
+     * Defaults to RRF. When scope=auto, this only affects graph-service retrieval
+     * shape for graph facts, observations, and thread summaries; source-episode
+     * retrieval uses RRF, and auto search applies its own internal rerank after retrieval.
+     */
     reranker?: Zep.Reranker;
-    /** Defaults to Edges. Communities will be added in the future. */
+    /**
+     * When scope=auto, include the selected raw graph results alongside the materialized context block.
+     * For graph-service-backed auto mode, selected raw results may include episodes,
+     * edges, nodes, observations, and thread_summaries.
+     */
+    returnRawResults?: boolean;
+    /** Defaults to Edges. */
     scope?: Zep.GraphSearchScope;
     /** Search filters to apply to the search */
     searchFilters?: Zep.SearchFilters;

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

@@ -104,13 +104,7 @@ class Edge {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -192,13 +186,7 @@ class Edge {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -274,13 +262,7 @@ class Edge {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new Zep.NotFoundError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -364,13 +346,7 @@ class Edge {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new Zep.NotFoundError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -461,13 +437,7 @@ class Edge {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new Zep.NotFoundError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",

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

@@ -91,6 +91,27 @@ export declare class Episode {
      */
     delete(uuid: string, requestOptions?: Episode.RequestOptions): core.HttpResponsePromise<Zep.SuccessResponse>;
     private __delete;
+    /**
+     * Update episode metadata with merge semantics. Supplied keys overwrite or add to existing metadata; keys set to null are removed.
+     *
+     * @param {string} uuid - Episode UUID
+     * @param {Zep.graph.UpdateEpisodeRequest} request
+     * @param {Episode.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.ForbiddenError}
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.episode.update("uuid", {
+     *         metadata: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    update(uuid: string, request: Zep.graph.UpdateEpisodeRequest, requestOptions?: Episode.RequestOptions): core.HttpResponsePromise<Zep.Episode>;
+    private __update;
     /**
      * Returns nodes and edges mentioned in an episode
      *

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

@@ -106,13 +106,7 @@ class Episode {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -196,13 +190,7 @@ class Episode {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -277,13 +265,7 @@ class Episode {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -359,7 +341,105 @@ class Episode {
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
                     case 400:
-                        throw new Zep.BadRequestError(serializers.ApiError.parseOrThrow(_response.error.body, {
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Zep.NotFoundError(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/episodes/{uuid}.");
+                case "unknown":
+                    throw new errors.ZepError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Update episode metadata with merge semantics. Supplied keys overwrite or add to existing metadata; keys set to null are removed.
+     *
+     * @param {string} uuid - Episode UUID
+     * @param {Zep.graph.UpdateEpisodeRequest} request
+     * @param {Episode.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.ForbiddenError}
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.episode.update("uuid", {
+     *         metadata: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    update(uuid, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__update(uuid, request, requestOptions));
+    }
+    __update(uuid, 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, `graph/episodes/${encodeURIComponent(uuid)}`),
+                method: "PATCH",
+                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.graph.UpdateEpisodeRequest.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.Episode.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(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Zep.ForbiddenError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
                             allowUnrecognizedUnionMembers: true,
                             allowUnrecognizedEnumValues: true,
@@ -398,7 +478,7 @@ class Episode {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.ZepTimeoutError("Timeout exceeded when calling DELETE /graph/episodes/{uuid}.");
+                    throw new errors.ZepTimeoutError("Timeout exceeded when calling PATCH /graph/episodes/{uuid}.");
                 case "unknown":
                     throw new errors.ZepError({
                         message: _response.error.errorMessage,
@@ -448,13 +528,7 @@ class Episode {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",

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

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         metadata: {
+ *             "key": "value"
+ *         }
+ *     }
+ */
+export interface UpdateEpisodeRequest {
+    /** Updated metadata. Merged with existing metadata: supplied keys overwrite/add, keys set to null are removed. Maximum 10 keys. Values must be scalars (string, number, boolean, null) or arrays of scalars. */
+    metadata: Record<string, unknown>;
+}

package/dist/cjs/api/resources/graph/resources/episode/client/requests/UpdateEpisodeRequest.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/resources/graph/resources/episode/client/requests/index.d.ts

@@ -1,2 +1,3 @@
 export { type EpisodeGetByGraphIdRequest } from "./EpisodeGetByGraphIdRequest.js";
 export { type EpisodeGetByUserIdRequest } from "./EpisodeGetByUserIdRequest.js";
+export { type UpdateEpisodeRequest } from "./UpdateEpisodeRequest.js";

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

@@ -1,6 +1,8 @@
 export * as edge from "./edge/index.js";
 export * as episode from "./episode/index.js";
 export * as node from "./node/index.js";
+export * as observation from "./observation/index.js";
+export * as threadSummary from "./threadSummary/index.js";
 export * from "./edge/client/requests/index.js";
 export * from "./episode/client/requests/index.js";
 export * from "./node/client/requests/index.js";

package/dist/cjs/api/resources/graph/resources/index.js

@@ -36,10 +36,12 @@ 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 });
-exports.node = exports.episode = exports.edge = void 0;
+exports.threadSummary = exports.observation = exports.node = exports.episode = exports.edge = void 0;
 exports.edge = __importStar(require("./edge/index.js"));
 exports.episode = __importStar(require("./episode/index.js"));
 exports.node = __importStar(require("./node/index.js"));
+exports.observation = __importStar(require("./observation/index.js"));
+exports.threadSummary = __importStar(require("./threadSummary/index.js"));
 __exportStar(require("./edge/client/requests/index.js"), exports);
 __exportStar(require("./episode/client/requests/index.js"), exports);
 __exportStar(require("./node/client/requests/index.js"), exports);

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

@@ -104,13 +104,7 @@ class Node {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -192,13 +186,7 @@ class Node {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -273,13 +261,7 @@ class Node {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -354,13 +336,7 @@ class Node {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -436,13 +412,7 @@ class Node {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new Zep.NotFoundError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -526,13 +496,7 @@ class Node {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new Zep.NotFoundError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -623,13 +587,7 @@ class Node {
             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);
+                        throw new Zep.BadRequestError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new Zep.NotFoundError(serializers.ApiError.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",

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

@@ -0,0 +1,81 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../../../environments.js";
+import * as core from "../../../../../../core/index.js";
+import * as Zep from "../../../../../index.js";
+export declare namespace Observation {
+    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 Observation {
+    protected readonly _options: Observation.Options;
+    constructor(_options?: Observation.Options);
+    /**
+     * Returns read-only observation nodes for a graph.
+     *
+     * @param {string} graphId - Graph ID
+     * @param {Zep.GraphObservationsRequest} request
+     * @param {Observation.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.observation.getByGraphId("graph_id", {})
+     */
+    getByGraphId(graphId: string, request: Zep.GraphObservationsRequest, requestOptions?: Observation.RequestOptions): core.HttpResponsePromise<Zep.DerivedNode[]>;
+    private __getByGraphId;
+    /**
+     * Returns read-only observation nodes for a user's graph.
+     *
+     * @param {string} userId - User ID
+     * @param {Zep.GraphObservationsRequest} request
+     * @param {Observation.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.observation.getByUserId("user_id", {})
+     */
+    getByUserId(userId: string, request: Zep.GraphObservationsRequest, requestOptions?: Observation.RequestOptions): core.HttpResponsePromise<Zep.DerivedNode[]>;
+    private __getByUserId;
+    /**
+     * Returns a specific observation node by UUID. Observation nodes are read-only.
+     *
+     * @param {string} uuid - Observation UUID
+     * @param {Observation.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.BadRequestError}
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.observation.get("uuid")
+     */
+    get(uuid: string, requestOptions?: Observation.RequestOptions): core.HttpResponsePromise<Zep.DerivedNode>;
+    private __get;
+    protected _getCustomAuthorizationHeaders(): Promise<{
+        Authorization: string;
+    }>;
+}