@getzep/zep-cloud 3.17.0 → 3.22.0

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

@@ -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/esm/api/resources/graph/resources/edge/client/Client.mjs

@@ -68,13 +68,7 @@ export 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",
@@ -156,13 +150,7 @@ export 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",
@@ -238,13 +226,7 @@ export 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",
@@ -328,13 +310,7 @@ export 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",
@@ -425,13 +401,7 @@ export 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/esm/api/resources/graph/resources/episode/client/Client.d.mts

@@ -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/esm/api/resources/graph/resources/episode/client/Client.mjs

@@ -70,13 +70,7 @@ export 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",
@@ -160,13 +154,7 @@ export 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",
@@ -241,13 +229,7 @@ export 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",
@@ -323,7 +305,105 @@ export 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: mergeHeaders((_d = this._options) === null || _d === void 0 ? void 0 : _d.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.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,
@@ -362,7 +442,7 @@ export 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,
@@ -412,13 +492,7 @@ export 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/esm/api/resources/graph/resources/episode/client/requests/UpdateEpisodeRequest.d.mts

@@ -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/esm/api/resources/graph/resources/episode/client/requests/UpdateEpisodeRequest.mjs

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

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

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

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

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

package/dist/esm/api/resources/graph/resources/index.mjs

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

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

@@ -68,13 +68,7 @@ export 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",
@@ -156,13 +150,7 @@ export 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",
@@ -237,13 +225,7 @@ export 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",
@@ -318,13 +300,7 @@ export 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",
@@ -400,13 +376,7 @@ export 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",
@@ -490,13 +460,7 @@ export 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",
@@ -587,13 +551,7 @@ export 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/esm/api/resources/graph/resources/observation/client/Client.d.mts

@@ -0,0 +1,81 @@
+/**
+ * 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";
+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;
+    }>;
+}