ޠj(xSrSSKJr SSKJrJr SSKJrJr SSK J r SSK J r SSK JrJrJrJr "SS 5rg ) z+Synchronous store client for LangGraph SDK.) annotations)MappingSequence)AnyLiteral)_provided_vals)SyncHttpClient)ItemListNamespaceResponseQueryParamTypesSearchItemsResponsec$\rSrSrSrS SjrSSSjjrSSSS.SSjjrSSSjjrSSS jjr SSSS .SS jjjr S r g)SyncStoreClientaA client for synchronous operations on a key-value store. Provides methods to interact with a remote key-value store, allowing storage and retrieval of items within namespaced hierarchies. ???+ example "Example" ```python client = get_sync_client(url="http://localhost:2024")) client.store.put_item(["users", "profiles"], "user123", {"name": "Alice", "age": 30}) ``` cXlg)Nhttp)selfrs S/var/www/html/gaurav/venv/lib/python3.13/site-packages/langgraph_sdk/_sync/store.py__init__SyncStoreClient.__init__ s NcUHnSU;dM [SUS35e UUUUUS.n URRS[U 5XgS9 g)a<Store or update an item. Args: namespace: A list of strings representing the namespace path. key: The unique identifier for the item within the namespace. value: A dictionary containing the item's data. index: Controls search indexing - None (use defaults), False (disable), or list of field paths to index. ttl: Optional time-to-live in minutes for the item, or None for no expiration. headers: Optional custom headers to include with the request. params: Optional query parameters to include with the request. Returns: `None` ???+ example "Example Usage" ```python client = get_sync_client(url="http://localhost:8123") client.store.put_item( ["documents", "user123"], key="item456", value={"title": "My Document", "content": "Hello World"} ) ``` .Invalid namespace label '1'. Namespace labels cannot contain periods ('.').) namespacekeyvalueindexttl /store/itemsjsonheadersparamsN) ValueErrorrputr) rrrrr r!r%r&labelpayloads rput_itemSyncStoreClient.put_item#skHEe| /w6gh #   !8'  r) refresh_ttlr%r&cUHnSU;dM [SUS35e USRU5S.nUbX7S'U(aURU5 URR SXtS9$)aRetrieve a single item. Args: key: The unique identifier for the item. namespace: Optional list of strings representing the namespace path. refresh_ttl: Whether to refresh the TTL on this read operation. If `None`, uses the store's default behavior. headers: Optional custom headers to include with the request. Returns: The retrieved item. ???+ example "Example Usage" ```python client = get_sync_client(url="http://localhost:8123") item = client.store.get_item( ["documents", "user123"], key="item456", ) print(item) ``` ```shell ---------------------------------------------------------------- { 'namespace': ['documents', 'user123'], 'key': 'item456', 'value': {'title': 'My Document', 'content': 'Hello World'}, 'created_at': '2024-07-30T12:00:00Z', 'updated_at': '2024-07-30T12:00:00Z' } ``` rrrrrr-r")r&r%)r'joinupdaterget)rrrr-r%r&r) query_paramss rget_itemSyncStoreClient.get_itemWs{XEe| /w6gh 03)AT'U  "*5 '     'yy}}^L}RRrc@URRSX!S.UUS9 g)aDelete an item. Args: key: The unique identifier for the item. namespace: Optional list of strings representing the namespace path. headers: Optional custom headers to include with the request. params: Optional query parameters to include with the request. Returns: `None` ???+ example "Example Usage" ```python client = get_sync_client(url="http://localhost:8123") client.store.delete_item( ["documents", "user123"], key="item456", ) ``` r"r/r#N)rdelete)rrrr%r&s r delete_itemSyncStoreClient.delete_items*:  5  rc ^UUUUUUS.n URRS[U 5UUS9$)aSearch for items within a namespace prefix. Args: namespace_prefix: List of strings representing the namespace prefix. filter: Optional dictionary of key-value pairs to filter results. limit: Maximum number of items to return (default is 10). offset: Number of items to skip before returning results (default is 0). query: Optional query for natural language search. refresh_ttl: Whether to refresh the TTL on items returned by this search. If `None`, uses the store's default behavior. headers: Optional custom headers to include with the request. params: Optional query parameters to include with the request. Returns: A list of items matching the search criteria. ???+ example "Example Usage" ```python client = get_sync_client(url="http://localhost:8123") items = client.store.search_items( ["documents"], filter={"author": "John Doe"}, limit=5, offset=0 ) print(items) ``` ```shell ---------------------------------------------------------------- { "items": [ { "namespace": ["documents", "user123"], "key": "item789", "value": { "title": "Another Document", "author": "John Doe" }, "created_at": "2024-07-30T12:00:00Z", "updated_at": "2024-07-30T12:00:00Z" }, # ... additional items ... ] } ``` )namespace_prefixfilterlimitoffsetqueryr-z/store/items/searchr#rpostr) rr;r<r=r>r?r-r%r&r*s r search_itemsSyncStoreClient.search_itemssKx!1&  yy~~ !(   r)r%r&c\UUUUUS.nURRS[U5UUS9$)a$List namespaces with optional match conditions. Args: prefix: Optional list of strings representing the prefix to filter namespaces. suffix: Optional list of strings representing the suffix to filter namespaces. max_depth: Optional integer specifying the maximum depth of namespaces to return. limit: Maximum number of namespaces to return (default is 100). offset: Number of namespaces to skip before returning results (default is 0). headers: Optional custom headers to include with the request. Returns: A list of namespaces matching the criteria. ???+ example "Example Usage" ```python client = get_sync_client(url="http://localhost:8123") namespaces = client.store.list_namespaces( prefix=["documents"], max_depth=3, limit=10, offset=0 ) print(namespaces) ``` ```shell ---------------------------------------------------------------- [ ["documents", "user123", "reports"], ["documents", "user456", "invoices"], ... ] ``` )prefixsuffix max_depthr=r>z/store/namespacesr#r@) rrErFrGr=r>r%r&r*s rlist_namespacesSyncStoreClient.list_namespacessH`"  yy~~ (   rr)rr returnNone)NNNN)rstrrzMapping[str, Any]r z!Literal[False] | list[str] | Noner! int | Noner%Mapping[str, str] | Noner&QueryParamTypes | Noner Sequence[str]rJrK) rrLrrPr- bool | Noner%rNr&rOrJr )NN) rrLr%rNr&rOrrPrJrK)N rNNNN)r<zMapping[str, Any] | Noner=intr>rSr?z str | Noner-rQr%rNr&rOr;rPrJr )NNNdr)rElist[str] | NonerFrUrGrMr=rSr>rSr%rNr&rOrJr ) __name__ __module__ __qualname____firstlineno____doc__rr+r4r8rBrH__static_attributes__rrrrs 48,0)-2  2 ! 2 1 2 2 *2 '2  2  2 t$(,0)-7S 7S 7S ! 7S*7S'7S 7S|-1)- "  " * " ' "  "  " P,0 #',0)-H ) H  H  H H !H *H 'H 'H  H X$(#' $ ; -1)-;  ; !;  ;  ;  ; *; ';  ; ; rrN)rZ __future__rcollections.abcrrtypingrrlanggraph_sdk._shared.utilitiesrlanggraph_sdk._sync.httpr langgraph_sdk.schemar r r r rr\rrrcs-1"-:3g g r