WEBDIENSTE/langgraph
1
0
Fork 0
mirror of https://github.com/langchain-ai/langgraph.git synced 2026-09-23 18:15:08 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs(checkpoint,checkpoint-postgres): clarify Store value and namespace semantics

Browse Source
This commit is contained in:
Mason Daugherty
2026-06-03 15:51:47 -04:00
parent 43682f0830
commit 14d09d9361
4 changed files with 104 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
libs/checkpoint-postgres/langgraph/store/postgres/aio.py
+14
View File
@@ -115,6 +115,20 @@ class AsyncPostgresStore(AsyncBatchedBaseStore, BasePostgresStore[_ainternal.Con
If you provide a TTL configuration, you must explicitly call `start_ttl_sweeper()` to begin
the background task that removes expired items. Call `stop_ttl_sweeper()` to properly
clean up resources when you're done with the store.
Note:
The core data operations -- `put`/`aput`, `get`/`aget`, `search`/`asearch`,
`delete`/`adelete`, and `list_namespaces`/`alist_namespaces` -- are inherited
from `langgraph.store.base.BaseStore`, which is the canonical reference for
their arguments and behavior. (This is LangGraph's `BaseStore`, distinct from
`langchain_core.stores.BaseStore`.) Key semantics:
- `put`/`aput` `value` must be a `dict` of JSON-serializable data. `None` is
not a valid stored value: a top-level `None` is reserved as the delete
signal (prefer `delete`/`adelete`). To store a marker or "empty" entry,
use an empty dict (`{}`), not `None`.
- `list_namespaces`/`alist_namespaces` match `prefix`/`suffix` exactly and
case-sensitively; there is no case-insensitive matching option.
"""
__slots__ = (
libs/checkpoint-postgres/langgraph/store/postgres/base.py
+14
View File
@@ -713,6 +713,20 @@ class PostgresStore(BaseStore, BasePostgresStore[_pg_internal.Conn]):
the background thread that removes expired items. Call `stop_ttl_sweeper()` to properly
clean up resources when you're done with the store.
Note:
The core data operations -- `put`/`aput`, `get`/`aget`, `search`/`asearch`,
`delete`/`adelete`, and `list_namespaces`/`alist_namespaces` -- are inherited
from `langgraph.store.base.BaseStore`, which is the canonical reference for
their arguments and behavior. (This is LangGraph's `BaseStore`, distinct from
`langchain_core.stores.BaseStore`.) Key semantics:
- `put`/`aput` `value` must be a `dict` of JSON-serializable data. `None` is
not a valid stored value: a top-level `None` is reserved as the delete
signal (prefer `delete`/`adelete`). To store a marker or "empty" entry,
use an empty dict (`{}`), not `None`.
- `list_namespaces`/`alist_namespaces` match `prefix`/`suffix` exactly and
case-sensitively; there is no case-insensitive matching option.
"""
__slots__ = (