change target language

.github/ISSUE_TEMPLATE/config.yml

@@ -1,9 +1,6 @@
 blank_issues_enabled: false
 version: 2.1
 contact_links:
-  - name: Documentation
-    url: https://github.com/langchain-ai/docs/issues/new?template=langgraph.yml
-    about: Report an issue related to the LangGraph documentation
   - name: LangChain Forum
     url:  https://forum.langchain.com/
-    about: General community discussions and support
+    about: General community discussions, support, and feature requests

.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,19 @@
+name: Documentation
+description: Report an issue related to the LangGraph documentation.
+title: "DOC: <Please write a comprehensive title after the 'DOC: ' prefix>"
+labels: [documentation]
+
+body:
+- type: textarea
+  attributes: 
+    label: "Issue with current documentation:"
+    description: >
+      Please make sure to leave a reference to the document/code you're
+      referring to.
+
+- type: textarea
+  attributes:
+    label: "Idea or request for content:"
+    description: >
+      Please describe as clearly as possible what topics you think are missing
+      from the current documentation.

.github/scripts/check_sdk_methods.py

@@ -1,15 +1,10 @@
 import ast
 import os
 from itertools import filterfalse
-from typing import Dict, List, Tuple
+from typing import List, Tuple
 
 ROOT_PATH = os.path.abspath(os.path.join(__file__, "..", "..", ".."))
 CLIENT_PATH = os.path.join(ROOT_PATH, "libs", "sdk-py", "langgraph_sdk", "client.py")
-ASYNC_TO_SYNC_METHOD_MAP: Dict[str, str] = {
-    "aclose": "close",
-    "__aenter__": "__enter__",
-    "__aexit__": "__exit__",
-}
 
 
 def get_class_methods(node: ast.ClassDef) -> List[str]:
@@ -27,7 +22,7 @@ def find_classes(tree: ast.AST) -> List[Tuple[str, List[str]]]:
 
 def compare_sync_async_methods(sync_methods: List[str], async_methods: List[str]) -> List[str]:
     sync_set = set(sync_methods)
-    async_set = {ASYNC_TO_SYNC_METHOD_MAP.get(async_method, async_method) for async_method in async_methods}
+    async_set = set(async_methods)
     missing_in_sync = list(async_set - sync_set)
     missing_in_async = list(sync_set - async_set)
     return missing_in_sync + missing_in_async

.github/scripts/run_langgraph_cli_test.py

@@ -1,145 +1,107 @@
+import asyncio
+import json
+import os
 import pathlib
 import sys
-import time
-from urllib import request, error
-
 import langgraph_cli
-import langgraph_cli.config
 import langgraph_cli.docker
-from langgraph_cli.cli import prepare_args_and_stdin
-from langgraph_cli.constants import DEFAULT_PORT
+import langgraph_cli.config
+
 from langgraph_cli.exec import Runner, subp_exec
 from langgraph_cli.progress import Progress
+from langgraph_cli.constants import DEFAULT_PORT
 
 
-def test(config: pathlib.Path, port: int, tag: str, verbose: bool):
-    """Spin up API with Postgres/Redis via docker compose and wait until ready."""
+def test(
+    config: pathlib.Path,
+    port: int,
+    tag: str,
+    verbose: bool,
+):
     with Runner() as runner, Progress(message="Pulling...") as set:
-        # Detect docker/compose capabilities
+        # check docker available
         capabilities = langgraph_cli.docker.check_capabilities(runner)
-
-        # Validate config and prepare compose stdin/args using built image
+        # open config
         config_json = langgraph_cli.config.validate_config_file(config)
-        args, stdin = prepare_args_and_stdin(
-            capabilities=capabilities,
-            config_path=config,
-            config=config_json,
-            docker_compose=None,
-            port=port,
-            watch=False,
-            debugger_port=None,
-            debugger_base_url=f"http://127.0.0.1:{port}",
-            postgres_uri=None,
-            api_version=None,
-            image=tag,
-            base_image=None,
-        )
 
-        # Compose up with wait (implies detach), similar to `langgraph up --wait`
-        args_up = [*args, "up", "--remove-orphans", "--wait"]
+        set("Running...")
+        args = [
+            "run",
+            "--rm",
+            "-p",
+            f"{port}:8000",
+        ]
+        if isinstance(config_json["env"], str):
+            args.extend(
+                [
+                    "--env-file",
+                    str(config.parent / config_json["env"]),
+                ]
+            )
+        else:
+            for k, v in config_json["env"].items():
+                args.extend(
+                    [
+                        "-e",
+                        f"{k}={v}",
+                    ]
+                )
+        if capabilities.healthcheck_start_interval:
+            args.extend(
+                [
+                    "--health-interval",
+                    "5s",
+                    "--health-retries",
+                    "1",
+                    "--health-start-period",
+                    "10s",
+                    "--health-start-interval",
+                    "1s",
+                ]
+            )
+        else:
+            args.extend(
+                [
+                    "--health-interval",
+                    "5s",
+                    "--health-retries",
+                    "2",
+                ]
+            )
 
-        compose_cmd = ["docker", "compose"]
-        if capabilities.compose_type == "standalone":
-            compose_cmd = ["docker-compose"]
+        _task = None
+
+        def on_stdout(line: str):
+            nonlocal _task
+            if "GET /ok" in line or "Uvicorn running on" in line:
+                set("")
+                sys.stdout.write(
+                    f"""Ready!
+- API: http://localhost:{port}
+"""
+                )
+                sys.stdout.flush()
+                _task.cancel()
+                return True
+            return False
+
+        async def subp_exec_task(*args, **kwargs):
+            nonlocal _task
+            _task = asyncio.create_task(subp_exec(*args, **kwargs))
+            await _task
 
-        set("Starting...")
         try:
             runner.run(
-                subp_exec(
-                    *compose_cmd,
-                    *args_up,
-                    input=stdin,
+                subp_exec_task(
+                    "docker",
+                    *args,
+                    tag,
                     verbose=verbose,
+                    on_stdout=on_stdout,
                 )
             )
-        except Exception as e:  # noqa: BLE001
-            # On failure, show diagnostics then ensure clean teardown
-            sys.stderr.write(f"docker compose up failed: {e}\n")
-            try:
-                sys.stderr.write("\n== docker compose ps ==\n")
-                runner.run(subp_exec(*compose_cmd, *args, "ps", input=stdin, verbose=False))
-            except Exception:
-                pass
-            try:
-                sys.stderr.write("\n== docker compose logs (api) ==\n")
-                runner.run(
-                    subp_exec(
-                        *compose_cmd,
-                        *args,
-                        "logs",
-                        "langgraph-api",
-                        input=stdin,
-                        verbose=False,
-                    )
-                )
-            except Exception:
-                pass
-            finally:
-                try:
-                    runner.run(
-                        subp_exec(
-                            *compose_cmd,
-                            *args,
-                            "down",
-                            "-v",
-                            "--remove-orphans",
-                            input=stdin,
-                            verbose=False,
-                        )
-                    )
-                finally:
-                    raise
-
-        set("")
-        base_url = f"http://localhost:{port}"
-        ok_url = f"{base_url}/ok"
-        print(f"Waiting for {ok_url} to respond with 200...")
-        deadline = time.time() + 30
-        last_err: Exception | None = None
-        while time.time() < deadline:
-            try:
-                with request.urlopen(ok_url, timeout=2) as resp:
-                    if resp.status == 200:
-                        sys.stdout.write(
-                            f"""Ready!\n- API: {base_url}\n- /ok: 200 OK\n"""
-                        )
-                        sys.stdout.flush()
-                        break
-                    else:
-                        last_err = RuntimeError(f"Unexpected status: {resp.status}")
-                        print(f"Unexpected status: {resp.status}")
-            except error.URLError as e:
-                last_err = e
-            except Exception as e:  # noqa: BLE001
-                last_err = e
-            time.sleep(0.5)
-        else:
-            # Bring stack down before raising
-            args_down = [*args, "down", "-v", "--remove-orphans"]
-            try:
-                runner.run(
-                    subp_exec(
-                        *compose_cmd,
-                        *args_down,
-                        input=stdin,
-                        verbose=verbose,
-                    )
-                )
-            finally:
-                raise SystemExit(
-                    f"/ok did not return 202 within timeout. Last error: {last_err}"
-                )
-
-        # Clean up: bring compose stack down to free ports for next test
-        args_down = [*args, "down", "-v", "--remove-orphans"]
-        runner.run(
-            subp_exec(
-                *compose_cmd,
-                *args_down,
-                input=stdin,
-                verbose=verbose,
-            )
-        )
+        except asyncio.CancelledError:
+            pass
 
 
 if __name__ == "__main__":
@@ -148,6 +110,6 @@ if __name__ == "__main__":
     parser = argparse.ArgumentParser()
     parser.add_argument("-t", "--tag", type=str)
     parser.add_argument("-c", "--config", type=str, default="./langgraph.json")
-    parser.add_argument("-p", "--port", type=int, default=DEFAULT_PORT)
+    parser.add_argument("-p", "--port", default=DEFAULT_PORT)
     args = parser.parse_args()
     test(pathlib.Path(args.config), args.port, args.tag, verbose=True)

.github/workflows/_integration_test.yml

@@ -14,25 +14,12 @@ jobs:
         python-version:
           - "3.10"
           - "3.11"
-        example:
-          - name: A
-            workdir: libs/cli/examples
-            tag: langgraph-test-a
-          - name: B
-            workdir: libs/cli/examples/graphs
-            tag: langgraph-test-b
-          - name: C
-            workdir: libs/cli/examples/graphs_reqs_a
-            tag: langgraph-test-c
-          - name: D
-            workdir: libs/cli/examples/graphs_reqs_b
-            tag: langgraph-test-d
     name: "CLI integration test"
     defaults:
       run:
         working-directory: libs/cli
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       - name: Get changed files
         id: changed-files
         uses: Ana06/get-changed-files@v2.3.0
@@ -46,65 +33,42 @@ jobs:
           enable-cache: true
           cache-suffix: "cli-integration-test"
           ignore-nothing-to-cache: true
+      - name: Setup env
+        if: steps.changed-files.outputs.all
+        working-directory: libs/cli/examples
+        run: cat .env.example > .env
       - name: Install cli globally
         if: steps.changed-files.outputs.all
         run: pip install -e .
-      - name: Build and test service ${{ matrix.example.name }}
+      - name: Build and test service A
         if: steps.changed-files.outputs.all
-        working-directory: ${{ matrix.example.workdir }}
-        env:
-          LANGSMITH_API_KEY: ${{ secrets.LANGSMITH_API_KEY }}
+        working-directory: libs/cli/examples
         run: |
-          # Build the image for this example
-          langgraph build -t ${{ matrix.example.tag }}
-          # Prepare environment file from local or parent example directory
-          if [ -f .env.example ]; then cp .env.example .env; elif [ -f ../.env.example ]; then cp ../.env.example .env && cp ../.env.example ../.env; fi
-          if [ -n "${{ secrets.LANGSMITH_API_KEY }}" ]; then echo "LANGSMITH_API_KEY=${{ secrets.LANGSMITH_API_KEY }}" >> .env; if [ -f ../.env ]; then echo "LANGSMITH_API_KEY=${{ secrets.LANGSMITH_API_KEY }}" >> ../.env; fi; fi
-          # Run the integration test using the built tag
-          # Compute repo root to reference the shared script robustly
-          REPO_ROOT=$(git rev-parse --show-toplevel)
-          timeout 60 python "$REPO_ROOT/.github/scripts/run_langgraph_cli_test.py" -t ${{ matrix.example.tag }}
+          # The build-arg isn't used; just testing that we accept other args
+          langgraph build -t langgraph-test-a  --base-image "langchain/langgraph-trial"
+          cp .env.example .envg
+          timeout 60 python ../../../.github/scripts/run_langgraph_cli_test.py -c langgraph.json -t langgraph-test-a
+      - name: Build and test service B
+        if: steps.changed-files.outputs.all
+        working-directory: libs/cli/examples/graphs
+        run: |
+          langgraph build -t langgraph-test-b  --base-image "langchain/langgraph-trial"
+          timeout 60 python ../../../../.github/scripts/run_langgraph_cli_test.py -t langgraph-test-b
+      - name: Build and test service C
+        if: steps.changed-files.outputs.all
+        working-directory: libs/cli/examples/graphs_reqs_a
+        run: |
+          langgraph build -t langgraph-test-c  --base-image "langchain/langgraph-trial"
+          timeout 60 python ../../../../.github/scripts/run_langgraph_cli_test.py -t langgraph-test-c
+      - name: Build and test service D
+        if: steps.changed-files.outputs.all
+        working-directory: libs/cli/examples/graphs_reqs_b
+        run: |
+          langgraph build -t langgraph-test-d  --base-image "langchain/langgraph-trial"
+          timeout 60 python ../../../../.github/scripts/run_langgraph_cli_test.py -t langgraph-test-d
 
       - name: Build JS service
         if: steps.changed-files.outputs.all
         working-directory: libs/cli/js-examples
         run: |
           langgraph build -t langgraph-test-e
-
-      - name: Build JS monorepo service
-        if: steps.changed-files.outputs.all
-        working-directory: libs/cli/js-monorepo-example
-        run: |
-          langgraph build -t langgraph-test-f -c apps/agent/langgraph.json --build-command "yarn run turbo build" --install-command "yarn install"
-
-      - name: Build Python monorepo service
-        if: steps.changed-files.outputs.all
-        working-directory: libs/cli/python-monorepo-example
-        run: |
-          langgraph build -t langgraph-test-g -c apps/agent/langgraph.json
-          cp apps/agent/.env.example apps/agent/.env
-          if [ -n "${{ secrets.LANGSMITH_API_KEY }}" ]; then echo "LANGSMITH_API_KEY=${{ secrets.LANGSMITH_API_KEY }}" >> apps/agent/.env; fi
-          timeout 60 python ../../../.github/scripts/run_langgraph_cli_test.py -t langgraph-test-g -c apps/agent/langgraph.json
-
-      - name: Build and test prerelease reqs service
-        if: steps.changed-files.outputs.all
-        working-directory: libs/cli/examples/graph_prerelease_reqs
-        run: |
-          langgraph build -t langgraph-test-h
-          cp ../.env.example .env
-          if [ -n "${{ secrets.LANGSMITH_API_KEY }}" ]; then echo "LANGSMITH_API_KEY=${{ secrets.LANGSMITH_API_KEY }}" >> .env; fi
-          timeout 60 python ../../../../.github/scripts/run_langgraph_cli_test.py -t langgraph-test-h
-          LANGGRAPH_VERSION=$(docker run --rm --entrypoint "" langgraph-test-h python -c "import sys; from importlib.metadata import version; v = version('langgraph'); print(v);")
-          if [ "$LANGGRAPH_VERSION" != "1.0.0a2" ]; then
-            exit 1
-          fi
-          LANGCHAIN_OPENAI_VERSION=$(docker run --rm --entrypoint "" langgraph-test-h python -c "import sys; from importlib.metadata import version; v = version('langchain-openai'); print(v);")
-          if [ "$LANGCHAIN_OPENAI_VERSION" != "0.3.0" ]; then
-            exit 1
-          fi
-
-      - name: Build and test prerelease reqs fail service
-        if: steps.changed-files.outputs.all
-        working-directory: libs/cli/examples/graph_prerelease_reqs_fail
-        run: |
-          langgraph build -t langgraph-test-i || [ $? -eq 1 ]

.github/workflows/_lint.yml

@@ -31,7 +31,7 @@ jobs:
           - "3.12"
     name: "lint #${{ matrix.python-version }}"
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       - name: Get changed files
         id: changed-files
         uses: Ana06/get-changed-files@v2.3.0

.github/workflows/_test.yml

@@ -25,7 +25,7 @@ jobs:
 
     name: "test #${{ matrix.python-version }}"
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.python-version }}
         uses: astral-sh/setup-uv@v6
         with:

.github/workflows/_test_langgraph.yml

@@ -23,7 +23,7 @@ jobs:
         working-directory: libs/langgraph
     name: "test #${{ matrix.python-version }}"
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.python-version }}
         uses: astral-sh/setup-uv@v6
         with:

.github/workflows/_test_release.yml

@@ -24,7 +24,7 @@ jobs:
       version: ${{ steps.check-version.outputs.version }}
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - name: Set up Python $${ env.PYTHON_VERSION }}
         uses: astral-sh/setup-uv@v6
@@ -75,9 +75,9 @@ jobs:
       id-token: write
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
-      - uses: actions/download-artifact@v5
+      - uses: actions/download-artifact@v4
         with:
           name: test-dist
           path: ${{ inputs.working-directory }}/dist/

.github/workflows/baseline.yml

@@ -17,7 +17,7 @@ jobs:
       run:
         working-directory: libs/langgraph
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       - run: SHA=$(git rev-parse HEAD) && echo "SHA=$SHA" >> $GITHUB_ENV
       - name: Set up Python 3.11
         uses: astral-sh/setup-uv@v6

.github/workflows/bench.yml

@@ -15,7 +15,7 @@ jobs:
       run:
         working-directory: libs/langgraph
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       - id: files
         name: Get changed files
         uses: Ana06/get-changed-files@v2.3.0
@@ -57,7 +57,7 @@ jobs:
             echo EOF
           } >> "$GITHUB_OUTPUT"
       - name: Annotation
-        uses: actions/github-script@v8
+        uses: actions/github-script@v7
         with:
           script: |
             const file = JSON.parse(`${{ steps.files.outputs.added_modified_renamed }}`)[0]

.github/workflows/ci.yml

@@ -3,8 +3,7 @@ name: CI
 
 on:
   push:
-    branches:
-      - main
+    branches: [main, v1]
   pull_request:
 
 permissions:
@@ -27,7 +26,7 @@ jobs:
       python: ${{ steps.filter.outputs.python }}
       deps: ${{ steps.filter.outputs.deps }}
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       - uses: dorny/paths-filter@v3
         id: filter
         with:
@@ -78,7 +77,6 @@ jobs:
             "libs/checkpoint-sqlite",
             "libs/checkpoint-postgres",
             "libs/prebuilt",
-            "libs/sdk-py",
           ]
     if: needs.changes.outputs.python == 'true' || needs.changes.outputs.deps == 'true'
     uses: ./.github/workflows/_test.yml
@@ -100,9 +98,9 @@ jobs:
     name: "Check SDK methods matching"
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v5
         with:
           python-version: "3.11"
       - name: Run check_sdk_methods script
@@ -118,7 +116,7 @@ jobs:
         python-version:
           - "3.11"
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.python-version }}
         uses: astral-sh/setup-uv@v6
         with:

.github/workflows/codespell.yml

@@ -21,7 +21,7 @@
     
         steps:
           - name: Checkout
-            uses: actions/checkout@v5
+            uses: actions/checkout@v4
     
           - name: Install Dependencies
             run: |

.github/workflows/deploy_docs.yml

@@ -28,7 +28,7 @@ jobs:
     outputs:
       changed-files: ${{ steps.changed-files.outputs.added_modified }}
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       - name: Get changed files
         id: changed-files
         uses: Ana06/get-changed-files@v2.3.0
@@ -41,7 +41,7 @@ jobs:
     env:
       GITHUB_TOKEN: ${{ secrets.MKDOCS_GITHUB_TOKEN }}
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
@@ -140,7 +140,7 @@ jobs:
 
       - name: Upload Pages Artifact
         # if: github.ref == 'refs/heads/main'
-        uses: actions/upload-pages-artifact@v4
+        uses: actions/upload-pages-artifact@v3
         with:
           path: ./docs/site/
 

.github/workflows/link_check.yml

@@ -19,7 +19,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
@@ -36,7 +36,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
         with:
           fetch-depth: 1
 

.github/workflows/pr_lint.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Validate PR Title
-        uses: amannn/action-semantic-pull-request@v6
+        uses: amannn/action-semantic-pull-request@v5
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
@@ -40,7 +40,6 @@ jobs:
             sdk-py
             docs
             ci
-            deps
           requireScope: false
           ignoreLabels: |
             ignore-lint-pr-title

.github/workflows/release.yml

@@ -26,7 +26,7 @@ jobs:
       tag: ${{ steps.check-version.outputs.tag }}
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - name: Set up Python
         uses: astral-sh/setup-uv@v6
@@ -62,13 +62,7 @@ jobs:
         working-directory: ${{ inputs.working-directory }}
         run: |
           PKG_NAME=$(grep -m 1 "^name = " pyproject.toml | cut -d '"' -f 2)
-          if grep -q 'dynamic.*=.*\[.*"version".*\]' pyproject.toml; then
-            # handle dynamic versioning
-            DIR_NAME=$(echo "$PKG_NAME" | tr '-' '_')
-            VERSION=$(grep -m 1 '^__version__' "${DIR_NAME}/__init__.py" | cut -d '"' -f 2)
-          else
-            VERSION=$(grep -m 1 "^version = " pyproject.toml | cut -d '"' -f 2)
-          fi
+          VERSION=$(grep -m 1 "^version = " pyproject.toml | cut -d '"' -f 2)
           SHORT_PKG_NAME="$(echo "$PKG_NAME" | sed -e 's/langgraph//g' -e 's/-//g')"
           if [ -z $SHORT_PKG_NAME ]; then
             TAG="$VERSION"
@@ -87,7 +81,7 @@ jobs:
     outputs:
       release-body: ${{ steps.generate-release-body.outputs.release-body }}
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
         with:
           repository: langchain-ai/langgraph
           path: langgraph
@@ -158,7 +152,7 @@ jobs:
       - test-pypi-publish
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       # We explicitly *don't* set up caching here. This ensures our tests are
       # maximally sensitive to catching breakage.
@@ -261,7 +255,7 @@ jobs:
         working-directory: ${{ inputs.working-directory }}
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - name: Set up Python
         uses: astral-sh/setup-uv@v6
@@ -270,7 +264,7 @@ jobs:
           enable-cache: true
           cache-suffix: "release"
 
-      - uses: actions/download-artifact@v5
+      - uses: actions/download-artifact@v4
         with:
           name: dist
           path: ${{ inputs.working-directory }}/dist/
@@ -302,7 +296,7 @@ jobs:
         working-directory: ${{ inputs.working-directory }}
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
 
       - name: Set up Python
         uses: astral-sh/setup-uv@v6
@@ -311,7 +305,7 @@ jobs:
           enable-cache: true
           cache-suffix: "release"
 
-      - uses: actions/download-artifact@v5
+      - uses: actions/download-artifact@v4
         with:
           name: dist
           path: ${{ inputs.working-directory }}/dist/

.github/workflows/run_notebooks.yml

@@ -28,7 +28,7 @@ jobs:
           - "latest"
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       - name: Set up Python + Poetry
         uses: astral-sh/setup-uv@v6
         with:

.github/workflows/uv_lock_ugprade.yml

@@ -16,7 +16,7 @@ jobs:
     runs-on: ubuntu-latest
     
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
       
       - name: Set up uv
         uses: astral-sh/setup-uv@v6
@@ -33,8 +33,8 @@ jobs:
         uses: peter-evans/create-pull-request@v7
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
-          commit-message: "chore(deps): upgrade dependencies with `uv lock --upgrade`"
-          title: "chore(deps): upgrade dependencies with `uv lock --upgrade`"
+          commit-message: "chore[deps]: upgrade dependencies with `uv lock --upgrade`"
+          title: "chore[deps]: upgrade dependencies with `uv lock --upgrade`"
           body: |
             This PR updates the dependencies in all Python packages using `uv lock --upgrade`.
             

CONTRIBUTING.md

@@ -277,9 +277,9 @@ def my_function(arg1: int, arg2: str) -> float:
     Examples:
         This is a section for examples of how to use the function.
 
-        ```python
-        my_function(1, "hello")
-        \```
+        .. code-block:: python
+
+            my_function(1, "hello")
 
     Args:
         arg1: This is a description of arg1. We do not need to specify the type since

README.md

@@ -71,7 +71,7 @@ While LangGraph can be used standalone, it also integrates seamlessly with any L
 
 ## Additional resources
 
-- [Guides](https://langchain-ai.github.io/langgraph/guides/): Quick, actionable code snippets for topics such as streaming, adding memory & persistence, and design patterns (e.g. branching, subgraphs, etc.).
+- [Guides](https://langchain-ai.github.io/langgraph/how-tos/): Quick, actionable code snippets for topics such as streaming, adding memory & persistence, and design patterns (e.g. branching, subgraphs, etc.).
 - [Reference](https://langchain-ai.github.io/langgraph/reference/graphs/): Detailed reference on core classes, methods, how to use the graph and checkpointing APIs, and higher-level prebuilt components.
 - [Examples](https://langchain-ai.github.io/langgraph/examples/): Guided examples on getting started with LangGraph.
 - [LangChain Forum](https://forum.langchain.com/): Connect with the community and share all of your technical questions, ideas, and feedback.

docs/Makefile

@@ -16,9 +16,6 @@ build-prebuilt:
 	uv run python -m _scripts.third_party_page.create_third_party_page stats.yml docs/agents/prebuilt.md
 
 build-docs: build-prebuilt
-	TARGET_LANGUAGE=python uv run python -m mkdocs build --clean -f mkdocs.yml --strict
-
-build-docs-js: build-prebuilt
 	TARGET_LANGUAGE=js uv run python -m mkdocs build --clean -f mkdocs.yml --strict
 
 llms-text:

docs/README.md

@@ -1,126 +1,24 @@
-# LangGraph Documentation
+# Setup
 
-For more information on contributing to our documentation, see the [Contributing Guide](../CONTRIBUTING.md).
-
-## Structure
-
-The primary documentation is located in the `docs/` directory. This directory contains both the source files for the main documentation as well as the API reference doc build process.
-
-### Main Documentation
-
-Main documentation files are located in `docs/docs/` and are written in Markdown format. The site uses [**MkDocs**](https://www.mkdocs.org/) with the [Material theme](https://squidfunk.github.io/mkdocs-material/) and includes:
-
-- **Concepts**: Core LangGraph concepts and explanations
-- **Tutorials**: Step-by-step learning guides
-- **How-tos**: Task-focused guides for specific use cases
-- **Examples**: Real-world applications and use cases
-- **Jupyter Notebooks**: Interactive tutorials that are automatically converted to markdown
-
-### API Reference
-
-API reference documentation is defined in `docs/docs/reference/`. Each `.md` file outlines the "template" that each page is built from. Reference content is automatically generated from docstrings in the codebase using the **mkdocstrings** plugin. Once generated, the content is plugged into the corresponding markdown file where it is referenced by using manual directives to specify which classes and/or functions are documented:
-
-```markdown
-::: langgraph.graph.state.StateGraph
-    options:
-      show_if_no_docstring: true
-      show_root_heading: true
-      show_root_full_path: false
-      members:
-        - add_node
-        - add_edge
-        - add_conditional_edges
-        - add_sequence
-        - compile
-```
-
-## Build Process
-
-Docs are built following these steps:
-
-1. **Content Processing:**
-   - `_scripts/notebook_hooks.py` - Main processing pipeline that:
-     - Converts how-tos/tutorial Jupyter notebooks to markdown using `notebook_convert.py`
-     - Adds automatic API reference links to code blocks using `generate_api_reference_links.py`
-     - Handles conditional rendering for Python/JS versions
-     - Processes highlight comments and custom syntax
-
-2. **API Reference Generation:**
-   - **mkdocstrings** plugin extracts docstrings from Python source code
-   - Manual `::: module.Class` directives in reference pages (`/docs/docs/*`) specify what to document
-   - Cross-references are automatically generated between docs and API
-
-3. **Site Generation:**
-   - **MkDocs** processes all markdown files and generates static HTML
-   - Custom hooks handle redirects and inject additional functionality
-
-4. **Deployment:**
-   - Site is deployed with Vercel
-   - `make build-docs` generates production build (also usable for local testing)
-   - Automatic redirects handle URL changes between versions
-
-### Local Development
-
-For local development, use the Makefile targets:
+To setup requirements for building docs you can run:
+
+```bash
+uv sync --group test
+```
+
+## Serving documentation locally
+
+To run the documentation server locally you can run:
 
 ```bash
-# Serve docs locally with hot reloading
 make serve-docs
-
-# Clean build for production testing
-make build-docs
-
-# Serve with clean build
-make serve-clean-docs
 ```
 
-The `serve-docs` command:
-
-- Watches source files for changes
-- Includes dirty builds for faster iteration
-- Serves on [http://127.0.0.1:8000/langgraph/](http://127.0.0.1:8000/langgraph/)
-
-## Standards
-
-**Docstring Format:**
-The API reference uses **Google-style docstrings** with Markdown markup. The `mkdocstrings` plugin processes these to generate documentation.
-
-**Required format:**
-
-```python
-def example_function(param1: str, param2: int = 5) -> bool:
-    """Brief description of the function.
-
-    Longer description can go here. Use Markdown syntax for
-    rich formatting like **bold** and *italic*.
-
-    Args:
-        param1: Description of the first parameter.
-        param2: Description of the second parameter with default value.
-
-    Returns:
-        Description of the return value.
-
-    Raises:
-        ValueError: When param1 is empty.
-        TypeError: When param2 is not an integer.
-
-    !!! warning
-        This function is experimental and may change.
-
-    !!! version-added "Added in version 0.2.0"
-    """
-```
-
-**Special Markers:**
-
-- **MkDocs admonitions**: `!!! warning`, `!!! note`, `!!! version-added`
-- **Code blocks**: Standard markdown ``` syntax
-- **Cross-references**: Automatic linking via `generate_api_reference_links.py`
+This will start the documentation server on [http://127.0.0.1:8000/langgraph/](http://127.0.0.1:8000/langgraph/).
 
 ## Execute notebooks
 
-If you would like to automatically execute all of the notebooks, to mimic the "Run notebooks" GitHub action, you can run:
+If you would like to automatically execute all of the notebooks, to mimic the "Run notebooks" GHA, you can run:
 
 ```bash
 python _scripts/prepare_notebooks_for_ci.py
@@ -135,9 +33,8 @@ python _scripts/prepare_notebooks_for_ci.py --comment-install-cells
 ```
 
 `prepare_notebooks_for_ci.py` script will add VCR cassette context manager for each cell in the notebook, so that:
-
-- when the notebook is run for the first time, cells with network requests will be recorded to a VCR cassette file
-- when the notebook is run subsequently, the cells with network requests will be replayed from the cassettes
+* when the notebook is run for the first time, cells with network requests will be recorded to a VCR cassette file
+* when the notebook is run subsequently, the cells with network requests will be replayed from the cassettes
 
 ## Adding new notebooks
 

docs/_scripts/generate_api_reference_links.py

@@ -1,5 +1,3 @@
-"""Generate API reference links for imports in Python code blocks within markdown files."""
-
 import ast
 import importlib
 import logging
@@ -72,18 +70,8 @@ MANUAL_API_REFERENCES_LANGGRAPH = [
     ([], "langgraph.checkpoint.postgres.aio", "AsyncPostgresSaver", "checkpoints"),
     ([], "langgraph.checkpoint.postgres", "PostgresSaver", "checkpoints"),
     # other prebuilts
-    (
-        ["langgraph_supervisor"],
-        "langgraph_supervisor.supervisor",
-        "create_supervisor",
-        "supervisor",
-    ),
-    (
-        ["langgraph_supervisor"],
-        "langgraph_supervisor.handoff",
-        "create_handoff_tool",
-        "supervisor",
-    ),
+    (["langgraph_supervisor"], "langgraph_supervisor.supervisor", "create_supervisor", "supervisor"),
+    (["langgraph_supervisor"], "langgraph_supervisor.handoff", "create_handoff_tool", "supervisor"),
     ([], "langgraph_supervisor.handoff", "create_forward_message_tool", "supervisor"),
     (["langgraph_swarm"], "langgraph_swarm.swarm", "create_swarm", "swarm"),
     (["langgraph_swarm"], "langgraph_swarm.swarm", "add_active_agent_router", "swarm"),

docs/_scripts/js_translation/codeblocks/yarn.lock

@@ -2108,9 +2108,9 @@ __metadata:
   linkType: hard
 
 "hono@npm:^4.5.4":
-  version: 4.9.7
-  resolution: "hono@npm:4.9.7"
-  checksum: 10c0/089184660a9211ea216ab95bafa45260e371651cb019db49828064b7982b0ae61cc3c4715324bfeb9037aa2460c39ffa2c91d84ad0c8d500fa77cbcc7fc07a8f
+  version: 4.8.9
+  resolution: "hono@npm:4.8.9"
+  checksum: 10c0/385539d1787fdc747bc869ef0e5ccc9f39cbe40289b94f23eecfc82c6ca440f059704647cd6381a5066d2cf7baa43ab25184c78d44af4c5c98a5c5b07670059e
   languageName: node
   linkType: hard
 

docs/_scripts/link_map.py

@@ -4,48 +4,52 @@ This module provides link mappings for different language/framework scopes
 to resolve @[link_name] references to actual URLs.
 """
 
+# Python-specific link mappings
 # Python-specific link mappings
 PYTHON_LINK_MAP = {
     "StateGraph": "reference/graphs/#langgraph.graph.StateGraph",
-    "add_conditional_edges": "reference/graphs/#langgraph.graph.state.StateGraph.add_conditional_edges",
-    "add_edge": "reference/graphs/#langgraph.graph.state.StateGraph.add_edge",
-    "add_node": "reference/graphs/#langgraph.graph.state.StateGraph.add_node",
-    "add_messages": "reference/graphs/#langgraph.graph.message.add_messages",
-    "ToolNode": "reference/agents/#langgraph.prebuilt.tool_node.ToolNode",
+    "add_conditional_edges": "reference/graphs/#langgraph.graph.StateGraph.add_conditional_edges",
+    "add_edge": "reference/graphs/#langgraph.graph.StateGraph.add_edge",
+    "add_node": "reference/graphs/#langgraph.graph.StateGraph.add_node",
+    "add_messages": "reference/messages/#langgraph.graph.message.add_messages",
+    "ToolNode": "reference/prebuilt/#langgraph.prebuilt.tool_node.ToolNode",
     "CompiledStateGraph.astream": "reference/graphs/#langgraph.graph.state.CompiledStateGraph.astream",
-    "Pregel.astream": "reference/pregel/#langgraph.pregel.Pregel.astream",
+    "Pregel.astream": "reference/graphs/#langgraph.pregel.Pregel.astream",
     "AsyncPostgresSaver": "reference/checkpoints/#langgraph.checkpoint.postgres.aio.AsyncPostgresSaver",
     "AsyncSqliteSaver": "reference/checkpoints/#langgraph.checkpoint.sqlite.aio.AsyncSqliteSaver",
     "BaseCheckpointSaver": "reference/checkpoints/#langgraph.checkpoint.base.BaseCheckpointSaver",
-    "BaseStore": "reference/store/#langgraph.store.base.BaseStore",
-    "BaseStore.put": "reference/store/#langgraph.store.base.BaseStore.put",
-    "BinaryOperatorAggregate": "reference/pregel/#langgraph.pregel.Pregel--advanced-channels-context-and-binaryoperatoraggregate",
+    "BaseStore": "reference/stores/#langgraph.store.base.BaseStore",
+    "BaseStore.put": "reference/stores/#langgraph.store.base.BaseStore.put",
+    "BinaryOperatorAggregate": "reference/channels/#langgraph.channels.BinaryOperatorAggregate",
     "CipherProtocol": "reference/checkpoints/#langgraph.checkpoint.serde.base.CipherProtocol",
-    "client.runs.stream": "cloud/reference/sdk/python_sdk_ref/#langgraph_sdk.client.RunsClient.stream",
-    "client.runs.wait": "cloud/reference/sdk/python_sdk_ref/#langgraph_sdk.client.RunsClient.wait",
-    "client.threads.get_history": "cloud/reference/sdk/python_sdk_ref/#langgraph_sdk.client.ThreadsClient.get_history",
-    "client.threads.update_state": "cloud/reference/sdk/python_sdk_ref/#langgraph_sdk.client.ThreadsClient.update_state",
+    "client.runs.stream": "reference/client/#langgraph_sdk.client.RunsClient.stream",
+    "client.runs.wait": "reference/client/#langgraph_sdk.client.RunsClient.wait",
+    "client.threads.get_history": "reference/client/#langgraph_sdk.client.ThreadsClient.get_history",
+    "client.threads.update_state": "reference/client/#langgraph_sdk.client.ThreadsClient.update_state",
     "Command": "reference/types/#langgraph.types.Command",
     "CompiledStateGraph": "reference/graphs/#langgraph.graph.state.CompiledStateGraph",
     "create_react_agent": "reference/prebuilt/#langgraph.prebuilt.chat_agent_executor.create_react_agent",
     "create_supervisor": "reference/supervisor/#langgraph_supervisor.supervisor.create_supervisor",
     "EncryptedSerializer": "reference/checkpoints/#langgraph.checkpoint.serde.encrypted.EncryptedSerializer",
-    "entrypoint.final": "reference/func/#langgraph.func.entrypoint.final",
-    "entrypoint": "reference/func/#langgraph.func.entrypoint",
+    "entrypoint.final": "reference/functions/#langgraph.func.entrypoint.final",
+    "entrypoint": "reference/functions/#langgraph.func.entrypoint",
     "from_pycryptodome_aes": "reference/checkpoints/#langgraph.checkpoint.serde.encrypted.EncryptedSerializer.from_pycryptodome_aes",
+    # "getContextVariable": "<insert-ref>",
     "get_state_history": "reference/graphs/#langgraph.graph.state.CompiledStateGraph.get_state_history",
     "get_stream_writer": "reference/config/#langgraph.config.get_stream_writer",
     "HumanInterrupt": "reference/prebuilt/#langgraph.prebuilt.interrupt.HumanInterrupt",
-    "InjectedState": "reference/agents/#langgraph.prebuilt.tool_node.InjectedState",
+    "InjectedState": "reference/prebuilt/#langgraph.prebuilt.InjectedState",
     "InMemorySaver": "reference/checkpoints/#langgraph.checkpoint.memory.InMemorySaver",
-    "interrupt": "reference/types/#langgraph.types.Interrupt",
+    "interrupt": "reference/graphs/#langgraph.graph.interrupt",
     "CompiledStateGraph.invoke": "reference/graphs/#langgraph.graph.state.CompiledStateGraph.invoke",
     "JsonPlusSerializer": "reference/checkpoints/#langgraph.checkpoint.serde.jsonplus.JsonPlusSerializer",
-    "langgraph.json": "cloud/reference/cli/#configuration-file",
+    "langgraph.json": "reference/configuration/#configuration-file",
     "LastValue": "reference/channels/#langgraph.channels.LastValue",
+    # "MemorySaver": "<insert-ref>",
+    # "messagesStateReducer": "<insert-ref>",
     "PostgresSaver": "reference/checkpoints/#langgraph.checkpoint.postgres.PostgresSaver",
-    "Pregel": "reference/pregel/",
-    "Pregel.stream": "reference/pregel/#langgraph.pregel.Pregel.stream",
+    "Pregel": "reference/graphs/#langgraph.pregel.Pregel",
+    "Pregel.stream": "reference/graphs/#langgraph.pregel.Pregel.stream",
     "pre_model_hook": "reference/prebuilt/#langgraph.prebuilt.chat_agent_executor.create_react_agent",
     "protocol": "reference/checkpoints/#langgraph.checkpoint.serde.base.SerializerProtocol",
     "Send": "reference/types/#langgraph.types.Send",
@@ -53,56 +57,68 @@ PYTHON_LINK_MAP = {
     "SqliteSaver": "reference/checkpoints/#langgraph.checkpoint.sqlite.SqliteSaver",
     "START": "reference/constants/#langgraph.constants.START",
     "CompiledStateGraph.stream": "reference/graphs/#langgraph.graph.state.CompiledStateGraph.stream",
-    "task": "reference/func/#langgraph.func.task",
+    "task": "reference/functions/#langgraph.func.task",
     "Topic": "reference/channels/#langgraph.channels.Topic",
     "update_state": "reference/graphs/#langgraph.graph.state.CompiledStateGraph.update_state",
 }
 
+
 # JavaScript-specific link mappings
 JS_LINK_MAP = {
     "Auth": "reference/classes/sdk_auth.Auth.html",
     "StateGraph": "reference/classes/langgraph.StateGraph.html",
-    "add_conditional_edges": "/reference/classes/langgraph.StateGraph.html#addConditionalEdges",
-    "add_edge": "reference/classes/langgraph.StateGraph.html#addEdge",
-    "add_node": "reference/classes/langgraph.StateGraph.html#addNode",
-    "add_messages": "reference/modules/langgraph.html#addMessages",
+    "add_conditional_edges": "reference/functions/langgraph_StateGraph.addConditionalEdges.html",
+    "add_edge": "reference/functions/langgraph_StateGraph.addEdge.html",
+    "add_node": "reference/functions/langgraph_StateGraph.addNode.html",
+    "add_messages": "reference/functions/langgraph_message.addMessages.html",
     "ToolNode": "reference/classes/langgraph_prebuilt.ToolNode.html",
-    "BaseCheckpointSaver": "reference/classes/checkpoint.BaseCheckpointSaver.html",
-    "BaseStore": "reference/classes/checkpoint.BaseStore.html",
-    "BaseStore.put": "reference/classes/checkpoint.BaseStore.html#put",
-    "BinaryOperatorAggregate": "reference/classes/langgraph.BinaryOperatorAggregate.html",
-    "client.runs.stream": "reference/classes/sdk_client.RunsClient.html#stream",
-    "client.runs.wait": "reference/classes/sdk_client.RunsClient.html#wait",
-    "client.threads.get_history": "reference/classes/sdk_client.ThreadsClient.html#getHistory",
-    "client.threads.update_state": "reference/classes/sdk_client.ThreadsClient.html#updateState",
+    "CompiledStateGraph.astream()": "reference/functions/langgraph_CompiledStateGraph.astream.html",
+    "Pregel.astream": "reference/functions/langgraph_Pregel.astream.html",
+    "AsyncPostgresSaver": "reference/classes/langgraph_checkpoint_postgres_aio.AsyncPostgresSaver.html",
+    "AsyncSqliteSaver": "reference/classes/langgraph_checkpoint_sqlite_aio.AsyncSqliteSaver.html",
+    "BaseCheckpointSaver": "reference/classes/langgraph_checkpoint_base.BaseCheckpointSaver.html",
+    "BaseStore": "reference/classes/langgraph_store_base.BaseStore.html",
+    "BaseStore.put": "reference/functions/langgraph_store_base.BaseStore.put.html",
+    "BinaryOperatorAggregate": "reference/classes/langgraph_channels.BinaryOperatorAggregate.html",
+    "CipherProtocol": "reference/classes/langgraph_checkpoint_serde_base.CipherProtocol.html",
+    "client.runs.stream": "reference/functions/langgraph_sdk_client.RunsClient.stream.html",
+    "client.runs.wait": "reference/functions/langgraph_sdk_client.RunsClient.wait.html",
+    "client.threads.get_history": "reference/functions/langgraph_sdk_client.ThreadsClient.getHistory.html",
+    "client.threads.update_state": "reference/functions/langgraph_sdk_client.ThreadsClient.updateState.html",
     "Command": "reference/classes/langgraph.Command.html",
     "CompiledStateGraph": "reference/classes/langgraph.CompiledStateGraph.html",
     "create_react_agent": "reference/functions/langgraph_prebuilt.createReactAgent.html",
     "create_supervisor": "reference/functions/langgraph_supervisor.createSupervisor.html",
-    "entrypoint.final": "reference/functions/langgraph.entrypoint.html#final",
-    "entrypoint": "reference/functions/langgraph.entrypoint.html",
+    "EncryptedSerializer": "reference/classes/langgraph_checkpoint_serde_encrypted.EncryptedSerializer.html",
+    "entrypoint.final": "reference/functions/langgraph_func.entrypoint.final.html",
+    "entrypoint": "reference/functions/langgraph_func.entrypoint.html",
+    "from_pycryptodome_aes": "reference/functions/langgraph_checkpoint_serde_encrypted.EncryptedSerializer.fromPycryptodomeAes.html",
     "getContextVariable": "https://v03.api.js.langchain.com/functions/_langchain_core.context.getContextVariable.html",
-    "get_state_history": "reference/classes/langgraph.CompiledStateGraph.html#getStateHistory",
-    "HumanInterrupt": "reference/interfaces/langgraph_prebuilt.HumanInterrupt.html",
+    "get_state_history": "reference/functions/langgraph_CompiledStateGraph.getStateHistory.html",
+    "get_stream_writer": "reference/functions/langgraph_config.getStreamWriter.html",
+    "HumanInterrupt": "reference/classes/langgraph_prebuilt.HumanInterrupt.html",
+    "InjectedState": "reference/classes/langgraph_prebuilt.InjectedState.html",
+    "InMemorySaver": "reference/classes/langgraph_checkpoint_memory.InMemorySaver.html",
     "interrupt": "reference/functions/langgraph.interrupt-2.html",
-    "CompiledStateGraph.invoke": "reference/classes/langgraph.CompiledStateGraph.html#invoke",
-    "langgraph.json": "cloud/reference/cli/#configuration-file",
+    "CompiledStateGraph.invoke": "reference/functions/langgraph_CompiledStateGraph.invoke.html",
+    "JsonPlusSerializer": "reference/classes/langgraph_checkpoint_serde_jsonplus.JsonPlusSerializer.html",
+    "langgraph.json": "reference/configuration.html",
+    "LastValue": "reference/classes/langgraph_channels.LastValue.html",
     "MemorySaver": "reference/classes/checkpoint.MemorySaver.html",
     "messagesStateReducer": "reference/functions/langgraph.messagesStateReducer.html",
-    "PostgresSaver": "reference/classes/checkpoint_postgres.PostgresSaver.html",
+    "PostgresSaver": "reference/classes/langgraph_checkpoint_postgres.PostgresSaver.html",
     "Pregel": "reference/classes/langgraph.Pregel.html",
-    "Pregel.stream": "reference/classes/langgraph.Pregel.html#stream",
+    "Pregel.stream": "reference/functions/langgraph_Pregel.stream.html",
     "pre_model_hook": "reference/functions/langgraph_prebuilt.createReactAgent.html",
-    "protocol": "reference/interfaces/checkpoint.SerializerProtocol.html",
+    "protocol": "reference/classes/langgraph_checkpoint_serde_base.SerializerProtocol.html",
     "Send": "reference/classes/langgraph.Send.html",
-    "SerializerProtocol": "reference/interfaces/checkpoint.SerializerProtocol.html",
-    "SqliteSaver": "reference/classes/checkpoint_sqlite.SqliteSaver.html",
-    "START": "reference/variables/langgraph.START.html",
-    "CompiledStateGraph.stream": "reference/classes/langgraph.CompiledStateGraph.html#stream",
-    "task": "reference/functions/langgraph.task.html",
-    ## TODO (hntrl): export Topic from langgraphjs
-    # "Topic": "reference/classes/langgraph_channels.Topic.html",
-    "update_state": "reference/classes/langgraph.CompiledStateGraph.html#updateState",
+    "SerializerProtocol": "reference/classes/langgraph_checkpoint_serde_base.SerializerProtocol.html",
+    "SqliteSaver": "reference/classes/langgraph_checkpoint_sqlite.SqliteSaver.html",
+    "START": "reference/constants.html#START",
+    "CompiledStateGraph.stream": "reference/functions/langgraph_CompiledStateGraph.stream.html",
+    "task": "reference/functions/langgraph_func.task.html",
+    "Topic": "reference/classes/langgraph_channels.Topic.html",
+    "update_state": "reference/functions/langgraph_CompiledStateGraph.updateState.html",
 }
 
 # TODO: Allow updating these to localhost for local development

docs/_scripts/notebook_convert.py

@@ -1,5 +1,3 @@
-"""Convert Jupyter notebooks to markdown with custom processing."""
-
 import ast
 import os
 import re

docs/_scripts/notebook_hooks.py

@@ -88,12 +88,12 @@ REDIRECT_MAP = {
     "cloud/how-tos/human_in_the_loop_user_input.md": "cloud/how-tos/add-human-in-the-loop.md",
     "concepts/platform_architecture.md": "concepts/langgraph_cloud#architecture",
     # cloud streaming redirects
-    "cloud/how-tos/stream_values.md": "https://docs.langchain.com/langgraph-platform/streaming",
-    "cloud/how-tos/stream_updates.md": "https://docs.langchain.com/langgraph-platform/streaming",
-    "cloud/how-tos/stream_messages.md": "https://docs.langchain.com/langgraph-platform/streaming",
-    "cloud/how-tos/stream_events.md": "https://docs.langchain.com/langgraph-platform/streaming",
-    "cloud/how-tos/stream_debug.md": "https://docs.langchain.com/langgraph-platform/streaming",
-    "cloud/how-tos/stream_multiple.md": "https://docs.langchain.com/langgraph-platform/streaming",
+    "cloud/how-tos/stream_values.md": "cloud/how-tos/streaming.md#stream-graph-state",
+    "cloud/how-tos/stream_updates.md": "cloud/how-tos/streaming.md#stream-graph-state",
+    "cloud/how-tos/stream_messages.md": "cloud/how-tos/streaming.md#messages",
+    "cloud/how-tos/stream_events.md": "cloud/how-tos/streaming.md#stream-events",
+    "cloud/how-tos/stream_debug.md": "cloud/how-tos/streaming.md#debug",
+    "cloud/how-tos/stream_multiple.md": "cloud/how-tos/streaming.md#stream-multiple-modes",
     "cloud/concepts/streaming.md": "concepts/streaming.md",
     "agents/streaming.md": "how-tos/streaming.md",
     # prebuilt redirects
@@ -127,85 +127,6 @@ REDIRECT_MAP = {
     "how-tos/human_in_the_loop/breakpoints.md": "how-tos/human_in_the_loop/add-human-in-the-loop.md",
     "cloud/how-tos/human_in_the_loop_breakpoint.md": "cloud/how-tos/add-human-in-the-loop.md",
     "how-tos/human_in_the_loop/edit-graph-state.ipynb": "how-tos/human_in_the_loop/time-travel.md",
-
-    # LGP mintlify migration redirects
-    "tutorials/auth/getting_started.md": "https://docs.langchain.com/langgraph-platform/auth",
-    "tutorials/auth/resource_auth.md": "https://docs.langchain.com/langgraph-platform/resource-auth",
-    "tutorials/auth/add_auth_server.md": "https://docs.langchain.com/langgraph-platform/add-auth-server",
-    "how-tos/use-remote-graph.md": "https://docs.langchain.com/langgraph-platform/use-remote-graph",
-    "how-tos/autogen-integration.md": "https://docs.langchain.com/langgraph-platform/autogen-integration",
-    "cloud/how-tos/use_stream_react.md": "https://docs.langchain.com/langgraph-platform/use-stream-react",
-    "cloud/how-tos/generative_ui_react.md": "https://docs.langchain.com/langgraph-platform/generative-ui-react",
-    "concepts/langgraph_platform.md": "https://docs.langchain.com/langgraph-platform/index",
-    "concepts/langgraph_components.md": "https://docs.langchain.com/langgraph-platform/components",
-    "concepts/langgraph_server.md": "https://docs.langchain.com/langgraph-platform/langgraph-server",
-    "concepts/langgraph_data_plane.md": "https://docs.langchain.com/langgraph-platform/data-plane",
-    "concepts/langgraph_control_plane.md": "https://docs.langchain.com/langgraph-platform/control-plane",
-    "concepts/langgraph_cli.md": "https://docs.langchain.com/langgraph-platform/langgraph-cli",
-    "concepts/langgraph_studio.md": "https://docs.langchain.com/langgraph-platform/langgraph-studio",
-    "cloud/how-tos/studio/quick_start.md": "https://docs.langchain.com/langgraph-platform/quick-start-studio",
-    "cloud/how-tos/invoke_studio.md": "https://docs.langchain.com/langgraph-platform/use-studio#run-application",
-    "cloud/how-tos/studio/manage_assistants.md": "https://docs.langchain.com/langgraph-platform/use-studio#manage-assistants",
-    "cloud/how-tos/threads_studio.md": "https://docs.langchain.com/langgraph-platform/use-studio#manage-threads",
-    "cloud/how-tos/iterate_graph_studio.md": "https://docs.langchain.com/langgraph-platform/observability-studio#iterate-on-prompts",
-    "cloud/how-tos/studio/run_evals.md": "https://docs.langchain.com/langgraph-platform/observability-studio#run-experiments-over-a-dataset",
-    "cloud/how-tos/clone_traces_studio.md": "https://docs.langchain.com/langgraph-platform/observability-studio#debug-langsmith-traces",
-    "cloud/how-tos/datasets_studio.md": "https://docs.langchain.com/langgraph-platform/observability-studio#add-node-to-dataset",
-    "concepts/sdk.md": "https://docs.langchain.com/langgraph-platform/sdk",
-    "concepts/plans.md": "https://docs.langchain.com/langgraph-platform/plans",
-    "concepts/application_structure.md": "https://docs.langchain.com/langgraph-platform/application-structure",
-    "concepts/scalability_and_resilience.md": "https://docs.langchain.com/langgraph-platform/scalability-and-resilience",
-    "concepts/auth.md": "https://docs.langchain.com/langgraph-platform/auth",
-    "how-tos/auth/custom_auth.md": "https://docs.langchain.com/langgraph-platform/custom-auth",
-    "how-tos/auth/openapi_security.md": "https://docs.langchain.com/langgraph-platform/openapi-security",
-    "concepts/assistants.md": "https://docs.langchain.com/langgraph-platform/assistants",
-    "cloud/how-tos/configuration_cloud.md": "https://docs.langchain.com/langgraph-platform/configuration-cloud",
-    "cloud/how-tos/use_threads.md": "https://docs.langchain.com/langgraph-platform/use-threads",
-    "cloud/how-tos/background_run.md": "https://docs.langchain.com/langgraph-platform/background-run",
-    "cloud/how-tos/same-thread.md": "https://docs.langchain.com/langgraph-platform/same-thread",
-    "cloud/how-tos/stateless_runs.md": "https://docs.langchain.com/langgraph-platform/stateless-runs",
-    "cloud/how-tos/configurable_headers.md": "https://docs.langchain.com/langgraph-platform/configurable-headers",
-    "concepts/double_texting.md": "https://docs.langchain.com/langgraph-platform/double-texting",
-    "cloud/how-tos/interrupt_concurrent.md": "https://docs.langchain.com/langgraph-platform/interrupt-concurrent",
-    "cloud/how-tos/rollback_concurrent.md": "https://docs.langchain.com/langgraph-platform/rollback-concurrent",
-    "cloud/how-tos/reject_concurrent.md": "https://docs.langchain.com/langgraph-platform/reject-concurrent",
-    "cloud/how-tos/enqueue_concurrent.md": "https://docs.langchain.com/langgraph-platform/enqueue-concurrent",
-    "cloud/concepts/webhooks.md": "https://docs.langchain.com/langgraph-platform/use-webhooks",
-    "cloud/how-tos/webhooks.md": "https://docs.langchain.com/langgraph-platform/use-webhooks",
-    "cloud/concepts/cron_jobs.md": "https://docs.langchain.com/langgraph-platform/cron-jobs",
-    "cloud/how-tos/cron_jobs.md": "https://docs.langchain.com/langgraph-platform/cron-jobs",
-    "how-tos/http/custom_lifespan.md": "https://docs.langchain.com/langgraph-platform/custom-lifespan",
-    "how-tos/http/custom_middleware.md": "https://docs.langchain.com/langgraph-platform/custom-middleware",
-    "how-tos/http/custom_routes.md": "https://docs.langchain.com/langgraph-platform/custom-routes",
-    "cloud/concepts/data_storage_and_privacy.md": "https://docs.langchain.com/langgraph-platform/data-storage-and-privacy",
-    "cloud/deployment/semantic_search.md": "https://docs.langchain.com/langgraph-platform/semantic-search",
-    "how-tos/ttl/configure_ttl.md": "https://docs.langchain.com/langgraph-platform/configure-ttl",
-    "concepts/deployment_options.md": "https://docs.langchain.com/langgraph-platform/deployment-options",
-    "cloud/quick_start.md": "https://docs.langchain.com/langgraph-platform/deployment-quickstart",
-    "cloud/deployment/setup.md": "https://docs.langchain.com/langgraph-platform/setup-app-requirements-txt",
-    "cloud/deployment/setup_pyproject.md": "https://docs.langchain.com/langgraph-platform/setup-pyproject",
-    "cloud/deployment/setup_javascript.md": "https://docs.langchain.com/langgraph-platform/setup-javascript",
-    "cloud/deployment/custom_docker.md": "https://docs.langchain.com/langgraph-platform/custom-docker",
-    "cloud/deployment/graph_rebuild.md": "https://docs.langchain.com/langgraph-platform/graph-rebuild",
-    "concepts/langgraph_cloud.md": "https://docs.langchain.com/langgraph-platform/cloud",
-    "concepts/langgraph_self_hosted_data_plane.md": "https://docs.langchain.com/langgraph-platform/hybrid",
-    "concepts/langgraph_self_hosted_control_plane.md": "https://docs.langchain.com/langgraph-platform/self-hosted",
-    "concepts/langgraph_standalone_container.md": "https://docs.langchain.com/langgraph-platform/self-hosted#standalone-server",
-    "cloud/deployment/cloud.md": "https://docs.langchain.com/langgraph-platform/cloud",
-    "cloud/deployment/self_hosted_data_plane.md": "https://docs.langchain.com/langgraph-platform/deploy-hybrid",
-    "cloud/deployment/self_hosted_control_plane.md": "https://docs.langchain.com/langgraph-platform/deploy-self-hosted-full-platform",
-    "cloud/deployment/standalone_container.md": "https://docs.langchain.com/langgraph-platform/deploy-standalone-server",
-    "concepts/server-mcp.md": "https://docs.langchain.com/langgraph-platform/server-mcp",
-    "cloud/how-tos/human_in_the_loop_time_travel.md": "https://docs.langchain.com/langgraph-platform/human-in-the-loop-time-travel",
-    "cloud/how-tos/add-human-in-the-loop.md": "https://docs.langchain.com/langgraph-platform/add-human-in-the-loop",
-    "cloud/deployment/egress.md": "https://docs.langchain.com/langgraph-platform/env-var",
-    "cloud/how-tos/streaming.md": "https://docs.langchain.com/langgraph-platform/streaming",
-    "cloud/reference/api/api_ref.md": "https://docs.langchain.com/langgraph-platform/server-api-ref",
-    "cloud/reference/langgraph_server_changelog.md": "https://docs.langchain.com/langgraph-platform/langgraph-server-changelog",
-    "cloud/reference/api/api_ref_control_plane.md": "https://docs.langchain.com/langgraph-platform/api-ref-control-plane",
-    "cloud/reference/cli.md": "https://docs.langchain.com/langgraph-platform/cli",
-    "cloud/reference/env_var.md": "https://docs.langchain.com/langgraph-platform/env-var",
-    "troubleshooting/studio.md": "https://docs.langchain.com/langgraph-platform/troubleshooting-studio",
 }
 
 
@@ -561,51 +482,16 @@ def on_post_page(html: str, page: Page, config: MkDocsConfig) -> str:
 def on_post_build(config):
     use_directory_urls = config.get("use_directory_urls")
     for page_old, page_new in REDIRECT_MAP.items():
-        # Convert .ipynb to .md for path calculation
         page_old = page_old.replace(".ipynb", ".md")
-        
-        # Calculate the HTML path for the old page (whether it exists or not)
-        if use_directory_urls:
-            # With directory URLs: /path/to/page/ becomes /path/to/page/index.html
-            if page_old.endswith(".md"):
-                old_html_path = page_old[:-3] + "/index.html"
-            else:
-                old_html_path = page_old + "/index.html"
-        else:
-            # Without directory URLs: /path/to/page.md becomes /path/to/page.html
-            if page_old.endswith(".md"):
-                old_html_path = page_old[:-3] + ".html"
-            else:
-                old_html_path = page_old + ".html"
-        
-        if isinstance(page_new, str) and page_new.startswith("http"):
-            # Handle external redirects
-            _write_html(config["site_dir"], old_html_path, page_new)
-        else:
-            # Handle internal redirects
-            page_new = page_new.replace(".ipynb", ".md")
-            page_new_before_hash, hash, suffix = page_new.partition("#")
-            
-            # Try to get the new path using File class, but fallback to manual calculation
-            try:
-                new_html_path = File(page_new_before_hash, "", "", True).url
-                new_html_path = (
-                    posixpath.relpath(new_html_path, start=posixpath.dirname(old_html_path))
-                    + hash
-                    + suffix
-                )
-            except:
-                # Fallback: calculate relative path manually
-                if use_directory_urls:
-                    if page_new_before_hash.endswith(".md"):
-                        new_html_path = page_new_before_hash[:-3] + "/"
-                    else:
-                        new_html_path = page_new_before_hash + "/"
-                else:
-                    if page_new_before_hash.endswith(".md"):
-                        new_html_path = page_new_before_hash[:-3] + ".html"
-                    else:
-                        new_html_path = page_new_before_hash + ".html"
-                new_html_path += hash + suffix
-            
-            _write_html(config["site_dir"], old_html_path, new_html_path)
+        page_new = page_new.replace(".ipynb", ".md")
+        page_new_before_hash, hash, suffix = page_new.partition("#")
+        old_html_path = File(page_old, "", "", use_directory_urls).dest_path.replace(
+            os.sep, "/"
+        )
+        new_html_path = File(page_new_before_hash, "", "", True).url
+        new_html_path = (
+            posixpath.relpath(new_html_path, start=posixpath.dirname(old_html_path))
+            + hash
+            + suffix
+        )
+        _write_html(config["site_dir"], old_html_path, new_html_path)

docs/docs/agents/agents.md

@@ -29,7 +29,7 @@ pip install -U langgraph "langchain[anthropic]"
 
 !!! info
 
-    `langchain[anthropic]` is installed so the agent can call the [model](https://python.langchain.com/docs/integrations/chat/).
+    LangChain is installed so the agent can call the [model](https://python.langchain.com/docs/integrations/chat/).
 
 :::
 
@@ -41,7 +41,7 @@ npm install @langchain/langgraph @langchain/core @langchain/anthropic
 
 !!! info
 
-    `@langchain/core` `@langchain/anthropic` are installed so the agent can call the [model](https://js.langchain.com/docs/integrations/chat/).
+    LangChain is installed so the agent can call the [model](https://js.langchain.com/docs/integrations/chat/).
 
 :::
 

docs/docs/agents/context.md

@@ -2,12 +2,13 @@
 
 **Context engineering** is the practice of building dynamic systems that provide the right information and tools, in the right format, so that an AI application can accomplish a task. Context can be characterized along two key dimensions:
 
+
 1. By **mutability**:
-    - **Static context**: Immutable data that doesn't change during execution (e.g., user metadata, database connections, tools)
-    - **Dynamic context**: Mutable data that evolves as the application runs (e.g., conversation history, intermediate results, tool call observations)
+      - **Static context**: Immutable data that doesn't change during execution (e.g., user metadata, database connections, tools)
+      - **Dynamic context**: Mutable data that evolves as the application runs (e.g., conversation history, intermediate results, tool call observations)
 2. By **lifetime**:
-    - **Runtime context**: Data scoped to a single run or invocation
-    - **Cross-conversation context**: Data that persists across multiple conversations or sessions
+      - **Runtime context**: Data scoped to a single run or invocation
+      - **Cross-conversation context**: Data that persists across multiple conversations or sessions
 
 !!! tip "Runtime context vs LLM context"
 
@@ -33,7 +34,7 @@ LangGraph provides three ways to manage context, which combines the mutability a
 
 **Static runtime context** represents immutable data like user metadata, tools, and database connections that are passed to an application at the start of a run via the `context` argument to `invoke`/`stream`. This data does not change during execution.
 
-!!! version-added "Added in version 0.6.0: `context` replaces `config['configurable']`"
+!!! version-added "New in LangGraph v0.6: `context` replaces `config['configurable']`"
 
     Runtime context is now passed to the `context` argument of `invoke`/`stream`,
     which replaces the previous pattern of passing application configuration to `config['configurable']`.
@@ -90,7 +91,7 @@ graph.invoke( # (1)!
     from langgraph.runtime import Runtime
 
     # highlight-next-line
-    def node(state: State, runtime: Runtime[ContextSchema]):
+    def node(state: State, config: Runtime[ContextSchema]):
         user_name = runtime.context.user_name
         ...
     ```
@@ -125,7 +126,7 @@ graph.invoke( # (1)!
 
 | Context type                                                                                | Description                                   | Mutability | Lifetime           |
 | ------------------------------------------------------------------------------------------- | --------------------------------------------- | ---------- | ------------------ |
-| [**Config**](#config-static-context)                                                        | data passed at the start of a run             | Static     | Single run         |
+| [**Config**](#config-static-context)                                                        | data passed at the start of a run             | ❌         | per run            |
 | [**Dynamic runtime context (state)**](#dynamic-runtime-context-state)                       | Mutable data that evolves during a single run | Dynamic    | Single run         |
 | [**Dynamic cross-conversation context (store)**](#dynamic-cross-conversation-context-store) | Persistent data shared across conversations   | Dynamic    | Cross-conversation |
 

docs/docs/agents/models.md

@@ -145,76 +145,6 @@ const agent = createReactAgent({
 
 :::
 
-:::python
-
-### Dynamic model selection
-
-Pass a callable function to `create_react_agent` to dynamically select the model at runtime. This is useful for scenarios where you want to choose a model based on user input, configuration settings, or other runtime conditions.
-
-The selector function must return a chat model. If you're using tools, you must bind the tools to the model within the selector function.
-
-  ```python
-from dataclasses import dataclass
-from typing import Literal
-from langchain.chat_models import init_chat_model
-from langchain_core.language_models import BaseChatModel
-from langchain_core.tools import tool
-from langgraph.prebuilt import create_react_agent
-from langgraph.prebuilt.chat_agent_executor import AgentState
-from langgraph.runtime import Runtime
-
-@tool
-def weather() -> str:
-    """Returns the current weather conditions."""
-    return "It's nice and sunny."
-
-
-# Define the runtime context
-@dataclass
-class CustomContext:
-    provider: Literal["anthropic", "openai"]
-
-# Initialize models
-openai_model = init_chat_model("openai:gpt-4o")
-anthropic_model = init_chat_model("anthropic:claude-sonnet-4-20250514")
-
-
-# Selector function for model choice
-def select_model(state: AgentState, runtime: Runtime[CustomContext]) -> BaseChatModel:
-    if runtime.context.provider == "anthropic":
-        model = anthropic_model
-    elif runtime.context.provider == "openai":
-        model = openai_model
-    else:
-        raise ValueError(f"Unsupported provider: {runtime.context.provider}")
-
-    # With dynamic model selection, you must bind tools explicitly
-    return model.bind_tools([weather])
-
-
-# Create agent with dynamic model selection
-agent = create_react_agent(select_model, tools=[weather])
-
-# Invoke with context to select model
-output = agent.invoke(
-    {
-        "messages": [
-            {
-                "role": "user",
-                "content": "Which model is handling this?",
-            }
-        ]
-    },
-    context=CustomContext(provider="openai"),
-)
-
-print(output["messages"][-1].text())
-```
-
-!!! version-added "Added in version 0.6.0"
-
-:::
-
 ## Advanced model configuration
 
 ### Disable streaming
@@ -351,13 +281,11 @@ If your desired LLM isn't officially supported by LangChain, consider these opti
 :::python
 
 1. **Implement a custom LangChain chat model**: Create a model conforming to the [LangChain chat model interface](https://python.langchain.com/docs/how_to/custom_chat_model/). This enables full compatibility with LangGraph's agents and workflows but requires understanding of the LangChain framework.
-
    :::
 
 :::js
 
 1. **Implement a custom LangChain chat model**: Create a model conforming to the [LangChain chat model interface](https://js.langchain.com/docs/how_to/custom_chat/). This enables full compatibility with LangGraph's agents and workflows but requires understanding of the LangChain framework.
-
    :::
 
 2. **Direct invocation with custom streaming**: Use your model directly by [adding custom streaming logic](../how-tos/streaming.md#use-with-any-llm) with `StreamWriter`.
@@ -373,7 +301,6 @@ If your desired LLM isn't officially supported by LangChain, consider these opti
 - [Force model to call a specific tool](https://python.langchain.com/docs/how_to/tool_choice/)
 - [All chat model how-to guides](https://python.langchain.com/docs/how_to/#chat-models)
 - [Chat model integrations](https://python.langchain.com/docs/integrations/chat/)
-
   :::
 
 :::js
@@ -384,5 +311,4 @@ If your desired LLM isn't officially supported by LangChain, consider these opti
 - [Force model to call a specific tool](https://js.langchain.com/docs/how_to/tool_choice/)
 - [All chat model how-to guides](https://js.langchain.com/docs/how_to/#chat-models)
 - [Chat model integrations](https://js.langchain.com/docs/integrations/chat/)
-
   :::

docs/docs/agents/multi-agent.md

@@ -367,13 +367,13 @@ To implement handoffs with `createReactAgent`, you need to:
 
 3.  Define a parent graph that contains individual agents as nodes:
 
-    ```typescript
-    import { StateGraph, MessagesZodState } from "@langchain/langgraph";
-    const multiAgentGraph = new StateGraph(MessagesZodState)
-      .addNode("flight_assistant", flightAssistant)
-      .addNode("hotel_assistant", hotelAssistant)
-      // ...
-    ```
+        ```typescript
+        import { StateGraph, MessagesZodState } from "@langchain/langgraph";
+        const multiAgentGraph = new StateGraph(MessagesZodState)
+          .addNode("flight_assistant", flightAssistant)
+          .addNode("hotel_assistant", hotelAssistant)
+          // ...
+        ```
 
     :::
 
@@ -619,8 +619,7 @@ for await (const chunk of multiAgentGraph.stream({
 3. Name of the agent or node to hand off to.
 4. Take the agent's messages and **add** them to the parent's **state** as part of the handoff. The next agent will see the parent state.
 5. Indicate to LangGraph that we need to navigate to agent node in a **parent** multi-agent graph.
-
-:::
+   :::
 
 !!! Note
 

docs/docs/agents/overview.md

@@ -159,7 +159,7 @@ function generateCodeSnippet({ tools, pre, post, response }) {
   if (post) lines.push("    post_model_hook=post_model_hook,");
   if (response) lines.push("    response_format=ResponseFormat,");
 
-  lines.push(")", "", "# Visualize the graph", "# For Jupyter or GUI environments:", "agent.get_graph().draw_mermaid_png()", "", "# To save PNG to file:", "png_data = agent.get_graph().draw_mermaid_png()", "with open(\"graph.png\", \"wb\") as f:", "    f.write(png_data)", "", "# For terminal/ASCII output:", "agent.get_graph().draw_ascii()");
+  lines.push(")", "", "agent.get_graph().draw_mermaid_png()");
 
   return lines.join("\n");
 }

docs/docs/cloud/deployment/cloud.md

@@ -99,8 +99,8 @@ Starting from the `LangGraph Platform` view...
 1. In the top-right corner, select the gear icon (`Deployment Settings`).
 1. Update the `Git Branch` to the desired branch.
 1. Check/uncheck checkbox to `Automatically update deployment on push to branch`.
-1. Branch creation/deletion and tag creation/deletion events will not trigger an update. Only pushes to an existing branch will trigger an update.
-1. Pushes in quick succession to a branch will queue subsequent updates. Once a build completes, the most recent commit will begin building and the other queued builds will be skipped.
+    1. Branch creation/deletion and tag creation/deletion events will not trigger an update. Only pushes to an existing branch will trigger an update.
+    1. Pushes in quick succession to a branch will not trigger subsequent updates. In the future, this functionality may be changed/improved.
 
 ## Add or Remove GitHub Repositories
 

docs/docs/cloud/deployment/standalone_container.md

@@ -21,6 +21,7 @@ Before deploying, review the [conceptual guide for the Standalone Container](../
 
             `<database_name_1>` and `database_name_2` are different databases within the same instance, but `<hostname_1>` is shared. **The same database cannot be used for separate deployments**.
 
+    1. `LANGSMITH_API_KEY`: (if using [Lite](../../concepts/langgraph_server.md#server-versions)) LangSmith API key. This will be used to authenticate ONCE at server start up.
     1. `LANGGRAPH_CLOUD_LICENSE_KEY`: (if using [Enterprise](../../concepts/langgraph_data_plane.md#licensing)) LangGraph Platform license key. This will be used to authenticate ONCE at server start up.
     1. `LANGSMITH_ENDPOINT`: To send traces to a [self-hosted LangSmith](https://docs.smith.langchain.com/self_hosting) instance, set `LANGSMITH_ENDPOINT` to the hostname of the self-hosted LangSmith instance.
 1. Egress to `https://beacon.langchain.com` from your network. This is required for license verification and usage reporting if not running in air-gapped mode. See the [Egress documentation](../../cloud/deployment/egress.md) for more details.

docs/docs/cloud/reference/cli.md

@@ -483,19 +483,19 @@ The LangGraph CLI requires a JSON configuration file that follows this [schema](
 
     RUN PIP_CONFIG_FILE=/pipconfig.txt PYTHONDONTWRITEBYTECODE=1 pip install --no-cache-dir -c /api/constraints.txt langchain_community langchain_anthropic langchain_openai wikipedia scikit-learn
 
-    ADD ./graphs /deps/outer-graphs/src
+    ADD ./graphs /deps/__outer_graphs/src
     RUN set -ex && \
         for line in '[project]' \
                     'name = "graphs"' \
                     'version = "0.1"' \
                     '[tool.setuptools.package-data]' \
                     '"*" = ["**/*"]'; do \
-            echo "$line" >> /deps/outer-graphs/pyproject.toml; \
+            echo "$line" >> /deps/__outer_graphs/pyproject.toml; \
         done
 
     RUN PIP_CONFIG_FILE=/pipconfig.txt PYTHONDONTWRITEBYTECODE=1 pip install --no-cache-dir -c /api/constraints.txt -e /deps/*
 
-    ENV LANGSERVE_GRAPHS='{"agent": "/deps/outer-graphs/src/agent.py:graph", "storm": "/deps/outer-graphs/src/storm.py:graph"}'
+    ENV LANGSERVE_GRAPHS='{"agent": "/deps/__outer_graphs/src/agent.py:graph", "storm": "/deps/__outer_graphs/src/storm.py:graph"}'
     ```
 
     ???+ note "Updating your langgraph.json file"

docs/docs/cloud/reference/langgraph_server_changelog.md

@@ -1,17 +1,9 @@
 # LangGraph Server Changelog
 
-> **Note:** This changelog is no longer actively maintained. For the most up-to-date LangGraph Server changelog, please visit our new documentation site: [LangGraph Server Changelog](https://docs.langchain.com/langgraph-platform/langgraph-server-changelog#langgraph-server-changelog)
-
 [LangGraph Server](../../concepts/langgraph_server.md) is an API platform for creating and managing agent-based applications. It provides built-in persistence, a task queue, and supports deploying, configuring, and running assistants (agentic workflows) at scale. This changelog documents all notable updates, features, and fixes to LangGraph Server releases.
 
 ---
 
-## v0.2.111 (2025-07-29)
-- Started the heartbeat immediately upon connection to prevent JS graph streaming errors during long startups.
-
-## v0.2.110 (2025-07-29)
-- Added interrupts as default values for all operations except streams to maintain consistent behavior.
-
 ## v0.2.109 (2025-07-28)
 - Fixed an issue where missing config schema occurred when `config_type` was not set.
 

docs/docs/concepts/auth.md

@@ -35,8 +35,7 @@ LangGraph Platform provides different security defaults:
 - Can be customized with your auth handler
 
 !!! note "Custom auth"
-
-   Custom auth **is supported** for all plans in LangGraph Platform.
+Custom auth **is supported** for all plans in LangGraph Platform.
 
 ### Self-Hosted
 
@@ -44,6 +43,11 @@ LangGraph Platform provides different security defaults:
 - Complete flexibility to implement your security model
 - You control all aspects of authentication and authorization
 
+!!! note "Custom auth"
+
+    Custom auth is supported for **Enterprise** self-hosted deployments.
+    Standalone Container (Lite) deployments do not support custom auth natively.
+
 ## System Architecture
 
 A typical authentication setup involves three main components:

docs/docs/concepts/deployment_options.md

@@ -7,7 +7,10 @@ search:
 
 ## Free deployment
 
-[Local](../tutorials/langgraph-platform/local-server.md): Deploy for local testing and development.
+There are two free options for deploying LangGraph applications via the LangGraph Server:
+
+1. [Local](../tutorials/langgraph-platform/local-server.md): Deploy for local testing and development. 
+1. [Standalone Container (Lite)](../concepts/langgraph_standalone_container.md): A limited version of Standalone Container for deployments unlikely to see more than 1 million node executions per year and that do not need crons and other enterprise features. Standalone Container (Lite) deployment option is free with a LangSmith API key.
 
 ## Production deployment
 
@@ -30,7 +33,8 @@ A quick comparison:
 | **CI/CD** | Managed internally by platform | Managed externally by you | Managed externally by you | Managed externally by you |
 | **Data/compute residency** | LangChain's cloud | Your cloud | Your cloud | Your cloud |
 | **LangSmith compatibility** | Trace to LangSmith SaaS | Trace to LangSmith SaaS | Trace to Self-Hosted LangSmith | Optional tracing |
-| **[Pricing](https://www.langchain.com/pricing-langgraph-platform)** | Plus | Enterprise | Enterprise | Enterprise |
+| **[Server version compatibility](../concepts/langgraph_server.md#server-versions)** | Enterprise | Enterprise | Enterprise | Lite, Enterprise |
+| **[Pricing](https://www.langchain.com/pricing-langgraph-platform)** | Plus | Enterprise | Enterprise | Developer |
 
 ## Cloud SaaS
 

docs/docs/concepts/durable_execution.md

@@ -51,51 +51,6 @@ For some examples of pitfalls to avoid, see the [Common Pitfalls](./functional_a
 how to structure your code using **tasks** to avoid these issues. The same principles apply to the @[StateGraph (Graph API)][StateGraph].
 :::
 
-## Durability modes
-
-LangGraph supports three durability modes that allow you to balance performance and data consistency based on your application's requirements. The durability modes, from least to most durable, are as follows:
-
-- [`"exit"`](#exit)
-- [`"async"`](#async)
-- [`"sync"`](#sync)
-
-A higher durability mode add more overhead to the workflow execution.
-
-!!! version-added "Added in v0.6.0"
-
-    Use the `durability` parameter instead of `checkpoint_during` (deprecated in v0.6.0) for persistence policy management:
-    
-    * `durability="async"` replaces `checkpoint_during=True`
-    * `durability="exit"` replaces `checkpoint_during=False`
-    
-    for persistence policy management, with the following mapping:
-
-    * `checkpoint_during=True` -> `durability="async"`
-    * `checkpoint_during=False` -> `durability="exit"`
-
-
-### `"exit"`
-Changes are persisted only when graph execution completes (either successfully or with an error). This provides the best performance for long-running graphs but means intermediate state is not saved, so you cannot recover from mid-execution failures or interrupt the graph execution.
-
-### `"async"`
-Changes are persisted asynchronously while the next step executes. This provides good performance and durability, but there's a small risk that checkpoints might not be written if the process crashes during execution.
-
-### `"sync"`
-Changes are persisted synchronously before the next step starts. This ensures that every checkpoint is written before continuing execution, providing high durability at the cost of some performance overhead.
-
-You can specify the durability mode when calling any graph execution method:
-
-:::python
-
-```python
-graph.stream(
-    {"input": "test"}, 
-    durability="sync"
-)
-```
-
-:::
-
 ## Using tasks in nodes
 
 If a [node](./low_level.md#nodes) contains multiple operations, you may find it easier to convert each operation into a **task** rather than refactor the operations into individual nodes.

docs/docs/concepts/langgraph_server.md

@@ -13,6 +13,21 @@ Use LangGraph Server to create and manage [assistants](assistants.md), [threads]
   
     For detailed information on the API endpoints and data models, see [LangGraph Platform API reference docs](../cloud/reference/api/api_ref.html).
 
+## Server versions
+
+There are two versions of LangGraph Server:
+
+- `Lite` is a limited version of the LangGraph Server that you can run locally or in a self-hosted manner (up to 1 million [nodes executed](../concepts/faq.md#what-does-nodes-executed-mean-for-langgraph-platform-usage) per year).
+- `Enterprise` is the full version of the LangGraph Server. To use the `Enterprise` version, you must acquire a license key that you will need to specify when running the Docker image. To acquire a license key, please email sales@langchain.dev.
+
+Feature Differences:
+
+|       | Lite       | Enterprise |
+|-------|------------|------------|
+| [Cron Jobs](../cloud/concepts/cron_jobs.md) |❌|✅|
+| [Custom Authentication](../concepts/auth.md) |❌|✅|
+| [Deployment options](../concepts/deployment_options.md) | Standalone container | Cloud SaaS, Self-Hosted Data Plane, Self-Hosted Control Plane, Standalone container
+
 ## Application structure
 
 To deploy a LangGraph Server application, you need to specify the graph(s) you want to deploy, as well as any relevant configuration settings, such as dependencies and environment variables.

docs/docs/concepts/langgraph_standalone_container.md

@@ -34,3 +34,12 @@ The Standalone Container deployment option supports deploying data plane infrast
 ### Docker
 
 The Standalone Container deployment option supports deploying data plane infrastructure to any Docker-supported compute platform.
+
+## Lite vs. Enterprise
+
+The Standalone Container deployment option supports both of the [server versions](../concepts/langgraph_server.md#langgraph-server):
+
+- The `Lite` version is free, but has limited features.
+- The `Enterprise` version has custom pricing and is fully featured.
+
+For more details on feature difference, see [LangGraph Server](../concepts/langgraph_server.md#server-versions).

docs/docs/concepts/low_level.md

@@ -88,6 +88,8 @@ Typically, all graph nodes communicate with a single schema. This means that the
 
 It is possible to have nodes write to private state channels inside the graph for internal node communication. We can simply define a private schema, `PrivateState`.
 
+See [this guide](../how-tos/graph-api.ipynb#pass-private-state-between-nodes) for more detail.
+
 It is also possible to define explicit input and output schemas for a graph. In these cases, we define an "internal" schema that contains _all_ keys relevant to graph operations. But, we also define `input` and `output` schemas that are sub-sets of the "internal" schema to constrain the input and output of the graph. See [this guide](../how-tos/graph-api.md#define-input-and-output-schemas) for more detail.
 
 Let's look at an example:
@@ -471,7 +473,7 @@ const builder = new StateGraph(State);
 
 :::
 
-Behind the scenes, functions are converted to [RunnableLambda](https://python.langchain.com/api_reference/core/runnables/langchain_core.runnables.base.RunnableLambda.html)s, which add batch and async support to your function, along with native tracing and debugging.
+Behind the scenes, functions are converted to [RunnableLambda](https://api.python.langchain.com/en/latest/runnables/langchain_core.runnables.base.RunnableLambda.html#langchain_core.runnables.base.RunnableLambda)s, which add batch and async support to your function, along with native tracing and debugging.
 
 If you add a node to a graph without specifying a name, it will be given a default name equivalent to the function name.
 
@@ -699,8 +701,7 @@ graph.addConditionalEdges("nodeA", routingFunction, {
 :::
 
 !!! tip
-
-    Use [`Command`](#command) instead of conditional edges if you want to combine state updates and routing in a single function.
+Use [`Command`](#command) instead of conditional edges if you want to combine state updates and routing in a single function.
 
 ### Entry Point
 
@@ -819,6 +820,7 @@ def my_node(state: State) -> Command[Literal["my_other_node"]]:
         return Command(update={"foo": "baz"}, goto="my_other_node")
 ```
 
+Check out this [how-to guide](../how-tos/graph-api.ipynb#combine-control-flow-and-state-updates-with-command) for an end-to-end example of how to use `Command`.
 :::
 
 :::js
@@ -858,6 +860,7 @@ builder.addNode("myNode", myNode, {
 });
 ```
 
+Check out this [how-to guide](../how-tos/graph-api.ipynb#combine-control-flow-and-state-updates-with-command) for an end-to-end example of how to use `Command`.
 :::
 
 !!! important
@@ -1040,7 +1043,7 @@ def node_a(state: State, runtime: Runtime[ContextSchema]):
     ...
 ```
 
-See [this guide](../how-tos/graph-api.md#add-runtime-configuration) for a full breakdown on configuration.
+See [this guide](../how-tos/graph-api.ipynb#add-runtime-configuration) for a full breakdown on configuration.
 :::
 
 :::js

docs/docs/concepts/mcp.md

@@ -6,14 +6,52 @@
 
 Install the `langchain-mcp-adapters` library to use MCP tools in LangGraph:
 
-:::python
 ```bash
 pip install langchain-mcp-adapters
 ```
-:::
 
-:::js
-```bash
-npm install @langchain/mcp-adapters
+## Authenticate to an MCP server
+
+You can set up [custom authentication middleware](../how-tos/auth/custom_auth.md) to authenticate a user with an MCP server to get access to user-scoped tools within your LangGraph Platform deployment.
+
+!!! note
+
+    Custom authentication is a LangGraph Platform feature.
+
+An example architecture for this flow:
+
+```mermaid
+sequenceDiagram
+  %% Actors
+  participant ClientApp as Client
+  participant AuthProv  as Auth Provider
+  participant LangGraph as LangGraph Backend
+  participant SecretStore as Secret Store
+  participant MCPServer as MCP Server
+
+  %% Platform login / AuthN
+  ClientApp  ->> AuthProv: 1. Login (username / password)
+  AuthProv   -->> ClientApp: 2. Return token
+  ClientApp  ->> LangGraph: 3. Request with token
+
+  Note over LangGraph: 4. Validate token (@auth.authenticate)
+  LangGraph  -->> AuthProv: 5. Fetch user info
+  AuthProv   -->> LangGraph: 6. Confirm validity
+
+  %% Fetch user tokens from secret store
+  LangGraph  ->> SecretStore: 6a. Fetch user tokens
+  SecretStore -->> LangGraph: 6b. Return tokens
+
+  Note over LangGraph: 7. Apply access control (@auth.on.*)
+
+  %% MCP round-trip
+  Note over LangGraph: 8. Build MCP client with user token
+  LangGraph  ->> MCPServer: 9. Call MCP tool (with header)
+  Note over MCPServer: 10. MCP validates header and runs tool
+  MCPServer  -->> LangGraph: 11. Tool response
+
+  %% Return to caller
+  LangGraph  -->> ClientApp: 12. Return resources / tool output
 ```
-:::
+
+For more information, see [MCP endpoint in LangGraph Server](../concepts/server-mcp.md).

docs/docs/concepts/memory.md

@@ -134,7 +134,7 @@ def update_instructions(state: State, store: BaseStore):
     namespace = ("instructions",)
     current_instructions = store.search(namespace)[0]
     # Memory logic
-    prompt = prompt_template.format(instructions=current_instructions.value["instructions"], conversation=state["messages"])
+    prompt = prompt_template.format(instructions=instructions.value["instructions"], conversation=state["messages"])
     output = llm.invoke(prompt)
     new_instructions = output['new_instructions']
     store.put(("agent_instructions",), "agent_a", {"instructions": new_instructions})
@@ -278,4 +278,4 @@ const items = await store.search(
 ```
 :::
 
-For more information about the memory store, see the [Persistence](persistence.md#memory-store) guide.
+For more information about the memory store, see the [Persistence](persistence.md#memory-store) guide.

docs/docs/concepts/multi_agent.md

@@ -897,5 +897,5 @@ There are two high-level approaches to achieve that:
 
 An agent might need to have a different state schema from the rest of the agents. For example, a search agent might only need to keep track of queries and retrieved documents. There are two ways to achieve this in LangGraph:
 
-- Define [subgraph](./subgraphs.md) agents with a separate state schema. If there are no shared state keys (channels) between the subgraph and the parent graph, it's important to [add input / output transformations](../how-tos/subgraph.md#different-state-schemas) so that the parent graph knows how to communicate with the subgraphs.
-- Define agent node functions with a [private input state schema](../how-tos/graph-api.md#pass-private-state-between-nodes) that is distinct from the overall graph state schema. This allows passing information that is only needed for executing that particular agent.
+- Define [subgraph](./subgraphs.md) agents with a separate state schema. If there are no shared state keys (channels) between the subgraph and the parent graph, it's important to [add input / output transformations](../how-tos/subgraph.ipynb#different-state-schemas) so that the parent graph knows how to communicate with the subgraphs.
+- Define agent node functions with a [private input state schema](../how-tos/graph-api.ipynb#pass-private-state-between-nodes) that is distinct from the overall graph state schema. This allows passing information that is only needed for executing that particular agent.

docs/docs/concepts/persistence.md

@@ -315,8 +315,7 @@ In our example, the output of `get_state_history` will look like this:
         tasks=(),
     ),
     StateSnapshot(
-        values={'foo': 'a', 'bar': ['a']},
-        next=('node_b',),
+        values={'foo': 'a', 'bar': ['a']}, next=('node_b',),
         config={'configurable': {'thread_id': '1', 'checkpoint_ns': '', 'checkpoint_id': '1ef663ba-28f9-6ec4-8001-31981c2c39f8'}},
         metadata={'source': 'loop', 'writes': {'node_a': {'foo': 'a', 'bar': ['a']}}, 'step': 1},
         created_at='2024-08-29T19:19:38.819946+00:00',

docs/docs/concepts/plans.md

@@ -10,17 +10,17 @@ search:
 LangGraph Platform is a solution for deploying agentic applications in production.
 There are three different plans for using it.
 
-- **Developer**: All [LangSmith](https://smith.langchain.com/) users have access to this plan. You can sign up for this plan simply by creating a LangSmith account. This gives you access to the [local deployment](./deployment_options.md#free-deployment) option.
+- **Developer**: All [LangSmith](https://smith.langchain.com/) users have access to this plan. You can sign up for this plan simply by creating a LangSmith account. This gives you access to the [Standalone Container (Lite)](./deployment_options.md) deployment option.
 - **Plus**: All [LangSmith](https://smith.langchain.com/) users with a [Plus account](https://docs.smith.langchain.com/administration/pricing) have access to this plan. You can sign up for this plan simply by upgrading your LangSmith account to the Plus plan type. This gives you access to the [Cloud](./deployment_options.md#cloud-saas) deployment option.
-- **Enterprise**: This is separate from LangSmith plans. You can sign up for this plan by [contacting our sales team](https://www.langchain.com/contact-sales). This gives you access to all [deployment options](./deployment_options.md).
+- **Enterprise**: This is separate from LangSmith plans. You can sign up for this plan by contacting sales@langchain.dev. This gives you access to all [deployment options](./deployment_options.md).
 
 
 ## Plan Details
 
 |                                                                  | Developer                                   | Plus                                                  | Enterprise                                          |
 |------------------------------------------------------------------|---------------------------------------------|-------------------------------------------------------|-----------------------------------------------------|
-| Deployment Options                                               | Local                          | Cloud SaaS                                         | <ul><li>Cloud SaaS</li><li>Self-Hosted Data Plane</li><li>Self-Hosted Control Plane</li><li>Standalone Container</li></ul> |
-| Usage                                                            | Free | See [Pricing](https://www.langchain.com/langgraph-platform-pricing) | Custom                                              |
+| Deployment Options                                               | Standalone Container (Lite)                          | Cloud SaaS                                         | <ul><li>Cloud SaaS</li><li>Self-Hosted Data Plane</li><li>Self-Hosted Control Plane</li><li>Standalone Container (Enterprise)</li></ul> |
+| Usage                                                            | Free, limited to 1M [nodes executed](../concepts/faq.md#what-does-nodes-executed-mean-for-langgraph-platform-usage) per year | See [Pricing](https://www.langchain.com/langgraph-platform-pricing) | Custom                                              |
 | APIs for retrieving and updating state and conversational history | ✅                                           | ✅                                                     | ✅                                                   |
 | APIs for retrieving and updating long-term memory                | ✅                                           | ✅                                                     | ✅                                                   |
 | Horizontally scalable task queues and servers                    | ✅                                           | ✅                                                     | ✅                                                   |

docs/docs/examples/index.md

@@ -9,4 +9,15 @@ The pages in this section provide end-to-end examples for the following topics:
 - [Agent Supervisor](../tutorials/multi_agent/agent_supervisor.md): Build a supervisor agent that can manage a team of agents.
 - [SQL agent](../tutorials/sql/sql-agent.md): Build a SQL agent that can execute SQL queries and return the results.
 - [Prebuilt chat UI](../agents/ui.md): Use a prebuilt chat UI to interact with any LangGraph agent.
-- [Graph runs in LangSmith](../how-tos/run-id-langsmith.md): Use LangSmith to track and analyze graph runs.
+- [Graph runs in LangSmith](../how-tos/run-id-langsmith.md): Use LangSmith to track and analyze graph runs.
+
+## LangGraph Platform
+
+- [Set up custom authentication](../tutorials/auth/getting_started.md): Set up custom authentication for your LangGraph application.
+- [Make conversations private](../tutorials/auth/resource_auth.md): Make conversations private by using resource-based authentication.
+- [Connect an authentication provider](../tutorials/auth/add_auth_server.md): Connect an authentication provider to your LangGraph application.
+- [Rebuild graph at runtime](../cloud/deployment/graph_rebuild.md): Rebuild a graph at runtime.
+- [Use RemoteGraph](../how-tos/use-remote-graph.md): Use RemoteGraph to deploy your LangGraph application to a remote server.
+- [Deploy CrewAI, AutoGen, and other frameworks](../how-tos/autogen-integration.md): Deploy CrewAI, AutoGen, and other frameworks with LangGraph.
+- [Integrate LangGraph into a React app](../cloud/how-tos/use_stream_react.md)
+- [Implement Generative User Interfaces with LangGraph](../cloud/how-tos/generative_ui_react.md)

docs/docs/guides/index.md

@@ -31,3 +31,15 @@ These capabilities are available in both LangGraph OSS and the LangGraph Platfor
 - [MCP](../concepts/mcp.md): Use MCP servers in a LangGraph graph.
 - [Evaluation](../agents/evals.md): Use LangSmith to evaluate your graph's performance.
 
+## Platform-only capabilities
+
+These capabilities are only available in [LangGraph Platform](../concepts/langgraph_platform.md).
+
+- [Authentication and access control](../concepts/auth.md): Authenticate and authorize users to access a LangGraph graph.
+- [Assistants](../concepts/assistants.md): Build assistants that can be used to interact with a LangGraph graph.
+- [Double-texting](../concepts/double_texting.md): Handle double-texting (consecutive messages before a first response is returned) in a LangGraph graph.
+- [Webhooks](../cloud/concepts/webhooks.md): Send webhooks to a LangGraph graph.
+- [Cron jobs](../cloud/concepts/cron_jobs.md): Schedule jobs to run at a specific time.
+- [Server customization](../how-tos/http/custom_lifespan.md): Customize the server that runs a LangGraph graph.
+- [Data management](../cloud/concepts/data_storage_and_privacy.md): Manage data in a LangGraph graph.
+- [Deployment](../concepts/deployment_options.md): Deploy a LangGraph graph to a server.

docs/docs/how-tos/auth/custom_auth.md

@@ -11,13 +11,13 @@
 
 ???+ note "Support by deployment type"
 
-    Custom auth is supported for all deployments in the **managed LangGraph Platform**, as well as **Enterprise** self-hosted plans.
+    Custom auth is supported for all deployments in the **managed LangGraph Platform**, as well as **Enterprise** self-hosted plans. It is not supported for **Lite** self-hosted plans.
 
 This guide shows how to add custom authentication to your LangGraph Platform application. This guide applies to both LangGraph Platform and self-hosted deployments. It does not apply to isolated usage of the LangGraph open source library in your own custom server.
 
 !!! note
 
-    Custom auth is supported for all **managed LangGraph Platform** deployments, as well as **Enterprise** self-hosted plans.
+    Custom auth is supported for all **managed LangGraph Platform** deployments, as well as **Enterprise** self-hosted plans. It is not supported for **Lite** self-hosted plans.
 
 ## Add custom authentication to your deployment
 
@@ -145,7 +145,7 @@ def my_node(state, config):
 By default, if you add custom authorization on your resources, this will also apply to interactions made from the Studio. If you want, you can handle logged-in Studio users differently by checking [is_studio_user()](../../reference/functions/sdk_auth.isStudioUser.html).
 
 !!! note
-    `is_studio_user` was added in version 0.1.73 of the langgraph-sdk. If you're on an older version, you can still check whether `isinstance(ctx.user, StudioUser)`.
+`is_studio_user` was added in version 0.1.73 of the langgraph-sdk. If you're on an older version, you can still check whether `isinstance(ctx.user, StudioUser)`.
 
 ```python
 from langgraph_sdk.auth import is_studio_user, Auth

docs/docs/how-tos/human_in_the_loop/add-human-in-the-loop.md

@@ -366,8 +366,8 @@ result = graph.invoke(
 
 # Resume with mapping of interrupt IDs to values
 resume_map = {
-    i.id: f"edited text for {i.value['text_to_revise']}"
-    for i in graph.get_state(config).interrupts
+    i.interrupt_id: f"human input for prompt {i.value}"
+    for i in parent.get_state(thread_config).interrupts
 }
 print(graph.invoke(Command(resume=resume_map), config=config))
 # > {'text_1': 'edited text for original text 1', 'text_2': 'edited text for original text 2'}

docs/docs/how-tos/memory/add-memory.md

@@ -1436,7 +1436,6 @@ await agent.invoke(
 from typing_extensions import TypedDict
 
 from langgraph.config import get_store
-from langchain_core.runnables import RunnableConfig
 from langgraph.prebuilt import create_react_agent
 from langgraph.store.memory import InMemoryStore
 
@@ -2798,6 +2797,4 @@ await checkpointer.deleteThread(threadId);
 ## Prebuilt memory tools
 
 **LangMem** is a LangChain-maintained library that offers tools for managing long-term memories in your agent. See the [LangMem documentation](https://langchain-ai.github.io/langmem/) for usage examples.
-
 :::
-

docs/docs/how-tos/multi_agent.md

@@ -22,7 +22,6 @@ To set up communication between the agents in a multi-agent system you can use [
 
 To implement handoffs, you can return `Command` objects from your agent nodes or tools:
 
-:::python
 ```python
 from typing import Annotated
 from langchain_core.tools import tool, InjectedToolCallId
@@ -58,7 +57,7 @@ def create_handoff_tool(*, agent_name: str, description: str | None = None):
     return handoff_tool
 ```
 
-1. Access the [state](../concepts/low_level.md#state) of the agent that is calling the handoff tool using the @[InjectedState] annotation. 
+1. Access the [state](../concepts/low_level.md#state) of the agent that is calling the handoff tool using the @[InjectedState][InjectedState] annotation. 
 2. The `Command` primitive allows specifying a state update and a node transition as a single operation, making it useful for implementing handoffs.
 3. Name of the agent or node to hand off to.
 4. Take the agent's messages and **add** them to the parent's **state** as part of the handoff. The next agent will see the parent state.
@@ -74,109 +73,25 @@ def create_handoff_tool(*, agent_name: str, description: str | None = None):
         commands = [tools_by_name[tool_call["name"]].invoke(tool_call) for tool_call in tool_calls]
         return commands
     ```
-:::
-
-:::js
-```typescript
-import { tool } from "@langchain/core/tools";
-import { Command, MessagesZodState } from "@langchain/langgraph";
-import { z } from "zod";
-
-function createHandoffTool({
-  agentName,
-  description,
-}: {
-  agentName: string;
-  description?: string;
-}) {
-  const name = `transfer_to_${agentName}`;
-  const toolDescription = description || `Transfer to ${agentName}`;
-
-  return tool(
-    async (_, config) => {
-      // (1)!
-      const state = config.state;
-      const toolCallId = config.toolCall.id;
-
-      const toolMessage = {
-        role: "tool" as const,
-        content: `Successfully transferred to ${agentName}`,
-        name: name,
-        tool_call_id: toolCallId,
-      };
-
-      return new Command({
-        // (3)!
-        goto: agentName,
-        // (4)!
-        update: { messages: [...state.messages, toolMessage] },
-        // (5)!
-        graph: Command.PARENT,
-      });
-    },
-    {
-      name,
-      description: toolDescription,
-      schema: z.object({}),
-    }
-  );
-}
-```
-
-1. Access the [state](../concepts/low_level.md#state) of the agent that is calling the handoff tool through the `config` parameter.
-2. The `Command` primitive allows specifying a state update and a node transition as a single operation, making it useful for implementing handoffs.
-3. Name of the agent or node to hand off to.
-4. Take the agent's messages and **add** them to the parent's **state** as part of the handoff. The next agent will see the parent state.
-5. Indicate to LangGraph that we need to navigate to agent node in a **parent** multi-agent graph.
-
-!!! tip
-
-    If you want to use tools that return `Command`, you can either use prebuilt @[`create_react_agent`][create_react_agent] / @[`ToolNode`][ToolNode] components, or implement your own tool-executing node that collects `Command` objects returned by the tools and returns a list of them, e.g.:
-    
-    ```typescript
-    const callTools = async (state) => {
-      // ...
-      const commands = await Promise.all(
-        toolCalls.map(toolCall => toolsByName[toolCall.name].invoke(toolCall))
-      );
-      return commands;
-    };
-    ```
-:::
 
 !!! Important
 
     This handoff implementation assumes that:
     
-    - each agent receives overall message history (across all agents) in the multi-agent system as its input. If you want more control over agent inputs, see [this section](#control-agent-inputs)
-    - each agent outputs its internal messages history to the overall message history of the multi-agent system. If you want more control over **how agent outputs are added**, wrap the agent in a separate node function:
+      - each agent receives overall message history (across all agents) in the multi-agent system as its input. If you want more control over agent inputs, see [this section](#control-agent-inputs)
+      - each agent outputs its internal messages history to the overall message history of the multi-agent system. If you want more control over **how agent outputs are added**, wrap the agent in a separate node function:
 
-      :::python
-      ```python
-      def call_hotel_assistant(state):
-          # return agent's final response,
-          # excluding inner monologue
-          response = hotel_assistant.invoke(state)
-          # highlight-next-line
-          return {"messages": response["messages"][-1]}
-      ```
-      :::
-
-      :::js
-      ```typescript
-      const callHotelAssistant = async (state) => {
-        // return agent's final response,
-        // excluding inner monologue
-        const response = await hotelAssistant.invoke(state);
-        // highlight-next-line
-        return { messages: [response.messages.at(-1)] };
-      };
-      ```
-      :::
+        ```python
+        def call_hotel_assistant(state):
+            # return agent's final response,
+            # excluding inner monologue
+            response = hotel_assistant.invoke(state)
+            # highlight-next-line
+            return {"messages": response["messages"][-1]}
+        ```
 
 ### Control agent inputs
 
-:::python
 You can use the @[`Send()`][Send] primitive to directly send data to the worker agents during the handoff. For example, you can request that the calling agent populate a task description for the next agent:
 
 ```python
@@ -214,63 +129,6 @@ def create_task_description_handoff_tool(
 
     return handoff_tool
 ```
-:::
-
-:::js
-You can use the @[`Send()`][Send] primitive to directly send data to the worker agents during the handoff. For example, you can request that the calling agent populate a task description for the next agent:
-
-```typescript
-import { tool } from "@langchain/core/tools";
-import { Command, Send, MessagesZodState } from "@langchain/langgraph";
-import { z } from "zod";
-
-function createTaskDescriptionHandoffTool({
-  agentName,
-  description,
-}: {
-  agentName: string;
-  description?: string;
-}) {
-  const name = `transfer_to_${agentName}`;
-  const toolDescription = description || `Ask ${agentName} for help.`;
-
-  return tool(
-    async (
-      { taskDescription },
-      config
-    ) => {
-      const state = config.state;
-      
-      const taskDescriptionMessage = {
-        role: "user" as const,
-        content: taskDescription,
-      };
-      const agentInput = {
-        ...state,
-        messages: [taskDescriptionMessage],
-      };
-      
-      return new Command({
-        // highlight-next-line
-        goto: [new Send(agentName, agentInput)],
-        graph: Command.PARENT,
-      });
-    },
-    {
-      name,
-      description: toolDescription,
-      schema: z.object({
-        taskDescription: z
-          .string()
-          .describe(
-            "Description of what the next agent should do, including all of the relevant context."
-          ),
-      }),
-    }
-  );
-}
-```
-:::
 
 See the multi-agent [supervisor](../tutorials/multi_agent/agent_supervisor.md#4-create-delegation-tasks) example for a full example of using @[`Send()`][Send] in handoffs.
 
@@ -278,7 +136,6 @@ See the multi-agent [supervisor](../tutorials/multi_agent/agent_supervisor.md#4-
 
 You can use handoffs in any agents built with LangGraph. We recommend using the prebuilt [agent](../agents/overview.md) or [`ToolNode`](./tool-calling.md#toolnode), as they natively support handoffs tools returning `Command`. Below is an example of how you can implement a multi-agent system for booking travel using handoffs:
 
-:::python
 ```python
 from langgraph.prebuilt import create_react_agent
 from langgraph.graph import StateGraph, START, MessagesState
@@ -319,65 +176,9 @@ multi_agent_graph = (
     .compile()
 )
 ```
-:::
-
-:::js
-```typescript
-import { createReactAgent } from "@langchain/langgraph/prebuilt";
-import { StateGraph, START, MessagesZodState } from "@langchain/langgraph";
-import { z } from "zod";
-
-function createHandoffTool({
-  agentName,
-  description,
-}: {
-  agentName: string;
-  description?: string;
-}) {
-  // same implementation as above
-  // ...
-  return new Command(/* ... */);
-}
-
-// Handoffs
-const transferToHotelAssistant = createHandoffTool({
-  agentName: "hotel_assistant",
-});
-const transferToFlightAssistant = createHandoffTool({
-  agentName: "flight_assistant",
-});
-
-// Define agents
-const flightAssistant = createReactAgent({
-  llm: model,
-  // highlight-next-line
-  tools: [/* ... */, transferToHotelAssistant],
-  // highlight-next-line
-  name: "flight_assistant",
-});
-
-const hotelAssistant = createReactAgent({
-  llm: model,
-  // highlight-next-line
-  tools: [/* ... */, transferToFlightAssistant],
-  // highlight-next-line
-  name: "hotel_assistant",
-});
-
-// Define multi-agent graph
-const multiAgentGraph = new StateGraph(MessagesZodState)
-  // highlight-next-line
-  .addNode("flight_assistant", flightAssistant)
-  // highlight-next-line
-  .addNode("hotel_assistant", hotelAssistant)
-  .addEdge(START, "flight_assistant")
-  .compile();
-```
-:::
 
 ??? example "Full example: Multi-agent system for booking travel"
 
-    :::python
     ```python
     from typing import Annotated
     from langchain_core.messages import convert_to_messages
@@ -522,183 +323,6 @@ const multiAgentGraph = new StateGraph(MessagesZodState)
     3. Name of the agent or node to hand off to.
     4. Take the agent's messages and **add** them to the parent's **state** as part of the handoff. The next agent will see the parent state.
     5. Indicate to LangGraph that we need to navigate to agent node in a **parent** multi-agent graph.
-    :::
-
-    :::js
-    ```typescript
-    import { tool } from "@langchain/core/tools";
-    import { createReactAgent } from "@langchain/langgraph/prebuilt";
-    import { StateGraph, START, MessagesZodState, Command } from "@langchain/langgraph";
-    import { ChatAnthropic } from "@langchain/anthropic";
-    import { isBaseMessage } from "@langchain/core/messages";
-    import { z } from "zod";
-
-    // We'll use a helper to render the streamed agent outputs nicely
-    const prettyPrintMessages = (update: Record<string, any>) => {
-      // Handle tuple case with namespace
-      if (Array.isArray(update)) {
-        const [ns, updateData] = update;
-        // Skip parent graph updates in the printouts
-        if (ns.length === 0) {
-          return;
-        }
-
-        const graphId = ns[ns.length - 1].split(":")[0];
-        console.log(`Update from subgraph ${graphId}:\n`);
-        update = updateData;
-      }
-
-      for (const [nodeName, updateValue] of Object.entries(update)) {
-        console.log(`Update from node ${nodeName}:\n`);
-
-        const messages = updateValue.messages || [];
-        for (const message of messages) {
-          if (isBaseMessage(message)) {
-            const textContent =
-              typeof message.content === "string"
-                ? message.content
-                : JSON.stringify(message.content);
-            console.log(`${message.getType()}: ${textContent}`);
-          }
-        }
-        console.log("\n");
-      }
-    };
-
-    function createHandoffTool({
-      agentName,
-      description,
-    }: {
-      agentName: string;
-      description?: string;
-    }) {
-      const name = `transfer_to_${agentName}`;
-      const toolDescription = description || `Transfer to ${agentName}`;
-
-      return tool(
-        async (_, config) => {
-          // highlight-next-line
-          const state = config.state; // (1)!
-          const toolCallId = config.toolCall.id;
-
-          const toolMessage = {
-            role: "tool" as const,
-            content: `Successfully transferred to ${agentName}`,
-            name: name,
-            tool_call_id: toolCallId,
-          };
-
-          return new Command({
-            // highlight-next-line
-            goto: agentName, // (3)!
-            // highlight-next-line
-            update: { messages: [...state.messages, toolMessage] }, // (4)!
-            // highlight-next-line
-            graph: Command.PARENT, // (5)!
-          });
-        },
-        {
-          name,
-          description: toolDescription,
-          schema: z.object({}),
-        }
-      );
-    }
-
-    // Handoffs
-    const transferToHotelAssistant = createHandoffTool({
-      agentName: "hotel_assistant",
-      description: "Transfer user to the hotel-booking assistant.",
-    });
-
-    const transferToFlightAssistant = createHandoffTool({
-      agentName: "flight_assistant",
-      description: "Transfer user to the flight-booking assistant.",
-    });
-
-    // Simple agent tools
-    const bookHotel = tool(
-      async ({ hotelName }) => {
-        return `Successfully booked a stay at ${hotelName}.`;
-      },
-      {
-        name: "book_hotel",
-        description: "Book a hotel",
-        schema: z.object({
-          hotelName: z.string(),
-        }),
-      }
-    );
-
-    const bookFlight = tool(
-      async ({ fromAirport, toAirport }) => {
-        return `Successfully booked a flight from ${fromAirport} to ${toAirport}.`;
-      },
-      {
-        name: "book_flight",
-        description: "Book a flight",
-        schema: z.object({
-          fromAirport: z.string(),
-          toAirport: z.string(),
-        }),
-      }
-    );
-
-    const model = new ChatAnthropic({
-      model: "claude-3-5-sonnet-latest",
-    });
-
-    // Define agents
-    const flightAssistant = createReactAgent({
-      llm: model,
-      // highlight-next-line
-      tools: [bookFlight, transferToHotelAssistant],
-      prompt: "You are a flight booking assistant",
-      // highlight-next-line
-      name: "flight_assistant",
-    });
-
-    const hotelAssistant = createReactAgent({
-      llm: model,
-      // highlight-next-line
-      tools: [bookHotel, transferToFlightAssistant],
-      prompt: "You are a hotel booking assistant",
-      // highlight-next-line
-      name: "hotel_assistant",
-    });
-
-    // Define multi-agent graph
-    const multiAgentGraph = new StateGraph(MessagesZodState)
-      .addNode("flight_assistant", flightAssistant)
-      .addNode("hotel_assistant", hotelAssistant)
-      .addEdge(START, "flight_assistant")
-      .compile();
-
-    // Run the multi-agent graph
-    const stream = await multiAgentGraph.stream(
-      {
-        messages: [
-          {
-            role: "user",
-            content: "book a flight from BOS to JFK and a stay at McKittrick Hotel",
-          },
-        ],
-      },
-      // highlight-next-line
-      { subgraphs: true }
-    );
-
-    for await (const chunk of stream) {
-      prettyPrintMessages(chunk);
-    }
-    ```
-
-    1. Access agent's state
-    2. The `Command` primitive allows specifying a state update and a node transition as a single operation, making it useful for implementing handoffs.
-    3. Name of the agent or node to hand off to.
-    4. Take the agent's messages and **add** them to the parent's **state** as part of the handoff. The next agent will see the parent state.
-    5. Indicate to LangGraph that we need to navigate to agent node in a **parent** multi-agent graph.
-    :::
 
 ## Multi-turn conversation
 
@@ -709,7 +333,6 @@ The agents can then be implemented as nodes in a graph that executes agent steps
 1. **Wait for user input** to continue the conversation, or  
 2. **Route to another agent** (or back to itself, such as in a loop) via a [handoff](#handoffs)
 
-:::python
 ```python
 def human(state) -> Command[Literal["agent", "another_agent"]]:
     """A node for collecting user input."""
@@ -737,44 +360,6 @@ def agent(state) -> Command[Literal["agent", "another_agent", "human"]]:
     else:
         return Command(goto="human") # Go to human node
 ```
-:::
-
-:::js
-```typescript
-import { interrupt, Command } from "@langchain/langgraph";
-
-function human(state: MessagesState): Command {
-  const userInput: string = interrupt("Ready for user input.");
-
-  // Determine the active agent
-  const activeAgent = /* ... */;
-
-  return new Command({
-    update: {
-      messages: [{
-        role: "human",
-        content: userInput,
-      }]
-    },
-    goto: activeAgent,
-  });
-}
-
-function agent(state: MessagesState): Command {
-  // The condition for routing/halting can be anything, e.g. LLM tool call / structured output, etc.
-  const goto = getNextAgent(/* ... */); // 'agent' / 'anotherAgent'
-
-  if (goto) {
-    return new Command({
-      goto,
-      update: { myStateKey: "myStateValue" }
-    });
-  }
-
-  return new Command({ goto: "human" });
-}
-```
-:::
 
 ??? example "Full example: multi-agent system for travel recommendations"
 
@@ -785,7 +370,6 @@ function agent(state: MessagesState): Command {
     * travel_advisor: can help with travel destination recommendations. Can ask hotel_advisor for help.
     * hotel_advisor: can help with hotel recommendations. Can ask travel_advisor for help.
 
-    :::python
     ```python
     from langchain_anthropic import ChatAnthropic
     from langgraph.graph import MessagesState, StateGraph, START
@@ -987,267 +571,10 @@ function agent(state: MessagesState): Command {
     
     Would you like more specific information about any of these activities or would you like to know about other options in the area?
     ```
-    :::
-
-    :::js
-    ```typescript
-    import { ChatAnthropic } from "@langchain/anthropic";
-    import { StateGraph, START, MessagesZodState, Command, interrupt, MemorySaver } from "@langchain/langgraph";
-    import { createReactAgent } from "@langchain/langgraph/prebuilt";
-    import { tool } from "@langchain/core/tools";
-    import { z } from "zod";
-
-    const model = new ChatAnthropic({ model: "claude-3-5-sonnet-latest" });
-
-    const MultiAgentState = MessagesZodState.extend({
-      lastActiveAgent: z.string().optional(),
-    });
-
-    // Define travel advisor tools
-    const getTravelRecommendations = tool(
-      async () => {
-        // Placeholder implementation
-        return "Based on current trends, I recommend visiting Japan, Portugal, or New Zealand.";
-      },
-      {
-        name: "get_travel_recommendations",
-        description: "Get current travel destination recommendations",
-        schema: z.object({}),
-      }
-    );
-
-    const makeHandoffTool = (agentName: string) => {
-      return tool(
-        async (_, config) => {
-          const state = config.state;
-          const toolCallId = config.toolCall.id;
-
-          const toolMessage = {
-            role: "tool" as const,
-            content: `Successfully transferred to ${agentName}`,
-            name: `transfer_to_${agentName}`,
-            tool_call_id: toolCallId,
-          };
-
-          return new Command({
-            goto: agentName,
-            update: { messages: [...state.messages, toolMessage] },
-            graph: Command.PARENT,
-          });
-        },
-        {
-          name: `transfer_to_${agentName}`,
-          description: `Transfer to ${agentName}`,
-          schema: z.object({}),
-        }
-      );
-    };
-
-    const travelAdvisorTools = [
-      getTravelRecommendations,
-      makeHandoffTool("hotel_advisor"),
-    ];
-
-    const travelAdvisor = createReactAgent({
-      llm: model,
-      tools: travelAdvisorTools,
-      prompt: [
-        "You are a general travel expert that can recommend travel destinations (e.g. countries, cities, etc). ",
-        "If you need hotel recommendations, ask 'hotel_advisor' for help. ",
-        "You MUST include human-readable response before transferring to another agent."
-      ].join("")
-    });
-
-    const callTravelAdvisor = async (
-      state: z.infer<typeof MultiAgentState>
-    ): Promise<Command> => {
-      const response = await travelAdvisor.invoke(state);
-      const update = { ...response, lastActiveAgent: "travel_advisor" };
-      return new Command({ update, goto: "human" });
-    };
-
-    // Define hotel advisor tools
-    const getHotelRecommendations = tool(
-      async () => {
-        // Placeholder implementation
-        return "I recommend the Ritz-Carlton for luxury stays or boutique hotels for unique experiences.";
-      },
-      {
-        name: "get_hotel_recommendations",
-        description: "Get hotel recommendations for destinations",
-        schema: z.object({}),
-      }
-    );
-
-    const hotelAdvisorTools = [
-      getHotelRecommendations,
-      makeHandoffTool("travel_advisor"),
-    ];
-
-    const hotelAdvisor = createReactAgent({
-      llm: model,
-      tools: hotelAdvisorTools,
-      prompt: [
-        "You are a hotel expert that can provide hotel recommendations for a given destination. ",
-        "If you need help picking travel destinations, ask 'travel_advisor' for help.",
-        "You MUST include human-readable response before transferring to another agent."
-      ].join("")
-    });
-
-    const callHotelAdvisor = async (
-      state: z.infer<typeof MultiAgentState>
-    ): Promise<Command> => {
-      const response = await hotelAdvisor.invoke(state);
-      const update = { ...response, lastActiveAgent: "hotel_advisor" };
-      return new Command({ update, goto: "human" });
-    };
-
-    const humanNode = async (
-      state: z.infer<typeof MultiAgentState>
-    ): Promise<Command> => {
-      const userInput: string = interrupt("Ready for user input.");
-      const activeAgent = state.lastActiveAgent || "travel_advisor";
-
-      return new Command({
-        update: {
-          messages: [
-            {
-              role: "human",
-              content: userInput,
-            }
-          ]
-        },
-        goto: activeAgent,
-      });
-    };
-
-    const builder = new StateGraph(MultiAgentState)
-      .addNode("travel_advisor", callTravelAdvisor)
-      .addNode("hotel_advisor", callHotelAdvisor)
-      .addNode("human", humanNode)
-      .addEdge(START, "travel_advisor");
-
-    const checkpointer = new MemorySaver();
-    const graph = builder.compile({ checkpointer });
-    ```
-    
-    Let's test a multi turn conversation with this application.
-
-    ```typescript
-    import { v4 as uuidv4 } from "uuid";
-    import { Command } from "@langchain/langgraph";
-
-    const threadConfig = { configurable: { thread_id: uuidv4() } };
-
-    const inputs = [
-      // 1st round of conversation
-      {
-        messages: [
-          { role: "user", content: "i wanna go somewhere warm in the caribbean" }
-        ]
-      },
-      // Since we're using `interrupt`, we'll need to resume using the Command primitive.
-      // 2nd round of conversation
-      new Command({
-        resume: "could you recommend a nice hotel in one of the areas and tell me which area it is."
-      }),
-      // 3rd round of conversation
-      new Command({
-        resume: "i like the first one. could you recommend something to do near the hotel?"
-      }),
-    ];
-
-    for (const [idx, userInput] of inputs.entries()) {
-      console.log();
-      console.log(`--- Conversation Turn ${idx + 1} ---`);
-      console.log();
-      console.log(`User: ${JSON.stringify(userInput)}`);
-      console.log();
-      
-      for await (const update of await graph.stream(
-        userInput,
-        { ...threadConfig, streamMode: "updates" }
-      )) {
-        for (const [nodeId, value] of Object.entries(update)) {
-          if (value?.messages?.length) {
-            const lastMessage = value.messages.at(-1);
-            if (lastMessage?.getType?.() === "ai") {
-              console.log(`${nodeId}: ${lastMessage.content}`);
-            }
-          }
-        }
-      }
-    }
-    ```
-    
-    ```
-    --- Conversation Turn 1 ---
-    
-    User: {"messages":[{"role":"user","content":"i wanna go somewhere warm in the caribbean"}]}
-    
-    travel_advisor: Based on the recommendations, Aruba would be an excellent choice for your Caribbean getaway! Aruba is known as "One Happy Island" and offers:
-    - Year-round warm weather with consistent temperatures around 82°F (28°C)
-    - Beautiful white sand beaches like Eagle Beach and Palm Beach
-    - Clear turquoise waters perfect for swimming and snorkeling
-    - Minimal rainfall and location outside the hurricane belt
-    - A blend of Caribbean and Dutch culture
-    - Great dining options and nightlife
-    - Various water sports and activities
-    
-    Would you like me to get some specific hotel recommendations in Aruba for your stay? I can transfer you to our hotel advisor who can help with accommodations.
-    
-    --- Conversation Turn 2 ---
-    
-    User: Command { resume: 'could you recommend a nice hotel in one of the areas and tell me which area it is.' }
-    
-    hotel_advisor: Based on the recommendations, I can suggest two excellent options:
-    
-    1. The Ritz-Carlton, Aruba - Located in Palm Beach
-    - This luxury resort is situated in the vibrant Palm Beach area
-    - Known for its exceptional service and amenities
-    - Perfect if you want to be close to dining, shopping, and entertainment
-    - Features multiple restaurants, a casino, and a world-class spa
-    - Located on a pristine stretch of Palm Beach
-    
-    2. Bucuti & Tara Beach Resort - Located in Eagle Beach
-    - An adults-only boutique resort on Eagle Beach
-    - Known for being more intimate and peaceful
-    - Award-winning for its sustainability practices
-    - Perfect for a romantic getaway or peaceful vacation
-    - Located on one of the most beautiful beaches in the Caribbean
-    
-    Would you like more specific information about either of these properties or their locations?
-    
-    --- Conversation Turn 3 ---
-    
-    User: Command { resume: 'i like the first one. could you recommend something to do near the hotel?' }
-    
-    travel_advisor: Near the Ritz-Carlton in Palm Beach, here are some highly recommended activities:
-    
-    1. Visit the Palm Beach Plaza Mall - Just a short walk from the hotel, featuring shopping, dining, and entertainment
-    2. Try your luck at the Stellaris Casino - It's right in the Ritz-Carlton
-    3. Take a sunset sailing cruise - Many depart from the nearby pier
-    4. Visit the California Lighthouse - A scenic landmark just north of Palm Beach
-    5. Enjoy water sports at Palm Beach:
-       - Jet skiing
-       - Parasailing
-       - Snorkeling
-       - Stand-up paddleboarding
-    
-    Would you like more specific information about any of these activities or would you like to know about other options in the area?
-    ```
-    :::
 
 ## Prebuilt implementations
 
 LangGraph comes with prebuilt implementations of two of the most popular multi-agent architectures:
 
-:::python
 - [supervisor](../agents/multi-agent.md#supervisor) — individual agents are coordinated by a central supervisor agent. The supervisor controls all communication flow and task delegation, making decisions about which agent to invoke based on the current context and task requirements. You can use [`langgraph-supervisor`](https://github.com/langchain-ai/langgraph-supervisor-py) library to create a supervisor multi-agent systems.
-- [swarm](../agents/multi-agent.md#supervisor) — agents dynamically hand off control to one another based on their specializations. The system remembers which agent was last active, ensuring that on subsequent interactions, the conversation resumes with that agent. You can use [`langgraph-swarm`](https://github.com/langchain-ai/langgraph-swarm-py) library to create a swarm multi-agent systems.
-:::
-
-:::js
-- [supervisor](../agents/multi-agent.md#supervisor) — individual agents are coordinated by a central supervisor agent. The supervisor controls all communication flow and task delegation, making decisions about which agent to invoke based on the current context and task requirements. You can use [`langgraph-supervisor`](https://github.com/langchain-ai/langgraph-supervisor-js) library to create a supervisor multi-agent systems.
-- [swarm](../agents/multi-agent.md#supervisor) — agents dynamically hand off control to one another based on their specializations. The system remembers which agent was last active, ensuring that on subsequent interactions, the conversation resumes with that agent. You can use [`langgraph-swarm`](https://github.com/langchain-ai/langgraph-swarm-js) library to create a swarm multi-agent systems.
-:::
+- [swarm](../agents/multi-agent.md#supervisor) — agents dynamically hand off control to one another based on their specializations. The system remembers which agent was last active, ensuring that on subsequent interactions, the conversation resumes with that agent. You can use [`langgraph-swarm`](https://github.com/langchain-ai/langgraph-swarm-py) library to create a swarm multi-agent systems. 

docs/docs/how-tos/subgraph.md

@@ -9,20 +9,11 @@ When adding subgraphs, you need to define how the parent graph and the subgraph
 
 ## Setup
 
-:::python
 ```bash
 pip install -U langgraph
 ```
-:::
-
-:::js
-```bash
-npm install @langchain/langgraph
-```
-:::
 
 !!! tip "Set up LangSmith for LangGraph development"
-
     Sign up for [LangSmith](https://smith.langchain.com) to quickly spot issues and improve the performance of your LangGraph projects. LangSmith lets you use trace data to debug, test, and monitor your LLM apps built with LangGraph — read more about how to get started [here](https://docs.smith.langchain.com).
 
 ## Shared state schemas
@@ -31,7 +22,6 @@ A common case is for the parent graph and subgraph to communicate over a shared
 
 If your subgraph shares state keys with the parent graph, you can follow these steps to add it to your graph:
 
-:::python
 1. Define the subgraph workflow (`subgraph_builder` in the example below) and compile it
 2. Pass compiled subgraph to the `.add_node` method when defining the parent graph workflow
 
@@ -59,41 +49,9 @@ builder.add_node("node_1", subgraph)
 builder.add_edge(START, "node_1")
 graph = builder.compile()
 ```
-:::
-
-:::js
-1. Define the subgraph workflow (`subgraphBuilder` in the example below) and compile it
-2. Pass compiled subgraph to the `.addNode` method when defining the parent graph workflow
-
-```typescript
-import { StateGraph, START } from "@langchain/langgraph";
-import { z } from "zod";
-
-const State = z.object({
-  foo: z.string(),
-});
-
-// Subgraph
-const subgraphBuilder = new StateGraph(State)
-  .addNode("subgraphNode1", (state) => {
-    return { foo: "hi! " + state.foo };
-  })
-  .addEdge(START, "subgraphNode1");
-
-const subgraph = subgraphBuilder.compile();
-
-// Parent graph
-const builder = new StateGraph(State)
-  .addNode("node1", subgraph)
-  .addEdge(START, "node1");
-
-const graph = builder.compile();
-```
-:::
 
 ??? example "Full example: shared state schemas"
 
-    :::python
     ```python
     from typing_extensions import TypedDict
     from langgraph.graph.state import StateGraph, START
@@ -143,61 +101,6 @@ const graph = builder.compile();
     {'node_1': {'foo': 'hi! foo'}}
     {'node_2': {'foo': 'hi! foobar'}}
     ```
-    :::
-
-    :::js
-    ```typescript
-    import { StateGraph, START } from "@langchain/langgraph";
-    import { z } from "zod";
-
-    // Define subgraph
-    const SubgraphState = z.object({
-      foo: z.string(),  // (1)! 
-      bar: z.string(),  // (2)!
-    });
-    
-    const subgraphBuilder = new StateGraph(SubgraphState)
-      .addNode("subgraphNode1", (state) => {
-        return { bar: "bar" };
-      })
-      .addNode("subgraphNode2", (state) => {
-        // note that this node is using a state key ('bar') that is only available in the subgraph
-        // and is sending update on the shared state key ('foo')
-        return { foo: state.foo + state.bar };
-      })
-      .addEdge(START, "subgraphNode1")
-      .addEdge("subgraphNode1", "subgraphNode2");
-    
-    const subgraph = subgraphBuilder.compile();
-    
-    // Define parent graph
-    const ParentState = z.object({
-      foo: z.string(),
-    });
-    
-    const builder = new StateGraph(ParentState)
-      .addNode("node1", (state) => {
-        return { foo: "hi! " + state.foo };
-      })
-      .addNode("node2", subgraph)
-      .addEdge(START, "node1")
-      .addEdge("node1", "node2");
-    
-    const graph = builder.compile();
-    
-    for await (const chunk of await graph.stream({ foo: "foo" })) {
-      console.log(chunk);
-    }
-    ```
-
-    3. This key is shared with the parent graph state
-    4. This key is private to the `SubgraphState` and is not visible to the parent graph
-    
-    ```
-    { node1: { foo: 'hi! foo' } }
-    { node2: { foo: 'hi! foobar' } }
-    ```
-    :::
 
 ## Different state schemas
 
@@ -205,7 +108,6 @@ For more complex systems you might want to define subgraphs that have a **comple
 
 If that's the case for your application, you need to define a node **function that invokes the subgraph**. This function needs to transform the input (parent) state to the subgraph state before invoking the subgraph, and transform the results back to the parent state before returning the state update from the node.
 
-:::python
 ```python
 from typing_extensions import TypedDict
 from langgraph.graph.state import StateGraph, START
@@ -240,48 +142,9 @@ graph = builder.compile()
 
 1. Transform the state to the subgraph state
 2. Transform response back to the parent state
-:::
-
-:::js
-```typescript
-import { StateGraph, START } from "@langchain/langgraph";
-import { z } from "zod";
-
-const SubgraphState = z.object({
-  bar: z.string(),
-});
-
-// Subgraph
-const subgraphBuilder = new StateGraph(SubgraphState)
-  .addNode("subgraphNode1", (state) => {
-    return { bar: "hi! " + state.bar };
-  })
-  .addEdge(START, "subgraphNode1");
-
-const subgraph = subgraphBuilder.compile();
-
-// Parent graph
-const State = z.object({
-  foo: z.string(),
-});
-
-const builder = new StateGraph(State)
-  .addNode("node1", async (state) => {
-    const subgraphOutput = await subgraph.invoke({ bar: state.foo }); // (1)!
-    return { foo: subgraphOutput.bar }; // (2)!
-  })
-  .addEdge(START, "node1");
-
-const graph = builder.compile();
-```
-
-1. Transform the state to the subgraph state
-2. Transform response back to the parent state
-:::
 
 ??? example "Full example: different state schemas"
 
-    :::python
     ```python
     from typing_extensions import TypedDict
     from langgraph.graph.state import StateGraph, START
@@ -337,74 +200,11 @@ const graph = builder.compile();
     (('node_2:9c36dd0f-151a-cb42-cbad-fa2f851f9ab7',), {'grandchild_2': {'bar': 'hi! foobaz'}})
     ((), {'node_2': {'foo': 'hi! foobaz'}})
     ```
-    :::
-
-    :::js
-    ```typescript
-    import { StateGraph, START } from "@langchain/langgraph";
-    import { z } from "zod";
-
-    // Define subgraph
-    const SubgraphState = z.object({
-      // note that none of these keys are shared with the parent graph state
-      bar: z.string(),
-      baz: z.string(),
-    });
-    
-    const subgraphBuilder = new StateGraph(SubgraphState)
-      .addNode("subgraphNode1", (state) => {
-        return { baz: "baz" };
-      })
-      .addNode("subgraphNode2", (state) => {
-        return { bar: state.bar + state.baz };
-      })
-      .addEdge(START, "subgraphNode1")
-      .addEdge("subgraphNode1", "subgraphNode2");
-    
-    const subgraph = subgraphBuilder.compile();
-    
-    // Define parent graph
-    const ParentState = z.object({
-      foo: z.string(),
-    });
-    
-    const builder = new StateGraph(ParentState)
-      .addNode("node1", (state) => {
-        return { foo: "hi! " + state.foo };
-      })
-      .addNode("node2", async (state) => {
-        const response = await subgraph.invoke({ bar: state.foo }); // (1)!
-        return { foo: response.bar }; // (2)!
-      })
-      .addEdge(START, "node1")
-      .addEdge("node1", "node2");
-    
-    const graph = builder.compile();
-    
-    for await (const chunk of await graph.stream(
-      { foo: "foo" }, 
-      { subgraphs: true }
-    )) {
-      console.log(chunk);
-    }
-    ```
-
-    3. Transform the state to the subgraph state
-    4. Transform response back to the parent state
-
-    ```
-    [[], { node1: { foo: 'hi! foo' } }]
-    [['node2:9c36dd0f-151a-cb42-cbad-fa2f851f9ab7'], { subgraphNode1: { baz: 'baz' } }]
-    [['node2:9c36dd0f-151a-cb42-cbad-fa2f851f9ab7'], { subgraphNode2: { bar: 'hi! foobaz' } }]
-    [[], { node2: { foo: 'hi! foobaz' } }]
-    ```
-    :::
 
 ??? example "Full example: different state schemas (two levels of subgraphs)"
 
     This is an example with two levels of subgraphs: parent -> child -> grandchild.
 
-    :::python
     ```python
     # Grandchild graph
     from typing_extensions import TypedDict
@@ -488,102 +288,14 @@ const graph = builder.compile();
     ((), {'child': {'my_key': 'hi Bob, how are you today?'}})
     ((), {'parent_2': {'my_key': 'hi Bob, how are you today? bye!'}})
     ```
-    :::
-
-    :::js
-    ```typescript
-    import { StateGraph, START, END } from "@langchain/langgraph";
-    import { z } from "zod";
-
-    // Grandchild graph
-    const GrandChildState = z.object({
-      myGrandchildKey: z.string(),
-    });
-    
-    const grandchild = new StateGraph(GrandChildState)
-      .addNode("grandchild1", (state) => {
-        // NOTE: child or parent keys will not be accessible here
-        return { myGrandchildKey: state.myGrandchildKey + ", how are you" };
-      })
-      .addEdge(START, "grandchild1")
-      .addEdge("grandchild1", END);
-    
-    const grandchildGraph = grandchild.compile();
-    
-    // Child graph
-    const ChildState = z.object({
-      myChildKey: z.string(),
-    });
-    
-    const child = new StateGraph(ChildState)
-      .addNode("child1", async (state) => {
-        // NOTE: parent or grandchild keys won't be accessible here
-        const grandchildGraphInput = { myGrandchildKey: state.myChildKey }; // (1)!
-        const grandchildGraphOutput = await grandchildGraph.invoke(grandchildGraphInput);
-        return { myChildKey: grandchildGraphOutput.myGrandchildKey + " today?" }; // (2)!
-      }) // (3)!
-      .addEdge(START, "child1")
-      .addEdge("child1", END);
-    
-    const childGraph = child.compile();
-    
-    // Parent graph
-    const ParentState = z.object({
-      myKey: z.string(),
-    });
-    
-    const parent = new StateGraph(ParentState)
-      .addNode("parent1", (state) => {
-        // NOTE: child or grandchild keys won't be accessible here
-        return { myKey: "hi " + state.myKey };
-      })
-      .addNode("child", async (state) => {
-        const childGraphInput = { myChildKey: state.myKey }; // (4)!
-        const childGraphOutput = await childGraph.invoke(childGraphInput);
-        return { myKey: childGraphOutput.myChildKey }; // (5)!
-      }) // (6)!
-      .addNode("parent2", (state) => {
-        return { myKey: state.myKey + " bye!" };
-      })
-      .addEdge(START, "parent1")
-      .addEdge("parent1", "child")
-      .addEdge("child", "parent2")
-      .addEdge("parent2", END);
-    
-    const parentGraph = parent.compile();
-    
-    for await (const chunk of await parentGraph.stream(
-      { myKey: "Bob" }, 
-      { subgraphs: true }
-    )) {
-      console.log(chunk);
-    }
-    ```
-
-    7. We're transforming the state from the child state channels (`myChildKey`) to the grandchild state channels (`myGrandchildKey`)
-    8. We're transforming the state from the grandchild state channels (`myGrandchildKey`) back to the child state channels (`myChildKey`)
-    9. We're passing a function here instead of just compiled graph (`grandchildGraph`)
-    10. We're transforming the state from the parent state channels (`myKey`) to the child state channels (`myChildKey`)
-    11. We're transforming the state from the child state channels (`myChildKey`) back to the parent state channels (`myKey`)
-    12. We're passing a function here instead of just a compiled graph (`childGraph`)
-
-    ```
-    [[], { parent1: { myKey: 'hi Bob' } }]
-    [['child:2e26e9ce-602f-862c-aa66-1ea5a4655e3b', 'child1:781bb3b1-3971-84ce-810b-acf819a03f9c'], { grandchild1: { myGrandchildKey: 'hi Bob, how are you' } }]
-    [['child:2e26e9ce-602f-862c-aa66-1ea5a4655e3b'], { child1: { myChildKey: 'hi Bob, how are you today?' } }]
-    [[], { child: { myKey: 'hi Bob, how are you today?' } }]
-    [[], { parent2: { myKey: 'hi Bob, how are you today? bye!' } }]
-    ```
-    :::
 
 ## Add persistence 
 
 You only need to **provide the checkpointer when compiling the parent graph**. LangGraph will automatically propagate the checkpointer to the child subgraphs.
 
-:::python
 ```python
 from langgraph.graph import START, StateGraph
-from langgraph.checkpoint.memory import MemorySaver
+from langgraph.checkpoint.memory import InMemorySaver
 from typing_extensions import TypedDict
 
 class State(TypedDict):
@@ -605,66 +317,20 @@ builder = StateGraph(State)
 builder.add_node("node_1", subgraph)
 builder.add_edge(START, "node_1")
 
-checkpointer = MemorySaver()
+checkpointer = InMemorySaver()
 graph = builder.compile(checkpointer=checkpointer)
 ```    
-:::
 
-:::js
-```typescript
-import { StateGraph, START, MemorySaver } from "@langchain/langgraph";
-import { z } from "zod";
+If you want the subgraph to **have its own memory**, you can compile it `with checkpointer=True`. This is useful in [multi-agent](../concepts/multi_agent.md) systems, if you want agents to keep track of their internal message histories:
 
-const State = z.object({
-  foo: z.string(),
-});
-
-// Subgraph
-const subgraphBuilder = new StateGraph(State)
-  .addNode("subgraphNode1", (state) => {
-    return { foo: state.foo + "bar" };
-  })
-  .addEdge(START, "subgraphNode1");
-
-const subgraph = subgraphBuilder.compile();
-
-// Parent graph
-const builder = new StateGraph(State)
-  .addNode("node1", subgraph)
-  .addEdge(START, "node1");
-
-const checkpointer = new MemorySaver();
-const graph = builder.compile({ checkpointer });
-```    
-:::
-
-If you want the subgraph to **have its own memory**, you can compile it with the appropriate checkpointer option. This is useful in [multi-agent](../concepts/multi_agent.md) systems, if you want agents to keep track of their internal message histories:
-
-:::python
 ```python
 subgraph_builder = StateGraph(...)
 subgraph = subgraph_builder.compile(checkpointer=True)
 ```
-:::
-
-:::js
-```typescript
-const subgraphBuilder = new StateGraph(...)
-const subgraph = subgraphBuilder.compile({ checkpointer: true });
-```
-:::
 
 ## View subgraph state
 
-When you enable [persistence](../concepts/persistence.md), you can [inspect the graph state](../concepts/persistence.md#checkpoints) (checkpoint) via the appropriate method. To view the subgraph state, you can use the subgraphs option.
-
-:::python
-You can inspect the graph state via `graph.get_state(config)`. To view the subgraph state, you can use `graph.get_state(config, subgraphs=True)`.
-:::
-
-:::js
-You can inspect the graph state via `graph.getState(config)`. To view the subgraph state, you can use `graph.getState(config, { subgraphs: true })`.
-:::
+When you enable [persistence](../concepts/persistence.md), you can [inspect the graph state](../concepts/persistence.md#checkpoints) (checkpoint) via `graph.get_state(config)`. To view the subgraph state, you can use `graph.get_state(config, subgraphs=True)`.
 
 !!! important "Available **only** when interrupted"
 
@@ -672,10 +338,9 @@ You can inspect the graph state via `graph.getState(config)`. To view the subgra
 
 ??? example "View interrupted subgraph state"
 
-    :::python
     ```python
     from langgraph.graph import START, StateGraph
-    from langgraph.checkpoint.memory import MemorySaver
+    from langgraph.checkpoint.memory import InMemorySaver
     from langgraph.types import interrupt, Command
     from typing_extensions import TypedDict
     
@@ -700,7 +365,7 @@ You can inspect the graph state via `graph.getState(config)`. To view the subgra
     builder.add_node("node_1", subgraph)
     builder.add_edge(START, "node_1")
     
-    checkpointer = MemorySaver()
+    checkpointer = InMemorySaver()
     graph = builder.compile(checkpointer=checkpointer)
     
     config = {"configurable": {"thread_id": "1"}}
@@ -714,53 +379,11 @@ You can inspect the graph state via `graph.getState(config)`. To view the subgra
     ```
     
     1. This will be available only when the subgraph is interrupted. Once you resume the graph, you won't be able to access the subgraph state.
-    :::
-
-    :::js
-    ```typescript
-    import { StateGraph, START, MemorySaver, interrupt, Command } from "@langchain/langgraph";
-    import { z } from "zod";
-    
-    const State = z.object({
-      foo: z.string(),
-    });
-    
-    // Subgraph
-    const subgraphBuilder = new StateGraph(State)
-      .addNode("subgraphNode1", (state) => {
-        const value = interrupt("Provide value:");
-        return { foo: state.foo + value };
-      })
-      .addEdge(START, "subgraphNode1");
-    
-    const subgraph = subgraphBuilder.compile();
-    
-    // Parent graph
-    const builder = new StateGraph(State)
-      .addNode("node1", subgraph)
-      .addEdge(START, "node1");
-    
-    const checkpointer = new MemorySaver();
-    const graph = builder.compile({ checkpointer });
-    
-    const config = { configurable: { thread_id: "1" } };
-    
-    await graph.invoke({ foo: "" }, config);
-    const parentState = await graph.getState(config);
-    const subgraphState = (await graph.getState(config, { subgraphs: true })).tasks[0].state; // (1)!
-    
-    // resume the subgraph
-    await graph.invoke(new Command({ resume: "bar" }), config);
-    ```
-    
-    2. This will be available only when the subgraph is interrupted. Once you resume the graph, you won't be able to access the subgraph state.
-    :::
 
 ## Stream subgraph outputs
 
-To include outputs from subgraphs in the streamed outputs, you can set the subgraphs option in the stream method of the parent graph. This will stream outputs from both the parent graph and any subgraphs.
+To include outputs from subgraphs in the streamed outputs, you can set `subgraphs=True` in the `.stream()` method of the parent graph. This will stream outputs from both the parent graph and any subgraphs.
 
-:::python
 ```python
 for chunk in graph.stream(
     {"foo": "foo"},
@@ -771,27 +394,9 @@ for chunk in graph.stream(
 ```
 
 1. Set `subgraphs=True` to stream outputs from subgraphs.
-:::
-
-:::js
-```typescript
-for await (const chunk of await graph.stream(
-  { foo: "foo" },
-  {
-    subgraphs: true, // (1)!
-    streamMode: "updates",
-  }
-)) {
-  console.log(chunk);
-}
-```
-
-1. Set `subgraphs: true` to stream outputs from subgraphs.
-:::
 
 ??? example "Stream from subgraphs"
 
-    :::python
     ```python
     from typing_extensions import TypedDict
     from langgraph.graph.state import StateGraph, START
@@ -845,66 +450,4 @@ for await (const chunk of await graph.stream(
     (('node_2:e58e5673-a661-ebb0-70d4-e298a7fc28b7',), {'subgraph_node_1': {'bar': 'bar'}})
     (('node_2:e58e5673-a661-ebb0-70d4-e298a7fc28b7',), {'subgraph_node_2': {'foo': 'hi! foobar'}})
     ((), {'node_2': {'foo': 'hi! foobar'}})
-    ```
-    :::
-
-    :::js
-    ```typescript
-    import { StateGraph, START } from "@langchain/langgraph";
-    import { z } from "zod";
-
-    // Define subgraph
-    const SubgraphState = z.object({
-      foo: z.string(),
-      bar: z.string(),
-    });
-    
-    const subgraphBuilder = new StateGraph(SubgraphState)
-      .addNode("subgraphNode1", (state) => {
-        return { bar: "bar" };
-      })
-      .addNode("subgraphNode2", (state) => {
-        // note that this node is using a state key ('bar') that is only available in the subgraph
-        // and is sending update on the shared state key ('foo')
-        return { foo: state.foo + state.bar };
-      })
-      .addEdge(START, "subgraphNode1")
-      .addEdge("subgraphNode1", "subgraphNode2");
-    
-    const subgraph = subgraphBuilder.compile();
-    
-    // Define parent graph
-    const ParentState = z.object({
-      foo: z.string(),
-    });
-    
-    const builder = new StateGraph(ParentState)
-      .addNode("node1", (state) => {
-        return { foo: "hi! " + state.foo };
-      })
-      .addNode("node2", subgraph)
-      .addEdge(START, "node1")
-      .addEdge("node1", "node2");
-    
-    const graph = builder.compile();
-
-    for await (const chunk of await graph.stream(
-      { foo: "foo" },
-      {
-        streamMode: "updates",
-        subgraphs: true, // (1)!
-      }
-    )) {
-      console.log(chunk);
-    }
-    ```
-  
-    2. Set `subgraphs: true` to stream outputs from subgraphs.
-
-    ```
-    [[], { node1: { foo: 'hi! foo' } }]
-    [['node2:e58e5673-a661-ebb0-70d4-e298a7fc28b7'], { subgraphNode1: { bar: 'bar' } }]
-    [['node2:e58e5673-a661-ebb0-70d4-e298a7fc28b7'], { subgraphNode2: { foo: 'hi! foobar' } }]
-    [[], { node2: { foo: 'hi! foobar' } }]
-    ```
-    :::
+    

docs/docs/how-tos/tool-calling.md

@@ -172,82 +172,6 @@ await agent.invoke({
 
 :::
 
-:::python
-
-### Dynamically select tools
-
-Configure tool availability at runtime based on context:
-
-```python
-from dataclasses import dataclass
-from typing import Literal
-
-from langchain.chat_models import init_chat_model
-from langchain_core.tools import tool
-
-from langgraph.prebuilt import create_react_agent
-from langgraph.prebuilt.chat_agent_executor import AgentState
-from langgraph.runtime import Runtime
-
-
-@dataclass
-class CustomContext:
-    tools: list[Literal["weather", "compass"]]
-
-
-@tool
-def weather() -> str:
-    """Returns the current weather conditions."""
-    return "It's nice and sunny."
-
-
-@tool
-def compass() -> str:
-    """Returns the direction the user is facing."""
-    return "North"
-
-model = init_chat_model("anthropic:claude-sonnet-4-20250514")
-
-# highlight-next-line
-def configure_model(state: AgentState, runtime: Runtime[CustomContext]):
-    """Configure the model with tools based on runtime context."""
-    selected_tools = [
-        tool
-        for tool in [weather, compass]
-        if tool.name in runtime.context.tools
-    ]
-    return model.bind_tools(selected_tools)
-
-
-agent = create_react_agent(
-    # Dynamically configure the model with tools based on runtime context
-    # highlight-next-line
-    configure_model,
-    # Initialize with all tools available
-    # highlight-next-line
-    tools=[weather, compass]
-)
-
-output = agent.invoke(
-    {
-        "messages": [
-            {
-                "role": "user",
-                "content": "Who are you and what tools do you have access to?",
-            }
-        ]
-    },
-    # highlight-next-line
-    context=CustomContext(tools=["weather"]),  # Only enable the weather tool
-)
-
-print(output["messages"][-1].text())
-```
-
-!!! version-added "Added in version 0.6.0"
-
-:::
-
 ## Use in a workflow
 
 If you are writing a custom workflow, you will need to:
@@ -1571,7 +1495,6 @@ const saveUserInfo = tool(
 
     from langchain_core.tools import tool
     from langgraph.config import get_store
-    from langchain_core.runnables import RunnableConfig
     from langgraph.prebuilt import create_react_agent
     from langgraph.store.memory import InMemoryStore
 

docs/docs/llms.txt

@@ -10,7 +10,7 @@
 - [Implementing Human-in-the-Loop Controls in LangGraph](https://langchain-ai.github.io/langgraph/tutorials/get-started/4-human-in-the-loop/): This page provides a comprehensive guide on adding human-in-the-loop controls to LangGraph workflows, enabling agents to pause execution for human input. It details the use of the `interrupt` function to facilitate user feedback and outlines the steps to integrate a `human_assistance` tool into a chatbot. Additionally, the tutorial covers graph compilation, visualization, and resuming execution with human input.
 - [Customizing State in LangGraph for Enhanced Chatbot Functionality](https://langchain-ai.github.io/langgraph/tutorials/get-started/5-customize-state/): This tutorial guides you through the process of adding custom fields to the state in LangGraph, enabling complex behaviors in your chatbot without relying solely on message lists. You will learn how to implement human-in-the-loop controls to verify information before it is stored in the state. By the end of this tutorial, you will have a deeper understanding of state management and how to enhance your chatbot's capabilities.
 - [Implementing Time Travel in LangGraph Chatbots](https://langchain-ai.github.io/langgraph/tutorials/get-started/6-time-travel/): This page provides a comprehensive guide on utilizing the time travel functionality in LangGraph to enhance chatbot interactions. It covers how to rewind, add steps, and replay the state history of a chatbot, allowing users to explore different outcomes and fix mistakes. Additionally, it includes code snippets and practical examples to help developers implement these features effectively.
-- [LangGraph Deployment Options](https://langchain-ai.github.io/langgraph/tutorials/deployment/): This page outlines the various options available for deploying LangGraph applications, including local testing and different cloud-based solutions. It details free deployment methods such as Local, as well as production options like Cloud SaaS and self-hosted solutions. Each deployment method is linked to further documentation for in-depth guidance.
+- [LangGraph Deployment Options](https://langchain-ai.github.io/langgraph/tutorials/deployment/): This page outlines the various options available for deploying LangGraph applications, including local testing and different cloud-based solutions. It details free deployment methods such as Local and Standalone Container (Lite), as well as production options like Cloud SaaS and self-hosted solutions. Each deployment method is linked to further documentation for in-depth guidance.
 - [Agent Development with LangGraph](https://langchain-ai.github.io/langgraph/agents/overview/): This page provides an overview of agent development using LangGraph, highlighting its prebuilt components and capabilities for building agent-based applications. It explains the structure of an agent, key features such as memory integration and human-in-the-loop control, and outlines the package ecosystem available for developers. With LangGraph, users can focus on application logic while leveraging robust infrastructure for state management and feedback.
 - [Guide to Running Agents in LangGraph](https://langchain-ai.github.io/langgraph/agents/run_agents/): This page provides a comprehensive overview of how to execute agents in LangGraph, detailing both synchronous and asynchronous methods. It covers input and output formats, streaming capabilities, and how to manage execution limits to prevent infinite loops. Additionally, it includes code examples and links to further resources for deeper understanding.
 - [Streaming Data in LangGraph](https://langchain-ai.github.io/langgraph/agents/streaming/): This page provides an overview of streaming data types in LangGraph, including agent progress, LLM tokens, and custom updates. It includes code examples for both synchronous and asynchronous streaming methods. Additionally, it covers how to stream multiple modes and disable streaming when necessary.
@@ -73,7 +73,7 @@
 - [Integrating Semantic Search in LangGraph](https://langchain-ai.github.io/langgraph/cloud/deployment/semantic_search/): This guide provides step-by-step instructions on how to implement semantic search in your LangGraph deployment. It covers prerequisites, configuration of the store, and usage examples for searching memories and documents by semantic similarity. Additionally, it includes information on using custom embeddings and querying via the LangGraph SDK.
 - [Configuring Time-to-Live (TTL) in LangGraph Applications](https://langchain-ai.github.io/langgraph/how-tos/ttl/configure_ttl/): This guide provides detailed instructions on how to configure Time-to-Live (TTL) settings for checkpoints and store items in LangGraph applications. It covers the necessary configurations in the `langgraph.json` file, including strategies for managing data lifecycle and memory. Additionally, it explains how to combine TTL configurations and override them at runtime.
 - [LangGraph Authentication & Access Control Overview](https://langchain-ai.github.io/langgraph/concepts/auth/): This page provides a comprehensive guide to the authentication and authorization mechanisms within the LangGraph Platform. It explains the core concepts of authentication versus authorization, outlines default security models, and details the system architecture involved in user identity management. Additionally, it covers implementation examples for authentication and authorization handlers, along with common access patterns and supported resources.
-- [Custom Authentication Setup for LangGraph Platform](https://langchain-ai.github.io/langgraph/how-tos/auth/custom_auth/): This guide provides step-by-step instructions on how to implement custom authentication in your LangGraph Platform application. It covers the necessary prerequisites, implementation details, configuration updates, and client connection methods. The guide is applicable to both managed and Enterprise self-hosted deployments.
+- [Custom Authentication Setup for LangGraph Platform](https://langchain-ai.github.io/langgraph/how-tos/auth/custom_auth/): This guide provides step-by-step instructions on how to implement custom authentication in your LangGraph Platform application. It covers the necessary prerequisites, implementation details, configuration updates, and client connection methods. The guide is applicable to both managed and Enterprise self-hosted deployments, but not to Lite self-hosted plans.
 - [Documenting API Authentication in OpenAPI for LangGraph](https://langchain-ai.github.io/langgraph/how-tos/auth/openapi_security/): This guide provides instructions on how to customize the security schema for your LangGraph Platform API documentation using OpenAPI. It covers default security schemes for both LangGraph Platform and self-hosted deployments, as well as how to implement custom authentication. Additionally, it includes examples for OAuth2 and API key authentication, along with testing procedures.
 - [Managing Assistants in LangGraph](https://langchain-ai.github.io/langgraph/concepts/assistants/): This page provides an overview of how to create and manage assistants within the LangGraph Platform, which allows for separate configuration of agents without altering the core graph logic. It covers the prerequisites, configuration options, and versioning of assistants, highlighting their role in optimizing agent performance for different tasks. Additionally, it includes links to relevant API references and how-to guides for further assistance.
 - [Managing Assistants in LangGraph](https://langchain-ai.github.io/langgraph/cloud/how-tos/configuration_cloud/): This documentation page provides a comprehensive guide on how to create, configure, and manage assistants using the LangGraph SDK and Platform UI. It includes code examples in Python and JavaScript, as well as instructions for creating new versions and using previous versions of assistants. Additionally, it covers the process of utilizing assistants in various environments.
@@ -112,7 +112,7 @@
 - [Deploying a Self-Hosted Data Plane](https://langchain-ai.github.io/langgraph/cloud/deployment/self_hosted_data_plane/): This page provides a comprehensive guide on deploying a Self-Hosted Data Plane using Kubernetes and Amazon ECS. It outlines the prerequisites, setup steps, and configuration details necessary for a successful deployment. Additionally, it highlights the current beta status of this deployment option.
 - [Self-Hosted Control Plane Deployment Guide](https://langchain-ai.github.io/langgraph/concepts/langgraph_self_hosted_control_plane/): This page provides an overview of the Self-Hosted Control Plane deployment option, currently in beta. It outlines the requirements, architecture, and compute platforms supported for deploying the control and data planes in your cloud environment. Additionally, it includes important links and resources for managing your self-hosted infrastructure.
 - [Deploying a Self-Hosted Control Plane](https://langchain-ai.github.io/langgraph/cloud/deployment/self_hosted_control_plane/): This page provides a comprehensive guide on deploying a Self-Hosted Control Plane using Kubernetes. It outlines the prerequisites, setup steps, and configuration details necessary for a successful deployment. Additionally, it highlights the beta status of this deployment option and includes links to relevant resources for further assistance.
-- [Deploying LangGraph Server with Standalone Container](https://langchain-ai.github.io/langgraph/concepts/langgraph_standalone_container/): This page provides a comprehensive guide on deploying a LangGraph Server using the Standalone Container option. It outlines the architecture, supported compute platforms, and Enterprise server version features. Users will find essential information on managing the data plane infrastructure without a control plane.
+- [Deploying LangGraph Server with Standalone Container](https://langchain-ai.github.io/langgraph/concepts/langgraph_standalone_container/): This page provides a comprehensive guide on deploying a LangGraph Server using the Standalone Container option. It outlines the architecture, supported compute platforms, and differences between Lite and Enterprise server versions. Users will find essential information on managing the data plane infrastructure without a control plane.
 - [Deploying a Standalone Container with LangGraph](https://langchain-ai.github.io/langgraph/cloud/deployment/standalone_container/): This documentation provides a comprehensive guide on deploying a standalone container for the LangGraph application. It covers prerequisites, environment variable configurations, and deployment methods using Docker and Docker Compose. Additionally, it includes instructions for deploying on Kubernetes using Helm.
 - [Scalability and Resilience of LangGraph Platform](https://langchain-ai.github.io/langgraph/concepts/scalability_and_resilience/): This page provides an overview of the scalability and resilience features of the LangGraph Platform. It details how the platform handles server and queue scalability, as well as the mechanisms in place for ensuring resilience during both graceful and hard shutdowns. Additionally, it covers the resilience strategies employed for Postgres and Redis to maintain service availability.
 - [LangGraph Platform Plans Overview](https://langchain-ai.github.io/langgraph/concepts/plans/): This page provides an overview of the different plans available for the LangGraph Platform, including Developer, Plus, and Enterprise options. Each plan offers varying deployment options, usage limits, and features tailored to different user needs. For detailed pricing and related resources, links to additional documentation are also included.

docs/docs/reference/index.md

@@ -49,8 +49,9 @@ Higher-level abstractions for common workflows, agents, and other patterns.
 
 Tools for deploying and connecting to the LangGraph Platform.
 
+- [CLI](../cloud/reference/cli.md): Command-line interface for building and deploying LangGraph Platform applications.
+- [Server API](../cloud/reference/api/api_ref.md): REST API for the LangGraph Server.
 - [SDK (Python)](../cloud/reference/sdk/python_sdk_ref.md): Python SDK for interacting with instances of the LangGraph Server.
 - [SDK (JS/TS)](../cloud/reference/sdk/js_ts_sdk_ref.md): JavaScript/TypeScript SDK for interacting with instances of the LangGraph Server.
 - [RemoteGraph](remote_graph.md): `Pregel` abstraction for connecting to LangGraph Server instances.
-
-See the [LangGraph Platform reference](https://docs.langchain.com/langgraph-platform/reference-overview) for more reference documentation.
+- [Environment variables](../cloud/reference/env_var.md): Supported configuration variables when deploying with the LangGraph Platform.

docs/docs/troubleshooting/errors/INVALID_LICENSE.md

@@ -21,9 +21,15 @@ See the [local server](../../tutorials/langgraph-platform/local-server.md) docs
 
 If you would like a fast managed environment, consider the [Cloud SaaS](../../concepts/langgraph_cloud.md) deployment option. This requires no additional license key.
 
-#### For Standalone Container
+#### For Standalone Container (Lite)
 
-For self-hosting, set the `LANGGRAPH_CLOUD_LICENSE_KEY` environment variable. If you are interested in an enterprise license key, please contact the LangChain support team.
+If your deployment is unlikely to see more than 1 million node executions per year and don't need Crons and other enterprise features, consider the [Standalone Container](../../concepts/deployment_options.md) deployment option.
+
+You can deploy with Standalone Container by setting a valid `LANGSMITH_API_KEY` in your environment (e.g., in the `.env` file referenced by `langgraph.json`) and building a Docker image. The API key must be associated with an account on a **Plus** plan or greater.
+
+#### For Standalone Container (Enterprise)
+
+For full self-hosting, set the `LANGGRAPH_CLOUD_LICENSE_KEY` environment variable. If you are interested in an enterprise license key, please contact the LangChain support team.
 
 For more information on deployment options and their features, see the [Deployment Options](../../concepts/deployment_options.md) documentation.
 
@@ -32,7 +38,12 @@ For more information on deployment options and their features, see the [Deployme
 
 If you have confirmed that you would like to self-host LangGraph Platform, please verify your credentials.
 
-#### For Standalone Container
+#### For Standalone Container (Lite)
+
+1. Confirm that you have provided a working `LANGSMITH_API_KEY` environment variable in your deployment environment or `.env` file
+2. Confirm the provided API key is associated with an account on a **Plus** or **Enterprise** plan (or equivalent)
+
+#### For Standalone Container (Enterprise)
 
 1. Confirm that you have provided a working `LANGGRAPH_CLOUD_LICENSE_KEY` environment variable in your deployment environment or `.env` file
 2. Confirm the key is still valid and has not surpassed its expiration date

docs/docs/troubleshooting/errors/index.md

@@ -11,4 +11,11 @@ Errors referenced below will have an `lc_error_code` property corresponding to o
 - [INVALID_CONCURRENT_GRAPH_UPDATE](./INVALID_CONCURRENT_GRAPH_UPDATE.md)
 - [INVALID_GRAPH_NODE_RETURN_VALUE](./INVALID_GRAPH_NODE_RETURN_VALUE.md)
 - [MULTIPLE_SUBGRAPHS](./MULTIPLE_SUBGRAPHS.md)
-- [INVALID_CHAT_HISTORY](./INVALID_CHAT_HISTORY.md)
+- [INVALID_CHAT_HISTORY](./INVALID_CHAT_HISTORY.md)
+
+## LangGraph Platform
+
+These guides provide troubleshooting information for errors that are specific to the LangGraph Platform.
+
+- [INVALID_LICENSE](./INVALID_LICENSE.md)
+- [Studio Errors](../studio.md)

docs/docs/tutorials/get-started/3-add-memory.md

@@ -17,7 +17,7 @@ Create a `MemorySaver` checkpointer:
 :::python
 
 ```python
-from langgraph.checkpoint.memory import InMemorySaver
+from langgraph.checkpoint.memory import MemorySaver
 
 memory = InMemorySaver()
 ```
@@ -447,4 +447,3 @@ const graph = new StateGraph(State)
 ## Next steps
 
 In the next tutorial, you will [add human-in-the-loop to the chatbot](./4-human-in-the-loop.md) to handle situations where it may need guidance or verification before proceeding.
-

docs/docs/tutorials/multi_agent/agent_supervisor.md

@@ -85,80 +85,124 @@ Let's [run the agent](../../agents/run_agents.md) to verify that it behaves as e
 
 !!! note "We'll use `pretty_print_messages` helper to render the streamed agent outputs nicely"
 
-  ```python
-  from langchain_core.messages import convert_to_messages
+    ```python
+    from langchain_core.messages import convert_to_messages
+    
+    
+    def pretty_print_message(message, indent=False):
+        pretty_message = message.pretty_repr(html=True)
+        if not indent:
+            print(pretty_message)
+            return
+    
+        indented = "\n".join("\t" + c for c in pretty_message.split("\n"))
+        print(indented)
+    
+    
+    def pretty_print_messages(update, last_message=False):
+        is_subgraph = False
+        if isinstance(update, tuple):
+            ns, update = update
+            # skip parent graph updates in the printouts
+            if len(ns) == 0:
+                return
+    
+            graph_id = ns[-1].split(":")[0]
+            print(f"Update from subgraph {graph_id}:")
+            print("\n")
+            is_subgraph = True
+    
+        for node_name, node_update in update.items():
+            update_label = f"Update from node {node_name}:"
+            if is_subgraph:
+                update_label = "\t" + update_label
+    
+            print(update_label)
+            print("\n")
+    
+            messages = convert_to_messages(node_update["messages"])
+            if last_message:
+                messages = messages[-1:]
+    
+            for m in messages:
+                pretty_print_message(m, indent=is_subgraph)
+            print("\n")
+    ```
+
+```python
+from langchain_core.messages import convert_to_messages
 
 
-  def pretty_print_message(message, indent=False):
-      pretty_message = message.pretty_repr(html=True)
-      if not indent:
-          print(pretty_message)
-          return
+def pretty_print_message(message, indent=False):
+    pretty_message = message.pretty_repr(html=True)
+    if not indent:
+        print(pretty_message)
+        return
 
-      indented = "\n".join("\t" + c for c in pretty_message.split("\n"))
-      print(indented)
+    indented = "\n".join("\t" + c for c in pretty_message.split("\n"))
+    print(indented)
 
 
-  def pretty_print_messages(update, last_message=False):
-      is_subgraph = False
-      if isinstance(update, tuple):
-          ns, update = update
-          # skip parent graph updates in the printouts
-          if len(ns) == 0:
-              return
+def pretty_print_messages(update, last_message=False):
+    is_subgraph = False
+    if isinstance(update, tuple):
+        ns, update = update
+        # skip parent graph updates in the printouts
+        if len(ns) == 0:
+            return
 
-          graph_id = ns[-1].split(":")[0]
-          print(f"Update from subgraph {graph_id}:")
-          print("\n")
-          is_subgraph = True
+        graph_id = ns[-1].split(":")[0]
+        print(f"Update from subgraph {graph_id}:")
+        print("\n")
+        is_subgraph = True
 
-      for node_name, node_update in update.items():
-          update_label = f"Update from node {node_name}:"
-          if is_subgraph:
-              update_label = "\t" + update_label
+    for node_name, node_update in update.items():
+        update_label = f"Update from node {node_name}:"
+        if is_subgraph:
+            update_label = "\t" + update_label
 
-          print(update_label)
-          print("\n")
+        print(update_label)
+        print("\n")
 
-          messages = convert_to_messages(node_update["messages"])
-          if last_message:
-              messages = messages[-1:]
+        messages = convert_to_messages(node_update["messages"])
+        if last_message:
+            messages = messages[-1:]
 
-          for m in messages:
-              pretty_print_message(m, indent=is_subgraph)
-          print("\n")
-  ```
+        for m in messages:
+            pretty_print_message(m, indent=is_subgraph)
+        print("\n")
+```
 
-  ```python
-  for chunk in research_agent.stream(
-      {"messages": [{"role": "user", "content": "who is the mayor of NYC?"}]}
-  ):
-      pretty_print_messages(chunk)
-  ```
+```python
+for chunk in research_agent.stream(
+    {"messages": [{"role": "user", "content": "who is the mayor of NYC?"}]}
+):
+    pretty_print_messages(chunk)
+```
 
-  **Output:**
-  ```
-  Update from node agent:
+**Output:**
+```
+Update from node agent:
 
 
-  ================================== Ai Message ==================================
-  Name: research_agent
-  Tool Calls:
-    tavily_search (call_U748rQhQXT36sjhbkYLSXQtJ)
-   Call ID: call_U748rQhQXT36sjhbkYLSXQtJ
-    Args:
-      query: current mayor of New York City
-      search_depth: basic
+================================== Ai Message ==================================
+Name: research_agent
+Tool Calls:
+  tavily_search (call_U748rQhQXT36sjhbkYLSXQtJ)
+ Call ID: call_U748rQhQXT36sjhbkYLSXQtJ
+  Args:
+    query: current mayor of New York City
+    search_depth: basic
 
 
-  Update from node tools:
+Update from node tools:
 
 
-  ================================= Tool Message ==================================
-  Name: tavily_search
+================================= Tool Message ==================================
+Name: tavily_search
 
-  {"query": "current mayor of New York City", "follow_up_questions": null, "answer": null, "images": [], "results": [{"title": "List of mayors of New York City - Wikipedia", "url": "https://en.wikipedia.org/wiki/List_of_mayors_of_New_York_City", "content": "The mayor of New York City is the chief executive of the Government of New York City, as stipulated by New York City's charter.The current officeholder, the 110th in the sequence of regular mayors, is Eric Adams, a member of the Democratic Party.. During the Dutch colonial period from 1624 to 1664, New Amsterdam was governed by the Director of Netherland.", "score": 0.9039154, "raw_content": null}, {"title": "Office of the Mayor | Mayor's Bio | City of New York - NYC.gov", "url": "https://www.nyc.gov/office-of-the-mayor/bio.page", "content": "Mayor Eric Adams has served the people of New York City as an NYPD officer, State Senator, Brooklyn Borough President, and now as the 110th Mayor of the City of New York. He gave voice to a diverse coalition of working families in all five boroughs and is leading the fight to bring back New York City's economy, reduce inequality, improve", "score": 0.8405867, "raw_content": null}, {"title": "Eric Adams - Wikipedia", "url": "https://en.wikipedia.org/wiki/Eric_Adams", "content": "Eric Leroy Adams (born September 1, 1960) is an American politician and former police officer who has served as the 110th mayor of New York City since 2022. Adams was an officer in the New York City Transit Police and then the New York City Police Department (```
-  ```
+{"query": "current mayor of New York City", "follow_up_questions": null, "answer": null, "images": [], "results": [{"title": "List of mayors of New York City - Wikipedia", "url": "https://en.wikipedia.org/wiki/List_of_mayors_of_New_York_City", "content": "The mayor of New York City is the chief executive of the Government of New York City, as stipulated by New York City's charter.The current officeholder, the 110th in the sequence of regular mayors, is Eric Adams, a member of the Democratic Party.. During the Dutch colonial period from 1624 to 1664, New Amsterdam was governed by the Director of Netherland.", "score": 0.9039154, "raw_content": null}, {"title": "Office of the Mayor | Mayor's Bio | City of New York - NYC.gov", "url": "https://www.nyc.gov/office-of-the-mayor/bio.page", "content": "Mayor Eric Adams has served the people of New York City as an NYPD officer, State Senator, Brooklyn Borough President, and now as the 110th Mayor of the City of New York. He gave voice to a diverse coalition of working families in all five boroughs and is leading the fight to bring back New York City's economy, reduce inequality, improve", "score": 0.8405867, "raw_content": null}, {"title": "Eric Adams - Wikipedia", "url": "https://en.wikipedia.org/wiki/Eric_Adams", "content": "Eric Leroy Adams (born September 1, 1960) is an American politician and former police officer who has served as the 110th mayor of New York City since 2022. Adams was an officer in the New York City Transit Police and then the New York City Police Department (```
+```
 
 ### Math agent
 
@@ -765,4 +809,4 @@ Update from subgraph research_agent:
 	Name: tavily_search
 	
 	{"query": "2024 United States GDP value from a reputable source", "follow_up_questions": null, "answer": null, "images": [], "results": [{"url": "https://www.focus-economics.com/countries/united-states/", "title": "United States Economy Overview - Focus Economics", "content": "The United States' Macroeconomic Analysis:\n------------------------------------------\n\n**Nominal GDP of USD 29,185 billion in 2024.**\n\n**Nominal GDP of USD 29,179 billion in 2024.**\n\n**GDP per capita of USD 86,635 compared to the global average of USD 10,589.**\n\n**GDP per capita of USD 86,652 compared to the global average of USD 10,589.**\n\n**Average real GDP growth of 2.5% over the last decade.**\n\n**Average real GDP growth of ```
-``` 
+``` 

docs/docs/tutorials/workflows.md

@@ -1948,7 +1948,7 @@ const llmWithTools = llm.bindTools(tools);
 
 
     # Conditional edge function to route to the tool node or end based upon whether the LLM made a tool call
-    def should_continue(state: MessagesState) -> Literal["Action", END]:
+    def should_continue(state: MessagesState) -> Literal["environment", END]:
         """Decide if we should continue the loop or stop based upon whether the LLM made a tool call"""
 
         messages = state["messages"]

docs/mkdocs.yml

@@ -52,103 +52,6 @@ theme:
 plugins:
   - search:
       separator: '[\s\u200b\-,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;'
-  - exclude-search:
-      exclude:
-        - additional-resources/index.md
-        - agents/prebuilt.md
-        - cloud/concepts/cron_jobs.md
-        - cloud/concepts/data_storage_and_privacy.md
-        - cloud/concepts/webhooks.md
-        - cloud/deployment/cloud.md
-        - cloud/deployment/custom_docker.md
-        - cloud/deployment/egress.md
-        - cloud/deployment/graph_rebuild.md
-        - cloud/deployment/self_hosted_control_plane.md
-        - cloud/deployment/self_hosted_data_plane.md
-        - cloud/deployment/semantic_search.md
-        - cloud/deployment/setup_javascript.md
-        - cloud/deployment/setup_pyproject.md
-        - cloud/deployment/setup.md
-        - cloud/deployment/standalone_container.md
-        - cloud/how-tos/add-human-in-the-loop.md
-        - cloud/how-tos/background_run.md
-        - cloud/how-tos/clone_traces_studio.md
-        - cloud/how-tos/configurable_headers.md
-        - cloud/how-tos/configuration_cloud.md
-        - cloud/how-tos/cron_jobs.md
-        - cloud/how-tos/datasets_studio.md
-        - cloud/how-tos/enqueue_concurrent.md
-        - cloud/how-tos/generative_ui_react.md
-        - cloud/how-tos/human_in_the_loop_time_travel.md
-        - cloud/how-tos/interrupt_concurrent.md
-        - cloud/how-tos/invoke_studio.md
-        - cloud/how-tos/iterate_graph_studio.md
-        - cloud/how-tos/reject_concurrent.md
-        - cloud/how-tos/rollback_concurrent.md
-        - cloud/how-tos/same-thread.md
-        - cloud/how-tos/stateless_runs.md
-        - cloud/how-tos/streaming.md
-        - cloud/how-tos/studio/manage_assistants.md
-        - cloud/how-tos/studio/quick_start.md
-        - cloud/how-tos/studio/run_evals.md
-        - cloud/how-tos/threads_studio.md
-        - cloud/how-tos/use_stream_react.md
-        - cloud/how-tos/use_threads.md
-        - cloud/how-tos/webhooks.md
-        - cloud/quick_start.md
-        - cloud/reference/api/api_ref_control_plane.md
-        - cloud/reference/api/api_ref.md
-        - cloud/reference/cli.md
-        - cloud/reference/env_var.md
-        - cloud/reference/langgraph_server_changelog.md
-        - cloud/reference/sdk/js_ts_sdk_ref.md
-        - concepts/application_structure.md
-        - concepts/assistants.md
-        - concepts/auth.md
-        - concepts/deployment_options.md
-        - concepts/double_texting.md
-        - concepts/faq.md
-        - concepts/langgraph_cli.md
-        - concepts/langgraph_cloud.md
-        - concepts/langgraph_components.md
-        - concepts/langgraph_control_plane.md
-        - concepts/langgraph_data_plane.md
-        - concepts/langgraph_platform.md
-        - concepts/langgraph_self_hosted_control_plane.md
-        - concepts/langgraph_self_hosted_data_plane.md
-        - concepts/langgraph_server.md
-        - concepts/langgraph_standalone_container.md
-        - concepts/langgraph_studio.md
-        - concepts/plans.md
-        - concepts/scalability_and_resilience.md
-        - concepts/sdk.md
-        - concepts/server-mcp.md
-        - concepts/template_applications.md
-        - concepts/why-langgraph.md
-        - examples/index.md
-        - guides/index.md
-        - how-tos/auth/custom_auth.md
-        - how-tos/auth/openapi_security.md
-        - how-tos/autogen-integration.md
-        - how-tos/http/custom_lifespan.md
-        - how-tos/http/custom_middleware.md
-        - how-tos/http/custom_routes.md
-        - how-tos/ttl/configure_ttl.md
-        - how-tos/use-remote-graph.md
-        - index.md
-        - reference/index.md
-        - snippets/chat_model_tabs.md
-        - troubleshooting/errors/GRAPH_RECURSION_LIMIT.md
-        - troubleshooting/errors/index.md
-        - troubleshooting/errors/INVALID_CHAT_HISTORY.md
-        - troubleshooting/errors/INVALID_CONCURRENT_GRAPH_UPDATE.md
-        - troubleshooting/errors/INVALID_GRAPH_NODE_RETURN_VALUE.md
-        - troubleshooting/errors/INVALID_LICENSE.md
-        - troubleshooting/errors/MULTIPLE_SUBGRAPHS.md
-        - troubleshooting/studio.md
-        - tutorials/auth/add_auth_server.md
-        - tutorials/auth/getting_started.md
-        - tutorials/auth/resource_auth.md
   - tags
   - include-markdown
   - mkdocstrings:
@@ -220,6 +123,7 @@ nav:
       - Streaming:
           - Overview: concepts/streaming.md
           - Stream outputs: how-tos/streaming.md
+          - Use Server API: cloud/how-tos/streaming.md
       - Persistence:
           - Overview: concepts/persistence.md
       - Durable execution:
@@ -237,9 +141,11 @@ nav:
       - Human-in-the-loop:
           - Overview: concepts/human_in_the_loop.md
           - Add human intervention: how-tos/human_in_the_loop/add-human-in-the-loop.md
+          - Use Server API: cloud/how-tos/add-human-in-the-loop.md
       - Time travel:
           - Overview: concepts/time-travel.md
           - Use time travel: how-tos/human_in_the_loop/time-travel.md
+          - Use Server API: cloud/how-tos/human_in_the_loop_time_travel.md
       - Subgraphs:
           - Overview: concepts/subgraphs.md
           - Use subgraphs: how-tos/subgraph.md
@@ -250,10 +156,88 @@ nav:
       - MCP:
           - Overview: concepts/mcp.md
           - Use MCP: agents/mcp.md
+          - Server API: concepts/server-mcp.md
       - Tracing:
           - Overview: concepts/tracing.md
           - Enable tracing: how-tos/enable-tracing.md
           - Evaluate performance: agents/evals.md
+    - Platform-only capabilities:
+      - LangGraph Platform:
+          - Overview: concepts/langgraph_platform.md
+          - Components:
+            - Overview: concepts/langgraph_components.md
+            - LangGraph Server:
+              - Overview: concepts/langgraph_server.md
+              - Data plane: concepts/langgraph_data_plane.md
+              - Control plane: concepts/langgraph_control_plane.md
+            - LangGraph CLI: concepts/langgraph_cli.md
+            - LangGraph Studio: 
+              - Overview: concepts/langgraph_studio.md
+              - Quickstart: cloud/how-tos/studio/quick_start.md
+              - cloud/how-tos/invoke_studio.md
+              - cloud/how-tos/studio/manage_assistants.md
+              - cloud/how-tos/threads_studio.md
+              - cloud/how-tos/iterate_graph_studio.md
+              - cloud/how-tos/studio/run_evals.md
+              - cloud/how-tos/clone_traces_studio.md
+              - cloud/how-tos/datasets_studio.md
+            - LangGraph SDK: concepts/sdk.md
+          - Plans & pricing: concepts/plans.md
+          - Application structure: concepts/application_structure.md
+          - Scalability & resilience: concepts/scalability_and_resilience.md
+      - Authentication & access control:
+          - Overview: concepts/auth.md
+          - how-tos/auth/custom_auth.md
+          - how-tos/auth/openapi_security.md
+      - Assistants:
+          - Overview: concepts/assistants.md
+          - cloud/how-tos/configuration_cloud.md
+          - Threads: cloud/how-tos/use_threads.md
+          - Runs:
+            - cloud/how-tos/background_run.md
+            - cloud/how-tos/same-thread.md
+            - cloud/how-tos/cron_jobs.md
+            - cloud/how-tos/stateless_runs.md
+            - cloud/how-tos/configurable_headers.md
+      - Double-texting: 
+          - Overview: concepts/double_texting.md
+          - cloud/how-tos/interrupt_concurrent.md
+          - cloud/how-tos/rollback_concurrent.md
+          - cloud/how-tos/reject_concurrent.md
+          - cloud/how-tos/enqueue_concurrent.md
+      - Webhooks:
+          - Overview: cloud/concepts/webhooks.md
+          - Use webhooks: cloud/how-tos/webhooks.md
+      - Cron jobs:
+          - Overview: cloud/concepts/cron_jobs.md
+          - cloud/how-tos/cron_jobs.md
+      - Server customization:
+          - how-tos/http/custom_lifespan.md
+          - how-tos/http/custom_middleware.md
+          - how-tos/http/custom_routes.md
+      - Data management:
+        - cloud/concepts/data_storage_and_privacy.md
+        - Add semantic search: cloud/deployment/semantic_search.md
+        - Add TTLs: how-tos/ttl/configure_ttl.md
+      - Deployment:
+          - Overview: concepts/deployment_options.md
+          - Quickstart: cloud/quick_start.md
+          - Set up your application:
+            - Use requirements.txt: cloud/deployment/setup.md
+            - Use pyproject.toml: cloud/deployment/setup_pyproject.md
+            - Use JavaScript: cloud/deployment/setup_javascript.md
+            - Use custom Docker: cloud/deployment/custom_docker.md
+            - Rebuild graph at runtime: cloud/deployment/graph_rebuild.md
+          - Deployment options:
+            - Cloud SaaS: concepts/langgraph_cloud.md
+            - Self-Hosted Data Plane: concepts/langgraph_self_hosted_data_plane.md
+            - Self-Hosted Control Plane: concepts/langgraph_self_hosted_control_plane.md
+            - Standalone Container: concepts/langgraph_standalone_container.md
+          - Deploy to production:
+            - Cloud SaaS: cloud/deployment/cloud.md
+            - Self-Hosted Data Plane: cloud/deployment/self_hosted_data_plane.md
+            - Self-Hosted Control Plane: cloud/deployment/self_hosted_control_plane.md
+            - Standalone Container: cloud/deployment/standalone_container.md
 
   - Reference:
     - reference/index.md
@@ -276,9 +260,14 @@ nav:
       - Swarm: reference/swarm.md
       - MCP Adapters: reference/mcp.md
     - LangGraph Platform:
+      - Server API: cloud/reference/api/api_ref.md
+      - Server changelog: cloud/reference/langgraph_server_changelog.md
+      - Control Plane API: cloud/reference/api/api_ref_control_plane.md
+      - CLI: cloud/reference/cli.md
       - SDK (Python): cloud/reference/sdk/python_sdk_ref.md
       - SDK (JS/TS): https://langchain-ai.github.io/langgraphjs/reference/modules/sdk.html
       - RemoteGraph: reference/remote_graph.md
+      - Environment variables: cloud/reference/env_var.md
 
   - Examples:
     - examples/index.md
@@ -288,6 +277,16 @@ nav:
     - SQL agent: tutorials/sql/sql-agent.md
     - Prebuilt chat UI: agents/ui.md
     - Graph runs in LangSmith: how-tos/run-id-langsmith.md
+    - LangGraph Platform:
+      - Authentication:
+        - tutorials/auth/getting_started.md
+        - tutorials/auth/resource_auth.md
+        - tutorials/auth/add_auth_server.md
+      - Use RemoteGraph: how-tos/use-remote-graph.md
+      - Deploy CrewAI, AutoGen, and other frameworks: how-tos/autogen-integration.md
+      - Front-end and generative UI:
+        - Integrate LangGraph into a React app: cloud/how-tos/use_stream_react.md
+        - Implement generative UI with LangGraph: cloud/how-tos/generative_ui_react.md
 
   - Additional resources:
     - additional-resources/index.md
@@ -306,6 +305,7 @@ nav:
           - troubleshooting/errors/MULTIPLE_SUBGRAPHS.md
           - troubleshooting/errors/INVALID_CHAT_HISTORY.md
           - troubleshooting/errors/INVALID_LICENSE.md
+        - LangGraph Studio: troubleshooting/studio.md
     
 
 markdown_extensions:
@@ -383,4 +383,5 @@ extra_css:
   - stylesheets/version_admonitions.css
   - stylesheets/logos.css
   - stylesheets/sticky_navigation.css
-  - stylesheets/agent_graph_widget.css
+  - stylesheets/agent_graph_widget.css
+

docs/overrides/main.html

@@ -291,7 +291,7 @@ j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
     }
 
     .md-banner {
-      background-color: #FFAE42;
+      background-color: #CFC9FA;
       color: #000000;
     }
 
@@ -360,5 +360,5 @@ j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
 {% endblock %}
 
 {% block announce %}
-These docs will be deprecated and removed with the release of LangGraph v1.0 in October 2025. <a href="https://docs.langchain.com/oss/python/langgraph/overview" target="_blank">Visit the v1.0 alpha docs</a>
+Our <a href="https://academy.langchain.com/courses/ambient-agents/?utm_medium=internal&utm_source=docs&utm_campaign=q2-2025_ambient-agents_co" target="_blank">Building Ambient Agents with LangGraph</a> course is now available on LangChain Academy!
 {% endblock %}

docs/pyproject.toml

@@ -7,14 +7,14 @@ name = "langgraph-docs"
 version = "0.0.1"
 description = "LangGraph docs"
 authors = []
-requires-python = ">=3.11.0,<4.0.0"
+requires-python = "~=3.11"
 readme = "README.md"
 license = "MIT"
 dependencies = [
     "aiohappyeyeballs==2.4.3",
-    "hub>=3.0.1,<4.0.0",
-    "xxhash>=3.5.0,<4.0.0",
-    "black>=25.1.0,<26.0.0",
+    "hub>=3.0.1,<4",
+    "xxhash>=3.5.0,<4",
+    "black>=25.1.0,<26",
 ]
 
 [dependency-groups]
@@ -39,7 +39,6 @@ docs = [
     "markdown-callouts",
     "markdown-include",
     "mkdocs-exclude",
-    "mkdocs-exclude-search",
     "psycopg[binary]",
     "psycopg-pool",
     "pygments-ansi-color",

docs/uv.lock

@@ -1,5 +1,5 @@
 version = 1
-revision = 3
+revision = 2
 requires-python = ">=3.11, <4"
 resolution-markers = [
     "python_full_version >= '3.13' and platform_python_implementation != 'PyPy'",
@@ -2337,7 +2337,7 @@ wheels = [
 
 [[package]]
 name = "langgraph"
-version = "0.6.7"
+version = "0.6.1"
 source = { editable = "../libs/langgraph" }
 dependencies = [
     { name = "langchain-core" },
@@ -2380,7 +2380,6 @@ dev = [
     { name = "pytest-repeat" },
     { name = "pytest-watcher" },
     { name = "pytest-xdist", extras = ["psutil"] },
-    { name = "redis" },
     { name = "ruff" },
     { name = "syrupy" },
     { name = "types-requests" },
@@ -2414,7 +2413,6 @@ dev = [
     { name = "pytest-asyncio" },
     { name = "pytest-mock" },
     { name = "pytest-watcher" },
-    { name = "redis" },
     { name = "ruff" },
 ]
 
@@ -2526,7 +2524,6 @@ docs = [
     { name = "markdown-include" },
     { name = "mkdocs" },
     { name = "mkdocs-exclude" },
-    { name = "mkdocs-exclude-search" },
     { name = "mkdocs-git-committers-plugin-2" },
     { name = "mkdocs-include-markdown-plugin" },
     { name = "mkdocs-material", extra = ["imaging"] },
@@ -2598,7 +2595,6 @@ docs = [
     { name = "markdown-include" },
     { name = "mkdocs" },
     { name = "mkdocs-exclude" },
-    { name = "mkdocs-exclude-search" },
     { name = "mkdocs-git-committers-plugin-2" },
     { name = "mkdocs-include-markdown-plugin", specifier = ">=7.1.6" },
     { name = "mkdocs-material", extras = ["imaging"] },
@@ -2645,7 +2641,7 @@ test = [
 
 [[package]]
 name = "langgraph-prebuilt"
-version = "0.6.4"
+version = "0.6.1"
 source = { editable = "../libs/prebuilt" }
 dependencies = [
     { name = "langchain-core" },
@@ -2676,6 +2672,7 @@ dev = [
 
 [[package]]
 name = "langgraph-sdk"
+version = "0.2.0"
 source = { editable = "../libs/sdk-py" }
 dependencies = [
     { name = "httpx" },
@@ -3033,18 +3030,6 @@ dependencies = [
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/54/b5/3a8e289282c9e8d7003f8a2f53d673d4fdaa81d493dc6966092d9985b6fc/mkdocs-exclude-1.0.2.tar.gz", hash = "sha256:ba6fab3c80ddbe3fd31d3e579861fd3124513708271180a5f81846da8c7e2a51", size = 6751, upload-time = "2019-02-20T23:34:12.81Z" }
 
-[[package]]
-name = "mkdocs-exclude-search"
-version = "0.6.6"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "mkdocs" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/1d/52/8243589d294cf6091c1145896915fe50feea0e91d64d843942d0175770c2/mkdocs-exclude-search-0.6.6.tar.gz", hash = "sha256:3cdff1b9afdc1b227019cd1e124f401453235b92153d60c0e5e651a76be4f044", size = 9501, upload-time = "2023-12-03T22:58:21.259Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/3b/ef/9af45ffb1bdba684a0694922abae0bb771e9777aba005933f838b7f1bcea/mkdocs_exclude_search-0.6.6-py3-none-any.whl", hash = "sha256:2b4b941d1689808db533fe4a6afba75ce76c9bab8b21d4e31efc05fd8c4e0a4f", size = 7821, upload-time = "2023-12-03T22:58:19.355Z" },
-]
-
 [[package]]
 name = "mkdocs-get-deps"
 version = "0.2.0"

examples/human_in_the_loop/dynamic_breakpoints.ipynb

@@ -0,0 +1,33 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "b3cec425",
+   "metadata": {},
+   "source": [
+    "This file has been moved to https://github.com/langchain-ai/langgraph/blob/main/docs/docs/how-tos/human_in_the_loop/dynamic_breakpoints.ipynb"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/human_in_the_loop/edit-graph-state.ipynb

@@ -0,0 +1,33 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "4876215f",
+   "metadata": {},
+   "source": [
+    "This file has been moved to https://github.com/langchain-ai/langgraph/blob/main/docs/docs/how-tos/human_in_the_loop/edit-graph-state.ipynb"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.8"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/human_in_the_loop/review-tool-calls.ipynb

@@ -0,0 +1,33 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "b162f1bd",
+   "metadata": {},
+   "source": [
+    "This file has been moved to https://github.com/langchain-ai/langgraph/blob/main/docs/docs/how-tos/human_in_the_loop/review-tool-calls.ipynb"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/human_in_the_loop/time-travel.ipynb

@@ -0,0 +1,33 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "84c5f6f1",
+   "metadata": {},
+   "source": [
+    "This file has been moved to https://github.com/langchain-ai/langgraph/blob/main/docs/docs/how-tos/human_in_the_loop/time-travel.ipynb"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/multi_agent/agent_supervisor.ipynb

@@ -0,0 +1,33 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "5eb637a4",
+   "metadata": {},
+   "source": [
+    "This file has been moved to https://github.com/langchain-ai/langgraph/blob/main/docs/docs/tutorials/multi_agent/agent_supervisor.ipynb"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

examples/persistence_postgres.ipynb

@@ -5,7 +5,7 @@
    "id": "18526f23",
    "metadata": {},
    "source": [
-    "This file has been moved to https://github.com/langchain-ai/langgraph/blob/main/docs/docs/how-tos/memory/add-memory.md"
+    "This file has been moved to https://github.com/langchain-ai/langgraph/blob/main/docs/docs/how-tos/persistence_postgres.ipynb"
    ]
   }
  ],

examples/rag/langgraph_crag_local.ipynb

@@ -707,9 +707,7 @@
     "    \"\"\"\n",
     "    Find all tool calls in the messages returned\n",
     "    \"\"\"\n",
-    "    tool_calls = [\n",
-    "        tc[\"name\"] for m in messages[\"messages\"] for tc in getattr(m, \"tool_calls\", [])\n",
-    "    ]\n",
+    "    tool_calls = [tc['name'] for m in messages['messages'] for tc in getattr(m, 'tool_calls', [])]\n",
     "    return tool_calls\n",
     "\n",
     "\n",

libs/checkpoint-postgres/langgraph/checkpoint/postgres/__init__.py

@@ -7,6 +7,11 @@ from contextlib import contextmanager
 from typing import Any
 
 from langchain_core.runnables import RunnableConfig
+from psycopg import Capabilities, Connection, Cursor, Pipeline
+from psycopg.rows import DictRow, dict_row
+from psycopg.types.json import Jsonb
+from psycopg_pool import ConnectionPool
+
 from langgraph.checkpoint.base import (
     WRITES_IDX_MAP,
     ChannelVersions,
@@ -14,17 +19,12 @@ from langgraph.checkpoint.base import (
     CheckpointMetadata,
     CheckpointTuple,
     get_checkpoint_id,
-    get_serializable_checkpoint_metadata,
+    get_checkpoint_metadata,
 )
-from langgraph.checkpoint.serde.base import SerializerProtocol
-from psycopg import Capabilities, Connection, Cursor, Pipeline
-from psycopg.rows import DictRow, dict_row
-from psycopg.types.json import Jsonb
-from psycopg_pool import ConnectionPool
-
 from langgraph.checkpoint.postgres import _internal
 from langgraph.checkpoint.postgres.base import BasePostgresSaver
 from langgraph.checkpoint.postgres.shallow import ShallowPostgresSaver
+from langgraph.checkpoint.serde.base import SerializerProtocol
 
 Conn = _internal.Conn  # For backward compatibility
 
@@ -325,7 +325,7 @@ class PostgresSaver(BasePostgresSaver):
                     checkpoint["id"],
                     checkpoint_id,
                     Jsonb(copy),
-                    Jsonb(get_serializable_checkpoint_metadata(config, metadata)),
+                    Jsonb(get_checkpoint_metadata(config, metadata)),
                 ),
             )
         return next_config
@@ -450,7 +450,7 @@ class PostgresSaver(BasePostgresSaver):
             {
                 **value["checkpoint"],
                 "channel_values": {
-                    **(value["checkpoint"].get("channel_values") or {}),
+                    **value["checkpoint"].get("channel_values"),
                     **self._load_blobs(value["channel_values"]),
                 },
             },

libs/checkpoint-postgres/langgraph/checkpoint/postgres/aio.py

@@ -7,6 +7,11 @@ from contextlib import asynccontextmanager
 from typing import Any
 
 from langchain_core.runnables import RunnableConfig
+from psycopg import AsyncConnection, AsyncCursor, AsyncPipeline, Capabilities
+from psycopg.rows import DictRow, dict_row
+from psycopg.types.json import Jsonb
+from psycopg_pool import AsyncConnectionPool
+
 from langgraph.checkpoint.base import (
     WRITES_IDX_MAP,
     ChannelVersions,
@@ -14,17 +19,12 @@ from langgraph.checkpoint.base import (
     CheckpointMetadata,
     CheckpointTuple,
     get_checkpoint_id,
-    get_serializable_checkpoint_metadata,
+    get_checkpoint_metadata,
 )
-from langgraph.checkpoint.serde.base import SerializerProtocol
-from psycopg import AsyncConnection, AsyncCursor, AsyncPipeline, Capabilities
-from psycopg.rows import DictRow, dict_row
-from psycopg.types.json import Jsonb
-from psycopg_pool import AsyncConnectionPool
-
 from langgraph.checkpoint.postgres import _ainternal
 from langgraph.checkpoint.postgres.base import BasePostgresSaver
 from langgraph.checkpoint.postgres.shallow import AsyncShallowPostgresSaver
+from langgraph.checkpoint.serde.base import SerializerProtocol
 
 Conn = _ainternal.Conn  # For backward compatibility
 
@@ -283,7 +283,7 @@ class AsyncPostgresSaver(BasePostgresSaver):
                     checkpoint["id"],
                     checkpoint_id,
                     Jsonb(copy),
-                    Jsonb(get_serializable_checkpoint_metadata(config, metadata)),
+                    Jsonb(get_checkpoint_metadata(config, metadata)),
                 ),
             )
         return next_config
@@ -409,7 +409,7 @@ class AsyncPostgresSaver(BasePostgresSaver):
             {
                 **value["checkpoint"],
                 "channel_values": {
-                    **(value["checkpoint"].get("channel_values") or {}),
+                    **value["checkpoint"].get("channel_values"),
                     **self._load_blobs(value["channel_values"]),
                 },
             },

libs/checkpoint-postgres/langgraph/checkpoint/postgres/base.py

@@ -1,12 +1,12 @@
 from __future__ import annotations
 
 import random
-import warnings
 from collections.abc import Sequence
-from importlib.metadata import version as get_version
 from typing import Any, Optional, cast
 
 from langchain_core.runnables import RunnableConfig
+from psycopg.types.json import Jsonb
+
 from langgraph.checkpoint.base import (
     WRITES_IDX_MAP,
     BaseCheckpointSaver,
@@ -14,22 +14,9 @@ from langgraph.checkpoint.base import (
     get_checkpoint_id,
 )
 from langgraph.checkpoint.serde.types import TASKS
-from psycopg.types.json import Jsonb
 
 MetadataInput = Optional[dict[str, Any]]
 
-try:
-    major, minor = get_version("langgraph").split(".")[:2]
-    if int(major) == 0 and int(minor) < 5:
-        warnings.warn(
-            "You're using incompatible versions of langgraph and checkpoint-postgres. Please upgrade langgraph to avoid unexpected behavior.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
-except Exception:
-    # skip version check if running from source
-    pass
-
 """
 To add a new migration, add a new string to the MIGRATIONS list.
 The position of the migration in the list is the version number.

libs/checkpoint-postgres/langgraph/checkpoint/postgres/shallow.py

@@ -6,16 +6,6 @@ from contextlib import asynccontextmanager, contextmanager
 from typing import Any, Optional
 
 from langchain_core.runnables import RunnableConfig
-from langgraph.checkpoint.base import (
-    WRITES_IDX_MAP,
-    ChannelVersions,
-    Checkpoint,
-    CheckpointMetadata,
-    CheckpointTuple,
-    get_serializable_checkpoint_metadata,
-)
-from langgraph.checkpoint.serde.base import SerializerProtocol
-from langgraph.checkpoint.serde.types import TASKS
 from psycopg import (
     AsyncConnection,
     AsyncCursor,
@@ -29,8 +19,18 @@ from psycopg.rows import DictRow, dict_row
 from psycopg.types.json import Jsonb
 from psycopg_pool import AsyncConnectionPool, ConnectionPool
 
+from langgraph.checkpoint.base import (
+    WRITES_IDX_MAP,
+    ChannelVersions,
+    Checkpoint,
+    CheckpointMetadata,
+    CheckpointTuple,
+    get_checkpoint_metadata,
+)
 from langgraph.checkpoint.postgres import _ainternal, _internal
 from langgraph.checkpoint.postgres.base import BasePostgresSaver
+from langgraph.checkpoint.serde.base import SerializerProtocol
+from langgraph.checkpoint.serde.types import TASKS
 
 """
 To add a new migration, add a new string to the MIGRATIONS list.
@@ -441,7 +441,7 @@ class ShallowPostgresSaver(BasePostgresSaver):
                     thread_id,
                     checkpoint_ns,
                     Jsonb(copy),
-                    Jsonb(get_serializable_checkpoint_metadata(config, metadata)),
+                    Jsonb(get_checkpoint_metadata(config, metadata)),
                 ),
             )
         return next_config
@@ -774,7 +774,7 @@ class AsyncShallowPostgresSaver(BasePostgresSaver):
                     thread_id,
                     checkpoint_ns,
                     Jsonb(copy),
-                    Jsonb(get_serializable_checkpoint_metadata(config, metadata)),
+                    Jsonb(get_checkpoint_metadata(config, metadata)),
                 ),
             )
         return next_config

libs/checkpoint-postgres/langgraph/store/postgres/__init__.py

@@ -1,4 +1,4 @@
 from langgraph.store.postgres.aio import AsyncPostgresStore
-from langgraph.store.postgres.base import PoolConfig, PostgresStore
+from langgraph.store.postgres.base import PostgresStore
 
-__all__ = ["AsyncPostgresStore", "PoolConfig", "PostgresStore"]
+__all__ = ["AsyncPostgresStore", "PostgresStore"]

libs/checkpoint-postgres/langgraph/store/postgres/aio.py

@@ -8,6 +8,11 @@ from types import TracebackType
 from typing import Any, Callable, cast
 
 import orjson
+from psycopg import AsyncConnection, AsyncCursor, AsyncPipeline, Capabilities
+from psycopg.rows import DictRow, dict_row
+from psycopg_pool import AsyncConnectionPool
+
+from langgraph.checkpoint.postgres import _ainternal
 from langgraph.store.base import (
     GetOp,
     ListNamespacesOp,
@@ -17,11 +22,6 @@ from langgraph.store.base import (
     SearchOp,
 )
 from langgraph.store.base.batch import AsyncBatchedBaseStore
-from psycopg import AsyncConnection, AsyncCursor, AsyncPipeline, Capabilities
-from psycopg.rows import DictRow, dict_row
-from psycopg_pool import AsyncConnectionPool
-
-from langgraph.checkpoint.postgres import _ainternal
 from langgraph.store.postgres.base import (
     PLACEHOLDER,
     BasePostgresStore,

libs/checkpoint-postgres/langgraph/store/postgres/base.py

@@ -22,6 +22,14 @@ from typing import (
 )
 
 import orjson
+from psycopg import Capabilities, Connection, Cursor, Pipeline
+from psycopg.rows import DictRow, dict_row
+from psycopg.types.json import Jsonb
+from psycopg_pool import ConnectionPool
+from typing_extensions import TypedDict
+
+from langgraph.checkpoint.postgres import _ainternal as _ainternal
+from langgraph.checkpoint.postgres import _internal as _pg_internal
 from langgraph.store.base import (
     BaseStore,
     GetOp,
@@ -38,14 +46,6 @@ from langgraph.store.base import (
     get_text_at_path,
     tokenize_path,
 )
-from psycopg import Capabilities, Connection, Cursor, Pipeline
-from psycopg.rows import DictRow, dict_row
-from psycopg.types.json import Jsonb
-from psycopg_pool import ConnectionPool
-from typing_extensions import TypedDict
-
-from langgraph.checkpoint.postgres import _ainternal as _ainternal
-from langgraph.checkpoint.postgres import _internal as _pg_internal
 
 if TYPE_CHECKING:
     from langchain_core.embeddings import Embeddings

libs/checkpoint-postgres/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "langgraph-checkpoint-postgres"
-version = "2.0.25"
+version = "2.0.23"
 description = "Library with a Postgres implementation of LangGraph checkpoint saver."
 authors = []
 requires-python = ">=3.9"
@@ -12,7 +12,7 @@ readme = "README.md"
 license = "MIT"
 license-files = ['LICENSE']
 dependencies = [
-  "langgraph-checkpoint>=2.1.2,<3.0.0",
+  "langgraph-checkpoint>=2.0.21,<3.0.0",
   "orjson>=3.10.1",
   "psycopg>=3.2.0",
   "psycopg-pool>=3.2.0",

libs/checkpoint-postgres/tests/test_async.py

@@ -6,6 +6,10 @@ from uuid import uuid4
 
 import pytest
 from langchain_core.runnables import RunnableConfig
+from psycopg import AsyncConnection
+from psycopg.rows import dict_row
+from psycopg_pool import AsyncConnectionPool
+
 from langgraph.checkpoint.base import (
     EXCLUDED_METADATA_KEYS,
     Checkpoint,
@@ -13,15 +17,11 @@ from langgraph.checkpoint.base import (
     create_checkpoint,
     empty_checkpoint,
 )
-from langgraph.checkpoint.serde.types import TASKS
-from psycopg import AsyncConnection
-from psycopg.rows import dict_row
-from psycopg_pool import AsyncConnectionPool
-
 from langgraph.checkpoint.postgres.aio import (
     AsyncPostgresSaver,
     AsyncShallowPostgresSaver,
 )
+from langgraph.checkpoint.serde.types import TASKS
 from tests.conftest import DEFAULT_POSTGRES_URI
 
 
@@ -187,11 +187,13 @@ def test_data():
     metadata_1: CheckpointMetadata = {
         "source": "input",
         "step": 2,
+        "writes": {},
         "score": 1,
     }
     metadata_2: CheckpointMetadata = {
         "source": "loop",
         "step": 1,
+        "writes": {"foo": "bar"},
         "score": None,
     }
     metadata_3: CheckpointMetadata = {}
@@ -218,6 +220,7 @@ async def test_combined_metadata(saver_name: str, test_data) -> None:
         metadata: CheckpointMetadata = {
             "source": "loop",
             "step": 1,
+            "writes": {"foo": "bar"},
             "score": None,
         }
         await saver.aput(config, chkpnt, metadata, {})
@@ -243,6 +246,7 @@ async def test_asearch(saver_name: str, test_data) -> None:
         query_1 = {"source": "input"}  # search by 1 key
         query_2 = {
             "step": 1,
+            "writes": {"foo": "bar"},
         }  # search by multiple keys
         query_3: dict[str, Any] = {}  # search by no keys, return all checkpoints
         query_4 = {"source": "update", "step": 1}  # no match
@@ -340,34 +344,3 @@ async def test_pending_sends_migration(saver_name: str) -> None:
             TASKS: ["send-1", "send-2", "send-3"]
         }
         assert TASKS in search_results[0].checkpoint["channel_versions"]
-
-
-@pytest.mark.parametrize("saver_name", ["base", "pool", "pipe"])
-async def test_get_checkpoint_no_channel_values(
-    monkeypatch, saver_name: str, test_data
-) -> None:
-    """Backwards compatibility test that verifies a checkpoint with no channel_values key can be retrieved without throwing an error."""
-    async with _saver(saver_name) as saver:
-        config = {
-            "configurable": {
-                "thread_id": "thread-2",
-                "checkpoint_ns": "",
-                "__super_private_key": "super_private_value",
-            },
-            "metadata": {"run_id": "my_run_id"},
-        }
-        chkpnt: Checkpoint = create_checkpoint(empty_checkpoint(), {}, 1)
-        await saver.aput(config, chkpnt, {}, {})
-
-        load_checkpoint_tuple = saver._load_checkpoint_tuple
-
-        def patched_load_checkpoint_tuple(value):
-            value["checkpoint"].pop("channel_values", None)
-            return load_checkpoint_tuple(value)
-
-        monkeypatch.setattr(
-            saver, "_load_checkpoint_tuple", patched_load_checkpoint_tuple
-        )
-
-        checkpoint = await saver.aget_tuple(config)
-        assert checkpoint.checkpoint["channel_values"] == {}

libs/checkpoint-postgres/tests/test_async_store.py

@@ -12,6 +12,8 @@ from typing import Any
 
 import pytest
 from langchain_core.embeddings import Embeddings
+from psycopg import AsyncConnection
+
 from langgraph.store.base import (
     GetOp,
     Item,
@@ -19,8 +21,6 @@ from langgraph.store.base import (
     PutOp,
     SearchOp,
 )
-from psycopg import AsyncConnection
-
 from langgraph.store.postgres import AsyncPostgresStore
 from tests.conftest import (
     DEFAULT_URI,

libs/checkpoint-postgres/tests/test_store.py

@@ -9,6 +9,8 @@ from uuid import uuid4
 
 import pytest
 from langchain_core.embeddings import Embeddings
+from psycopg import Connection
+
 from langgraph.store.base import (
     GetOp,
     Item,
@@ -17,8 +19,6 @@ from langgraph.store.base import (
     PutOp,
     SearchOp,
 )
-from psycopg import Connection
-
 from langgraph.store.postgres import PostgresStore
 from tests.conftest import (
     DEFAULT_URI,
@@ -861,41 +861,3 @@ def test_store_ttl(store):
     # Now has been (TTL_SECONDS-2)*2 > TTL_SECONDS + TTL_SECONDS/2
     res = store.search(ns, query="bar", refresh_ttl=False)
     assert len(res) == 0
-
-
-@pytest.mark.parametrize(
-    "vector_type,distance_type",
-    [
-        ("vector", "cosine"),
-        ("vector", "inner_product"),
-        ("halfvec", "cosine"),
-        ("halfvec", "inner_product"),
-    ],
-)
-def test_non_ascii(
-    request: Any,
-    fake_embeddings: CharacterEmbeddings,
-    vector_type: str,
-    distance_type: str,
-) -> None:
-    """Test support for non-ascii characters"""
-    with _create_vector_store(vector_type, distance_type, fake_embeddings) as store:
-        store.put(("user_123", "memories"), "1", {"text": "这是中文"})  # Chinese
-        store.put(
-            ("user_123", "memories"), "2", {"text": "これは日本語です"}
-        )  # Japanese
-        store.put(("user_123", "memories"), "3", {"text": "이건 한국어야"})  # Korean
-        store.put(("user_123", "memories"), "4", {"text": "Это русский"})  # Russian
-        store.put(("user_123", "memories"), "5", {"text": "यह रूसी है"})  # Hindi
-
-        result1 = store.search(("user_123", "memories"), query="这是中文")
-        result2 = store.search(("user_123", "memories"), query="これは日本語です")
-        result3 = store.search(("user_123", "memories"), query="이건 한국어야")
-        result4 = store.search(("user_123", "memories"), query="Это русский")
-        result5 = store.search(("user_123", "memories"), query="यह रूसी है")
-
-        assert result1[0].key == "1"
-        assert result2[0].key == "2"
-        assert result3[0].key == "3"
-        assert result4[0].key == "4"
-        assert result5[0].key == "5"

libs/checkpoint-postgres/tests/test_sync.py

@@ -7,6 +7,10 @@ from uuid import uuid4
 
 import pytest
 from langchain_core.runnables import RunnableConfig
+from psycopg import Connection
+from psycopg.rows import dict_row
+from psycopg_pool import ConnectionPool
+
 from langgraph.checkpoint.base import (
     EXCLUDED_METADATA_KEYS,
     Checkpoint,
@@ -14,12 +18,8 @@ from langgraph.checkpoint.base import (
     create_checkpoint,
     empty_checkpoint,
 )
-from langgraph.checkpoint.serde.types import TASKS
-from psycopg import Connection
-from psycopg.rows import dict_row
-from psycopg_pool import ConnectionPool
-
 from langgraph.checkpoint.postgres import PostgresSaver, ShallowPostgresSaver
+from langgraph.checkpoint.serde.types import TASKS
 from tests.conftest import DEFAULT_POSTGRES_URI
 
 
@@ -169,11 +169,13 @@ def test_data():
     metadata_1: CheckpointMetadata = {
         "source": "input",
         "step": 2,
+        "writes": {},
         "score": 1,
     }
     metadata_2: CheckpointMetadata = {
         "source": "loop",
         "step": 1,
+        "writes": {"foo": "bar"},
         "score": None,
     }
     metadata_3: CheckpointMetadata = {}
@@ -200,6 +202,7 @@ def test_combined_metadata(saver_name: str, test_data) -> None:
         metadata: CheckpointMetadata = {
             "source": "loop",
             "step": 1,
+            "writes": {"foo": "bar"},
             "score": None,
         }
         saver.put(config, chkpnt, metadata, {})
@@ -225,6 +228,7 @@ def test_search(saver_name: str, test_data) -> None:
         query_1 = {"source": "input"}  # search by 1 key
         query_2 = {
             "step": 1,
+            "writes": {"foo": "bar"},
         }  # search by multiple keys
         query_3: dict[str, Any] = {}  # search by no keys, return all checkpoints
         query_4 = {"source": "update", "step": 1}  # no match
@@ -328,33 +332,3 @@ def test_pending_sends_migration(saver_name: str) -> None:
             TASKS: ["send-1", "send-2", "send-3"]
         }
         assert TASKS in search_results[0].checkpoint["channel_versions"]
-
-
-@pytest.mark.parametrize("saver_name", ["base", "pool", "pipe"])
-def test_get_checkpoint_no_channel_values(
-    monkeypatch, saver_name: str, test_data
-) -> None:
-    """Backwards compatibility test that verifies a checkpoint with no channel_values key can be retrieved without throwing an error."""
-    with _saver(saver_name) as saver:
-        config = {
-            "configurable": {
-                "thread_id": "thread-2",
-                "checkpoint_ns": "",
-                "__super_private_key": "super_private_value",
-            },
-        }
-        chkpnt: Checkpoint = create_checkpoint(empty_checkpoint(), {}, 1)
-        saver.put(config, chkpnt, {}, {})
-
-        load_checkpoint_tuple = saver._load_checkpoint_tuple
-
-        def patched_load_checkpoint_tuple(value):
-            value["checkpoint"].pop("channel_values", None)
-            return load_checkpoint_tuple(value)
-
-        monkeypatch.setattr(
-            saver, "_load_checkpoint_tuple", patched_load_checkpoint_tuple
-        )
-
-        checkpoint = saver.get_tuple(config)
-        assert checkpoint.checkpoint["channel_values"] == {}

libs/checkpoint-sqlite/langgraph/checkpoint/sqlite/__init__.py

@@ -8,6 +8,7 @@ from contextlib import closing, contextmanager
 from typing import Any, cast
 
 from langchain_core.runnables import RunnableConfig
+
 from langgraph.checkpoint.base import (
     WRITES_IDX_MAP,
     BaseCheckpointSaver,
@@ -20,7 +21,6 @@ from langgraph.checkpoint.base import (
     get_checkpoint_metadata,
 )
 from langgraph.checkpoint.serde.jsonplus import JsonPlusSerializer
-
 from langgraph.checkpoint.sqlite.utils import search_where
 
 _AIO_ERROR_MSG = (

libs/checkpoint-sqlite/langgraph/checkpoint/sqlite/aio.py

@@ -8,6 +8,7 @@ from typing import Any, Callable, TypeVar, cast
 
 import aiosqlite
 from langchain_core.runnables import RunnableConfig
+
 from langgraph.checkpoint.base import (
     WRITES_IDX_MAP,
     BaseCheckpointSaver,
@@ -20,7 +21,6 @@ from langgraph.checkpoint.base import (
     get_checkpoint_metadata,
 )
 from langgraph.checkpoint.serde.jsonplus import JsonPlusSerializer
-
 from langgraph.checkpoint.sqlite.utils import search_where
 
 T = TypeVar("T", bound=Callable)

libs/checkpoint-sqlite/langgraph/checkpoint/sqlite/utils.py

@@ -5,6 +5,7 @@ from collections.abc import Sequence
 from typing import Any
 
 from langchain_core.runnables import RunnableConfig
+
 from langgraph.checkpoint.base import get_checkpoint_id
 
 

libs/checkpoint-sqlite/langgraph/store/sqlite/aio.py

@@ -11,6 +11,7 @@ from typing import Any, Callable, cast
 import aiosqlite
 import orjson
 import sqlite_vec  # type: ignore[import-untyped]
+
 from langgraph.store.base import (
     GetOp,
     ListNamespacesOp,
@@ -21,7 +22,6 @@ from langgraph.store.base import (
     TTLConfig,
 )
 from langgraph.store.base.batch import AsyncBatchedBaseStore
-
 from langgraph.store.sqlite.base import (
     _PLACEHOLDER,
     BaseSqliteStore,
@@ -507,9 +507,7 @@ class AsyncSqliteStore(AsyncBatchedBaseStore, BaseSqliteStore):
             results: List to store results in.
             cur: Database cursor.
         """
-        prepared_queries, embedding_requests = self._prepare_batch_search_queries(
-            search_ops
-        )
+        queries, embedding_requests = self._prepare_batch_search_queries(search_ops)
 
         # Setup dot_product function if it doesn't exist
         if embedding_requests and self.embeddings:
@@ -517,60 +515,23 @@ class AsyncSqliteStore(AsyncBatchedBaseStore, BaseSqliteStore):
                 [query for _, query in embedding_requests]
             )
 
-            for (embed_req_idx, _), embedding in zip(embedding_requests, vectors):
-                # Find the corresponding query in prepared_queries
-                # The embed_req_idx is the original index in search_ops, which should map to prepared_queries
-                if embed_req_idx < len(prepared_queries):
-                    _params_list: list = prepared_queries[embed_req_idx][1]
-                    for i, param in enumerate(_params_list):
-                        if param is _PLACEHOLDER:
-                            _params_list[i] = sqlite_vec.serialize_float32(embedding)
-                else:
-                    logger.warning(
-                        f"Embedding request index {embed_req_idx} out of bounds for prepared_queries."
-                    )
+            for (idx, _), embedding in zip(embedding_requests, vectors):
+                _params_list: list = queries[idx][1]
+                for i, param in enumerate(_params_list):
+                    if param is _PLACEHOLDER:
+                        _params_list[i] = sqlite_vec.serialize_float32(embedding)
 
-        for (original_op_idx, _), (query, params, needs_refresh) in zip(
-            search_ops, prepared_queries
-        ):
+        for (idx, _), (query, params) in zip(search_ops, queries):
             await cur.execute(query, params)
             rows = await cur.fetchall()
 
-            if needs_refresh and rows and self.ttl_config:
-                keys_to_refresh = []
-                for row_data in rows:
-                    # Assuming row_data[0] is prefix (text), row_data[1] is key (text)
-                    # These are raw text values directly from the DB.
-                    keys_to_refresh.append((row_data[0], row_data[1]))
-
-                if keys_to_refresh:
-                    updates_by_prefix = defaultdict(list)
-                    for prefix_text, key_text in keys_to_refresh:
-                        updates_by_prefix[prefix_text].append(key_text)
-
-                    for prefix_text, key_list in updates_by_prefix.items():
-                        placeholders = ",".join(["?"] * len(key_list))
-                        update_query = f"""
-                            UPDATE store
-                            SET expires_at = DATETIME(CURRENT_TIMESTAMP, '+' || ttl_minutes || ' minutes')
-                            WHERE prefix = ? AND key IN ({placeholders}) AND ttl_minutes IS NOT NULL
-                        """
-                        update_params = (prefix_text, *key_list)
-                        try:
-                            await cur.execute(update_query, update_params)
-                        except Exception as e:
-                            logger.error(
-                                f"Error during TTL refresh update for search: {e}"
-                            )
-
-            # Process rows into items
-            if "score" in query:  # Vector search query
+            if "score" in query:
                 items = [
                     _row_to_search_item(
-                        _decode_ns_text(row[0]),  # prefix
+                        _decode_ns_text(row[0]),
                         {
-                            "key": row[1],  # key
-                            "value": row[2],  # value
+                            "key": row[1],
+                            "value": row[2],
                             "created_at": row[3],
                             "updated_at": row[4],
                             "expires_at": row[5] if len(row) > 5 else None,
@@ -584,10 +545,10 @@ class AsyncSqliteStore(AsyncBatchedBaseStore, BaseSqliteStore):
             else:  # Regular search query
                 items = [
                     _row_to_search_item(
-                        _decode_ns_text(row[0]),  # prefix
+                        _decode_ns_text(row[0]),
                         {
-                            "key": row[1],  # key
-                            "value": row[2],  # value
+                            "key": row[1],
+                            "value": row[2],
                             "created_at": row[3],
                             "updated_at": row[4],
                             "expires_at": row[5] if len(row) > 5 else None,
@@ -598,7 +559,7 @@ class AsyncSqliteStore(AsyncBatchedBaseStore, BaseSqliteStore):
                     for row in rows
                 ]
 
-            results[original_op_idx] = items
+            results[idx] = items
 
     async def _batch_list_namespaces_ops(
         self,

libs/checkpoint-sqlite/langgraph/store/sqlite/base.py

@@ -13,6 +13,7 @@ from typing import Any, Callable, Literal, NamedTuple, cast
 
 import orjson
 import sqlite_vec  # type: ignore[import-untyped]
+
 from langgraph.store.base import (
     BaseStore,
     GetOp,
@@ -371,15 +372,13 @@ class BaseSqliteStore:
     def _prepare_batch_search_queries(
         self, search_ops: Sequence[tuple[int, SearchOp]]
     ) -> tuple[
-        list[
-            tuple[str, list[None | str | list[float]], bool]
-        ],  # queries, params, needs_refresh
+        list[tuple[str, list[None | str | list[float]]]],  # queries, params
         list[tuple[int, str]],  # idx, query_text pairs to embed
     ]:
         """
-        Build per-SearchOp SQL queries (with optional TTL refresh flag) plus embedding requests.
+        Build per-SearchOp SQL queries (with optional TTL refresh) plus embedding requests.
         Returns:
-        - queries: list of (SQL, param_list, needs_ttl_refresh_flag)
+        - queries: list of (SQL, param_list)
         - embedding_requests: list of (original_index_in_search_ops, text_query)
         """
         queries = []
@@ -520,18 +519,30 @@ class BaseSqliteStore:
                 logger.debug(f"Search query: {base_query}")
                 logger.debug(f"Search params: {params}")
 
-            # Determine if TTL refresh is needed
-            needs_ttl_refresh = bool(
+            # Handle TTL refresh if requested
+            if (
                 op.refresh_ttl
                 and self.ttl_config
                 and self.ttl_config.get("refresh_on_read", False)
-            )
+            ):
+                final_sql = f"""
+                    WITH search_results AS (
+                        {base_query}
+                    ),
+                    updated AS (
+                        UPDATE store
+                        SET expires_at = DATETIME(CURRENT_TIMESTAMP, '+' || ttl_minutes || ' minutes')
+                        WHERE (prefix, key) IN (SELECT prefix, key FROM search_results)
+                        AND ttl_minutes IS NOT NULL
+                    )
+                    SELECT * FROM search_results
+                """
+                final_params = params[:]  # copy params
+            else:
+                final_sql = base_query
+                final_params = params
 
-            # The base_query is now the final_sql, and we pass the refresh flag
-            final_sql = base_query
-            final_params = params
-
-            queries.append((final_sql, final_params, needs_ttl_refresh))
+            queries.append((final_sql, final_params))
 
         return queries, embedding_requests
 
@@ -1320,9 +1331,7 @@ class SqliteStore(BaseSqliteStore, BaseStore):
         results: list[Result],
         cur: sqlite3.Cursor,
     ) -> None:
-        prepared_queries, embedding_requests = self._prepare_batch_search_queries(
-            search_ops
-        )
+        queries, embedding_requests = self._prepare_batch_search_queries(search_ops)
 
         # Setup similarity functions if they don't exist
         if embedding_requests and self.embeddings:
@@ -1332,48 +1341,16 @@ class SqliteStore(BaseSqliteStore, BaseStore):
             )
 
             # Replace placeholders with actual embeddings
-            for (embed_req_idx, _), embedding in zip(embedding_requests, embeddings):
-                if embed_req_idx < len(prepared_queries):
-                    _params_list: list = prepared_queries[embed_req_idx][1]
-                    for i, param in enumerate(_params_list):
-                        if param is _PLACEHOLDER:
-                            _params_list[i] = sqlite_vec.serialize_float32(embedding)
-                else:
-                    logger.warning(
-                        f"Embedding request index {embed_req_idx} out of bounds for prepared_queries."
-                    )
+            for (idx, _), embedding in zip(embedding_requests, embeddings):
+                _params_list: list = queries[idx][1]
+                for i, param in enumerate(_params_list):
+                    if param is _PLACEHOLDER:
+                        _params_list[i] = sqlite_vec.serialize_float32(embedding)
 
-        for (original_op_idx, _), (query, params, needs_refresh) in zip(
-            search_ops, prepared_queries
-        ):
+        for (idx, _), (query, params) in zip(search_ops, queries):
             cur.execute(query, params)
             rows = cur.fetchall()
 
-            if needs_refresh and rows and self.ttl_config:
-                keys_to_refresh = []
-                for row_data in rows:
-                    keys_to_refresh.append((row_data[0], row_data[1]))
-
-                if keys_to_refresh:
-                    updates_by_prefix = defaultdict(list)
-                    for prefix_text, key_text in keys_to_refresh:
-                        updates_by_prefix[prefix_text].append(key_text)
-
-                    for prefix_text, key_list in updates_by_prefix.items():
-                        placeholders = ",".join(["?"] * len(key_list))
-                        update_query = f"""
-                            UPDATE store
-                            SET expires_at = DATETIME(CURRENT_TIMESTAMP, '+' || ttl_minutes || ' minutes')
-                            WHERE prefix = ? AND key IN ({placeholders}) AND ttl_minutes IS NOT NULL
-                        """
-                        update_params = (prefix_text, *key_list)
-                        try:
-                            cur.execute(update_query, update_params)
-                        except Exception as e:
-                            logger.error(
-                                f"Error during TTL refresh update for search: {e}"
-                            )
-
             if "score" in query:  # Vector search query
                 items = [
                     _row_to_search_item(
@@ -1408,7 +1385,7 @@ class SqliteStore(BaseSqliteStore, BaseStore):
                     for row in rows
                 ]
 
-            results[original_op_idx] = items
+            results[idx] = items
 
     def _batch_list_namespaces_ops(
         self,

libs/checkpoint-sqlite/tests/test_aiosqlite.py

@@ -2,13 +2,13 @@ from typing import Any
 
 import pytest
 from langchain_core.runnables import RunnableConfig
+
 from langgraph.checkpoint.base import (
     Checkpoint,
     CheckpointMetadata,
     create_checkpoint,
     empty_checkpoint,
 )
-
 from langgraph.checkpoint.sqlite.aio import AsyncSqliteSaver
 
 

libs/checkpoint-sqlite/tests/test_async_store.py

@@ -8,6 +8,7 @@ from contextlib import asynccontextmanager
 from typing import Optional, Union, cast
 
 import pytest
+
 from langgraph.store.base import (
     GetOp,
     Item,
@@ -15,7 +16,6 @@ from langgraph.store.base import (
     PutOp,
     SearchOp,
 )
-
 from langgraph.store.sqlite import AsyncSqliteStore
 from langgraph.store.sqlite.base import SqliteIndexConfig
 from tests.test_store import CharacterEmbeddings

libs/checkpoint-sqlite/tests/test_sqlite.py

@@ -2,13 +2,13 @@ from typing import Any, cast
 
 import pytest
 from langchain_core.runnables import RunnableConfig
+
 from langgraph.checkpoint.base import (
     Checkpoint,
     CheckpointMetadata,
     create_checkpoint,
     empty_checkpoint,
 )
-
 from langgraph.checkpoint.sqlite import SqliteSaver
 from langgraph.checkpoint.sqlite.utils import _metadata_predicate, search_where
 
@@ -116,17 +116,7 @@ class TestSqliteSaver:
                 search_results_5[1].config["configurable"]["checkpoint_ns"],
             } == {"", "inner"}
 
-            # search with before param
-            search_results_6 = list(saver.list(None, before=search_results_5[1].config))
-            assert len(search_results_6) == 1
-            assert search_results_6[0].config["configurable"]["thread_id"] == "thread-1"
-
-            # search with limit param
-            search_results_7 = list(
-                saver.list({"configurable": {"thread_id": "thread-2"}}, limit=1)
-            )
-            assert len(search_results_7) == 1
-            assert search_results_7[0].config["configurable"]["thread_id"] == "thread-2"
+            # TODO: test before and limit params
 
     def test_search_where(self) -> None:
         # call method / assertions