checkpoint==2.0.19

langgraph-checkpoint 2.0.19

Summary of Changes

• Fixed a bug where Item was incorrectly using created_at instead of updated_at when converting from string format (#3767)
• Added comprehensive TTL (time-to-live) configuration support for stores, including default TTL values and customizable refresh behavior (#3781, #3786)
• Added sentinel object pattern to distinguish between explicitly setting TTL to None vs not providing a TTL value (#3786)

Detailed Changes

langgraph.store.base.Item

• Fixed a bug where updated_at timestamp was incorrectly using the created_at value when converting from string format (#3767)

langgraph.store.base.TTLConfig

• Added new TypedDict to configure Time-To-Live (TTL) behavior in stores (#3781)
• Added refresh_on_read option to control whether TTLs should be refreshed on read operations (#3781)
• Added default_ttl option to specify a default TTL duration in minutes for new items (#3786)

langgraph.store.base.NotProvided

• Added new sentinel class and NOT_PROVIDED constant to distinguish between explicitly setting a value to None and not providing a value at all (#3786)

langgraph.store.base.BaseStore

• Added ttl_config property to configure TTL behavior at the store level (#3781)
• Updated method signatures for get, search, put and their async counterparts to better handle TTL configuration (#3781)
• Changed refresh_ttl parameter to default to None (use store's configuration) instead of True (#3781)
• Updated put and aput methods to use default TTL from store's configuration if no TTL is explicitly provided (#3786)

langgraph.store.base.batch.AsyncBatchedBaseStore

• Updated to support the new TTL configuration system (#3781, #3786)
• Modified method signatures to match changes in BaseStore (#3781)
• Added support for default TTLs in item storage operations (#3786)