diff --git a/.fern/replay.lock b/.fern/replay.lock
index a21a790c..158dc985 100644
--- a/.fern/replay.lock
+++ b/.fern/replay.lock
@@ -30,5 +30,11 @@ generations:
cli_version: unknown
generator_versions:
fernapi/fern-python-sdk: 4.25.5
-current_generation: c78e60a610fc85f34bc472c3338458a2b92d5936
+ - commit_sha: 01282ecde6f53105beb07e91cdfba1119005cdab
+ tree_hash: 8ec77865ba063cf4bd7cdae5936d33356e3c08f5
+ timestamp: 2026-09-24T17:41:01.114Z
+ cli_version: unknown
+ generator_versions:
+ fernapi/fern-python-sdk: 4.25.5
+current_generation: 01282ecde6f53105beb07e91cdfba1119005cdab
patches: []
diff --git a/pyproject.toml b/pyproject.toml
index 70bd5399..b00f248a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,10 +1,10 @@
[project]
name = "zep-cloud"
-version = "3.29.0"
+version = "3.30.0"
[tool.poetry]
name = "zep-cloud"
-version = "3.29.0"
+version = "3.30.0"
description = ""
readme = "README.md"
authors = []
diff --git a/reference.md b/reference.md
index 18eb3175..dd4dc508 100644
--- a/reference.md
+++ b/reference.md
@@ -6338,7 +6338,12 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]`
+
+Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+(default "uuid"). "degree" sorts by the count of live entity edges that
+touch each node (the edge scopes the entity edge list returns) and is
+supported on the node list endpoints only.
@@ -6464,7 +6469,12 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]`
+
+Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+(default "uuid"). "degree" sorts by the count of live entity edges that
+touch each node (the edge scopes the entity edge list returns) and is
+supported on the node list endpoints only.
@@ -6589,7 +6599,12 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]`
+
+Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+(default "uuid"). "degree" sorts by the count of live entity edges that
+touch each node (the edge scopes the entity edge list returns) and is
+supported on the node list endpoints only.
@@ -7685,7 +7700,12 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]`
+
+Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+(default "uuid"). "degree" sorts by the count of live entity edges that
+touch each node (the edge scopes the entity edge list returns) and is
+supported on the node list endpoints only.
@@ -7810,7 +7830,12 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]`
+
+Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+(default "uuid"). "degree" sorts by the count of live entity edges that
+touch each node (the edge scopes the entity edge list returns) and is
+supported on the node list endpoints only.
@@ -8458,7 +8483,12 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]`
+
+Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+(default "uuid"). "degree" sorts by the count of live entity edges that
+touch each node (the edge scopes the entity edge list returns) and is
+supported on the node list endpoints only.
@@ -8583,7 +8613,12 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]`
+
+Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+(default "uuid"). "degree" sorts by the count of live entity edges that
+touch each node (the edge scopes the entity edge list returns) and is
+supported on the node list endpoints only.
@@ -8779,7 +8814,12 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]`
+
+Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+(default "uuid"). "degree" sorts by the count of live entity edges that
+touch each node (the edge scopes the entity edge list returns) and is
+supported on the node list endpoints only.
@@ -8904,7 +8944,12 @@ of the previous page. Encodes the sort field, direction, and continuation positi
-
-**order_by:** `typing.Optional[str]` — Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+**order_by:** `typing.Optional[str]`
+
+Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+(default "uuid"). "degree" sorts by the count of live entity edges that
+touch each node (the edge scopes the entity edge list returns) and is
+supported on the node list endpoints only.
diff --git a/src/zep_cloud/core/client_wrapper.py b/src/zep_cloud/core/client_wrapper.py
index e4684068..a4c5cee4 100644
--- a/src/zep_cloud/core/client_wrapper.py
+++ b/src/zep_cloud/core/client_wrapper.py
@@ -22,10 +22,10 @@ def __init__(
def get_headers(self) -> typing.Dict[str, str]:
headers: typing.Dict[str, str] = {
- "User-Agent": "zep-cloud/3.29.0",
+ "User-Agent": "zep-cloud/3.30.0",
"X-Fern-Language": "Python",
"X-Fern-SDK-Name": "zep-cloud",
- "X-Fern-SDK-Version": "3.29.0",
+ "X-Fern-SDK-Version": "3.30.0",
**(self.get_custom_headers() or {}),
}
headers["Authorization"] = f"Api-Key {self.api_key}"
diff --git a/src/zep_cloud/graph/document_summary/client.py b/src/zep_cloud/graph/document_summary/client.py
index 8a771fcb..c3a13ba5 100644
--- a/src/zep_cloud/graph/document_summary/client.py
+++ b/src/zep_cloud/graph/document_summary/client.py
@@ -61,7 +61,10 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -149,7 +152,10 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/document_summary/raw_client.py b/src/zep_cloud/graph/document_summary/raw_client.py
index c6ffd1f0..555256d9 100644
--- a/src/zep_cloud/graph/document_summary/raw_client.py
+++ b/src/zep_cloud/graph/document_summary/raw_client.py
@@ -59,7 +59,10 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -184,7 +187,10 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/edge/client.py b/src/zep_cloud/graph/edge/client.py
index 2835015e..0fd372de 100644
--- a/src/zep_cloud/graph/edge/client.py
+++ b/src/zep_cloud/graph/edge/client.py
@@ -62,7 +62,10 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -134,7 +137,10 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -353,7 +359,10 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -433,7 +442,10 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/edge/raw_client.py b/src/zep_cloud/graph/edge/raw_client.py
index 4375c21b..5e3b23dd 100644
--- a/src/zep_cloud/graph/edge/raw_client.py
+++ b/src/zep_cloud/graph/edge/raw_client.py
@@ -60,7 +60,10 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -166,7 +169,10 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -542,7 +548,10 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -648,7 +657,10 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/node/client.py b/src/zep_cloud/graph/node/client.py
index 3cd22131..01b44826 100644
--- a/src/zep_cloud/graph/node/client.py
+++ b/src/zep_cloud/graph/node/client.py
@@ -65,7 +65,10 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -137,7 +140,10 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -486,7 +492,10 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -566,7 +575,10 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/node/raw_client.py b/src/zep_cloud/graph/node/raw_client.py
index 20e6ce39..30cf724d 100644
--- a/src/zep_cloud/graph/node/raw_client.py
+++ b/src/zep_cloud/graph/node/raw_client.py
@@ -63,7 +63,10 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -169,7 +172,10 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -792,7 +798,10 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -898,7 +907,10 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/observation/client.py b/src/zep_cloud/graph/observation/client.py
index cdd97fb5..c019b4d8 100644
--- a/src/zep_cloud/graph/observation/client.py
+++ b/src/zep_cloud/graph/observation/client.py
@@ -61,7 +61,10 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -133,7 +136,10 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -252,7 +258,10 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -332,7 +341,10 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/observation/raw_client.py b/src/zep_cloud/graph/observation/raw_client.py
index b677dfa4..437d4427 100644
--- a/src/zep_cloud/graph/observation/raw_client.py
+++ b/src/zep_cloud/graph/observation/raw_client.py
@@ -59,7 +59,10 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -176,7 +179,10 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -372,7 +378,10 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -489,7 +498,10 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/thread_summary/client.py b/src/zep_cloud/graph/thread_summary/client.py
index 02b8db7f..f70c84b2 100644
--- a/src/zep_cloud/graph/thread_summary/client.py
+++ b/src/zep_cloud/graph/thread_summary/client.py
@@ -61,7 +61,10 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -133,7 +136,10 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -221,7 +227,10 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -301,7 +310,10 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/graph/thread_summary/raw_client.py b/src/zep_cloud/graph/thread_summary/raw_client.py
index 063a02f1..b90f4a7d 100644
--- a/src/zep_cloud/graph/thread_summary/raw_client.py
+++ b/src/zep_cloud/graph/thread_summary/raw_client.py
@@ -59,7 +59,10 @@ def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -176,7 +179,10 @@ def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -298,7 +304,10 @@ async def get_by_graph_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
@@ -415,7 +424,10 @@ async def get_by_user_id(
Maximum number of items to return
order_by : typing.Optional[str]
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
uuid_cursor : typing.Optional[str]
UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.
diff --git a/src/zep_cloud/types/entity_node.py b/src/zep_cloud/types/entity_node.py
index 9161cc17..488e0d37 100644
--- a/src/zep_cloud/types/entity_node.py
+++ b/src/zep_cloud/types/entity_node.py
@@ -19,6 +19,13 @@ class EntityNode(UniversalBaseModel):
Creation time of the node
"""
+ degree: typing.Optional[int] = pydantic.Field(default=None)
+ """
+ The count of live entity edges that touch this node (the edge scopes
+ the entity edge list returns). Present only when the list request
+ orders by degree.
+ """
+
episodes: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
"""
The UUIDs of the live episodes that mention this node, newest first. The
diff --git a/src/zep_cloud/types/graph_edges_request.py b/src/zep_cloud/types/graph_edges_request.py
index 77cc19a8..9a8a924a 100644
--- a/src/zep_cloud/types/graph_edges_request.py
+++ b/src/zep_cloud/types/graph_edges_request.py
@@ -33,7 +33,10 @@ class GraphEdgesRequest(UniversalBaseModel):
order_by: typing.Optional[str] = pydantic.Field(default=None)
"""
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
"""
uuid_cursor: typing.Optional[str] = pydantic.Field(default=None)
diff --git a/src/zep_cloud/types/graph_nodes_request.py b/src/zep_cloud/types/graph_nodes_request.py
index e74a760f..ed5f423c 100644
--- a/src/zep_cloud/types/graph_nodes_request.py
+++ b/src/zep_cloud/types/graph_nodes_request.py
@@ -33,7 +33,10 @@ class GraphNodesRequest(UniversalBaseModel):
order_by: typing.Optional[str] = pydantic.Field(default=None)
"""
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
"""
uuid_cursor: typing.Optional[str] = pydantic.Field(default=None)
diff --git a/src/zep_cloud/types/graph_observations_request.py b/src/zep_cloud/types/graph_observations_request.py
index 21f81b7e..1fdc952b 100644
--- a/src/zep_cloud/types/graph_observations_request.py
+++ b/src/zep_cloud/types/graph_observations_request.py
@@ -33,7 +33,10 @@ class GraphObservationsRequest(UniversalBaseModel):
order_by: typing.Optional[str] = pydantic.Field(default=None)
"""
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
"""
uuid_cursor: typing.Optional[str] = pydantic.Field(default=None)
diff --git a/src/zep_cloud/types/graph_thread_summaries_request.py b/src/zep_cloud/types/graph_thread_summaries_request.py
index 0f835d73..c5923e0f 100644
--- a/src/zep_cloud/types/graph_thread_summaries_request.py
+++ b/src/zep_cloud/types/graph_thread_summaries_request.py
@@ -33,7 +33,10 @@ class GraphThreadSummariesRequest(UniversalBaseModel):
order_by: typing.Optional[str] = pydantic.Field(default=None)
"""
- Field to sort by. One of "created_at", "valid_at", or "uuid" (default "uuid").
+ Field to sort by. One of "created_at", "valid_at", "degree", or "uuid"
+ (default "uuid"). "degree" sorts by the count of live entity edges that
+ touch each node (the edge scopes the entity edge list returns) and is
+ supported on the node list endpoints only.
"""
uuid_cursor: typing.Optional[str] = pydantic.Field(default=None)