[GH-ISSUE #2157] Docs mismatch: namespace documented as list[str] but type is tuple[str] #271

Closed
opened 2026-02-17 17:19:32 -05:00 by yindo · 0 comments
Owner

Originally created by @alfon96 on GitHub (Jan 9, 2026).
Original GitHub issue: https://github.com/langchain-ai/docs/issues/2157

Hi,
In the persistence docs here:
https://docs.langchain.com/oss/python/langgraph/persistence#basic-usage

The final paragraph says an item has:

value: dict
key: str
namespace: list[str]
created_at: datetime
updated_at: datetime

But the actual type in code defines:

namespace: tuple[str, ...]

Ref:
https://reference.langchain.com/python/langgraph/store/#langgraph.store.base.NotProvided

So docs say list but implementation returns a tuple.

Either:

update docs to reflect tuple, or

clarify if tuple is intended and stable API.

Thanks!

Originally created by @alfon96 on GitHub (Jan 9, 2026). Original GitHub issue: https://github.com/langchain-ai/docs/issues/2157 Hi, In the persistence docs here: https://docs.langchain.com/oss/python/langgraph/persistence#basic-usage The final paragraph says an item has: ``` value: dict key: str namespace: list[str] created_at: datetime updated_at: datetime ``` But the actual type in code defines: `namespace: tuple[str, ...]` Ref: https://reference.langchain.com/python/langgraph/store/#langgraph.store.base.NotProvided So docs say list but implementation returns a tuple. Either: update docs to reflect tuple, or clarify if tuple is intended and stable API. Thanks!
yindo added the external label 2026-02-17 17:19:32 -05:00
yindo closed this issue 2026-02-17 17:19:32 -05:00
yindo changed title from Docs mismatch: namespace documented as list[str] but type is tuple[str] to [GH-ISSUE #2157] Docs mismatch: namespace documented as list[str] but type is tuple[str] 2026-06-05 17:26:01 -04:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/docs#271