V3 (#288)

* chore: Fix fact ratings table

* SDK regeneration

* chore: Version bump

* chore: Version bump

* SDK regeneration

* chore: Add support for user/graph ontology targets

* SDK regeneration

* chore: Add support for setting entity/edges on a list of users/graphs

* SDK regeneration

* chore: Bump version

* SDK regeneration

* feat: Update compose context string util to include episodes and display entity attributes

* chore: Bump version

* fix: tests

* chore: Remove redundant timestamp conversion branch

* SDK regeneration

* chore: Version bump

* SDK regeneration

* SDK regeneration

* fix: tests

* chore: Version bump

* SDK regeneration

* chore: Simplify date parsing in string composition utility

* chore: Add python date util dep

* chore: Bump version

* SDK regeneration

* SDK regeneration

* chore: Bump version

* SDK regeneration

---------

Co-authored-by: fern-api <115122769+fern-api[bot]@users.noreply.github.com>

Author: paul-paliychuk

pyproject.toml

@@ -3,7 +3,7 @@ name = "zep-cloud"
 
 [tool.poetry]
 name = "zep-cloud"
-version = "3.5.0"
+version = "3.6.0"
 description = ""
 readme = "README.md"
 authors = []

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.5.0",
+            "User-Agent": "zep-cloud/3.6.0",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "zep-cloud",
-            "X-Fern-SDK-Version": "3.5.0",
+            "X-Fern-SDK-Version": "3.6.0",
             **(self.get_custom_headers() or {}),
         }
         headers["Authorization"] = f"Api-Key {self.api_key}"

src/zep_cloud/types/entity_edge.py

@@ -44,7 +44,17 @@ class EntityEdge(UniversalBaseModel):
     Name of the edge, relation name
     """
 
-    score: typing.Optional[float] = None
+    relevance: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    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).
+    """
+
+    score: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker
+    """
+
     source_node_uuid: str = pydantic.Field()
     """
     UUID of the source node

src/zep_cloud/types/entity_node.py

@@ -29,7 +29,17 @@ class EntityNode(UniversalBaseModel):
     Name of the node
     """
 
-    score: typing.Optional[float] = None
+    relevance: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    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).
+    """
+
+    score: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker
+    """
+
     summary: str = pydantic.Field()
     """
     Regional summary of surrounding edges

src/zep_cloud/types/episode.py

@@ -14,6 +14,12 @@ class Episode(UniversalBaseModel):
     content: str
     created_at: str
     processed: typing.Optional[bool] = None
+    relevance: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    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).
+    """
+
     role: typing.Optional[str] = pydantic.Field(default=None)
     """
     Optional role, will only be present if the episode was created using memory.add API
@@ -24,7 +30,11 @@ class Episode(UniversalBaseModel):
     Optional role_type, will only be present if the episode was created using memory.add API
     """
 
-    score: typing.Optional[float] = None
+    score: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker
+    """
+
     session_id: typing.Optional[str] = None
     source: typing.Optional[GraphDataType] = None
     source_description: typing.Optional[str] = None