Merge branch 'main' into add-copy-page-button

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

.github/workflows/pr_lint.yml

@@ -38,7 +38,6 @@ jobs:
             prebuilt
             scheduler-kafka
             sdk-py
-            docs
           requireScope: false
           ignoreLabels: |
             ignore-lint-pr-title

CONTRIBUTING.md

@@ -1,4 +1,3 @@
-TESTING
 # Contributing to LangGraph
 
 Thank you for being interested in contributing to LangGraph!
@@ -292,4 +291,4 @@ def my_function(arg1: int, arg2: str) -> float:
         This is a description of the return value.
     """
     return 3.14
-```
+```

docs/_scripts/copy_page_hooks.py

@@ -41,21 +41,54 @@ def _process_includes(content: str, docs_dir: Path) -> str:
 
 
 def _clean_markdown(content: str) -> str:
-    """Minimal cleanup of markdown content - preserve original as much as possible."""
+    """Clean up markdown content by removing MkDocs artifacts."""
     # Remove frontmatter
     content = re.sub(r'^---\n.*?\n---\n', '', content, flags=re.DOTALL)
     
-    # Remove script tags (security)
-    content = re.sub(r'<script[^>]*>.*?</script\s*>', '', content, flags=re.DOTALL | re.IGNORECASE)
+    # Remove script tags (handle malformed closing tags)
+    content = re.sub(r'<script[^>]*>.*?</script[^>]*>', '', content, flags=re.DOTALL | re.IGNORECASE)
     
-    # Remove style tags (security)
+    # Remove style tags (handle spaces in closing tags)
     content = re.sub(r'<style[^>]*>.*?</style\s*>', '', content, flags=re.DOTALL | re.IGNORECASE)
     
     # Remove HTML comments
     content = re.sub(r'<!--.*?-->', '', content, flags=re.DOTALL)
     
-    # Just strip and return - preserve original structure
-    return content.strip()
+    # Remove all HTML tags (more aggressive cleaning)
+    content = re.sub(r'<[^>]+>', '', content)
+    
+    # Remove markdown image references that might be logos
+    content = re.sub(r'!\[[^\]]*\]\([^)]*logo[^)]*\)', '', content, flags=re.IGNORECASE)
+    
+    # Clean up line by line
+    lines = content.split('\n')
+    cleaned_lines = []
+    
+    for line in lines:
+        line = line.strip()
+        # Skip completely empty lines for now
+        if line:
+            cleaned_lines.append(line)
+    
+    # Join lines and then clean up spacing
+    content = '\n'.join(cleaned_lines)
+    
+    # Add proper paragraph breaks by looking for markdown patterns
+    # Add double newline before headers
+    content = re.sub(r'\n(#{1,6}\s)', r'\n\n\1', content)
+    
+    # Add double newline before list items
+    content = re.sub(r'\n(\*\s|-\s|\d+\.\s)', r'\n\n\1', content)
+    
+    # Add double newline before code blocks
+    content = re.sub(r'\n(```)', r'\n\n\1', content)
+    
+    # Clean up any triple+ newlines
+    content = re.sub(r'\n{3,}', '\n\n', content)
+    
+    content = content.strip()
+    
+    return content
 
 
 def inject_markdown_content(html: str, page: Page, config: MkDocsConfig) -> str:

docs/docs/agents/evals.md

@@ -15,7 +15,7 @@ To evaluate your agent's performance you can use `LangSmith` [evaluations](https
 def evaluator(*, outputs: dict, reference_outputs: dict):
     # compare agent outputs against reference outputs
     output_messages = outputs["messages"]
-    reference_messages = reference_outputs["messages"]
+    reference_messages = reference["messages"]
     score = compare_messages(output_messages, reference_messages)
     return {"key": "evaluator_score", "score": score}
 ```

docs/docs/cloud/reference/cli.md

@@ -409,8 +409,6 @@ The LangGraph CLI requires a JSON configuration file that follows this [schema](
     | Option                       | Default                   | Description                                                                                                             |
     | ---------------------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
     | `--wait`                     |                           | Wait for services to start before returning. Implies --detach                                                           |
-| `--base-image TEXT`          | `langchain/langgraph-api`  | Base image to use for the LangGraph API server. Pin to specific versions using version tags.                            |
-| `--image TEXT`               |                           | Docker image to use for the langgraph-api service. If specified, skips building and uses this image directly.           |
     | `--postgres-uri TEXT`        | Local database            | Postgres URI to use for the database.                                                                                   |
     | `--watch`                    |                           | Restart on file changes                                                                                                 |
     | `--debugger-base-url TEXT`   | `http://127.0.0.1:[PORT]` | URL used by the debugger to access LangGraph API.                                                                       |
@@ -438,8 +436,6 @@ The LangGraph CLI requires a JSON configuration file that follows this [schema](
     | Option                                                                 | Default                   | Description                                                                                                             |
     | ---------------------------------------------------------------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
     | <span style="white-space: nowrap;">`--wait`</span>                     |                           | Wait for services to start before returning. Implies --detach                                                           |
-| <span style="white-space: nowrap;">`--base-image TEXT`</span>          | <span style="white-space: nowrap;">`langchain/langgraph-api`</span> | Base image to use for the LangGraph API server. Pin to specific versions using version tags. |
-| <span style="white-space: nowrap;">`--image TEXT`</span>               |                           | Docker image to use for the langgraph-api service. If specified, skips building and uses this image directly. |
     | <span style="white-space: nowrap;">`--postgres-uri TEXT`</span>        | Local database            | Postgres URI to use for the database.                                                                                   |
     | <span style="white-space: nowrap;">`--watch`</span>                    |                           | Restart on file changes                                                                                                 |
     | <span style="white-space: nowrap;">`-c, --config FILE`</span>          | `langgraph.json`          | Path to configuration file declaring dependencies, graphs and environment variables.                                    |

docs/docs/cloud/reference/langgraph_server_changelog.md

@@ -1,151 +0,0 @@
-# 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.86 (2025-07-11)
-- Respected tool descriptions in the `/mcp` endpoint.
-
-## v0.2.85 (2025-07-10)
-- Added support for the `on_disconnect` field to `runs/wait` and included disconnect logs for better debugging.
-
-## v0.2.84 (2025-07-09)
-- Removed unnecessary status updates to streamline thread handling and updated version to 0.2.84.
-
-## v0.2.83 (2025-07-09)
-- Reduced the default time-to-live for resumable streams to 2 minutes.
-- Enhanced data submission logic to send data to both Beacon and LangSmith instance based on license configuration.
-- Enabled submission of self-hosted data to a Langsmith instance when the endpoint is configured.
-
-## v0.2.82 (2025-07-03)
-- Addressed a race condition in background runs by implementing a lock using join, ensuring reliable execution across CTEs.
-
-## v0.2.81 (2025-07-03)
-- Optimized run streams by reducing initial wait time to improve responsiveness for older or non-existent runs.
-
-## v0.2.80 (2025-07-03)
-- Corrected parameter passing in the `logger.ainfo()` API call to resolve a TypeError.
-
-## v0.2.79 (2025-07-02)
-- Fixed a JsonDecodeError in checkpointing with remote graph by correcting JSON serialization to handle trailing slashes properly.
-- Introduced a configuration flag to disable webhooks globally across all routes.
-
-## v0.2.78 (2025-07-02)
-- Added timeout retries to webhook calls to improve reliability.
-- Added HTTP request metrics, including a request count and latency histogram, for enhanced monitoring capabilities.
-
-## v0.2.77 (2025-07-02)
-- Added HTTP metrics to improve performance monitoring.
-- Changed the Redis cache delimiter to reduce conflicts with subgraph message names and updated caching behavior.
-
-## v0.2.76 (2025-07-01)
-- Updated Redis cache delimiter to prevent conflicts with subgraph messages.
-
-## v0.2.74 (2025-06-30)
-- Scheduled webhooks in an isolated loop to ensure thread-safe operations and prevent errors with PYTHONASYNCIODEBUG=1.
-
-## v0.2.73 (2025-06-27)
-- Fixed an infinite frame loop issue and removed the dict_parser due to structlog's unexpected behavior.
-- Throw a 409 error on deadlock occurrence during run cancellations to handle lock conflicts gracefully.
-
-## v0.2.72 (2025-06-27)
-- Ensured compatibility with future langgraph versions.
-- Implemented a 409 response status to handle deadlock issues during cancellation.
-
-## v0.2.71 (2025-06-26)
-- Improved logging for better clarity and detail regarding log types.
-
-## v0.2.70 (2025-06-26)
-- Improved error handling to better distinguish and log TimeoutErrors caused by users from internal run timeouts.
-
-## v0.2.69 (2025-06-26)
-- Added sorting and pagination to the crons API and updated schema definitions for improved accuracy.
-
-## v0.2.66 (2025-06-26)
-- Fixed a 404 error when creating multiple runs with the same thread_id using `on_not_exist="create"`.
-
-## v0.2.65 (2025-06-25)
-- Ensured that only fields from `assistant_versions` are returned when necessary.
-- Ensured consistent data types for in-memory and PostgreSQL users, improving internal authentication handling.
-
-## v0.2.64 (2025-06-24)
-- Added descriptions to version entries for better clarity.
-
-## v0.2.62 (2025-06-23)
-- Improved user handling for custom authentication in the JS Studio.
-- Added Prometheus-format run statistics to the metrics endpoint for better monitoring.
-- Added run statistics in Prometheus format to the metrics endpoint.
-
-## v0.2.61 (2025-06-20)
-- Set a maximum idle time for Redis connections to prevent unnecessary open connections.
-
-## v0.2.60 (2025-06-20)
-- Enhanced error logging to include traceback details for dictionary operations.
-- Added a `/metrics` endpoint to expose queue worker metrics for monitoring.
-
-## v0.2.57 (2025-06-18)
-- Removed CancelledError from retriable exceptions to allow local interrupts while maintaining retriability for workers.
-- Introduced middleware to gracefully shut down the server after completing in-flight requests upon receiving a SIGINT.
-- Reduced metadata stored in checkpoint to only include necessary information.
-- Improved error handling in join runs to return error details when present.
-
-## v0.2.56 (2025-06-17)
-- Improved application stability by adding a handler for SIGTERM signals.
-
-## v0.2.55 (2025-06-17)
-- Improved the handling of cancellations in the queue entrypoint.
-- Improved cancellation handling in the queue entry point.
-
-## v0.2.54 (2025-06-16)
-- Enhanced error message for LuaLock timeout during license validation.
-- Fixed the $contains filter in custom auth by requiring an explicit ::text cast and updated tests accordingly.
-- Ensured project and tenant IDs are formatted as UUIDs for consistency.
-
-## v0.2.53 (2025-06-13)
-- Resolved a timing issue to ensure the queue starts only after the graph is registered.
-- Improved performance by setting thread and run status in a single query and enhanced error handling during checkpoint writes.
-- Reduced the default background grace period to 3 minutes.
-
-## v0.2.52 (2025-06-12)
-- Now logging expected graphs when one is omitted to improve traceability.
-- Implemented a time-to-live (TTL) feature for resumable streams.
-- Improved query efficiency and consistency by adding a unique index and optimizing row locking.
-
-## v0.2.51 (2025-06-12)
-- Handled `CancelledError` by marking tasks as ready to retry, improving error management in worker processes.
-- Added LG API version and request ID to metadata and logs for better tracking.
-- Added LG API version and request ID to metadata and logs to improve traceability.
-- Improved database performance by creating indexes concurrently.
-- Ensured postgres write is committed only after the Redis running marker is set to prevent race conditions.
-- Enhanced query efficiency and reliability by adding a unique index on thread_id/running, optimizing row locks, and ensuring deterministic run selection.
-- Resolved a race condition by ensuring Postgres updates only occur after the Redis running marker is set.
-
-## v0.2.46 (2025-06-07)
-- Introduced a new connection for each operation while preserving transaction characteristics in Threads state `update()` and `bulk()` commands.
-
-## v0.2.45 (2025-06-05)
-- Enhanced streaming feature by incorporating tracing contexts.
-- Removed an unnecessary query from the Crons.search function.
-- Resolved connection reuse issue when scheduling next run for multiple cron jobs.
-- Removed an unnecessary query in the Crons.search function to improve efficiency.
-- Resolved an issue with scheduling the next cron run by improving connection reuse.
-
-## v0.2.44 (2025-06-04)
-- Enhanced the worker logic to exit the pipeline before continuing when the Redis message limit is reached.
-- Introduced a ceiling for Redis message size with an option to skip messages larger than 128 MB for improved performance.
-- Ensured the pipeline always closes properly to prevent resource leaks.
-
-## v0.2.43 (2025-06-04)
-- Improved performance by omitting logs in metadata calls and ensuring output schema compliance in value streaming.
-- Ensured the connection is properly closed after use.
-- Aligned output format to strictly adhere to the specified schema.
-- Stopped sending internal logs in metadata requests to improve privacy.
-
-## v0.2.42 (2025-06-04)
-- Added timestamps to track the start and end of a request's run.
-- Added tracer information to the configuration settings.
-- Added support for streaming with tracing contexts.
-
-## v0.2.41 (2025-06-03)
-- Added locking mechanism to prevent errors in pipelined executions.

docs/docs/examples/index.md

@@ -5,17 +5,17 @@ The pages in this section provide end-to-end examples for the following topics:
 ## General 
 
 - [Template Applications](../concepts/template_applications.md): Create a LangGraph application from a template.
-- [Agentic RAG](../tutorials/rag/langgraph_agentic_rag.md): Build a retrieval agent that can decide when to use a retriever tool.
-- [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.
+- [Agentic RAG](./rag/langgraph_agentic_rag.md): Build a retrieval agent that can decide when to use a retriever tool.
+- [Agent Supervisor](./multi_agent/agent_supervisor.md): Build a supervisor agent that can manage a team of agents.
+- [SQL agent](./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.
 
 ## 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.
+- [Set up custom authentication](./auth/getting_started.md): Set up custom authentication for your LangGraph application.
+- [Make conversations private](./auth/resource_auth.md): Make conversations private by using resource-based authentication.
+- [Connect an authentication provider](./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.

docs/mkdocs.yml

@@ -261,7 +261,6 @@ nav:
       - 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

docs/overrides/main.html

@@ -25,15 +25,11 @@ j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
         try {
             let rawContent = markdownScript.textContent;
             
-            // Safe HTML entity decoding function
-            function decodeHtmlEntities(text) {
-                const parser = new DOMParser();
-                const doc = parser.parseFromString(text, 'text/html');
-                return doc.documentElement.textContent || '';
-            }
+            // Import a library for decoding HTML entities
+            import { decode } from 'he';
             
-            // Always decode HTML entities since the browser might encode them
-            rawContent = decodeHtmlEntities(rawContent);
+            // Always decode HTML entities using a safe library
+            rawContent = decode(rawContent);
             
             
             const data = JSON.parse(rawContent);
@@ -83,12 +79,7 @@ j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
             };
             option1.onmouseout = function() { this.style.background = 'transparent'; };
             option1.onclick = function() {
-                // Check if we're on a reference page
-                if (window.location.pathname.includes('/reference/')) {
-                    alert('Copy Page not yet available in API reference pages.');
-                } else {
-                    copyPageAsMarkdown();
-                }
+                copyPageAsMarkdown();
                 dropdown.style.display = 'none';
             };
             

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

@@ -557,7 +557,7 @@ class BasePostgresStore(Generic[C]):
     ) -> list[tuple[str, Sequence]]:
         queries: list[tuple[str, Sequence]] = []
         for _, op in list_ops:
-            query = r"""
+            query = """
                 SELECT DISTINCT ON (truncated_prefix) truncated_prefix, prefix
                 FROM (
                     SELECT

libs/checkpoint-postgres/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "langgraph-checkpoint-postgres"
-version = "2.0.22"
+version = "2.0.21"
 description = "Library with a Postgres implementation of LangGraph checkpoint saver."
 authors = []
 requires-python = ">=3.9"

libs/checkpoint-postgres/uv.lock

@@ -334,7 +334,7 @@ dev = [
 
 [[package]]
 name = "langgraph-checkpoint-postgres"
-version = "2.0.22"
+version = "2.0.21"
 source = { editable = "." }
 dependencies = [
     { name = "langgraph-checkpoint" },

libs/langgraph/langgraph/graph/state.py

@@ -794,7 +794,7 @@ class StateGraph(Generic[StateT, InputT, OutputT]):
         interrupt_after: All | list[str] | None = None,
         debug: bool = False,
         name: str | None = None,
-    ) -> CompiledStateGraph[StateT, InputT, OutputT]:
+    ) -> CompiledStateGraph[StateT, InputT]:
         """Compiles the state graph into a `CompiledStateGraph` object.
 
         The compiled graph implements the `Runnable` interface and can be invoked,
@@ -996,7 +996,7 @@ class CompiledStateGraph(
                 writers=[ChannelWrite(write_entries)],
             )
         elif node is not None:
-            input_schema = node.input if node else self.builder.state_schema
+            input_schema = node.input if node else self.builder._state_schema
             input_channels = list(self.builder.schemas[input_schema])
             is_single_input = len(input_channels) == 1 and "__root__" in input_channels
             if input_schema in self.schema_to_mapper:

libs/langgraph/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "langgraph"
-version = "0.5.2"
+version = "0.5.1"
 description = "Building stateful, multi-actor applications with LLMs"
 authors = []
 requires-python = ">=3.9"

libs/langgraph/uv.lock

@@ -670,7 +670,7 @@ name = "importlib-metadata"
 version = "8.7.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "zipp", marker = "python_full_version < '3.10'" },
+    { name = "zipp", marker = "python_full_version < '3.11'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/76/66/650a33bd90f786193e4de4b3ad86ea60b53c89b669a5c7be931fac31cdb0/importlib_metadata-8.7.0.tar.gz", hash = "sha256:d13b81ad223b890aa16c5471f2ac3056cf76c5f10f82d6f9292f0b415f389000", size = 56641, upload-time = "2025-04-27T15:29:01.736Z" }
 wheels = [
@@ -1192,7 +1192,7 @@ wheels = [
 
 [[package]]
 name = "langgraph"
-version = "0.5.2"
+version = "0.5.1"
 source = { editable = "." }
 dependencies = [
     { name = "langchain-core" },
@@ -1331,7 +1331,7 @@ dev = [
 
 [[package]]
 name = "langgraph-checkpoint-postgres"
-version = "2.0.22"
+version = "2.0.21"
 source = { editable = "../checkpoint-postgres" }
 dependencies = [
     { name = "langgraph-checkpoint" },

libs/prebuilt/uv.lock

@@ -316,7 +316,7 @@ wheels = [
 
 [[package]]
 name = "langgraph"
-version = "0.5.2"
+version = "0.5.1"
 source = { editable = "../langgraph" }
 dependencies = [
     { name = "langchain-core" },
@@ -397,7 +397,7 @@ dev = [
 
 [[package]]
 name = "langgraph-checkpoint-postgres"
-version = "2.0.22"
+version = "2.0.21"
 source = { editable = "../checkpoint-postgres" }
 dependencies = [
     { name = "langgraph-checkpoint" },