ޠjy)xSrSSKJr SSKJrJr SSKJrJr SSK J r SSK J r SSK JrJrJrJr "SS 5rg ) z%Async Store client for LangGraph SDK.) annotations)MappingSequence)AnyLiteral) HttpClient)_provided_vals)ItemListNamespaceResponseQueryParamTypesSearchItemsResponsec\rSrSrSrS SjrS SSjjrSSSS.SSjjrSSSjjrSSS jjr SSS jjr S r g) StoreClientaClient for interacting with the graph's shared storage. The Store provides a key-value storage system for persisting data across graph executions, allowing for stateful operations and data sharing across threads. ???+ example "Example" ```python client = get_client(url="http://localhost:2024") await client.store.put_item(["users", "user123"], "mem-123451342", {"name": "Alice", "score": 100}) ``` cXlg)Nhttp)selfrs T/var/www/html/gaurav/venv/lib/python3.13/site-packages/langgraph_sdk/_async/store.py__init__StoreClient.__init__ s Nc# UHnSU;dM [SUS35e UUUUUS.n URRS[U 5XgS9IShvN gN7f)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_client(url="http://localhost:2024") await 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_itemStoreClient.put_item#sxHEe| /w6gh #  iimm !8'   s AAAAA) refresh_ttlr%r&c# UHnSU;dM [SUS35e SRU5US.nUbX7S'U(a0UE[U5EnURR SXtS9IShvN $N7f) 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. Returns: Item: The retrieved item. headers: Optional custom headers to include with the request. params: Optional query parameters to include with the request. ???+ example "Example Usage" ```python client = get_client(url="http://localhost:2024") item = await 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' } ``` rrrrrNr-r")r&r%)r'joindictrget)rrrr-r%r&r) get_paramss rget_itemStoreClient.get_itemWsZEe| /w6gh 4788I3Fs%S  "(3} % 7J7$v,7JYY]]>*]VVVVs A6AA6/A40A6c\# URRSXS.UUS9IShvN gN7f)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_client(url="http://localhost:2024") await client.store.delete_item( ["documents", "user123"], key="item456", ) ``` r"r/r#N)rdelete)rrrr%r&s r delete_itemStoreClient.delete_items7:ii (5    s ",*,c z# UUUUUUS.n URRS[U 5UUS9IShvN $N7f)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_client(url="http://localhost:2024") items = await 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#Nrpostr ) rr;r<r=r>r?r-r%r&r*s r search_itemsStoreClient.search_itemssXz!1&  YY^^ !( $    s 2;9;cx# UUUUUS.nURRS[U5UUS9IShvN $N7f)aSList 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. params: Optional query parameters to include with the request. Returns: A list of namespaces matching the criteria. ???+ example "Example Usage" ```python client = get_client(url="http://localhost:2024") namespaces = await client.store.list_namespaces( prefix=["documents"], max_depth=3, limit=10, offset=0 ) print(namespaces) ---------------------------------------------------------------- [ ["documents", "user123", "reports"], ["documents", "user456", "invoices"], ... ] ``` )prefixsuffix max_depthr=r>z/store/namespacesr#Nr@) rrErFrGr=r>r%r&r*s rlist_namespacesStoreClient.list_namespacessU\"  YY^^ ( $    s 1:8:r)rrreturnNone)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 )NNNdrNN)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)-7W 7W 7W ! 7W*7W'7W 7W|-1)- "  " * " ' "  "  " P,0 #',0)-J ) J  J  J J !J *J 'J 'J  J \$(#' $,0)-9  9 !9  9  9  9 *9 '9  9 9 rrN)rZ __future__rcollections.abcrrtypingrrlanggraph_sdk._async.httprlanggraph_sdk._shared.utilitiesr langgraph_sdk.schemar r r r rr\rrrcs-+"-0:g g r