@getzep/zep-cloud 3.18.0 → 3.23.0

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

@@ -111,7 +111,7 @@ export declare class Thread {
      * @example
      *     await client.thread.get("threadId", {
      *         limit: 1,
-     *         cursor: 1,
+     *         cursor: 1000000,
      *         lastn: 1
      *     })
      */
@@ -137,7 +137,9 @@ export declare class Thread {
     addMessages(threadId: string, request: Zep.AddThreadMessagesRequest, requestOptions?: Thread.RequestOptions): core.HttpResponsePromise<Zep.AddThreadMessagesResponse>;
     private __addMessages;
     /**
-     * Add messages to a thread in batch mode. This will process messages concurrently, which is useful for data migrations.
+     * Deprecated. Use the [Batch API](/adding-batch-data) (`client.batch.*` with `type: "thread_message"`) instead.
+     *
+     * Adds messages to a thread in batch mode, processing messages concurrently.
      *
      * @param {string} threadId - The ID of the thread to which messages should be added.
      * @param {Zep.AddThreadMessagesRequest} request
@@ -155,6 +157,21 @@ export declare class Thread {
      */
     addMessagesBatch(threadId: string, request: Zep.AddThreadMessagesRequest, requestOptions?: Thread.RequestOptions): core.HttpResponsePromise<Zep.AddThreadMessagesResponse>;
     private __addMessagesBatch;
+    /**
+     * Returns the incremental summary generated from messages in the thread. Returns 404 if no summary exists for the thread.
+     *
+     * @param {string} threadId - The thread ID.
+     * @param {Thread.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.ForbiddenError}
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.thread.getSummary("threadId")
+     */
+    getSummary(threadId: string, requestOptions?: Thread.RequestOptions): core.HttpResponsePromise<Zep.ThreadSummary>;
+    private __getSummary;
     protected _getCustomAuthorizationHeaders(): Promise<{
         Authorization: string;
     }>;

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

@@ -86,13 +86,7 @@ export class Thread {
             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",
@@ -176,13 +170,7 @@ export class Thread {
             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,7 +388,7 @@ export class Thread {
      * @example
      *     await client.thread.get("threadId", {
      *         limit: 1,
-     *         cursor: 1,
+     *         cursor: 1000000,
      *         lastn: 1
      *     })
      */
@@ -570,7 +558,9 @@ export class Thread {
         });
     }
     /**
-     * Add messages to a thread in batch mode. This will process messages concurrently, which is useful for data migrations.
+     * Deprecated. Use the [Batch API](/adding-batch-data) (`client.batch.*` with `type: "thread_message"`) instead.
+     *
+     * Adds messages to a thread in batch mode, processing messages concurrently.
      *
      * @param {string} threadId - The ID of the thread to which messages should be added.
      * @param {Zep.AddThreadMessagesRequest} request
@@ -653,6 +643,96 @@ export class Thread {
             }
         });
     }
+    /**
+     * Returns the incremental summary generated from messages in the thread. Returns 404 if no summary exists for the thread.
+     *
+     * @param {string} threadId - The thread ID.
+     * @param {Thread.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.ForbiddenError}
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.thread.getSummary("threadId")
+     */
+    getSummary(threadId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getSummary(threadId, requestOptions));
+    }
+    __getSummary(threadId, 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, `threads/${encodeURIComponent(threadId)}/summary`),
+                method: "GET",
+                headers: mergeHeaders((_d = this._options) === null || _d === void 0 ? void 0 : _d.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.ThreadSummary.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 403:
+                        throw new Zep.ForbiddenError(serializers.ApiError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _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 GET /threads/{threadId}/summary.");
+                case "unknown":
+                    throw new errors.ZepError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getCustomAuthorizationHeaders() {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;

package/dist/esm/api/resources/thread/client/requests/ThreadGetRequest.d.mts

@@ -5,7 +5,7 @@
  * @example
  *     {
  *         limit: 1,
- *         cursor: 1,
+ *         cursor: 1000000,
  *         lastn: 1
  *     }
  */

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

@@ -70,13 +70,7 @@ export class User {
             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",
@@ -171,13 +165,7 @@ export class User {
             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",
@@ -267,13 +255,7 @@ export class User {
             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 @@ export class User {
             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",
@@ -469,13 +445,7 @@ export class User {
             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",
@@ -720,13 +690,7 @@ export class User {
             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/types/ApidataBatchAddItemRole.d.mts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type ApidataBatchAddItemRole = "norole" | "system" | "assistant" | "user" | "function" | "tool";
+export declare const ApidataBatchAddItemRole: {
+    readonly Norole: "norole";
+    readonly System: "system";
+    readonly Assistant: "assistant";
+    readonly User: "user";
+    readonly Function: "function";
+    readonly Tool: "tool";
+};

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

@@ -0,0 +1,11 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const ApidataBatchAddItemRole = {
+    Norole: "norole",
+    System: "system",
+    Assistant: "assistant",
+    User: "user",
+    Function: "function",
+    Tool: "tool",
+};

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type ApidataBatchAddItemType = "graph_episode" | "thread_message";
+export declare const ApidataBatchAddItemType: {
+    readonly GraphEpisode: "graph_episode";
+    readonly ThreadMessage: "thread_message";
+};

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

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const ApidataBatchAddItemType = {
+    GraphEpisode: "graph_episode",
+    ThreadMessage: "thread_message",
+};

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

@@ -0,0 +1,18 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../index.mjs";
+export interface BatchAddItem {
+    content?: string;
+    createdAt?: string;
+    data?: string;
+    dataType?: Zep.GraphDataType;
+    graphId?: string;
+    metadata?: Record<string, unknown>;
+    name?: string;
+    role?: Zep.ApidataBatchAddItemRole;
+    sourceDescription?: string;
+    threadId?: string;
+    type: Zep.ApidataBatchAddItemType;
+    userId?: string;
+}

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../index.mjs";
+export interface BatchItemDetail {
+    createdAt?: string;
+    /**
+     * EpisodeUUID is the UUID of the episode that will be (or has been) created
+     * for this batch item. Populated for every item kind and always equal to
+     * SourceUUID — the underlying source row's UUID is reused as the episode
+     * UUID during processing.
+     */
+    episodeUuid?: string;
+    error?: Record<string, unknown>;
+    graphId?: string;
+    itemId?: string;
+    kind?: Zep.BatchItemKind;
+    sequenceIndex?: number;
+    sourceUuid?: string;
+    status?: Zep.BatchItemStatus;
+    threadId?: string;
+    updatedAt?: string;
+    userId?: string;
+}

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type BatchItemKind = "graph_episode" | "thread_message";
+export declare const BatchItemKind: {
+    readonly GraphEpisode: "graph_episode";
+    readonly ThreadMessage: "thread_message";
+};

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

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const BatchItemKind = {
+    GraphEpisode: "graph_episode",
+    ThreadMessage: "thread_message",
+};

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../index.mjs";
+export interface BatchItemListResponse {
+    items?: Zep.BatchItemDetail[];
+    nextCursor?: number;
+}

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type BatchItemStatus = "pending" | "queued" | "processing" | "succeeded" | "failed" | "skipped" | "canceled";
+export declare const BatchItemStatus: {
+    readonly Pending: "pending";
+    readonly Queued: "queued";
+    readonly Processing: "processing";
+    readonly Succeeded: "succeeded";
+    readonly Failed: "failed";
+    readonly Skipped: "skipped";
+    readonly Canceled: "canceled";
+};

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

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const BatchItemStatus = {
+    Pending: "pending",
+    Queued: "queued",
+    Processing: "processing",
+    Succeeded: "succeeded",
+    Failed: "failed",
+    Skipped: "skipped",
+    Canceled: "canceled",
+};

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../index.mjs";
+export interface BatchListResponse {
+    batches?: Zep.BatchSummary[];
+    nextCursor?: number;
+}

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface BatchProgress {
+    canceledItems?: number;
+    failedItems?: number;
+    percentComplete?: number;
+    processingItems?: number;
+    queuedItems?: number;
+    skippedItems?: number;
+    succeededItems?: number;
+    totalItems?: number;
+}

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type BatchStatus = "draft" | "invalid" | "queued" | "processing" | "succeeded" | "partial" | "failed" | "canceled";
+export declare const BatchStatus: {
+    readonly Draft: "draft";
+    readonly Invalid: "invalid";
+    readonly Queued: "queued";
+    readonly Processing: "processing";
+    readonly Succeeded: "succeeded";
+    readonly Partial: "partial";
+    readonly Failed: "failed";
+    readonly Canceled: "canceled";
+};

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

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const BatchStatus = {
+    Draft: "draft",
+    Invalid: "invalid",
+    Queued: "queued",
+    Processing: "processing",
+    Succeeded: "succeeded",
+    Partial: "partial",
+    Failed: "failed",
+    Canceled: "canceled",
+};

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

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../index.mjs";
+export interface BatchSummary {
+    batchId?: string;
+    completedAt?: string;
+    createdAt?: string;
+    ignoreRoles?: Zep.RoleType[];
+    itemCount?: number;
+    metadata?: Record<string, unknown>;
+    processedAt?: string;
+    progress?: Zep.BatchProgress;
+    status?: Zep.BatchStatus;
+    updatedAt?: string;
+}

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

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

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

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export type ComparisonOperator = "=" | "<>" | ">" | "<" | ">=" | "<=" | "IS NULL" | "IS NOT NULL";
+export type ComparisonOperator = "=" | "<>" | ">" | "<" | ">=" | "<=" | "IS NULL" | "IS NOT NULL" | "CONTAINS";
 export declare const ComparisonOperator: {
     readonly Equals: "=";
     readonly NotEquals: "<>";
@@ -11,4 +11,5 @@ export declare const ComparisonOperator: {
     readonly LessThanEqual: "<=";
     readonly IsNull: "IS NULL";
     readonly IsNotNull: "IS NOT NULL";
+    readonly Contains: "CONTAINS";
 };

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

@@ -10,4 +10,5 @@ export const ComparisonOperator = {
     LessThanEqual: "<=",
     IsNull: "IS NULL",
     IsNotNull: "IS NOT NULL",
+    Contains: "CONTAINS",
 };

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

@@ -0,0 +1,44 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface DerivedNode {
+    /** Additional attributes of the derived node. */
+    attributes?: Record<string, unknown>;
+    /** Creation time of the node */
+    createdAt: string;
+    /**
+     * EndAt is the close timestamp of the evidence window. Set when the
+     * underlying pattern is no longer supported (closed observations);
+     * nil for active observations.
+     */
+    endAt?: string;
+    /** Episode UUIDs that support this observation. Only populated for observation nodes in web API responses. */
+    episodeIds?: string[];
+    /** Labels associated with the node */
+    labels?: string[];
+    /**
+     * LatestEvidenceAt is the most recent source-episode timestamp from
+     * which this observation drew evidence.
+     */
+    latestEvidenceAt?: string;
+    /** Name of the node */
+    name: string;
+    /**
+     * Relevance is an experimental rank-aligned score in [0,1] derived from Score via logit transformation.
+     * Only populated when using cross_encoder reranker; omitted for other reranker types (e.g., RRF).
+     */
+    relevance?: number;
+    /** Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker */
+    score?: number;
+    /** SelectionRank is the global cross-scope rank assigned by auto scope selection. */
+    selectionRank?: number;
+    /**
+     * StartAt is the earliest source-episode timestamp from which this
+     * observation was derived. Only populated for observation nodes.
+     */
+    startAt?: string;
+    /** Region summary of member nodes */
+    summary?: string;
+    /** UUID of the node */
+    uuid: string;
+}

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

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

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

@@ -21,8 +21,12 @@ export interface EntityEdge {
      * Only populated when using cross_encoder reranker; omitted for other reranker types (e.g., RRF).
      */
     relevance?: number;
+    /** Scope of the edge (e.g. "entity", "maybe_related") */
+    scope?: string;
     /** Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker */
     score?: number;
+    /** SelectionRank is the global cross-scope rank assigned by auto scope selection. */
+    selectionRank?: number;
     /** UUID of the source node */
     sourceNodeUuid: string;
     /** UUID of the target node */

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

@@ -17,6 +17,8 @@ export interface EntityNode {
     relevance?: number;
     /** Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker */
     score?: number;
+    /** SelectionRank is the global cross-scope rank assigned by auto scope selection. */
+    selectionRank?: number;
     /** Regional summary of surrounding edges */
     summary: string;
     /** UUID of the node */

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

@@ -18,6 +18,8 @@ export interface Episode {
     roleType?: Zep.RoleType;
     /** Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker */
     score?: number;
+    /** SelectionRank is the global cross-scope rank assigned by auto scope selection. */
+    selectionRank?: number;
     source?: Zep.GraphDataType;
     sourceDescription?: string;
     /** Optional task ID to poll episode processing status. Currently only available for batch ingestion. */