DeltaChannelHistory not found in langgraph-api:3.12

LangSmith Product Help
1

Hi,

I’m running into an issue after pulling the latest version of the langchain/langgraph-api:3.12 Docker image.

I previously used this tag without any problems, but after re-pulling the image, I now get the following error at runtime:

ImportError: cannot import name 'DeltaChannelHistory' from 'langgraph.checkpoint.base'

It looks like the 3.12 tag may have been updated recently and now includes a newer version of langgraph where DeltaChannelHistory has been removed or refactored.

Is there a recommended migration path for this change?

For now, this breaks previously working code without any changes on my side, so any guidance would be appreciated.

Thanks!

2

Can you confirm the digest of your image using

docker images --digests langchain/langgraph-api

I tried running the agent locally on the following digest and faced no errors.

This digest is the latest one as well.

Can you also confirm the checkpointer you are using?

3

Here is my digest: sha256:f589776bddf8402df000f4aef666175e5b293fe863a02f8d2705c3629f50b538

I use the postgres checkpointer and updated the following dependencies:

  • “langchain-core (>=1.3.2,<2.0.0)”
  • “langchain-openai (>=1.2.1,<2.0.0)”
  • “langchain (>=1.2.17,<2.0.0)”
4

I tried with following:

requires-python = ">=3.12"
dependencies = [
    "langchain>=1.2.17,<2.0.0",
    "langchain-core>=1.3.2,<2.0.0",
    "langchain-openai>=1.2.1,<2.0.0",
    "langchain-anthropic>=1.2.1,<2.0.0",
    "langchain-mcp-adapters>=0.1.0",
    "langgraph>=1.0,<2.0.0",
    "deepagents>=0.4.0",
    "httpx>=0.27.0",
]

With langgraph.json


{
  "dependencies": ["."],
  "graphs": {
    "docs_agent": "./langchain_docs_agent/agent.py:graph"
  },
  "env": "./.env",
  "python_version": "3.12"
}

I am running my server using the following command:

langgraph up

While the Docker image digest for langchain/langgraph-api is the same as yours, and I faced no errors.
So strange why you are getting this error. Perhaps double-check the versions, otherwise only an official maintainer will be able to help you out @wfh @mdrxy

5

Hi @gdrouet , we had an issue with some feature flagging code that we just fixed, can you try pulling the latest image again? Also, did this happen when you ran langgraph up? How did you encounter this failure?

6

Hi,

I upgraded to 3.13 yesterday but I got the same error. Today I tried again with the latest digest and it worked.

I don’t use langgraph up, only the Docker image.

This failure occurred suddenly when I updated my code and deploy it to k8s. My CI/CD always pulls the latest digest so it’s at this moment I saw the error to appear.

How should I prevent this in the future? What tag is not overridden?