langgraph-checkpoint 2.0.0__tar.gz → 2.0.2__tar.gz

{langgraph_checkpoint-2.0.0 → langgraph_checkpoint-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: langgraph-checkpoint
-Version: 2.0.0
+Version: 2.0.2
 Summary: Library with base interfaces for LangGraph checkpoint savers.
 Home-page: https://www.github.com/langchain-ai/langgraph
 License: MIT

{langgraph_checkpoint-2.0.0 → langgraph_checkpoint-2.0.2}/langgraph/checkpoint/base/__init__.py

@@ -178,7 +178,7 @@ CheckpointNS = ConfigurableFieldSpec(
     annotation=str,
     name="Checkpoint NS",
     description='Checkpoint namespace. Denotes the path to the subgraph node the checkpoint originates from, separated by `|` character, e.g. `"child|grandchild"`. Defaults to "" (root graph).',
-    default=None,
+    default="",
     is_shared=True,
 )
 

{langgraph_checkpoint-2.0.0 → langgraph_checkpoint-2.0.2}/langgraph/checkpoint/serde/jsonplus.py

@@ -206,7 +206,9 @@ class JsonPlusSerializer(SerializerProtocol):
         elif type_ == "json":
             return self.loads(data_)
         elif type_ == "msgpack":
-            return msgpack.unpackb(data_, ext_hook=_msgpack_ext_hook)
+            return msgpack.unpackb(
+                data_, ext_hook=_msgpack_ext_hook, strict_map_key=False
+            )
         else:
             raise NotImplementedError(f"Unknown serialization type: {type_}")
 

{langgraph_checkpoint-2.0.0 → langgraph_checkpoint-2.0.2}/langgraph/store/base/__init__.py

@@ -14,7 +14,7 @@ class Item:
 
     Args:
         value (dict[str, Any]): The stored data as a dictionary. Keys are filterable.
-        (str): Unique identifier within the namespace.
+        key (str): Unique identifier within the namespace.
         namespace (tuple[str, ...]): Hierarchical path defining the collection in which this document resides.
             Represented as a tuple of strings, allowing for nested categorization.
             For example: ("documents", 'user123')
@@ -159,15 +159,34 @@ class InvalidNamespaceError(ValueError):
 
 
 def _validate_namespace(namespace: tuple[str, ...]) -> None:
+    if not namespace:
+        raise InvalidNamespaceError("Namespace cannot be empty.")
     for label in namespace:
+        if not isinstance(label, str):
+            raise InvalidNamespaceError(
+                f"Invalid namespace label '{label}' found in {namespace}. Namespace labels"
+                f" must be strings, but got {type(label).__name__}."
+            )
         if "." in label:
             raise InvalidNamespaceError(
-                f"Invalid namespace label '{label}'. Namespace labels cannot contain periods ('.')."
+                f"Invalid namespace label '{label}' found in {namespace}. Namespace labels cannot contain periods ('.')."
+            )
+        elif not label:
+            raise InvalidNamespaceError(
+                f"Namespace labels cannot be empty strings. Got {label} in {namespace}"
             )
+    if namespace[0] == "langgraph":
+        raise InvalidNamespaceError(
+            f'Root label for namespace cannot be "langgraph". Got: {namespace}'
+        )
 
 
 class BaseStore(ABC):
-    """Abstract base class for key-value stores."""
+    """Abstract base class for persistent key-value stores.
+
+    Stores enable persistence and memory that can be shared across threads,
+    scoped to user IDs, assistant IDs, or other arbitrary namespaces.
+    """
 
     __slots__ = ("__weakref__",)
 

{langgraph_checkpoint-2.0.0 → langgraph_checkpoint-2.0.2}/langgraph/store/base/batch.py

@@ -2,7 +2,15 @@ import asyncio
 import weakref
 from typing import Any, Optional
 
-from langgraph.store.base import BaseStore, GetOp, Item, Op, PutOp, SearchOp
+from langgraph.store.base import (
+    BaseStore,
+    GetOp,
+    Item,
+    Op,
+    PutOp,
+    SearchOp,
+    _validate_namespace,
+)
 
 
 class AsyncBatchedBaseStore(BaseStore):
@@ -46,6 +54,7 @@ class AsyncBatchedBaseStore(BaseStore):
         key: str,
         value: dict[str, Any],
     ) -> None:
+        _validate_namespace(namespace)
         fut = self._loop.create_future()
         self._aqueue[fut] = PutOp(namespace, key, value)
         return await fut

{langgraph_checkpoint-2.0.0 → langgraph_checkpoint-2.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "langgraph-checkpoint"
-version = "2.0.0"
+version = "2.0.2"
 description = "Library with base interfaces for LangGraph checkpoint savers."
 authors = []
 license = "MIT"