# What changed in @langchain/langgraph-checkpoint

> 18 changes in @langchain/langgraph-checkpoint 1 from its official release notes, upgrade guides and advisories: 6 breaking, 4 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/@langchain/langgraph-checkpoint/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @langchain/langgraph-checkpoint 1

### Breaking changes

- BaseStore gets, deletes, and namespace-listing filters reject empty, non-string, or period-containing labels with InvalidNamespaceError instead of returning no results. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- Task IDs for functional task() calls under a Send or handler task change with the updated task paths. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- Writes to the same DeltaChannel in a superstep are applied and replayed in (task_path, task_id, idx) order instead of task-id order, aligning with Python langgraph. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- getTuple and list must return pendingWrites in writesSortKey order; third-party savers that ignore this can replay a different DeltaChannel value. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- Search prefixes now match at namespace segment boundaries; empty-prefix searches remain unrestricted. (1.1.6) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.1.6)
- Labels containing colons are rejected. (1.1.6) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.1.6)

### New APIs and options

- putWrites accepts an optional taskPath containing the serialized task path; custom savers must persist it and return pending writes in the new sort order. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- A new export provides comparison of pending-write sort keys for the required ordering. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- SQLite and Postgres gain a task_path column, migrated automatically on setup; Redis and MongoDB documents gain a task_path field. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- A new export provides the sort key used to order pending writes by task path, task id, and index. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)

### Behavior and default changes

- Task metadata changes to reflect the new Send and node-error-handler task path shapes. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- The SDK's Send-task detection accepts both the old and new task path shapes. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)

### Fixes and other changes

- AsyncBatchedStore validates namespace labels before queueing, so a failing namespace rejects only its own call; in-graph puts also reject a langgraph root label and an empty namespace. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- bulkUpdateState seals the first update superstep by snapshotting affected DeltaChannels on the update checkpoint, preventing writes from replaying in the wrong order. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- Resumed delta writes replay in live order, interleaving with loaded writes by task path; writes loaded with the checkpoint are no longer stored twice. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- MemorySaver uses locale-independent checkpoint ID ordering in getTuple, list, and getDeltaChannelHistory, consistent with UUID6 timestamp order and the before filter. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- When config has no checkpoint_id, the method reads from the thread's latest checkpoint, like getTuple and the other savers. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)
- bulkUpdateState and updateState update tasks carry (__interrupt__, i) task paths so multiple updates writing the same DeltaChannel replay in the given order. (1.2.0) — [release notes](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain/langgraph-checkpoint%401.2.0)