From 472152716a1955e74d3257e05531f634b0c16c6c Mon Sep 17 00:00:00 2001
From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com>
Date: Tue, 11 Aug 2026 20:04:55 +0000
Subject: [PATCH 1/3] [fern-generated] Update SDK
Generated by Fern
CLI Version: unknown
Generators:
- fernapi/fern-python-sdk: 4.25.5
---
reference.md | 534 +++++++++++++++++-
src/zep_cloud/__init__.py | 6 +
src/zep_cloud/core/client_wrapper.py | 4 +-
src/zep_cloud/graph/client.py | 181 ++++++
src/zep_cloud/graph/episode/client.py | 288 +++++++++-
src/zep_cloud/graph/episode/raw_client.py | 400 ++++++++++++-
src/zep_cloud/graph/node/client.py | 175 +++++-
src/zep_cloud/graph/node/raw_client.py | 263 ++++++++-
src/zep_cloud/graph/raw_client.py | 293 ++++++++++
src/zep_cloud/types/__init__.py | 6 +
src/zep_cloud/types/date_filter.py | 2 +-
src/zep_cloud/types/entity_edge.py | 27 +
.../types/graph_episode_list_request.py | 45 ++
src/zep_cloud/types/graph_node_neighbor.py | 22 +
.../types/graph_subgraph_response.py | 41 ++
src/zep_cloud/types/property_filter.py | 2 +-
src/zep_cloud/types/search_filters.py | 45 +-
17 files changed, 2307 insertions(+), 27 deletions(-)
create mode 100644 src/zep_cloud/types/graph_episode_list_request.py
create mode 100644 src/zep_cloud/types/graph_node_neighbor.py
create mode 100644 src/zep_cloud/types/graph_subgraph_response.py
diff --git a/reference.md b/reference.md
index 9158587..d9dba04 100644
--- a/reference.md
+++ b/reference.md
@@ -3536,6 +3536,9 @@ client.graph.search(
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.
+episode_mentions ranks edge candidates by how many of the episodes listed
+in search_filters.episode_uuids mention them; without episode_uuids it has
+no effect and results are ranked as if no reranker were specified.
@@ -3587,6 +3590,153 @@ edges, nodes, observations, and thread_summaries.
+
+
+
+
+client.graph.get_subgraph(...)
+
+-
+
+#### ๐ Description
+
+
+-
+
+
+-
+
+Returns the bounded neighborhood of a set of seed nodes as a single {nodes, edges} payload: breadth-first expansion up to a caller-specified depth, subject to explicit budgets, with explicit truncation reporting.
+
+
+
+
+
+#### ๐ Usage
+
+
+-
+
+
+-
+
+```python
+from zep_cloud import Zep
+
+client = Zep(
+ api_key="YOUR_API_KEY",
+)
+client.graph.get_subgraph(
+ seed_node_uuids=["seed_node_uuids"],
+)
+
+```
+
+
+
+
+
+#### โ๏ธ Parameters
+
+
+-
+
+
+-
+
+**seed_node_uuids:** `typing.Sequence[str]`
+
+Seed node UUIDs to expand from, in traversal-priority order: seeds are
+admitted before any expansion, in this order, and count toward
+max_nodes first. 1-20 entries, required. Seeds that do not exist in
+the target graph are ignored, not an error.
+
+
+
+
+
+-
+
+**depth:** `typing.Optional[int]` โ Maximum traversal depth from the seeds. 1-3. Defaults to 1.
+
+
+
+
+
+-
+
+**direction:** `typing.Optional[str]`
+
+Edge orientation followed during expansion, relative to each frontier
+node: "in" | "out" | "both". Defaults to "both".
+
+
+
+
+
+-
+
+**graph_id:** `typing.Optional[str]`
+
+graph_id identifies the target named graph. Exactly one of user_id or
+graph_id is required.
+
+
+
+
+
+-
+
+**max_edges:** `typing.Optional[int]` โ Maximum number of edges in the response. 1-1000. Defaults to 200.
+
+
+
+
+
+-
+
+**max_nodes:** `typing.Optional[int]`
+
+Maximum number of nodes in the response, including admitted seeds.
+1-500. Defaults to 100.
+
+
+
+
+
+-
+
+**search_filters:** `typing.Optional[SearchFilters]`
+
+Filters constraining traversed edges and included nodes. Reuses the
+graph.search filter type. search_filters.episode_metadata_filters is
+rejected: it cannot be enforced during graph traversal (spec-2 ยง9.4).
+
+
+
+
+
+-
+
+**user_id:** `typing.Optional[str]`
+
+user_id identifies the target user graph. Exactly one of user_id or
+graph_id is required.
+
+
+
+
+
+-
+
+**request_options:** `typing.Optional[RequestOptions]` โ Request-specific configuration.
+
+
+
+
+
+
+
client.graph.episode.list_by_graph_id(...)
+
+-
+
+#### ๐ Description
+
+
+-
+
+
+-
+
+Returns a paginated, filterable list of episodes for a graph.
+
+
+
+
+
+#### ๐ Usage
+
+
+-
+
+
+-
+
+```python
+from zep_cloud import Zep
+
+client = Zep(
+ api_key="YOUR_API_KEY",
+)
+client.graph.episode.list_by_graph_id(
+ graph_id="graph_id",
+)
+
+```
+
+
+
+
+
+#### โ๏ธ Parameters
+
+
+-
+
+
+-
+
+**graph_id:** `str` โ Graph ID
+
+
+
+
+
+-
+
+**cursor:** `typing.Optional[str]`
+
+Opaque cursor for pagination, obtained from the Zep-Next-Cursor
+response header of the previous page.
+
+
+
+
+
+-
+
+**direction:** `typing.Optional[str]` โ Sort direction. One of "asc" or "desc". Defaults to "desc".
+
+
+
+
+
+-
+
+**limit:** `typing.Optional[int]`
+
+Maximum number of episodes to return. An explicit value is clamped to
+50; when omitted, the default page size (100) applies.
+
+
+
+
+
+-
+
+**mentioned_node_uuids:** `typing.Optional[typing.Sequence[str]]`
+
+Restricts results to episodes that mention any of the listed node
+UUIDs. At most 256 entries; each must be a syntactically valid UUID.
+
+
+
+
+
+-
+
+**order_by:** `typing.Optional[str]` โ Field to sort by. One of "uuid" or "created_at". Defaults to "uuid".
+
+
+
+
+
+-
+
+**request_options:** `typing.Optional[RequestOptions]` โ Request-specific configuration.
+
+
+
+
+
+
+
client.graph.episode.list_by_user_id(...)
+
+-
+
+#### ๐ Description
+
+
+-
+
+
+-
+
+Returns a paginated, filterable list of episodes for a user's graph.
+
+
+
+
+
+#### ๐ Usage
+
+
+-
+
+
+-
+
+```python
+from zep_cloud import Zep
+
+client = Zep(
+ api_key="YOUR_API_KEY",
+)
+client.graph.episode.list_by_user_id(
+ user_id="user_id",
+)
+
+```
+
+
+
+
+
+#### โ๏ธ Parameters
+
+
+-
+
+
+-
+
+**user_id:** `str` โ User ID
+
+
+
+
+
+-
+
+**cursor:** `typing.Optional[str]`
+
+Opaque cursor for pagination, obtained from the Zep-Next-Cursor
+response header of the previous page.
+
+
+
+
+
+-
+
+**direction:** `typing.Optional[str]` โ Sort direction. One of "asc" or "desc". Defaults to "desc".
+
+
+
+
+
+-
+
+**limit:** `typing.Optional[int]`
+
+Maximum number of episodes to return. An explicit value is clamped to
+50; when omitted, the default page size (100) applies.
+
+
+
+
+
+-
+
+**mentioned_node_uuids:** `typing.Optional[typing.Sequence[str]]`
+
+Restricts results to episodes that mention any of the listed node
+UUIDs. At most 256 entries; each must be a syntactically valid UUID.
+
+
+
+
+
+-
+
+**order_by:** `typing.Optional[str]` โ Field to sort by. One of "uuid" or "created_at". Defaults to "uuid".
+
+
+
+
+
+-
+
+**request_options:** `typing.Optional[RequestOptions]` โ Request-specific configuration.
+
+
+
+
+
+
+
-
-Returns nodes and edges mentioned in an episode
+Deprecated. Use edge and node listing with `filters.episode_uuids` instead. Returns nodes and edges mentioned in an episode, subject to an internal cap; responses reduced by that cap set the Zep-Truncated header.
@@ -7130,7 +7518,7 @@ Deprecated: prefer Cursor, the opaque cursor returned via the Zep-Next-Cursor re
-
-Returns all edges for a node
+Deprecated. Use edge listing with `filters.connected_node_uuids`, or the neighbors endpoint (`POST /graph/node/{node_uuid}/neighbors`), instead. Returns all edges for a node, subject to an internal cap; responses reduced by that cap set the Zep-Truncated header.
@@ -7200,7 +7588,7 @@ client.graph.node.get_edges(
-
-Returns all episodes that mentioned a given node
+Deprecated. Use episode listing with `mentioned_node_uuids` (`POST /graph/episodes/graph/{graph_id}` or `POST /graph/episodes/user/{user_id}`) instead. Returns episodes that mentioned a given node, subject to an internal cap; responses reduced by that cap set the Zep-Truncated header.
@@ -7254,6 +7642,146 @@ client.graph.node.get_episodes(
+
+
+
+
+client.graph.node.get_neighbors(...)
+
+-
+
+#### ๐ Description
+
+
+-
+
+
+-
+
+Enumerates the distinct entity nodes directly connected to a node, together with the edges connecting each to it.
+
+
+
+
+
+#### ๐ Usage
+
+
+-
+
+
+-
+
+```python
+from zep_cloud import Zep
+
+client = Zep(
+ api_key="YOUR_API_KEY",
+)
+client.graph.node.get_neighbors(
+ node_uuid="node_uuid",
+)
+
+```
+
+
+
+
+
+#### โ๏ธ Parameters
+
+
+-
+
+
+-
+
+**node_uuid:** `str` โ Node UUID
+
+
+
+
+
+-
+
+**cursor:** `typing.Optional[str]`
+
+Opaque cursor for pagination, obtained from the Zep-Next-Cursor
+response header of the previous page.
+
+
+
+
+
+-
+
+**direction:** `typing.Optional[str]`
+
+Orientation of the connecting edge relative to the anchor node: "out"
+(anchor is the edge's source), "in" (anchor is the edge's target), or
+"both" (either). Defaults to "both".
+
+
+
+
+
+-
+
+**direction_sort:** `typing.Optional[str]`
+
+Sort direction for order_by. One of "asc" or "desc". Defaults to
+"desc". Named direction_sort to avoid clashing with the traversal
+Direction field above.
+
+
+
+
+
+-
+
+**filters:** `typing.Optional[SearchFilters]`
+
+Filters constraining the connecting edges (edge types, dates, and the
+section-3 node-/episode-anchored fields) and the neighbor nodes
+(node_labels/exclude_node_labels). Reuses the graph.search filter
+type.
+
+
+
+
+
+-
+
+**limit:** `typing.Optional[int]`
+
+Maximum number of neighbor nodes to return. An explicit value is
+clamped to 50; when omitted, the default page size (100) applies.
+
+
+
+
+
+-
+
+**order_by:** `typing.Optional[str]`
+
+Field to sort neighbor nodes by. One of "uuid" or "created_at".
+Defaults to "uuid".
+
+
+
+
+
+-
+
+**request_options:** `typing.Optional[RequestOptions]` โ Request-specific configuration.
+
+
+
+
+
+
+