@getzep/zep-cloud 3.22.0 → 3.23.0

package/dist/cjs/serialization/types/GraphSearchResponseMetadata.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphSearchResponseMetadata = void 0;
+const core = __importStar(require("../../core/index.js"));
+exports.GraphSearchResponseMetadata = core.serialization.object({
+    serverLatencyMs: core.serialization.property("server_latency_ms", core.serialization.number().optional()),
+});

package/dist/cjs/serialization/types/GraphSearchResults.d.ts

@@ -8,6 +8,7 @@ import { EntityEdge } from "./EntityEdge.js";
 import { Episode } from "./Episode.js";
 import { EntityNode } from "./EntityNode.js";
 import { DerivedNode } from "./DerivedNode.js";
+import { GraphSearchResponseMetadata } from "./GraphSearchResponseMetadata.js";
 import { GraphitiSagaNode } from "./GraphitiSagaNode.js";
 export declare const GraphSearchResults: core.serialization.ObjectSchema<serializers.GraphSearchResults.Raw, Zep.GraphSearchResults>;
 export declare namespace GraphSearchResults {
@@ -17,6 +18,7 @@ export declare namespace GraphSearchResults {
         episodes?: Episode.Raw[] | null;
         nodes?: EntityNode.Raw[] | null;
         observations?: DerivedNode.Raw[] | null;
+        response?: GraphSearchResponseMetadata.Raw | null;
         thread_summaries?: GraphitiSagaNode.Raw[] | null;
     }
 }

package/dist/cjs/serialization/types/GraphSearchResults.js

@@ -42,6 +42,7 @@ const EntityEdge_js_1 = require("./EntityEdge.js");
 const Episode_js_1 = require("./Episode.js");
 const EntityNode_js_1 = require("./EntityNode.js");
 const DerivedNode_js_1 = require("./DerivedNode.js");
+const GraphSearchResponseMetadata_js_1 = require("./GraphSearchResponseMetadata.js");
 const GraphitiSagaNode_js_1 = require("./GraphitiSagaNode.js");
 exports.GraphSearchResults = core.serialization.object({
     context: core.serialization.string().optional(),
@@ -49,5 +50,6 @@ exports.GraphSearchResults = core.serialization.object({
     episodes: core.serialization.list(Episode_js_1.Episode).optional(),
     nodes: core.serialization.list(EntityNode_js_1.EntityNode).optional(),
     observations: core.serialization.list(DerivedNode_js_1.DerivedNode).optional(),
+    response: GraphSearchResponseMetadata_js_1.GraphSearchResponseMetadata.optional(),
     threadSummaries: core.serialization.property("thread_summaries", core.serialization.list(GraphitiSagaNode_js_1.GraphitiSagaNode).optional()),
 });

package/dist/cjs/serialization/types/GraphitiSagaNode.d.ts

@@ -10,6 +10,7 @@ export declare namespace GraphitiSagaNode {
         created_at: string;
         labels?: string[] | null;
         last_summarized_at?: string | null;
+        last_summarized_episode_valid_at?: string | null;
         name: string;
         relevance?: number | null;
         score?: number | null;

package/dist/cjs/serialization/types/GraphitiSagaNode.js

@@ -42,6 +42,7 @@ exports.GraphitiSagaNode = core.serialization.object({
     createdAt: core.serialization.property("created_at", core.serialization.string()),
     labels: core.serialization.list(core.serialization.string()).optional(),
     lastSummarizedAt: core.serialization.property("last_summarized_at", core.serialization.string().optional()),
+    lastSummarizedEpisodeValidAt: core.serialization.property("last_summarized_episode_valid_at", core.serialization.string().optional()),
     name: core.serialization.string(),
     relevance: core.serialization.number().optional(),
     score: core.serialization.number().optional(),

package/dist/cjs/serialization/types/ThreadSummary.d.ts

@@ -9,6 +9,7 @@ export declare namespace ThreadSummary {
     interface Raw {
         created_at?: string | null;
         last_summarized_at?: string | null;
+        last_summarized_episode_valid_at?: string | null;
         summary?: string | null;
         thread_id?: string | null;
         uuid?: string | null;

package/dist/cjs/serialization/types/ThreadSummary.js

@@ -41,6 +41,7 @@ const core = __importStar(require("../../core/index.js"));
 exports.ThreadSummary = core.serialization.object({
     createdAt: core.serialization.property("created_at", core.serialization.string().optional()),
     lastSummarizedAt: core.serialization.property("last_summarized_at", core.serialization.string().optional()),
+    lastSummarizedEpisodeValidAt: core.serialization.property("last_summarized_episode_valid_at", core.serialization.string().optional()),
     summary: core.serialization.string().optional(),
     threadId: core.serialization.property("thread_id", core.serialization.string().optional()),
     uuid: core.serialization.string().optional(),

package/dist/cjs/serialization/types/index.d.ts

@@ -31,6 +31,7 @@ export * from "./EpisodeResponse.js";
 export * from "./GraphListResponse.js";
 export * from "./GraphNodesRequest.js";
 export * from "./GraphObservationsRequest.js";
+export * from "./GraphSearchResponseMetadata.js";
 export * from "./GraphSearchResults.js";
 export * from "./GraphThreadSummariesRequest.js";
 export * from "./HubDetectConfig.js";

package/dist/cjs/serialization/types/index.js

@@ -47,6 +47,7 @@ __exportStar(require("./EpisodeResponse.js"), exports);
 __exportStar(require("./GraphListResponse.js"), exports);
 __exportStar(require("./GraphNodesRequest.js"), exports);
 __exportStar(require("./GraphObservationsRequest.js"), exports);
+__exportStar(require("./GraphSearchResponseMetadata.js"), exports);
 __exportStar(require("./GraphSearchResults.js"), exports);
 __exportStar(require("./GraphThreadSummariesRequest.js"), exports);
 __exportStar(require("./HubDetectConfig.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.22.0";
+export declare const SDK_VERSION = "3.23.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "3.22.0";
+exports.SDK_VERSION = "3.23.0";

package/dist/esm/Client.mjs

@@ -15,8 +15,8 @@ export class ZepClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "zep-cloud",
-                "X-Fern-SDK-Version": "3.22.0",
-                "User-Agent": "zep-cloud/3.22.0",
+                "X-Fern-SDK-Version": "3.23.0",
+                "User-Agent": "zep-cloud/3.23.0",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/resources/batch/client/requests/ApidataCreateBatchRequest.d.mts

@@ -1,10 +1,18 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Zep from "../../../../index.mjs";
 /**
  * @example
  *     {}
  */
 export interface ApidataCreateBatchRequest {
+    /**
+     * Optional list of message role types to skip during graph ingestion for
+     * thread_message items in this batch. The messages are still stored and
+     * retained as context, but no graph extraction is performed for them.
+     * Has no effect on graph_episode items.
+     */
+    ignoreRoles?: Zep.RoleType[];
     metadata?: Record<string, unknown>;
 }

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

@@ -147,7 +147,9 @@ export declare class Graph {
     add(request: Zep.AddDataRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.Episode>;
     private __add;
     /**
-     * Add data to the graph in batch mode. Episodes are processed sequentially in the order provided.
+     * Deprecated. Use the [Batch API](/adding-batch-data) (`client.batch.*`) instead.
+     *
+     * Adds data to the graph in batch mode, processing episodes concurrently.
      *
      * @param {Zep.AddDataBatchRequest} request
      * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
@@ -312,6 +314,20 @@ export declare class Graph {
      */
     update(graphId: string, request?: Zep.UpdateGraphRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.Graph>;
     private __update;
+    /**
+     * Hints Zep to warm a graph for low-latency search
+     *
+     * @param {string} graphId - The graph_id of the graph to warm.
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.warm("graphId")
+     */
+    warm(graphId: string, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.SuccessResponse>;
+    private __warm;
     protected _getCustomAuthorizationHeaders(): Promise<{
         Authorization: string;
     }>;

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

@@ -597,7 +597,9 @@ export class Graph {
         });
     }
     /**
-     * Add data to the graph in batch mode. Episodes are processed sequentially in the order provided.
+     * Deprecated. Use the [Batch API](/adding-batch-data) (`client.batch.*`) instead.
+     *
+     * Adds data to the graph in batch mode, processing episodes concurrently.
      *
      * @param {Zep.AddDataBatchRequest} request
      * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
@@ -1470,6 +1472,87 @@ export class Graph {
             }
         });
     }
+    /**
+     * Hints Zep to warm a graph for low-latency search
+     *
+     * @param {string} graphId - The graph_id of the graph to warm.
+     * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Zep.NotFoundError}
+     * @throws {@link Zep.InternalServerError}
+     *
+     * @example
+     *     await client.graph.warm("graphId")
+     */
+    warm(graphId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__warm(graphId, requestOptions));
+    }
+    __warm(graphId, 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/${encodeURIComponent(graphId)}/warm`),
+                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.SuccessResponse.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 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 /graph/{graphId}/warm.");
+                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/graph/client/requests/AddTripleRequest.d.mts

@@ -37,7 +37,13 @@ export interface AddTripleRequest {
      * Nested objects and arrays are not allowed.
      */
     sourceNodeAttributes?: Record<string, unknown>;
-    /** The labels for the source node */
+    /**
+     * The labels for the source node. At most one entity-type label may be
+     * provided so that manually-added triples remain consistent with automatic
+     * episode extraction, which assigns one best-match entity type per node.
+     * The base "Entity" label is added implicitly by the graph layer on save
+     * and does not need to be supplied here.
+     */
     sourceNodeLabels?: string[];
     /** The name of the source node to add */
     sourceNodeName?: string;
@@ -50,7 +56,13 @@ export interface AddTripleRequest {
      * Nested objects and arrays are not allowed.
      */
     targetNodeAttributes?: Record<string, unknown>;
-    /** The labels for the target node */
+    /**
+     * The labels for the target node. At most one entity-type label may be
+     * provided so that manually-added triples remain consistent with automatic
+     * episode extraction, which assigns one best-match entity type per node.
+     * The base "Entity" label is added implicitly by the graph layer on save
+     * and does not need to be supplied here.
+     */
     targetNodeLabels?: string[];
     /** The name of the target node to add */
     targetNodeName?: string;

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

@@ -15,7 +15,7 @@ export interface GraphSearchQuery {
     centerNodeUuid?: string;
     /** The graph_id to search in. When searching user graph, please use user_id instead. */
     graphId?: string;
-    /** The maximum number of facts to retrieve. Defaults to 10. Limited to 50. */
+    /** The maximum number of facts to retrieve for non-auto scopes. Defaults to 10. Limited to 50. Ignored when scope=auto. */
     limit?: number;
     /** Maximum total characters across all selected results when scope=auto. Defaults to 2500. Limited to 50000. */
     maxCharacters?: number;
@@ -24,9 +24,8 @@ export interface GraphSearchQuery {
     /** The string to search for (required) */
     query: string;
     /**
-     * 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.
+     * Defaults to RRF. Ignored when scope=auto except node_distance and episode_mentions are rejected;
+     * auto search always uses RRF retrieval and applies its own internal rerank after retrieval.
      */
     reranker?: Zep.Reranker;
     /**

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

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

@@ -388,7 +388,7 @@ export class Thread {
      * @example
      *     await client.thread.get("threadId", {
      *         limit: 1,
-     *         cursor: 1,
+     *         cursor: 1000000,
      *         lastn: 1
      *     })
      */
@@ -558,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

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/types/BatchItemDetail.d.mts

@@ -4,6 +4,12 @@
 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;

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

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

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

@@ -8,4 +8,5 @@ export const BatchItemStatus = {
     Succeeded: "succeeded",
     Failed: "failed",
     Skipped: "skipped",
+    Canceled: "canceled",
 };

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

@@ -2,6 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 export interface BatchProgress {
+    canceledItems?: number;
     failedItems?: number;
     percentComplete?: number;
     processingItems?: number;

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

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

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

@@ -9,4 +9,5 @@ export const BatchStatus = {
     Succeeded: "succeeded",
     Partial: "partial",
     Failed: "failed",
+    Canceled: "canceled",
 };

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

@@ -6,6 +6,7 @@ export interface BatchSummary {
     batchId?: string;
     completedAt?: string;
     createdAt?: string;
+    ignoreRoles?: Zep.RoleType[];
     itemCount?: number;
     metadata?: Record<string, unknown>;
     processedAt?: string;

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

@@ -6,10 +6,21 @@ export interface DerivedNode {
     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;
     /**
@@ -21,6 +32,11 @@ export interface DerivedNode {
     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 */

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

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface GraphSearchResponseMetadata {
+    /** Server-side processing latency in milliseconds. */
+    serverLatencyMs?: number;
+}

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

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

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

@@ -8,5 +8,6 @@ export interface GraphSearchResults {
     episodes?: Zep.Episode[];
     nodes?: Zep.EntityNode[];
     observations?: Zep.DerivedNode[];
+    response?: Zep.GraphSearchResponseMetadata;
     threadSummaries?: Zep.GraphitiSagaNode[];
 }

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

@@ -6,8 +6,17 @@ export interface GraphitiSagaNode {
     createdAt: string;
     /** Labels associated with the node */
     labels?: string[];
-    /** Timestamp of the most recent summary update. */
+    /**
+     * Wall-clock timestamp of the most recent summary update. Used internally
+     * as the watermark for filtering new episodes by ingestion time.
+     */
     lastSummarizedAt?: string;
+    /**
+     * Maximum episode reference time (valid_at) covered by the most recent
+     * summary. Use this field — not LastSummarizedAt — when answering "how
+     * recent is this summary's content in event-time?".
+     */
+    lastSummarizedEpisodeValidAt?: string;
     /** Name of the node */
     name: string;
     /**

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

@@ -4,8 +4,19 @@
 export interface ThreadSummary {
     /** CreatedAt is when the summary node was first created. */
     createdAt?: string;
-    /** LastSummarizedAt is the timestamp of the most recent summary update. */
+    /**
+     * LastSummarizedAt is the wall-clock timestamp of the most recent
+     * summary update. This is an ingestion-time watermark; for the
+     * event-time recency of the summary's content, use
+     * LastSummarizedEpisodeValidAt instead.
+     */
     lastSummarizedAt?: string;
+    /**
+     * LastSummarizedEpisodeValidAt is the maximum episode reference time
+     * (valid_at) covered by the most recent summary. Use this when
+     * answering "how recent is this summary's content in event-time?".
+     */
+    lastSummarizedEpisodeValidAt?: string;
     /** Summary is the incremental summary content. */
     summary?: string;
     /**

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

@@ -31,6 +31,7 @@ export * from "./EpisodeResponse.mjs";
 export * from "./GraphListResponse.mjs";
 export * from "./GraphNodesRequest.mjs";
 export * from "./GraphObservationsRequest.mjs";
+export * from "./GraphSearchResponseMetadata.mjs";
 export * from "./GraphSearchResults.mjs";
 export * from "./GraphThreadSummariesRequest.mjs";
 export * from "./HubDetectConfig.mjs";

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

@@ -31,6 +31,7 @@ export * from "./EpisodeResponse.mjs";
 export * from "./GraphListResponse.mjs";
 export * from "./GraphNodesRequest.mjs";
 export * from "./GraphObservationsRequest.mjs";
+export * from "./GraphSearchResponseMetadata.mjs";
 export * from "./GraphSearchResults.mjs";
 export * from "./GraphThreadSummariesRequest.mjs";
 export * from "./HubDetectConfig.mjs";

package/dist/esm/serialization/resources/batch/client/requests/ApidataCreateBatchRequest.d.mts

@@ -4,9 +4,11 @@
 import * as serializers from "../../../../index.mjs";
 import * as Zep from "../../../../../api/index.mjs";
 import * as core from "../../../../../core/index.mjs";
+import { RoleType } from "../../../../types/RoleType.mjs";
 export declare const ApidataCreateBatchRequest: core.serialization.Schema<serializers.ApidataCreateBatchRequest.Raw, Zep.ApidataCreateBatchRequest>;
 export declare namespace ApidataCreateBatchRequest {
     interface Raw {
+        ignore_roles?: RoleType.Raw[] | null;
         metadata?: Record<string, unknown> | null;
     }
 }

package/dist/esm/serialization/resources/batch/client/requests/ApidataCreateBatchRequest.mjs

@@ -2,6 +2,8 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as core from "../../../../../core/index.mjs";
+import { RoleType } from "../../../../types/RoleType.mjs";
 export const ApidataCreateBatchRequest = core.serialization.object({
+    ignoreRoles: core.serialization.property("ignore_roles", core.serialization.list(RoleType).optional()),
     metadata: core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional(),
 });

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

@@ -6,5 +6,5 @@ import * as Zep from "../../api/index.mjs";
 import * as core from "../../core/index.mjs";
 export declare const BatchItemStatus: core.serialization.Schema<serializers.BatchItemStatus.Raw, Zep.BatchItemStatus>;
 export declare namespace BatchItemStatus {
-    type Raw = "pending" | "queued" | "processing" | "succeeded" | "failed" | "skipped";
+    type Raw = "pending" | "queued" | "processing" | "succeeded" | "failed" | "skipped" | "canceled";
 }