@getzep/zep-cloud 3.22.0 → 3.23.0

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

@@ -2,4 +2,4 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as core from "../../core/index.mjs";
-export const BatchItemStatus = core.serialization.enum_(["pending", "queued", "processing", "succeeded", "failed", "skipped"]);
+export const BatchItemStatus = core.serialization.enum_(["pending", "queued", "processing", "succeeded", "failed", "skipped", "canceled"]);

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

@@ -7,6 +7,7 @@ import * as core from "../../core/index.mjs";
 export declare const BatchProgress: core.serialization.ObjectSchema<serializers.BatchProgress.Raw, Zep.BatchProgress>;
 export declare namespace BatchProgress {
     interface Raw {
+        canceled_items?: number | null;
         failed_items?: number | null;
         percent_complete?: number | null;
         processing_items?: number | null;

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

@@ -3,6 +3,7 @@
  */
 import * as core from "../../core/index.mjs";
 export const BatchProgress = core.serialization.object({
+    canceledItems: core.serialization.property("canceled_items", core.serialization.number().optional()),
     failedItems: core.serialization.property("failed_items", core.serialization.number().optional()),
     percentComplete: core.serialization.property("percent_complete", core.serialization.number().optional()),
     processingItems: core.serialization.property("processing_items", core.serialization.number().optional()),

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

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

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

@@ -2,4 +2,13 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as core from "../../core/index.mjs";
-export const BatchStatus = core.serialization.enum_(["draft", "invalid", "queued", "processing", "succeeded", "partial", "failed"]);
+export const BatchStatus = core.serialization.enum_([
+    "draft",
+    "invalid",
+    "queued",
+    "processing",
+    "succeeded",
+    "partial",
+    "failed",
+    "canceled",
+]);

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

@@ -4,6 +4,7 @@
 import * as serializers from "../index.mjs";
 import * as Zep from "../../api/index.mjs";
 import * as core from "../../core/index.mjs";
+import { RoleType } from "./RoleType.mjs";
 import { BatchProgress } from "./BatchProgress.mjs";
 import { BatchStatus } from "./BatchStatus.mjs";
 export declare const BatchSummary: core.serialization.ObjectSchema<serializers.BatchSummary.Raw, Zep.BatchSummary>;
@@ -12,6 +13,7 @@ export declare namespace BatchSummary {
         batch_id?: string | null;
         completed_at?: string | null;
         created_at?: string | null;
+        ignore_roles?: RoleType.Raw[] | null;
         item_count?: number | null;
         metadata?: Record<string, unknown> | null;
         processed_at?: string | null;

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

@@ -2,12 +2,14 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as core from "../../core/index.mjs";
+import { RoleType } from "./RoleType.mjs";
 import { BatchProgress } from "./BatchProgress.mjs";
 import { BatchStatus } from "./BatchStatus.mjs";
 export const BatchSummary = core.serialization.object({
     batchId: core.serialization.property("batch_id", core.serialization.string().optional()),
     completedAt: core.serialization.property("completed_at", core.serialization.string().optional()),
     createdAt: core.serialization.property("created_at", core.serialization.string().optional()),
+    ignoreRoles: core.serialization.property("ignore_roles", core.serialization.list(RoleType).optional()),
     itemCount: core.serialization.property("item_count", core.serialization.number().optional()),
     metadata: core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional(),
     processedAt: core.serialization.property("processed_at", core.serialization.string().optional()),

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

@@ -9,12 +9,15 @@ export declare namespace DerivedNode {
     interface Raw {
         attributes?: Record<string, unknown> | null;
         created_at: string;
+        end_at?: string | null;
         episode_ids?: string[] | null;
         labels?: string[] | null;
+        latest_evidence_at?: string | null;
         name: string;
         relevance?: number | null;
         score?: number | null;
         selection_rank?: number | null;
+        start_at?: string | null;
         summary?: string | null;
         uuid: string;
     }

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

@@ -5,12 +5,15 @@ import * as core from "../../core/index.mjs";
 export const DerivedNode = core.serialization.object({
     attributes: core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional(),
     createdAt: core.serialization.property("created_at", core.serialization.string()),
+    endAt: core.serialization.property("end_at", core.serialization.string().optional()),
     episodeIds: core.serialization.property("episode_ids", core.serialization.list(core.serialization.string()).optional()),
     labels: core.serialization.list(core.serialization.string()).optional(),
+    latestEvidenceAt: core.serialization.property("latest_evidence_at", core.serialization.string().optional()),
     name: core.serialization.string(),
     relevance: core.serialization.number().optional(),
     score: core.serialization.number().optional(),
     selectionRank: core.serialization.property("selection_rank", core.serialization.number().optional()),
+    startAt: core.serialization.property("start_at", core.serialization.string().optional()),
     summary: core.serialization.string().optional(),
     uuid: core.serialization.string(),
 });

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

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as serializers from "../index.mjs";
+import * as Zep from "../../api/index.mjs";
+import * as core from "../../core/index.mjs";
+export declare const GraphSearchResponseMetadata: core.serialization.ObjectSchema<serializers.GraphSearchResponseMetadata.Raw, Zep.GraphSearchResponseMetadata>;
+export declare namespace GraphSearchResponseMetadata {
+    interface Raw {
+        server_latency_ms?: number | null;
+    }
+}

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

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../../core/index.mjs";
+export const GraphSearchResponseMetadata = core.serialization.object({
+    serverLatencyMs: core.serialization.property("server_latency_ms", core.serialization.number().optional()),
+});

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

@@ -8,6 +8,7 @@ import { EntityEdge } from "./EntityEdge.mjs";
 import { Episode } from "./Episode.mjs";
 import { EntityNode } from "./EntityNode.mjs";
 import { DerivedNode } from "./DerivedNode.mjs";
+import { GraphSearchResponseMetadata } from "./GraphSearchResponseMetadata.mjs";
 import { GraphitiSagaNode } from "./GraphitiSagaNode.mjs";
 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/esm/serialization/types/GraphSearchResults.mjs

@@ -6,6 +6,7 @@ import { EntityEdge } from "./EntityEdge.mjs";
 import { Episode } from "./Episode.mjs";
 import { EntityNode } from "./EntityNode.mjs";
 import { DerivedNode } from "./DerivedNode.mjs";
+import { GraphSearchResponseMetadata } from "./GraphSearchResponseMetadata.mjs";
 import { GraphitiSagaNode } from "./GraphitiSagaNode.mjs";
 export const GraphSearchResults = core.serialization.object({
     context: core.serialization.string().optional(),
@@ -13,5 +14,6 @@ export const GraphSearchResults = core.serialization.object({
     episodes: core.serialization.list(Episode).optional(),
     nodes: core.serialization.list(EntityNode).optional(),
     observations: core.serialization.list(DerivedNode).optional(),
+    response: GraphSearchResponseMetadata.optional(),
     threadSummaries: core.serialization.property("thread_summaries", core.serialization.list(GraphitiSagaNode).optional()),
 });

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

@@ -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/esm/serialization/types/GraphitiSagaNode.mjs

@@ -6,6 +6,7 @@ export const 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/esm/serialization/types/ThreadSummary.d.mts

@@ -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/esm/serialization/types/ThreadSummary.mjs

@@ -5,6 +5,7 @@ import * as core from "../../core/index.mjs";
 export const 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/esm/serialization/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/serialization/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/version.d.mts

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

package/dist/esm/version.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@getzep/zep-cloud",
-    "version": "3.22.0",
+    "version": "3.23.0",
     "private": false,
     "repository": "https://github.com/getzep/zep-js",
     "description": "Zep: Fast, scalable building blocks for production LLM apps",

package/reference.md

@@ -1203,7 +1203,9 @@ await client.graph.add({
 <dl>
 <dd>
 
-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.
 
 </dd>
 </dl>
@@ -1852,6 +1854,69 @@ await client.graph.update("graphId");
 </dl>
 </details>
 
+<details><summary><code>client.graph.<a href="/src/api/resources/graph/client/Client.ts">warm</a>(graphId) -> Zep.SuccessResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Hints Zep to warm a graph for low-latency search
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.graph.warm("graphId");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**graphId:** `string` — The graph_id of the graph to warm.
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Graph.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 ## Project
 
 <details><summary><code>client.project.<a href="/src/api/resources/project/client/Client.ts">get</a>() -> Zep.ProjectInfoResponse</code></summary>
@@ -2276,7 +2341,7 @@ Returns messages for a thread.
 ```typescript
 await client.thread.get("threadId", {
     limit: 1,
-    cursor: 1,
+    cursor: 1000000,
     lastn: 1,
 });
 ```
@@ -2411,7 +2476,9 @@ await client.thread.addMessages("threadId", {
 <dl>
 <dd>
 
-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.
 
 </dd>
 </dl>