https://aitoolchain.io/tools/langgraph New releases and features in LangGraph, tracked by The AI Toolchain. en Thu, 27 Aug 2026 21:25:36 GMT https://github.com/langchain-ai/langgraph/releases/tag/sdk%3D%3D0.4.4 https://github.com/langchain-ai/langgraph/releases/tag/sdk%3D%3D0.4.4 Thu, 27 Aug 2026 21:25:36 GMT LangGraph SDK 0.4.4 routes LangSmith traces from thread streams for deeper agent observability. • Routes LangSmith traces from thread streams, enabling trace visibility for streaming thread operations. https://github.com/langchain-ai/langgraph/releases/tag/sdk%3D%3D0.4.3 https://github.com/langchain-ai/langgraph/releases/tag/sdk%3D%3D0.4.3 Wed, 19 Aug 2026 18:05:32 GMT LangGraph SDK 0.4.3 adds decrypted replacement results and clears cron end_time via update(end_time=None). • Supports clearing a cron job's `end_time` by calling update(end_time=None) on the cron client. • Adds decrypt replacement result support to the Python SDK. https://github.com/langchain-ai/langgraph/releases/tag/1.2.11 https://github.com/langchain-ai/langgraph/releases/tag/1.2.11 Tue, 11 Aug 2026 14:00:50 GMT LangGraph 1.2.11 exposes `trace_policy` on `add_node` for per-node tracing control. • Adds `trace_policy` parameter to `add_node`, letting callers control tracing behavior on a per-node basis. https://github.com/langchain-ai/langgraph/releases/tag/1.2.11 https://github.com/langchain-ai/langgraph/releases/tag/1.2.11 Tue, 11 Aug 2026 14:00:50 GMT LangGraph 1.2.11 exposes `trace_policy` on `add_node` for per-node tracing control. • Adds `trace_policy` parameter to `add_node` to control tracing behaviour on a per-node basis. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==4.2.0 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==4.2.0 Fri, 07 Aug 2026 20:05:22 GMT LangGraph checkpoint 4.2.0 adds opt-in `omit_expired` flag to skip expired rows on checkpoint reads. • Adds `omit_expired` opt-in parameter to checkpoint and checkpoint-postgres read operations to skip expired rows, enabling cleaner state retrieval without stale data. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint%3D%3D4.2.0 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint%3D%3D4.2.0 Fri, 07 Aug 2026 20:05:22 GMT LangGraph checkpoint 4.2.0 adds opt-in `omit_expired` flag to skip expired checkpoint rows on read. • Adds opt-in `omit_expired` parameter to checkpoint and checkpoint-postgres readers to skip expired rows when reading checkpoint history, reducing noise and improving read performance in long-running workflows. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint%3D%3D4.2.0 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint%3D%3D4.2.0 Fri, 07 Aug 2026 20:05:22 GMT LangGraph checkpoint 4.2.0 adds opt-in `omit_expired` flag to skip expired checkpoint rows on read. • Adds opt-in `omit_expired` parameter to checkpoint and checkpoint-postgres readers to skip expired rows when reading checkpoint history, reducing noise and improving read performance in long-running workflows. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==3.1.1 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==3.1.1 Thu, 30 Jul 2026 19:16:01 GMT LangGraph checkpoint-postgres 3.1.1 adds opt-in `omit_expired` flag to skip expired checkpoint rows on read. • Adds `omit_expired` opt-in parameter to checkpoint reads, allowing callers to skip expired rows instead of returning them. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres%3D%3D3.1.1 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres%3D%3D3.1.1 Thu, 30 Jul 2026 19:16:01 GMT checkpoint-postgres 3.1.1 adds opt-in `omit_expired` flag to skip expired checkpoint rows on read. • Adds opt-in `omit_expired` parameter to checkpoint read operations, allowing callers to skip expired rows and avoid processing stale state. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres%3D%3D3.1.1 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres%3D%3D3.1.1 Thu, 30 Jul 2026 19:16:01 GMT checkpoint-postgres 3.1.1 adds opt-in `omit_expired` flag to skip expired checkpoint rows on read. • Adds opt-in `omit_expired` parameter to checkpoint read operations, allowing callers to skip expired rows and avoid processing stale state. https://github.com/langchain-ai/langgraph/releases/tag/1.2.10 https://github.com/langchain-ai/langgraph/releases/tag/1.2.10 Tue, 28 Jul 2026 18:34:14 GMT LangGraph 1.2.10 adds `trace_policy` on `add_node` and typed v3 `stream_events` return with native projections. • Exposes `trace_policy` parameter on `add_node`, letting you control tracing behavior per node when building graphs. • Types the v3 `stream_events` return value and adds native projections, enabling strongly-typed streaming event handling. https://github.com/langchain-ai/langgraph/releases/tag/1.2.10 https://github.com/langchain-ai/langgraph/releases/tag/1.2.10 Tue, 28 Jul 2026 18:34:14 GMT LangGraph 1.2.10 exposes `trace_policy` on `add_node` and drops tags from TracePolicy for cleaner tracing control. • Exposes `trace_policy` parameter on `add_node`, letting callers set per-node tracing behavior directly when wiring the graph. • Drops `tags` from `TracePolicy`, narrowing the tracing configuration surface. • Adds typed return for v3 `stream_events` and native projections support. Breaking changes: • The `tags` field has been removed from `TracePolicy`; any code that sets `tags` on a `TracePolicy` instance will break. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.31 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.31 Fri, 10 Jul 2026 22:58:04 GMT LangGraph CLI now supports prebuild images for langgraph deploy. • Supports prebuild images for `langgraph deploy`, enabling faster deployments by skipping the image build step. https://github.com/langchain-ai/langgraph/releases/tag/1.2.3 https://github.com/langchain-ai/langgraph/releases/tag/1.2.3 Mon, 01 Jun 2026 18:56:09 GMT LangGraph 1.2.3 adds v3 streaming support, WebSocket transport, and tool-dispatched subagent naming to RemoteGraph. • Adds v3 streaming support to `RemoteGraph`, enabling the latest streaming protocol for remote graph execution. • Wires `RemoteGraph.interleave` to `sdk-py` `interleave_projections` for interleaved stream output. • Names tool-dispatched subagents via `lc_agent_name` for clearer agent identification in multi-agent graphs. • Adds WebSocket stream transport to the Python SDK (`sdk-py`) as an alternative to SSE. • Adds `messages` and tool call projections to `sdk-py` for structured stream consumption. • Adds v3 streaming primitives and SSE transport to `sdk-py`. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.4.1 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.4.1 Mon, 01 Jun 2026 15:23:38 GMT LangGraph SDK 0.4.1 adds interleave_projections stream decoder and v3 streaming support for RemoteGraph. • Extracts stream decoders into a reusable module and adds `interleave_projections` stream decoder. • Adds v3 streaming protocol support to `RemoteGraph`, enabling richer real-time output from remote graph execution. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.4.0 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.4.0 Thu, 28 May 2026 14:11:35 GMT LangGraph SDK 0.4.0 adds WebSocket streaming, reconnect resilience, scoped subgraph handles, and sync/async thread stream helpers. • Adds WebSocket stream transport support, enabling lower-latency bidirectional streaming as an alternative to SSE. • Adds SSE transport and v3 streaming primitives as a foundational streaming layer. • Adds WebSocket stream selection wiring so clients can choose between SSE and WebSocket transports. • Adds async stream reconnect support with hardened reconnect logic for resilient long-running streams. • Adds async and sync thread stream helpers for high-level, ergonomic consumption of streamed thread output. • Adds scoped subgraph handles (async and sync) for targeting and streaming specific subgraph execution. • Adds messages and tool call projections to extract structured message and tool-call data from stream events. • Adds output, values, and controller extraction from stream lifecycle state. • Adds shared stream subscriptions for multiplexing a single stream across multiple consumers. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.3.15 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.3.15 Fri, 22 May 2026 16:54:42 GMT LangGraph SDK 0.3.15 adds metadata filtering for cron job search and count operations. • Supports metadata filter parameter when searching and counting cron jobs via the SDK. https://github.com/langchain-ai/langgraph/releases/tag/1.2.1 https://github.com/langchain-ai/langgraph/releases/tag/1.2.1 Thu, 21 May 2026 18:33:24 GMT LangGraph 1.2.1 adds `before_builtins` opt-in for stream transformers. • Adds `before_builtins` opt-in option for stream transformers, enabling custom transformation logic to run before built-in stream processing. https://github.com/langchain-ai/langgraph/releases/tag/1.2.0 https://github.com/langchain-ai/langgraph/releases/tag/1.2.0 Tue, 12 May 2026 03:46:55 GMT LangGraph 1.2.0 adds node defaults, durable error-handler resume, and delta-channel snapshot guarantees. • Adds set_node_defaults() to `StateGraph`, letting you set shared default configuration across nodes. • Enables durable error-handler resume so graph execution can recover across host crashes. • Forces a delta channel snapshot after a configurable max number of supersteps since the last snapshot, preventing unbounded replay. • Overrides `get_delta_channel_history` in the SQLite checkpoint backend with a streaming walk for more efficient history retrieval. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==4.1.0 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==4.1.0 Tue, 12 May 2026 03:34:06 GMT LangGraph checkpoint 4.1.0 forces delta channel snapshots after max supersteps to ensure durability. • Adds forced delta channel snapshot after a configurable maximum number of supersteps since the last snapshot, preventing unbounded checkpoint gaps. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.25 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.25 Thu, 07 May 2026 16:33:24 GMT LangGraph CLI gains Studio deploy support for pushing graphs directly to LangGraph Studio. • Adds `studio deploy` command to the LangGraph CLI, enabling direct deployment to LangGraph Studio. https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==3.1.0a1 https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==3.1.0a1 Tue, 05 May 2026 19:35:35 GMT LangGraph SQLite checkpointer gains a public get_writes_history API and streaming delta channel history. • Adds public `get_writes_history` saver API for retrieving write history with reworked delta cadence. • Overrides `get_delta_channel_history` with a streaming walk implementation for more efficient history retrieval. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.3.14 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.3.14 Tue, 05 May 2026 18:40:27 GMT LangGraph SDK 0.3.14 adds `return_minimal` to thread updates, trimming response payload size. • Adds `return_minimal` parameter to the threads update API, allowing callers to request a reduced response payload. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==3.1.0a4 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==3.1.0a4 Mon, 04 May 2026 19:35:49 GMT langgraph-checkpoint-postgres 3.1.0a4 exposes a public `get_writes_history` saver API with reworked delta cadence. • Adds public `get_writes_history` API on the checkpoint saver, enabling programmatic retrieval of write history for a thread. • Reworks delta cadence logic for checkpoint writes, enabling finer-grained control over how incremental state changes are persisted. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.1.0a1 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.1.0a1 Fri, 01 May 2026 15:58:28 GMT LangGraph prebuilt 1.1.0a1 adds stream_events v3 dispatch and streaming transformer infrastructure. • Dispatches stream_events(version='v3') on Pregel, enabling finer-grained streaming event visibility. • Adds streaming transformer infrastructure, providing a new layer for composing and testing stream transformations in the graph runtime. https://github.com/langchain-ai/langgraph/releases/tag/1.2.0a3 https://github.com/langchain-ai/langgraph/releases/tag/1.2.0a3 Fri, 01 May 2026 15:35:08 GMT LangGraph 1.2.0a3 adds node-level error handlers, graceful shutdown/drain, stream_events v3, and richer streaming infrastructure. • Adds node-level error handlers, letting graphs catch and handle errors at individual nodes rather than propagating them globally. • Supports graceful graph shutdown/drain on request, allowing in-flight work to complete cleanly before termination. • Dispatches stream_events(version='v3') on Pregel graphs, enabling richer event streaming for observability pipelines. • Introduces `DeltaChannel` for storing sentinels in blobs and reconstructing state from checkpoint writes. • Adds native v2 projections for `custom`, `updates`, `checkpoints`, `debug`, and `tasks` stream modes. • Introduces streaming transformer infrastructure for composable, testable stream processing. • Allows `ToolNode` tools to return `list[Command | ToolMessage]`, enabling richer tool output patterns. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==4.1.0a3 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==4.1.0a3 Fri, 01 May 2026 15:26:50 GMT LangGraph checkpoint 4.1.0a3 introduces DeltaChannel with sentinel storage and checkpoint_writes reconstruction. • Adds `DeltaChannel`: stores sentinels in blobs and reconstructs state from `checkpoint_writes`, enabling more efficient incremental state tracking. https://github.com/langchain-ai/langgraph/releases/tag/1.2.0a2 https://github.com/langchain-ai/langgraph/releases/tag/1.2.0a2 Thu, 30 Apr 2026 20:10:03 GMT LangGraph 1.2.0a2 adds node-level error handlers for fine-grained fault control in graphs. • Adds node-level error handlers, enabling per-node fault handling logic directly in graph definitions. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==3.1.0a1 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==3.1.0a1 Thu, 30 Apr 2026 18:05:09 GMT checkpoint-postgres 3.1.0a1 adds DeltaChannel sentinel storage in blobs with checkpoint_writes reconstruction. • Adds `DeltaChannel` support: stores sentinel values in blobs and reconstructs state from `checkpoint_writes`, enabling more efficient incremental checkpointing. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.0.13 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.0.13 Thu, 30 Apr 2026 01:48:28 GMT LangGraph prebuilt 1.0.13 adds alpha timer support and streaming transformer infrastructure. • Introduces alpha timer support for scheduling and time-based graph behaviors. • Adds streaming transformer infrastructure enabling new streaming pipeline patterns in graphs. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==4.1.0a1 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==4.1.0a1 Wed, 29 Apr 2026 22:30:33 GMT LangGraph checkpoint 4.1.0a1 adds timer support (alpha) and a new DeltaChannel for efficient checkpoint reconstruction. • Adds alpha timer support for checkpoint-based workflows. • Introduces `DeltaChannel`: stores sentinel values in blobs and reconstructs state from `checkpoint_writes` rather than full snapshots. https://github.com/langchain-ai/langgraph/releases/tag/1.2.0a1 https://github.com/langchain-ai/langgraph/releases/tag/1.2.0a1 Wed, 29 Apr 2026 22:30:21 GMT LangGraph 1.2.0a1 adds graceful shutdown/drain, timer support, DeltaChannel checkpointing, and native v2 streaming projections. • Adds graceful shutdown/drain support, allowing graphs to finish in-flight work before stopping on request. • Introduces alpha timer primitives for scheduling time-based graph behavior. • New `DeltaChannel` stores sentinel values in blobs and reconstructs state from checkpoint writes. • Adds native v2 projections for custom, updates, checkpoints, debug, and tasks streams. • Adds streaming transformer infrastructure enabling richer, composable stream processing pipelines. https://github.com/langchain-ai/langgraph/releases/tag/1.1.10 https://github.com/langchain-ai/langgraph/releases/tag/1.1.10 Mon, 27 Apr 2026 17:19:21 GMT LangGraph 1.1.10 lets ToolNode tools return mixed lists of Command and ToolMessage objects. • Enables ToolNode tools to return `list[Command | ToolMessage]`, allowing a single tool call to emit both control-flow commands and tool messages in one response. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.0.11 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.0.11 Fri, 24 Apr 2026 18:18:45 GMT LangGraph prebuilt 1.0.11 lets ToolNode return mixed Command/ToolMessage lists and exposes available tools on ToolRuntime. • Enables ToolNode tools to return `list[Command | ToolMessage]`, allowing a single tool call to emit a mix of graph commands and tool messages. • Exposes the set of available tools on `ToolRuntime`, making it possible to inspect or enumerate registered tools at runtime. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==4.0.2 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==4.0.2 Wed, 15 Apr 2026 21:03:16 GMT LangGraph checkpoint 4.0.2 documents `LANGGRAPH_STRICT_MSGPACK` environment variable for checkpoint security hardening. • Documents `LANGGRAPH_STRICT_MSGPACK` environment variable to control strict MessagePack deserialization security for checkpoints. https://github.com/langchain-ai/langgraph/releases/tag/1.1.7a1 https://github.com/langchain-ai/langgraph/releases/tag/1.1.7a1 Fri, 10 Apr 2026 21:16:27 GMT LangGraph 1.1.7a1 adds graph lifecycle callback handlers for hooking into graph execution events. • Adds graph lifecycle callback handlers, enabling hooks into key stages of graph execution. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.20 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.20 Wed, 08 Apr 2026 00:36:17 GMT LangGraph CLI gains remote build support for `langgraph deploy` • Adds remote build support for `langgraph deploy`, enabling builds to run on remote infrastructure instead of locally. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.3.13 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.3.13 Tue, 07 Apr 2026 20:34:31 GMT LangGraph SDK adds `langsmith_tracing` parameter to runs.create/stream/wait for per-call tracing control. • Adds `langsmith_tracing` parameter to `runs.create`, `runs.stream`, and `runs.wait` to enable or disable LangSmith tracing on a per-call basis. https://github.com/langchain-ai/langgraph/releases/tag/1.1.5 https://github.com/langchain-ai/langgraph/releases/tag/1.1.5 Fri, 03 Apr 2026 14:12:44 GMT LangGraph 1.1.5 adds remote build support for `langgraph deploy` and richer runtime execution information. • Adds remote build support to `langgraph deploy` in the CLI. • Enhances the runtime with more execution information. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.0.9 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.0.9 Fri, 03 Apr 2026 14:06:48 GMT LangGraph prebuilt 1.0.9 exposes richer execution information at runtime for agent observability. • Enhances the runtime with additional execution information, giving agents and tools access to more context about the current run. https://github.com/langchain-ai/langgraph/releases/tag/1.1.4 https://github.com/langchain-ai/langgraph/releases/tag/1.1.4 Tue, 31 Mar 2026 12:56:58 GMT LangGraph 1.1.4 adds LangSmith integration metadata to graph runs. • Adds LangSmith integration metadata to LangGraph, enabling richer tracing and observability linkage between graph runs and LangSmith. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.19 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.19 Fri, 20 Mar 2026 22:12:33 GMT LangGraph CLI 0.4.19 adds `deploy revisions list` command to inspect deployment revisions. • Adds `deploy revisions list` subcommand to list revisions of a LangGraph deployment. https://github.com/langchain-ai/langgraph/releases/tag/1.1.3 https://github.com/langchain-ai/langgraph/releases/tag/1.1.3 Wed, 18 Mar 2026 23:43:10 GMT LangGraph 1.1.3 adds execution info to the runtime context. • Adds execution info to the LangGraph runtime, exposing contextual metadata during graph execution. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.16 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.16 Thu, 12 Mar 2026 23:28:59 GMT LangGraph CLI gains deploy logs, list, delete subcommands and distributed runtime support. • Adds `langgraph deploy logs` subcommand to stream or retrieve logs from a deployment. • Adds `langgraph deploy list` subcommand to enumerate active deployments. • Adds `langgraph deploy delete` subcommand to remove a deployment. • Adds distributed runtime support to the LangGraph CLI for scalable deployment configurations. https://github.com/langchain-ai/langgraph/releases/tag/1.1.2 https://github.com/langchain-ai/langgraph/releases/tag/1.1.2 Thu, 12 Mar 2026 17:11:29 GMT LangGraph 1.1.2 adds context support for remote graph API calls. • Adds context parameter support for remote graph API interactions. https://github.com/langchain-ai/langgraph/releases/tag/1.1.0 https://github.com/langchain-ai/langgraph/releases/tag/1.1.0 Tue, 10 Mar 2026 12:46:46 GMT LangGraph 1.1 adds opt-in `version="v2"` for type-safe streaming and invoke with Pydantic/dataclass output coercion. • Adds `version="v2"` opt-in to invoke(), ainvoke(), stream(), and astream() for fully type-safe outputs. • New `GraphOutput` return type from invoke(..., version="v2") exposes `.value` and `.interrupts` attributes, cleanly separating state from interrupt signals. • New strongly-typed `StreamPart` discriminated union (and per-mode TypedDicts: `ValuesStreamPart`, `UpdatesStreamPart`, `MessagesStreamPart`, `CustomStreamPart`, `CheckpointStreamPart`, `TasksStreamPart`, `DebugStreamPart`) enables full type narrowing in editors and type checkers. • Automatic output coercion to Pydantic models or dataclasses when the graph's state schema is declared as one — no manual parsing needed. • Non-`"values"` stream modes with `version="v2"` return `list[StreamPart]` from invoke() instead of `list[tuple]`. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.15 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.15 Tue, 10 Mar 2026 01:16:29 GMT LangGraph CLI gains a `langgraph deploy` command for direct deployment from the CLI. • Adds `langgraph deploy` command to deploy LangGraph applications directly from the CLI. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.3.10 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.3.10 Mon, 09 Mar 2026 23:46:33 GMT LangGraph SDK 0.3.10 adds type-safe stream/invoke with proper output type coercion • Adds type-safe `stream`/`invoke` calls with proper output type coercion, enabling strongly-typed responses from graph runs https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.14 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.14 Mon, 02 Mar 2026 21:27:30 GMT LangGraph CLI gains a `keep_latest` prune strategy for ThreadTTLConfig and checkpointer config passthrough. • Adds `keep_latest` prune strategy to `ThreadTTLConfig`, giving finer control over which threads are retained when TTL cleanup runs. • Passes checkpointer config through to the CLI, enabling checkpointer settings to be applied via CLI invocation. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.3.8 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.3.8 Thu, 19 Feb 2026 19:12:53 GMT LangGraph Python SDK 0.3.8 adds stream_mode, stream_subgraphs, stream_resumable, and durability options to cron jobs, plus improved store auth type safety. • Adds `stream_mode`, `stream_subgraphs`, `stream_resumable`, and `durability` parameters to cron job creation in the Python SDK. • Improves type safety and docstrings for store auth in the Python SDK. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.3.4 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.3.4 Fri, 06 Feb 2026 00:44:26 GMT LangGraph Python SDK gains cron job update, enable, and disable methods in the crons client. • Adds `update` method to the crons client for modifying existing cron jobs. • Supports enabling and disabling cron jobs via the crons client. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.0.7 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.0.7 Thu, 22 Jan 2026 16:45:37 GMT LangGraph prebuilt 1.0.7 adds dynamic tool calling via a `tool` override in `wrap_model_call`. • Supports dynamic tool calling by accepting a `tool` override parameter in `wrap_model_call`. https://github.com/langchain-ai/langgraph/releases/tag/1.0.6 https://github.com/langchain-ai/langgraph/releases/tag/1.0.6 Mon, 12 Jan 2026 20:33:46 GMT LangGraph 1.0.6 adds compile-time checkpointer type validation to catch configuration errors early. • Validates checkpointer type at compile time, surfacing misconfigured checkpointers before runtime. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.0.6 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.0.6 Mon, 12 Jan 2026 20:32:33 GMT LangGraph prebuilt 1.0.6 adds compile-time checkpointer validation, custom encryption at rest, and paginated assistant search. • Validates checkpointer type at compile time, catching misconfiguration before runtime. • Supports custom encryption at rest for checkpoint data. • Includes pagination in assistants search responses. https://github.com/langchain-ai/langgraph/releases/tag/1.0.5 https://github.com/langchain-ai/langgraph/releases/tag/1.0.5 Fri, 12 Dec 2025 23:06:02 GMT LangGraph 1.0.5 adds custom encryption at rest, stream event IDs, and pagination for assistants search. • Adds custom encryption at rest for persisted graph state. • Emits `id` as part of stream events in the Python SDK. • Includes pagination in assistants search responses. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.8 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.8 Tue, 09 Dec 2025 13:30:20 GMT LangGraph CLI 0.4.8 adds webhook configuration and custom encryption at rest. • Adds webhook configuration support to the CLI. • Supports custom encryption at rest for stored data. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.2.12 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.2.12 Tue, 02 Dec 2025 15:47:49 GMT LangGraph SDK 0.2.12 adds pagination to assistants search and a sentinel to skip auto-loading API keys. • Adds pagination metadata to the assistants search response, enabling clients to page through large assistant lists. • Introduces a sentinel value to skip automatic API key loading when instantiating the SDK client, allowing explicit credential control. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.2.10 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.2.10 Mon, 24 Nov 2025 21:32:13 GMT LangGraph Python SDK 0.2.10 adds `name` filtering to Assistants search and cursory Python 3.14 support. • Adds `name` parameter to the Assistants search API, enabling filtering assistants by name. • Adds cursory Python 3.14 support. Breaking changes: • Python 3.9 is no longer supported; projects running on Python 3.9 must upgrade their runtime. https://github.com/langchain-ai/langgraph/releases/tag/1.0.2 https://github.com/langchain-ai/langgraph/releases/tag/1.0.2 Wed, 29 Oct 2025 18:38:49 GMT LangGraph 1.0.2 adds Overwrite reducer bypass, Python 3.14 support, and ships Checkpointers 3.0. • Adds `Overwrite` type to bypass reducers and directly overwrite state channel values without merging. • Adds cursory Python 3.14 support. • Ships Checkpointers 3.0 release. Breaking changes: • Python 3.9 is no longer supported; the minimum supported Python version has been raised. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.0.2 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==1.0.2 Wed, 29 Oct 2025 18:29:13 GMT LangGraph prebuilt 1.0.2 adds Python 3.14 support and drops Python 3.9. • Adds cursory Python 3.14 support for prebuilt components. • Un-deprecates ToolNode, restoring it as a supported API. Breaking changes: • Python 3.9 is no longer supported; setups running on Python 3.9 will break on upgrade. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==0.6.5 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==0.6.5 Tue, 21 Oct 2025 00:15:12 GMT LangGraph prebuilt 0.6.5 adds Redis node-level caching and SDK client query-parameter support. • Adds Redis node-level cache via `feat(langgraph): implement redis node level cache`, enabling per-node result caching backed by Redis. • Adds query-parameter support to the Python SDK client (`feat(sdk-py): client qparams`), allowing callers to pass arbitrary query parameters through SDK calls. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==3.0.0 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==3.0.0 Mon, 20 Oct 2025 18:46:14 GMT langgraph-checkpoint-postgres 3.0 adds cursory Python 3.14 support. • Adds cursory Python 3.14 support, enabling use of the Postgres checkpointer on the latest Python release. Breaking changes: • Python 3.9 is no longer supported; setups running langgraph-checkpoint-postgres on Python 3.9 will break on upgrade. https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==3.0.0 https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==3.0.0 Mon, 20 Oct 2025 18:42:38 GMT LangGraph checkpointsqlite 3.0 adds Python 3.14 support and drops Python 3.9. • Adds cursory Python 3.14 support, keeping the library compatible with the upcoming CPython release. • Drops Python 3.9 support; minimum supported Python version is now 3.10 or higher. Breaking changes: • Python 3.9 is no longer supported; running checkpointsqlite on Python 3.9 will break after upgrading to 3.0.0. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==3.0.0 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==3.0.0 Mon, 20 Oct 2025 18:36:05 GMT LangGraph checkpoint 3.0 drops Python 3.9 and adds cursory Python 3.14 support. • Adds cursory Python 3.14 support to the checkpointers library. • Restricts 'json' type deserialization for tighter serialization safety. Breaking changes: • Python 3.9 is no longer supported; upgrade to Python 3.10 or later before upgrading to checkpoint 3.0.0. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.3 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.4.3 Wed, 08 Oct 2025 16:18:13 GMT LangGraph CLI 0.4.3 adds auth control on custom routes and server customization ordering. • Adds `auth` flag in `HttpConfig` to enable or disable authentication on custom routes. • Adds configuration for controlling the ordering of server customization (middleware/routers). https://github.com/langchain-ai/langgraph/releases/tag/0.6.8 https://github.com/langchain-ai/langgraph/releases/tag/0.6.8 Mon, 29 Sep 2025 09:21:27 GMT LangGraph 0.6.8 adds guardrails that prevent arbitrary resumes when multiple interrupts are pending. • Adds enforcement that prevents arbitrary graph resumes when multiple pending interrupts exist, ensuring interrupt handling is ordered and intentional. https://github.com/langchain-ai/langgraph/releases/tag/0.6.7 https://github.com/langchain-ai/langgraph/releases/tag/0.6.7 Sun, 07 Sep 2025 16:49:57 GMT LangGraph CLI gains monorepo support for managing multi-package LangGraph projects. • Adds monorepo support in the LangGraph CLI, enabling multi-package project structures to be managed from a single repository. https://github.com/langchain-ai/langgraph/releases/tag/0.6.3 https://github.com/langchain-ai/langgraph/releases/tag/0.6.3 Sun, 03 Aug 2025 11:21:49 GMT LangGraph 0.6.3 adds a durability mode to `invoke` and `ainvoke` for controlling checkpoint persistence. • Adds `durability` mode parameter to `invoke` and `ainvoke` for controlling checkpoint persistence behavior. https://github.com/langchain-ai/langgraph/releases/tag/0.6.0 https://github.com/langchain-ai/langgraph/releases/tag/0.6.0 Mon, 28 Jul 2025 13:53:19 GMT LangGraph 0.6 introduces a typed Context/Runtime API, durability modes, dynamic model/tool selection, and a solidified public API surface. • Adds a new Context API with `Runtime[Context]` parameter for type-safe, run-scoped context injection, replacing the `config['configurable']` pattern. • Introduces `context_schema` argument on `StateGraph` as the successor to `config_schema`, enabling typed context definitions via dataclasses. • Adds `durability` argument with three modes — `"exit"`, `"async"`, and `"sync"` — giving fine-grained control over checkpoint persistence behavior. • Enables `create_react_agent` to dynamically select model and tools at runtime via a custom context object. • Makes `StateGraph` and `Pregel` generic over `state_schema`, `context_schema`, `input_schema`, and `output_schema` for compile-time type checking of node signatures and `invoke`/`stream` inputs. • Refines the `Interrupt` interface: adds `id` (unique identifier encoding namespace) and `value` attributes as the canonical surface. • Centralizes all error classes under `langgraph.errors`; moves `Send` and `Interrupt` imports to `langgraph.types`. • Adds `get_context_jsonschema` for graph introspection, superseding `get_config_jsonschema`. Breaking changes: • Importing from `langgraph.channels` is removed — all error classes must now be imported from `langgraph.errors`. • The `TAG_NOSTREAM_ALT` constant is removed from `langgraph.constants`; use `NOSTREAM` instead. • The `Interrupt` attributes `when`, `resumable`, and `ns` are removed; namespace info is now encoded in the `id` attribute. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==0.6.0 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==0.6.0 Mon, 28 Jul 2025 13:48:13 GMT LangGraph prebuilt 0.6.0 adds dynamic model selection in create_react_agent and a new context API replacing config['configurable']. • Adds dynamic model support to `create_react_agent`, allowing the LLM to be swapped at runtime per invocation. • Introduces a new context API as a cleaner replacement for `config['configurable']` and `config_schema` patterns. Breaking changes: • Public/private differentiations have been solidified — previously accessible private symbols may no longer be importable from their old paths. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.3.6 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.3.6 Wed, 23 Jul 2025 23:53:12 GMT LangGraph CLI 0.3.6 introduces an api-version option and a new context API replacing config['configurable'] and config_schema. • Adds `api-version` option for explicit API version control. • Introduces new context API as a replacement for `config['configurable']` and `config_schema` for passing configuration to graph nodes. Breaking changes: • The new context API replaces `config['configurable']` and `config_schema`; existing code relying on these patterns will need to be migrated. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.2.0 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.2.0 Tue, 22 Jul 2025 17:31:19 GMT LangGraph Python SDK 0.2.0 adds context API support and exposes interrupts in thread state • Adds SDK support for the `context` API, enabling callers to pass context through the LangGraph SDK. • Adds `interrupts` field to thread state, making interrupt information accessible when inspecting thread state. • Cleans up the `Interrupt` interface for v1, refining the interrupt contract. Breaking changes: • The `Interrupt` interface has been changed as part of a v1 cleanup — existing code relying on the previous `Interrupt` interface shape may break. https://github.com/langchain-ai/langgraph/releases/tag/0.5.4 https://github.com/langchain-ai/langgraph/releases/tag/0.5.4 Mon, 21 Jul 2025 18:21:08 GMT LangGraph 0.5.4 adds ParentCommand handling in RemoteGraph for cross-graph command propagation. • Supports `ParentCommand` in `RemoteGraph`, enabling commands issued inside a remote graph to propagate up to the parent graph. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.73 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.73 Mon, 14 Jul 2025 23:57:39 GMT LangGraph SDK 0.1.73 exposes is_studio_user flag to identify Studio-originated requests. • Adds `is_studio_user` attribute to identify whether the current user is a LangGraph Studio user. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.22 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.22 Thu, 10 Jul 2025 22:45:38 GMT LangGraph checkpoint-postgres 2.0.22 adds numpy array serialization and pandas pickle fallback in JsonPlusSerializer. • Supports numpy array serialization in `JsonPlusSerializer`, enabling checkpoint storage of numpy arrays without manual conversion. • Adds pickle fallback for pandas objects in `JsonPlusSerializer` via `serialize/deserialize` path, so DataFrames and Series round-trip through checkpoints reliably. • Extends pipeline mode in `checkpoint-postgres` to use the same lock used in non-pipeline mode, improving consistency under concurrent writes. • Centralizes `CheckpointTuple` creation into a shared helper function within `checkpoint_postgres`, reducing duplication across sync and async paths. Breaking changes: • `Checkpoint.metadata.writes` has been removed; any code reading or writing this field will break on upgrade. • `Checkpoint.pending_sends` has been removed; any code referencing this field will break on upgrade. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.3.4 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.3.4 Tue, 08 Jul 2025 19:52:38 GMT LangGraph CLI 0.3.4 adds a flag to retain build dependencies (setuptools, pip, wheel) in container builds. • Adds a CLI argument to retain build dependencies (setuptools, pip, wheel) in the build output instead of pruning them. https://github.com/langchain-ai/langgraph/releases/tag/0.5.0 https://github.com/langchain-ai/langgraph/releases/tag/0.5.0 Thu, 26 Jun 2025 22:55:31 GMT LangGraph 0.5 adds NodeBuilder, granular streaming modes, NumPy serialization, and a stricter StateGraph API ahead of 1.0. • New `NodeBuilder` utility provides a declarative way to create nodes and attach them to channels, replacing `Channel.subscribe_to`. • Introduces `stream_mode="tasks"` and `stream_mode="checkpoints"` as individually selectable streaming modes (and `"debug"` becomes an alias for both). • Adds `print_mode=` argument to `invoke`/`stream` for controlling output printing. • `StateGraph` now accepts `input_schema` and `output_schema` parameters (replacing `input`/`output`). • `JsonPlusSerializer` now natively handles NumPy arrays (including Fortran-ordered) without pickle fallback. • Checkpoints are leaner: redundant keys dropped, per-task writes stored directly, and legacy `pending_sends` data is auto-migrated on first load. • Allows same-name channels and nodes in `StateGraph`. • Task masquerading with `update_state` is now supported. Breaking changes: • `state_schema` is now required in `StateGraph.__init__`; graphs constructed without it will error. • The `input` and `output` keyword arguments to `StateGraph` are deprecated and renamed to `input_schema` and `output_schema`; the old names raise a deprecation warning. • Subclassing both `PregelNode` and `Runnable` is no longer supported; drop the `Runnable` base class. • add_conditional_edge(..., then=) has been removed. • `Checkpoint.writes` and `Checkpoint.pending_sends` fields have been removed. • The postgres shallow checkpointer has been removed. • `Context` channel/managed value and `SharedValue` have been removed. • Support for a node reading a single managed value has been removed. • The `retry` parameter is renamed to `retry_policy`. • Dict subclasses used for `values`/`updates` stream chunks have been removed. • The default for `checkpoint_during` has been flipped. • `Channel.subscribe_to` (the `Channel` node builder) has been removed. https://github.com/langchain-ai/langgraph/releases/tag/0.4.10 https://github.com/langchain-ai/langgraph/releases/tag/0.4.10 Wed, 25 Jun 2025 17:52:17 GMT LangGraph 0.4.10 adds 'tasks' and 'checkpoints' stream modes and numpy/pandas serialization support. • Introduces `tasks` and `checkpoints` stream modes for finer-grained visibility into graph execution. • Supports numpy array serialization in `JsonPlusSerializer`, enabling numpy data in graph state. • Adds pickle fallback for pandas serialization/deserialization via `JsonPlusSerializer`. • Allows same-name channels and nodes in `StateGraph`, removing a previous naming constraint. • Skips saving checkpoints for subgraphs when `checkpoint_during=False`, reducing unnecessary checkpoint overhead. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.1.0 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.1.0 Mon, 16 Jun 2025 22:05:18 GMT langgraph-checkpoint 2.1.0 adds NumPy array and pandas serialization support to JsonPlusSerializer • Supports NumPy array serialization in JsonPlusSerializer, enabling checkpoint storage of array-heavy state. • Adds pickle fallback for pandas serialization, allowing DataFrames and Series to round-trip through the checkpoint layer. Breaking changes: • `Checkpoint.writes` has been removed. • `Checkpoint.pending_sends` has been removed. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.2.11 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.2.11 Wed, 04 Jun 2025 00:45:56 GMT LangGraph CLI 0.2.11 adds `image_distro` config support and warns when distro is not set to Wolfi. • Supports `image_distro` setting in the LangGraph config file for controlling the base image distribution used in Dockerfile generation. • Adds a warning when the image distro is not configured as Wolfi, nudging users toward the recommended distro. https://github.com/langchain-ai/langgraph/releases/tag/0.4.8 https://github.com/langchain-ai/langgraph/releases/tag/0.4.8 Mon, 02 Jun 2025 23:26:34 GMT LangGraph 0.4.8 adds NodeBuilder to replace Channel.subscribe_to and flips the default for checkpoint_during. • Adds `NodeBuilder` class as the new way to define node subscriptions, replacing `Channel.subscribe_to`. • Flips the default value for `checkpoint_during`, changing checkpoint behavior out of the box. • Stream modes `messages` and `custom` now respect `subgraphs=False`, giving finer control over subgraph output filtering. • Requires `state_schema` in `StateGraph.__init__`, enforcing explicit schema declaration at graph construction. Breaking changes: • `MessageGraph` has been removed; graphs using `MessageGraph` will break on upgrade. • add_conditional_edge(..., then=) argument has been removed; any call using the `then=` parameter will break. • `Checkpoint.writes` has been removed; code reading or writing this field will break. • `Checkpoint.pending_sends` has been removed; code reading or writing this field will break. • The postgres shallow checkpointer has been removed; setups using it must migrate to another checkpointer. • `UntrackedValue` channel has been removed; any code referencing it will break. • `Context` channel/managed value and `SharedValue` have been removed; code relying on them will break. • `ChannelsManager` has been removed; managed values are now static classes and can no longer be instantiated. • `SchemaCoercionMapper` has been removed; code referencing it will break. • Dict subclasses used for `values`/`updates` stream chunks have been removed; code that relied on the specific types of those chunks may break. • The non-state `Graph` base class has been removed; code subclassing it directly will break. • The `Channel` node builder has been removed; use the new `NodeBuilder` class instead. • `state_schema` is now required in `StateGraph.__init__`; existing code that omits it will raise an error. • The default for `checkpoint_during` has been flipped; existing graphs that relied on the previous default behavior will behave differently without an explicit override. https://github.com/langchain-ai/langgraph/releases/tag/0.4.6 https://github.com/langchain-ai/langgraph/releases/tag/0.4.6 Fri, 23 May 2025 22:34:15 GMT LangGraph 0.4.6 adds push_message() for manual stream writes, SQLiteStore, and smarter stream_mode=values emission. • Adds push_message() method to manually push messages directly to the `messages` / `message-tuple` stream from within a graph node. • Introduces `SqliteStore` as a new built-in store backend. • Optimizes `stream_mode=values` to emit chunks only when output channels have actually changed, reducing noise in high-frequency graphs. • Prints output for cached `@task` functions, making task caching observable in the stream. • Updates `list_namespaces` in SQLite with `max_depth` support for scoped namespace queries. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==0.2.0 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==0.2.0 Thu, 22 May 2025 17:58:31 GMT LangGraph prebuilt 0.2.0 adds a post_model_hook, HumanInterruptNode, parallel tool calls via Send, and a SqliteStore with namespace search. • Adds `post_model_hook` parameter to inject custom logic after model responses in `create_react_agent`. • Introduces `HumanInterruptNode` for structured human-in-the-loop interruption handling in prebuilt agents. • Switches parallel tool call execution to use `Send` by default, enabling concurrent tool dispatch in the ReAct agent. • Releases `SqliteStore` as a persistent key-value store backend with namespace search and `list_namespaces` supporting `max_depth` filtering. Breaking changes: • The `state_modifier` parameter has been removed from `create_react_agent`; existing code passing `state_modifier` will break on upgrade. https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==2.0.8 https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==2.0.8 Sun, 18 May 2025 04:59:38 GMT LangGraph SQLite checkpoint adds SqliteStore and InMemoryCache for persistent and in-memory state storage. • New `SqliteStore` provides a SQLite-backed key-value store for persisting LangGraph state across runs. • New `InMemoryCache` (moved into the sqlite package alongside `FileCache`) enables fast, non-persistent caching without a database. • Adds `SqliteStore` release as the official sqlite store integration for LangGraph checkpointing. • Overloaded clear() method on the store now deletes all entries when called without arguments. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.26 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.26 Thu, 15 May 2025 17:31:42 GMT LangGraph checkpoint 2.0.26 adds InMemoryCache, namespace-scoped cache keys, TTL support, and pickle fallback for the JSON serializer. • Adds `InMemoryCache` as a new cache backend alongside the existing file-based cache. • Moves `FileCache` to the sqlite package and re-implements it using SQLite for more reliable storage. • Adds namespace support to cache keys, enabling isolated cache spaces across different workloads. • Implements TTL (time-to-live) expiry in `FileCache`, allowing automatic cache entry invalidation. • Overloads the `clear` method so calling it without arguments deletes all cache entries. • Adds `pickle_fallback` option to the JSON-plus serializer, enabling serialization of objects that are not natively JSON-serializable. • Removes Python version upper bounds, allowing installation on future Python releases without constraint conflicts. https://github.com/langchain-ai/langgraph/releases/tag/0.4.4 https://github.com/langchain-ai/langgraph/releases/tag/0.4.4 Thu, 15 May 2025 15:32:10 GMT LangGraph 0.4.4 adds update_state for the functional API, a caching layer with InMemoryCache, and deferred node execution. • Implements `update_state` for the functional API, enabling state updates mid-graph in entrypoint-based workflows. • Introduces a cache interface with `InMemoryCache` and `FileCache` (moved to sqlite package), including `clear` methods and namespace-scoped cache keys. • Adds `cache_policy` acceptance on graph, entrypoint, and pregel for default caching configuration. • Adds support for Deferred Nodes, enabling nodes whose execution can be deferred within a graph. • Adds ability to start the dev server externally. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.69 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.69 Tue, 13 May 2025 02:35:32 GMT LangGraph Python SDK adds customizable client timeouts, loop-safe ASGI transport, and a new 'running' RunStatus. • Supports customizable timeouts in get_client() for fine-grained control over request lifecycle. • Adds optional loop-safe ASGI transport to avoid event-loop conflicts in async environments. • Adds missing `'running'` value to `RunStatus` enum, enabling accurate status checks on in-progress runs. Breaking changes: • Private SDK functions are now prefixed with `_`; any code calling these functions by their former unprefixed names will break. https://github.com/langchain-ai/langgraph/releases/tag/0.4.3 https://github.com/langchain-ai/langgraph/releases/tag/0.4.3 Thu, 08 May 2025 03:40:22 GMT LangGraph 0.4.3 uses tuples for streamed message events in RemoteGraph and adds a draw limit to Pregel graphs. • Uses tuples for streamed message events in RemoteGraph, aligning remote streaming with local graph conventions. • Adds a node limit to `Pregel.draw` to prevent rendering failures on very large graphs. https://github.com/langchain-ai/langgraph/releases/tag/0.4.2 https://github.com/langchain-ai/langgraph/releases/tag/0.4.2 Wed, 07 May 2025 01:39:06 GMT LangGraph 0.4.2 decouples RemoteGraph name from assistant ID and executes parallel tool calls via Send by default. • Decouples the graph name from the assistant ID in `RemoteGraph`, allowing them to be set independently. • Switches `prebuilt` parallel tool calls to execute via `Send` by default, enabling more controlled parallel tool dispatch. https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==2.0.7 https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==2.0.7 Fri, 02 May 2025 05:44:47 GMT LangGraph checkpoint-sqlite 2.0.7 adds a delete_thread method to the Checkpointer class. • Adds `delete_thread` method to the `Checkpointer` class for removing thread state from SQLite checkpoints. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.2.8 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.2.8 Fri, 02 May 2025 00:09:42 GMT LangGraph CLI 0.2.8 adds custom base image support and configurable headers schema for Docker workflows. • Supports specifying a custom base image in Docker commands. • Adds schema updates for configurable headers. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.66 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.66 Wed, 30 Apr 2025 22:59:29 GMT LangGraph SDK 0.1.66 adds `checkpoint_during` parameter to control mid-execution checkpointing in graph runs. • Adds optional `checkpoint_during: Optional[bool]` parameter to `stream`, `create`, `wait`, and `create_for_thread` client methods, letting callers control whether checkpoints are written during graph execution or only at the end/interruption. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.65 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.65 Wed, 30 Apr 2025 21:11:32 GMT LangGraph SDK 0.1.65 adds sorting support to assistants search with new sort_by and sort_order parameters. • Adds `sort_by` and `sort_order` parameters to `Client.search` for assistants, enabling sorting by `assistant_id`, `graph_id`, `name`, `created_at`, or `updated_at` in ascending or descending order. • Introduces new type aliases `AssistantSortBy`, `ThreadSortBy`, and `SortOrder` for strongly-typed sort parameter hints across assistant and thread searches. https://github.com/langchain-ai/langgraph/releases/tag/0.4.1 https://github.com/langchain-ai/langgraph/releases/tag/0.4.1 Wed, 30 Apr 2025 18:36:05 GMT LangGraph 0.4.1 adds incremental UI message merging and drops Pydantic V1 support. • Adds a `merge` parameter to `push_ui_message` enabling incremental/partial updates to existing UI messages without replacing them wholesale. • Drops Pydantic V1 support — `SchemaCoercionMapper` and `langgraph.utils.pydantic` now exclusively use Pydantic V2 APIs. Breaking changes: • Pydantic V1 models are no longer supported in `SchemaCoercionMapper`; graphs using Pydantic V1 models will break on upgrade. • `TAG_NOSTREAM` value changed from `"langsmith:nostream"` to `"nostream"`; code comparing against the old string literal will no longer match (the old value is available as `TAG_NOSTREAM_ALT` for backward compatibility). https://github.com/langchain-ai/langgraph/releases/tag/0.4.0 https://github.com/langchain-ai/langgraph/releases/tag/0.4.0 Tue, 29 Apr 2025 13:54:45 GMT LangGraph 0.4.0 adds targeted interrupt resumption by ID and exposes pending interrupts on StateSnapshot • Adds `interrupt_id` property on `Interrupt` that generates a unique ID from its namespace, enabling precise identification of individual interrupts. • Enhances `Command.resume` to accept a mapping of interrupt IDs to resume values, allowing targeted resumption of specific interrupts rather than all-or-nothing. • Adds `interrupts` field to `StateSnapshot` to track interrupts that occurred in a step and are pending resolution. • Propagates interrupts in `"values"` stream mode so `invoke`/`ainvoke` and streaming consumers now see interrupts emitted during graph execution. • Adds `add_edge` utility in graph visualization to prevent duplicate edges when rendering graphs with END nodes. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.25 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.25 Sat, 26 Apr 2025 21:01:04 GMT LangGraph checkpoint savers gain `delete_thread` and `adelete_thread` methods to remove all data for a given thread ID. • Adds `delete_thread` and `adelete_thread` methods to `BaseCheckpointSaver` and `InMemorySaver` for deleting all checkpoints and writes associated with a specific thread ID. https://github.com/langchain-ai/langgraph/releases/tag/0.3.32 https://github.com/langchain-ai/langgraph/releases/tag/0.3.32 Wed, 23 Apr 2025 16:01:30 GMT LangGraph 0.3.32 adds `draw_graph` for graph visualization and `get_static_writes` for static analysis of conditional edges. • Adds `get_static_writes` method to `ChannelWrite` to support static analysis of what a writer might write, enabling better resolution of conditional edges. • Extends `ChannelWrite.register_writer` to accept static declarations for writers, with a new `static` field on `ChannelWriteTupleEntry` to declare writes for static analysis. • Adds new `langgraph.pregel.draw` module with a `draw_graph` function that simulates execution to discover edges, correctly handling subgraphs and conditional edges. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.2.7 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.2.7 Wed, 23 Apr 2025 14:51:14 GMT LangGraph CLI gains `--image` option to deploy pre-built Docker images without a rebuild step. • Adds `--image` option to `langgraph up` to specify a pre-built Docker image for the langgraph-api service, skipping the build process entirely. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.2.6 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.2.6 Tue, 22 Apr 2025 14:27:21 GMT LangGraph CLI 0.2.6 adds `--tunnel` flag to expose local dev server publicly via Cloudflare. • Adds `--tunnel` flag to the `dev` command to expose the local LangGraph API server through a public Cloudflare tunnel, enabling remote frontend access without localhost restrictions. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.62 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.62 Mon, 21 Apr 2025 21:45:21 GMT LangGraph SDK 0.1.62 adds sort_by and sort_order parameters to thread search for ordered result retrieval. • Adds `sort_by` and `sort_order` parameters to `Client.search` for sorting thread results by `id`, `status`, `created_at`, or `updated_at` in ascending or descending order. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.20 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.20 Thu, 17 Apr 2025 21:17:08 GMT LangGraph Postgres checkpoint library adds thread deletion and tightens search method signatures. • Adds `delete_thread` method to `PostgresSaver` for complete removal of all checkpoints and writes tied to a specific thread ID. • Adds `adelete_thread` (async) and `delete_thread` (sync, with main-thread safety checks) to `AsyncPostgresSaver` for the same capability in async workflows. • Updates `search` on `PostgresStore` and `asearch` on `AsyncPostgresStore` to require `query` as an explicit keyword argument rather than a positional parameter. Breaking changes: • The `query` parameter in `PostgresStore.search` is now a named (keyword) parameter; callers passing it positionally will break. • The `query` parameter in `AsyncPostgresStore.asearch` is now a named (keyword) parameter; callers passing it positionally will break. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.2.5 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.2.5 Thu, 17 Apr 2025 20:36:06 GMT LangGraph CLI 0.2.5 adds internal config option to override Docker tags in generated Dockerfiles. • Adds `_INTERNAL_docker_tag` configuration option to override the default Docker tag used in generated Dockerfiles, falling back to the Python or Node.js version when not set. https://github.com/langchain-ai/langgraph/releases/tag/0.3.31 https://github.com/langchain-ai/langgraph/releases/tag/0.3.31 Thu, 17 Apr 2025 17:12:07 GMT LangGraph 0.3.31 adds CONFIG_KEY_THREAD_ID constant for tracking thread IDs in concurrent graph invocations. • New `langgraph.constants.CONFIG_KEY_THREAD_ID` constant enables explicit tracking of thread IDs for current invocations in checkpointing and state management. https://github.com/langchain-ai/langgraph/releases/tag/0.3.28 https://github.com/langchain-ai/langgraph/releases/tag/0.3.28 Fri, 11 Apr 2025 01:27:52 GMT LangGraph 0.3.28 adds support for multiple retry policies per node or task, applying the first matching policy on exception. • Supports passing a sequence of retry policies to `StateGraph.add_node`, `langgraph.func.task`, and `Pregel`, applying the first matching policy when an exception occurs. • Improves `SchemaCoercionMapper` performance with `functools.lru_cache` caching, fast paths for basic types, and better handling of tuple, set, and other collection types. • Adds compatibility with both Pydantic v1 and v2 in schema coercion via `SchemaCoercionMapper`. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.2.2 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.2.2 Thu, 10 Apr 2025 23:43:25 GMT LangGraph CLI 0.2.2 adds auto-detection of Python/JS graphs and smarter Docker base-image selection for mixed-language projects. • Automatically detects Python and JavaScript graphs by file extension, eliminating manual language configuration. • Selects the appropriate Docker base image automatically based on project composition via new `default_base_image` logic. • Supports mixed Python/Node.js projects in a single configuration, with `validate_config` now auto-detecting and setting correct runtime versions for each graph file. • New `docker_tag` utility generates correct Docker image tags based on project configuration. https://github.com/langchain-ai/langgraph/releases/tag/0.3.27 https://github.com/langchain-ai/langgraph/releases/tag/0.3.27 Tue, 08 Apr 2025 22:15:34 GMT LangGraph 0.3.27 adds `checkpoint_during` parameter to skip per-step checkpointing and boost large-graph performance. • Adds `checkpoint_during` parameter to stream(), astream(), invoke(), and ainvoke() — set to `False` to checkpoint only at run end, reducing overhead in large graphs. Breaking changes: • `checkpoint_every_step` is renamed to `checkpoint_during` in `PregelLoop` — any code referencing the old name will break. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.89 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.89 Fri, 04 Apr 2025 17:49:24 GMT LangGraph CLI now accepts dictionary-format graph definitions with a 'path' key in addition to plain import-path strings. • Supports dictionary-format graph definitions (with a `'path'` key) in the configuration file, alongside the existing plain import-path string format, enabling additional metadata to be co-located with graph paths. https://github.com/langchain-ai/langgraph/releases/tag/0.3.25 https://github.com/langchain-ai/langgraph/releases/tag/0.3.25 Thu, 03 Apr 2025 20:31:00 GMT LangGraph 0.3.25 adds a UI messaging system to push, remove, and reduce UI component updates during graph execution. • New `UIMessage` TypedDict represents UI component updates with properties and metadata during graph execution. • New `RemoveUIMessage` TypedDict enables removal of UI components from the current graph state. • New `AnyUIMessage` Union type combines `UIMessage` and `RemoveUIMessage` for flexible type annotations. • New push_ui_message() function creates and sends UI messages to render components mid-execution. • New delete_ui_message() function removes a UI component from state by ID. • New ui_message_reducer() function merges UI message lists, handling both additions and deletions. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==0.1.8 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==0.1.8 Thu, 03 Apr 2025 16:04:46 GMT LangGraph prebuilt 0.1.8 adds a `pre_model_hook` to `create_react_agent` for trimming or summarizing long message histories before LLM calls. • Adds `pre_model_hook` parameter to `create_react_agent`, letting you inject a custom node before every LLM call to preprocess message history via trimming, summarization, or other logic. • Hook can return `messages` to update agent state or `llm_input_messages` to reshape only what the LLM sees, leaving persisted state untouched. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.84 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.84 Thu, 03 Apr 2025 13:29:21 GMT LangGraph CLI 0.1.84 adds custom UI configuration support for dev server and Docker builds. • Supports `ui` and `ui_config` options in config files for customized UI when running `langgraph dev`. • Docker image builds now automatically detect and install UI dependencies (npm, yarn, pnpm, bun) when UI is configured. • Docker images now include `LANGGRAPH_UI` and `LANGGRAPH_UI_CONFIG` environment variables when UI is configured. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.61 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.61 Thu, 03 Apr 2025 01:53:26 GMT LangGraph SDK 0.1.61 adds description support to assistant create and update methods. • Adds optional `description` field to `AssistantBase` TypedDict for storing assistant descriptions. • Adds `description` parameter to `create` and `update` methods (async and sync) on the assistants client. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.24 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.24 Wed, 02 Apr 2025 22:47:54 GMT LangGraph checkpoint 2.0.24 adds explicit None serialization support in JsonPlusSerializer. • Supports `None` values in `JsonPlusSerializer` via a new `"null"` type designation, enabling round-trip serialization of null checkpoint state fields. https://github.com/langchain-ai/langgraph/releases/tag/0.3.23 https://github.com/langchain-ai/langgraph/releases/tag/0.3.23 Wed, 02 Apr 2025 14:01:20 GMT LangGraph 0.3.23 adds REMOVE_ALL_MESSAGES to clear entire conversation histories in one operation. • Adds `REMOVE_ALL_MESSAGES` constant to wipe an entire MessageGraph conversation history in a single `RemoveMessage` call. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.83 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.83 Wed, 02 Apr 2025 04:32:19 GMT LangGraph CLI 0.1.83 adds TTL-based checkpointer config for automatic thread data cleanup in deployments. • Adds `CheckpointerConfig` class to configure the built-in checkpointer in LangGraph deployments via the main config file. • Adds `ThreadTTLConfig` class to set default TTL (in minutes), sweep interval, and expiry strategy ("delete") for automatic cleanup of thread checkpoints. • Supports passing checkpointer configuration to Docker environments via the `LANGGRAPH_CHECKPOINTER` environment variable automatically. • Switches from msgpack to ormsgpack for improved serialization performance. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.82 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.82 Tue, 01 Apr 2025 12:58:48 GMT LangGraph CLI dev command gains --allow-blocking flag to suppress synchronous I/O blocking errors • Adds `--allow-blocking` flag to the `dev` command, allowing the server to run without raising errors when synchronous I/O blocking operations are detected. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.81 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.81 Fri, 28 Mar 2025 22:17:44 GMT LangGraph CLI 0.1.81 adds `ui_config` parameter to customize the LangGraph UI via configuration. • Adds `ui_config` parameter to the LangGraph configuration for customizing the LangGraph UI. • Exposes `LANGGRAPH_UI_CONFIG` Docker environment variable when UI configurations are provided, enabling container-level UI customization. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.60 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.60 Thu, 27 Mar 2025 23:24:06 GMT LangGraph SDK 0.1.60 adds dictionary-like access to the auth user object — index, check, and iterate over user properties. • Adds `__getitem__` to the auth user object, enabling dictionary-style property access (e.g., `user["sub"]`). • Adds `__contains__` to the auth user object so you can check property existence with the `in` operator. • Adds `__iter__` to the auth user object, allowing iteration over all user properties in auth handlers. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.80 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.80 Tue, 25 Mar 2025 22:46:52 GMT LangGraph CLI now reads package.json metadata to auto-detect Yarn, pnpm, or Bun when no lock file is present. • Adds get_pkg_manager_name() helper that reads `packageManager` or `devEngines.packageManager.name` from package.json to detect the correct package manager (Yarn, pnpm, Bun, or npm) even when no lock file exists. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.59 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.59 Tue, 25 Mar 2025 22:14:20 GMT LangGraph SDK 0.1.59 adds per-request custom HTTP headers across all API client methods. • Adds an optional `headers` parameter to all HTTP methods (`get`, `post`, `put`, `patch`, `delete`, `stream`) on `HttpClient` and `SyncHttpClient`, merging custom headers with existing request headers. • Adds optional `headers` parameter to all methods on `AssistantsClient` and `SyncAssistantsClient` (including `get`, `create`, `update`, `delete`, `search`). • Adds optional `headers` parameter to all thread-related methods on `ThreadsClient` and `SyncThreadsClient`, including state management, history, and creation. • Adds optional `headers` parameter to all run methods on `RunsClient` and `SyncRunsClient`, covering create, stream, wait, and management operations. • Adds optional `headers` parameter to all cron job methods on `CronClient` and `SyncCronClient` (create, search, delete). • Adds optional `headers` parameter to all store operations on `StoreClient` and `SyncStoreClient`, including item storage, retrieval, and namespace management. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.22 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.22 Mon, 24 Mar 2025 23:32:50 GMT langgraph-checkpoint 2.0.22 adds blob storage for InMemorySaver, upgrades to ormsgpack, and supports custom serialization hooks. • Adds dedicated blob storage system to `InMemorySaver` for more efficient, lower-memory channel value management via a new `blobs` store and `_load_blobs` method. • Bumps checkpoint format to `LATEST_VERSION = 2`, adopted by empty_checkpoint() and create_checkpoint(), to support the new storage layout. • Replaces `msgpack` with `ormsgpack` in `JsonPlusSerializer` for faster serialization, including new `bytearray` support and optimized serialization options. • Adds customizable `JsonPlusSerializer.__init__` accepting an optional custom unpacking hook, plus `_msgpack_ext_hook_to_json` for better MessagePack-to-JSON type translation. https://github.com/langchain-ai/langgraph/releases/tag/0.3.19 https://github.com/langchain-ai/langgraph/releases/tag/0.3.19 Mon, 24 Mar 2025 16:57:41 GMT LangGraph 0.3.19 adds dependency-aware node scheduling and XXH3-based task ID hashing for faster graph execution. • Adds dependency-aware node scheduling: only nodes whose trigger channels were updated in the previous step are evaluated, reducing unnecessary work in large graphs. • Adds `trigger_to_nodes` property on `Pregel` to expose the mapping from channel triggers to dependent nodes. • Adds `subgraphs` parameter on `PregelNode` to directly specify subgraphs instead of extracting them from a bound runnable. • Adds `func_accepts_config` parameter on `RunnableCallable` to explicitly control whether a wrapped function receives the LangChain config argument. • Switches task ID generation to the XXH3 hash algorithm (via `_xxhash_str`) for newer checkpoint versions, replacing the slower SHA-1 implementation. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.78 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.78 Fri, 21 Mar 2025 18:11:27 GMT LangGraph CLI `dev` command gains `--studio_url` option to connect to custom Studio instances. • Adds `--studio_url` option to the `dev` command, enabling connection to a custom LangGraph Studio instance instead of the default https://smith.langchain.com. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.58 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.58 Wed, 19 Mar 2025 21:13:20 GMT LangGraph SDK 0.1.58 adds `supersteps` and `graph_id` parameters to thread creation for cross-deployment thread copying. • Adds `supersteps` parameter to sync and async ThreadsClient.create(), enabling a sequence of state updates to be applied at thread creation — useful for copying threads between deployments. • Adds `graph_id` parameter to ThreadsClient.create() to associate a new thread with a specific graph at creation time. https://github.com/langchain-ai/langgraph/releases/tag/0.3.17 https://github.com/langchain-ai/langgraph/releases/tag/0.3.17 Wed, 19 Mar 2025 18:35:55 GMT LangGraph 0.3.17 adds bulk state update methods for efficient sequential graph state mutations. • Adds `bulk_update_state` and `abulk_update_state` methods to `Pregel` for applying multiple state updates to a graph in a single sequential operation. • Introduces `StateUpdate` NamedTuple (fields: `values`, `as_node`) as a structured type for representing individual state updates passed to bulk operations. https://github.com/langchain-ai/langgraph/releases/tag/0.3.15 https://github.com/langchain-ai/langgraph/releases/tag/0.3.15 Tue, 18 Mar 2025 20:22:34 GMT LangGraph 0.3.15 adds is_available() channel introspection and improves Pregel task execution performance. • Adds is_available() method to all channel types (`AnyValue`, `BinaryOperatorAggregate`, `DynamicBarrierValue`, `EphemeralValue`, `LastValue`, `NamedBarrierValue`, `Topic`, `UntrackedValue`) for exception-free channel state checks. • Changes `PregelExecutableTask.triggers` type from `list[str]` to `Sequence[str]` for more flexible and performant trigger handling. Breaking changes: • The `return_exception` parameter is removed from read_channel() in `langgraph.pregel.io`; code passing that argument will break. https://github.com/langchain-ai/langgraph/releases/tag/0.3.13 https://github.com/langchain-ai/langgraph/releases/tag/0.3.13 Tue, 18 Mar 2025 02:09:29 GMT LangGraph 0.3.13 adds RemoteGraph visualization support and improves handling of multiple concurrent interrupts. • Adds support for visualizing `RemoteGraph` instances in both sync and async graph drawing methods. • Enables parallel traversal of subgraphs during async graph visualization via asyncio.gather(), speeding up rendering of complex graphs. • Enhances multiple concurrent interrupt handling by collecting and combining them into a single interrupt for cleaner propagation. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.21 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.21 Mon, 17 Mar 2025 22:27:52 GMT LangGraph checkpoint adds EncryptedSerializer and CipherProtocol for at-rest encryption of checkpoint data. • New `CipherProtocol` interface defines encrypt/decrypt contract for pluggable cipher implementations. • New `EncryptedSerializer` class wraps any underlying serializer (defaults to `JsonPlusSerializer`) to transparently encrypt and decrypt checkpoint data. • Factory method `EncryptedSerializer.from_pycryptodome_aes` enables AES-encrypted checkpoints via the pycryptodome library with minimal setup. • Supports AES key supply via `LANGGRAPH_AES_KEY` environment variable or direct key passing, and is backward-compatible with existing unencrypted checkpoint data. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.17 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.17 Fri, 14 Mar 2025 21:55:46 GMT langgraph-checkpoint-postgres 2.0.17 adds TTL support for Postgres store items with automatic background expiry sweeping. • Adds `ttl` parameter to `PostgresStore` and `AsyncPostgresStore` constructors to configure Time To Live behavior for store items. • Adds start_ttl_sweeper() and stop_ttl_sweeper() methods to manage a background thread/task that automatically deletes expired items. • Adds sweep_ttl() method (sync and async) for on-demand manual deletion of expired store items. • Supports TTL configuration via from_conn_string() for both sync and async store classes. • Adds `expires_at` and `ttl_minutes` columns plus an index on `expires_at` to the store table via new database migrations. • Enables TTL refresh on GET and SEARCH operations so item lifetimes can be extended on access. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.20 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.20 Fri, 14 Mar 2025 21:32:35 GMT LangGraph checkpoint 2.0.20 adds configurable TTL sweep intervals for automatic expiry cleanup in stores. • Adds `sweep_interval_minutes` field to `TTLConfig` to schedule automatic periodic deletion of expired store items. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.77 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.77 Fri, 14 Mar 2025 21:32:15 GMT LangGraph CLI 0.1.77 adds automatic TTL sweeping via new `sweep_interval_minutes` config option. • Adds `sweep_interval_minutes` to `TTLConfig`, enabling the store to periodically delete expired items automatically; omitting it preserves the previous no-sweep behavior. https://github.com/langchain-ai/langgraph/releases/tag/0.3.10 https://github.com/langchain-ai/langgraph/releases/tag/0.3.10 Fri, 14 Mar 2025 01:31:09 GMT LangGraph 0.3.10 adds env-var recursion control, cached schema coercion, and flexible task return types. • New `SchemaCoercionMapper` class provides cached schema coercion supporting Pydantic v1/v2, nested lists, dicts, tuples, and unions. • Configures graph recursion limit via the `LANGGRAPH_DEFAULT_RECURSION_LIMIT` environment variable (default: 25), removing the need for per-run config. • Expands `PregelTask.result` field to accept `Any` type, enabling flexible non-dict return values from tasks. Breaking changes: • The `require_at_least_one_of` parameter is removed from `ChannelWrite`; code that passes this parameter will break on upgrade. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.57 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.57 Thu, 13 Mar 2025 17:14:17 GMT LangGraph SDK adds `stream_mode` filtering and `cancel_on_disconnect` to `join_stream` for precise run output control. • Adds `stream_mode` parameter to both sync and async `RunClient.join_stream`, enabling filtering of streamed run output by mode (e.g. `"values"`, `"debug"`). • Adds `cancel_on_disconnect` parameter to the sync `RunClient.join_stream`, reaching feature parity with the async version. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==0.1.3 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==0.1.3 Thu, 13 Mar 2025 15:49:47 GMT LangGraph prebuilt 0.1.3 adds Pydantic agent state models and Callable tool support in create_react_agent. • Adds `AgentStatePydantic` and `AgentStateWithStructuredResponsePydantic` Pydantic models for representing agent state with messages, remaining steps, and structured responses. • Enables `create_react_agent` to accept plain `Callable` objects as tools, in addition to `BaseTool` instances. • Supports both TypedDict and Pydantic models interchangeably for agent state schema via updated `StateSchemaType`. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.19 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.19 Wed, 12 Mar 2025 13:49:15 GMT LangGraph Checkpoint 2.0.19 adds TTL configuration support for stores with default TTL values and refresh-on-read control. • Adds `TTLConfig` TypedDict to configure Time-To-Live behavior at the store level, including `default_ttl` (in minutes) and `refresh_on_read` options. • Adds `ttl_config` property to `BaseStore` so TTL policy is set once and applied automatically to `get`, `search`, `put`, and their async counterparts. • Adds `NotProvided` sentinel class and `NOT_PROVIDED` constant to distinguish between explicitly passing `ttl=None` and omitting a TTL value entirely. Breaking changes: • The `refresh_ttl` parameter on `get`, `search`, and async counterparts now defaults to `None` (inherit store's TTL configuration) instead of `True`; stores that relied on TTLs being refreshed on every read will no longer do so unless TTLConfig(refresh_on_read=True) is set or `refresh_ttl=True` is passed explicitly. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.76 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.76 Wed, 12 Mar 2025 13:49:09 GMT LangGraph CLI 0.1.76 adds TTL configuration for stores, enabling automatic expiration of stored items. • Adds `TTLConfig` TypedDict to control automatic expiration of store items, with per-read TTL refresh and a configurable default TTL in minutes. • Extends `StoreConfig` with an optional `ttl` field to attach TTL settings to any store definition. https://github.com/langchain-ai/langgraph/releases/tag/0.3.7 https://github.com/langchain-ai/langgraph/releases/tag/0.3.7 Wed, 12 Mar 2025 03:02:41 GMT LangGraph 0.3.7 adds Pydantic v1/v2 model validation for graph inputs via `input_model` support. • Adds `input_model` support to `Pregel` for validating graph inputs against Pydantic v1 and v2 models, using `construct`/`model_construct` respectively. • Extends `get_input_schema` to prioritize the `input_model` when available, surfacing typed input schemas for state graphs. • Introduces `_pick_mapper` function in `StateGraph`/`CompiledStateGraph` to correctly handle Pydantic and non-Pydantic schema types during state coercion. https://github.com/langchain-ai/langgraph/releases/tag/0.3.6 https://github.com/langchain-ai/langgraph/releases/tag/0.3.6 Tue, 11 Mar 2025 15:51:24 GMT LangGraph 0.3.6 adds input schema inference for conditional edges and a dedicated Branch module with a new `from_path` factory method. • Adds `input_schema` field to `Branch` for automatic schema inference on conditional edges in `StateGraph`. • New `Branch.from_path` factory method handles `path_map` conversion and optionally infers input schema. • Extends `StateGraph.add_conditional_edges` with schema inference, improving type safety for branch routing. • Improves type annotations on the `task` decorator to consistently prioritize async functions in Union types. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.16 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.16 Fri, 07 Mar 2025 21:56:10 GMT LangGraph Postgres checkpoint store exposes `PLACEHOLDER` and `get_distance_operator` as public API • Exposes `PLACEHOLDER` constant (formerly `_PLACEHOLDER`) as a public symbol in `langgraph.store.postgres.base` for use in external code. • Exposes `get_distance_operator` function (formerly `_get_distance_operator`) as a public API in `langgraph.store.postgres.base` for custom vector-distance logic. Breaking changes: • The `_PLACEHOLDER` constant is renamed to `PLACEHOLDER`; any code importing `_PLACEHOLDER` directly will break. • The `_get_distance_operator` function is renamed to `get_distance_operator`; any code importing or calling `_get_distance_operator` directly will break. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.18 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.18 Fri, 07 Mar 2025 19:24:29 GMT LangGraph checkpoint 2.0.18 lets BaseStore operations accept non-string keys with automatic conversion. • Enables non-string keys (integers, tuples, etc.) in all BaseStore operations (`get`, `put`, `delete`, and async variants) by automatically converting them to strings before storage. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.55 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.55 Thu, 06 Mar 2025 23:33:51 GMT LangGraph SDK 0.1.55 adds TTL support to the store API, enabling automatic expiration and refresh of stored items. • Adds `ttl` parameter to `put_item` to set item expiration time (in minutes) in the store API. • Adds `refresh_ttl` parameter to `get_item` to control whether an item's TTL is refreshed on read. • Adds `refresh_ttl` parameter to `search_items` to control TTL refresh for items returned by search. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.17 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.17 Thu, 06 Mar 2025 21:39:07 GMT LangGraph Checkpoint 2.0.17 adds TTL support for store items, enabling automatic expiration of stored data. • Adds TTL (time-to-live) support to `BaseStore` via a `supports_ttl` flag, letting store implementations enable automatic expiration of stored items. • Adds `ttl: Optional[float] = None` parameter to `PutOp` to set per-item expiration time in minutes when writing to the store. • Adds `refresh_ttl: bool = True` parameter to `GetOp` and `SearchOp` to control whether TTLs are refreshed on retrieval or search. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.75 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.75 Thu, 06 Mar 2025 19:02:04 GMT LangGraph CLI 0.1.75 adds IDE schema validation for langgraph.json and UI component configuration support. • Adds JSON schema files (`schema.json` and `schema.v0.json`) referenceable in `langgraph.json` to enable IDE autocompletion and validation of LangGraph configuration. • Adds a new `ui` configuration option to the `Config` class for defining UI components associated with agents. • Supports setting the `LANGGRAPH_UI` environment variable in Docker deployments to configure UI components. Breaking changes: • `StoreConfig.embed` is renamed to `StoreConfig.index` — any `langgraph.json` or code referencing `StoreConfig.embed` will break on upgrade. https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==0.1.2 https://github.com/langchain-ai/langgraph/releases/tag/prebuilt==0.1.2 Thu, 06 Mar 2025 02:44:02 GMT LangGraph prebuilt 0.1.2 lets create_react_agent accept a RunnableSequence as its model argument. • Supports passing a `RunnableSequence` as the model to `create_react_agent`, enabling prompt-chained pipelines to be used directly as the agent's LLM backbone. https://github.com/langchain-ai/langgraph/releases/tag/0.3.4 https://github.com/langchain-ai/langgraph/releases/tag/0.3.4 Tue, 04 Mar 2025 22:52:30 GMT LangGraph 0.3.4 adds `config_schema` and `get_config_jsonschema` methods to Pregel, plus a new Pydantic-support utility. • Adds `config_schema` method to `Pregel` for proper configuration schema generation when the config type is a TypedDict, dataclass, or Pydantic model. • Adds `get_config_jsonschema` method to `Pregel` for converting config schemas to JSON Schema format, consistent with existing `get_input_jsonschema`/`get_output_jsonschema`. • Adds `is_supported_by_pydantic` utility function to detect whether a type (dataclass, Pydantic model, or TypedDict, including Python 3.12+) is directly supported by Pydantic. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.74 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.74 Thu, 27 Feb 2025 18:59:31 GMT LangGraph CLI 0.1.74 adds langgraph 0.3.x support and the new langgraph-prebuilt high-level agent API. • Supports langgraph 0.3.x, enabling use of the latest core graph features in CLI-managed projects. • Adds support for `langgraph-prebuilt` v0.1.1, which provides high-level APIs for creating and executing LangGraph agents and tools. https://github.com/langchain-ai/langgraph/releases/tag/0.2.75 https://github.com/langchain-ai/langgraph/releases/tag/0.2.75 Wed, 26 Feb 2025 17:04:18 GMT LangGraph 0.2.75 adds structured response support and configuration schemas to the ReAct agent executor. • Adds `AgentStateWithStructuredResponse` class to support structured responses in the ReAct agent executor. • Adds configuration schema support to the ReAct agent executor. • Enhances `StreamMessagesHandler` to track message IDs nested within input dictionaries for proper deduplication. • Adds `py.typed` markers to package subdirectories for improved type-checking support. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.53 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.53 Thu, 20 Feb 2025 00:01:36 GMT LangGraph SDK 0.1.53 adds store authorization via `@auth.on.store` and dynamic loopback transport configuration. • Adds `@auth.on.store` decorator to authorize access to storage operations, enabling per-user data access control. • Adds `configure_loopback_transports` function and `_registered_transports` list for dynamic server transport configuration. • Supports deferred loopback transport setup via the `__LANGGRAPH_DEFER_LOOPBACK_TRANSPORT` environment variable. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.72 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.72 Wed, 19 Feb 2025 16:55:16 GMT LangGraph CLI 0.1.72 adds Docker build-context support for parent-dir deps and new HTTP server config options including CORS and custom app mounting. • Supports Docker build contexts for local dependencies located in parent directories, enabling more flexible project layouts. • Adds `http.app` config option to mount custom Starlette/FastAPI apps onto the LangGraph HTTP server. • Adds options to disable specific API route groups (assistants, threads, runs, store) via HTTP configuration. • Adds CORS configuration support for the LangGraph HTTP server. https://github.com/langchain-ai/langgraph/releases/tag/0.2.74 https://github.com/langchain-ai/langgraph/releases/tag/0.2.74 Wed, 19 Feb 2025 00:12:44 GMT LangGraph 0.2.74 stabilizes the Functional API and adds custom task submission via CONFIG_KEY_RUNNER_SUBMIT. • Adds `CONFIG_KEY_RUNNER_SUBMIT` configuration key, enabling custom task submission logic in `PregelRunner` for flexible execution control. • Promotes `langgraph.func.task` and `langgraph.func.entrypoint` decorators to stable (Beta label removed). • Adds no-op fallback in `get_stream_writer` so callers can safely invoke the stream writer even when none is configured. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.15 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.15 Sat, 15 Feb 2025 02:59:22 GMT LangGraph checkpoint 2.0.15 adds `get_checkpoint_metadata` for standardized, filtered checkpoint metadata extraction. • Adds `get_checkpoint_metadata` function to extract and process checkpoint metadata from a `RunnableConfig`, filtering out private/excluded keys and non-primitive types for consistent handling across checkpoint implementations. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.14 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.14 Thu, 13 Feb 2025 03:49:21 GMT PostgreSQL checkpoint savers now store richer metadata by merging configurable properties with existing and explicit metadata. • Enriches checkpoint metadata automatically: `put`/`aput` methods on `PostgresSaver`, `AsyncPostgresSaver`, `ShallowPostgresSaver`, and `AsyncShallowPostgresSaver` now combine non-private configurable properties, existing metadata, and explicitly passed metadata into each saved checkpoint. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.13 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.13 Thu, 13 Feb 2025 03:47:25 GMT InMemorySaver now serializes configurable options and existing metadata into checkpoint metadata • Enriches `InMemorySaver.put` checkpoint metadata with non-private `config["configurable"]` entries (keys not prefixed with `__`) and any existing `config["metadata"]` values https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==2.0.4 https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==2.0.4 Thu, 13 Feb 2025 03:47:21 GMT LangGraph SQLite checkpointers now store richer metadata including configurable fields and existing checkpoint metadata. • Enriches checkpoint metadata in `SqliteSaver.put` and `AsyncSqliteSaver.aput` with configurable fields (excluding private `__`-prefixed keys) and any pre-existing metadata alongside explicitly provided metadata. https://github.com/langchain-ai/langgraph/releases/tag/0.2.71 https://github.com/langchain-ai/langgraph/releases/tag/0.2.71 Tue, 11 Feb 2025 19:22:54 GMT LangGraph 0.2.71 adds a `destinations` parameter to add_node() for visualizing routing in edgeless graphs. • Adds optional `destinations` parameter to StateGraph.add_node(), accepting a dict of target-node→edge-label pairs or a tuple of node names, to declare possible routing paths for visualization. • Enables `NodeSpec` and `StateNodeSpec` `ends` field to accept either a tuple of strings or a dict mapping destination node names to edge labels, improving graph rendering fidelity for `Command`-based edgeless graphs. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.12 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.12 Sun, 09 Feb 2025 02:15:08 GMT LangGraph Checkpoint 2.0.12 adds provider-string embedding init and renames MemorySaver to InMemorySaver. • Supports initializing embedding models via provider strings (e.g., `"openai:text-embedding-3-small"`) in `IndexConfig.embed`, eliminating the need to manually instantiate an embeddings object. • Introduces `InMemorySaver` as the canonical class name for the in-memory checkpoint saver, with `MemorySaver` retained as a backward-compatible alias. https://github.com/langchain-ai/langgraph/releases/tag/0.2.70 https://github.com/langchain-ai/langgraph/releases/tag/0.2.70 Thu, 06 Feb 2025 23:06:29 GMT LangGraph 0.2.70 adds parallel tool execution in ReAct agents and graph naming for multi-agent systems. • Adds `version` parameter to create_react_agent() enabling parallel tool execution via the `Send` API (`v2`) or single-node processing (`v1`, default). • Adds `name` parameter to Graph.compile(), StateGraph.compile(), and create_react_agent() to identify graphs when used as subgraphs. • Automatically attaches agent name to AIMessages generated by the ReAct agent for easier identification in multi-agent workflows. • Enables `ToolNode` to accept direct tool calls as a list of `ToolCall` dicts. • Promotes `_inject_tool_args` to public method `inject_tool_args` on `ToolNode`. • Extends `RunnableLike` type to support injected kwargs such as `writer` and `store` via `Concatenate` and `ParamSpec`. https://github.com/langchain-ai/langgraph/releases/tag/0.2.69 https://github.com/langchain-ai/langgraph/releases/tag/0.2.69 Fri, 31 Jan 2025 01:12:37 GMT LangGraph 0.2.69 adds context utilities (get_config, get_store, get_stream_writer), tag support for streamed LLM messages, and optional store in ToolNode. • Adds get_config(), get_store(), and get_stream_writer() utilities in the new `langgraph.config` module to access runtime context (config, store, and custom stream writer) from inside any node or task. • Adds optional `store` parameter support in `ToolNode`, enabling tools to access the LangGraph store without requiring it as a mandatory dependency. • Adds tag support in `StreamMessagesHandler` so streamed LLM messages carry filtered tag metadata (excluding internal sequence-step tags). • Adds `subgraphs` property to `PregelNode` and `subgraphs` field to `PregelExecutableTask` for direct tracking and caching of nested graph references. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.70 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.70 Wed, 29 Jan 2025 13:12:14 GMT LangGraph CLI now supports auth configuration in langgraph.json with path validation and Docker container handling. • Supports `auth` configuration block in `langgraph.json`, with validation that `auth.path` follows the required `./path/to/file.py:attribute_name` format. • Enables auth path resolution in Docker environments via new `_update_auth_path` function, so auth handlers are correctly wired when deploying containers. https://github.com/langchain-ai/langgraph/releases/tag/0.2.68 https://github.com/langchain-ai/langgraph/releases/tag/0.2.68 Tue, 28 Jan 2025 02:25:06 GMT LangGraph 0.2.68 promotes the Functional API to Beta and adds a `name` parameter to the `task` decorator. • Adds `name` parameter to the `task` decorator, allowing custom display names for tasks regardless of the underlying function name. • Promotes the Functional API (`@task`, `@entrypoint`) from Experimental to Beta status with expanded documentation. • Introduces unified `SyncAsyncFuture` type in `langgraph.pregel.call` that implements both the Future interface and the awaitable protocol for task return values. • Renames `state_modifier` parameter to `prompt` in `create_react_agent`, with full backward compatibility retained. Breaking changes: • Generators are no longer supported in the Functional API (`@entrypoint`); any entrypoint using a generator function will break on upgrade. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.69 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.69 Sat, 25 Jan 2025 03:35:29 GMT LangGraph CLI now ships PostgreSQL with pgvector enabled for vector operations support. • Upgrades the bundled PostgreSQL Docker image to `pgvector/pgvector:pg16`, enabling vector operations in local dev environments. • Loads the pgvector extension automatically via `shared_preload_libraries=vector` in the generated Docker Compose configuration. https://github.com/langchain-ai/langgraph/releases/tag/0.2.67 https://github.com/langchain-ai/langgraph/releases/tag/0.2.67 Thu, 23 Jan 2025 23:18:11 GMT LangGraph 0.2.67 adds entrypoint.final for separating return vs. checkpointed values and async state modifiers in the chat agent executor. • Adds `entrypoint.final` primitive to return a value to the caller that differs from the value saved in the checkpoint. • Supports async coroutine functions as state modifiers in the chat agent executor. • Adds thread-safe atomic counters in `PregelScratchpad` for safer concurrent graph execution. • Supports Union types in node function return annotations so `add_node` correctly extracts `Command` types. • Enhances `Command.update` with automatic field extraction from type hints on dataclasses and typed objects. • Reduces tracing noise by applying `recurse=False` to internal `RunnableCallable` instances. Breaking changes: • The `CONFIG_KEY_END` constant is renamed to `CONFIG_KEY_PREVIOUS`; any code referencing `CONFIG_KEY_END` will break. • `PregelScratchpad` is changed from a `TypedDict` to a dataclass; code that constructs or unpacks it as a plain dict will break. https://github.com/langchain-ai/langgraph/releases/tag/0.2.66 https://github.com/langchain-ai/langgraph/releases/tag/0.2.66 Tue, 21 Jan 2025 18:43:21 GMT LangGraph 0.2.66 adds `run_coroutine_threadsafe`, `explode_args`, and `trace_inputs` for safer async execution and richer tracing. • Adds `explode_args` parameter to `RunnableCallable` to unpack a tuple of (args, kwargs) instead of passing it as the first positional argument; affects both `invoke` and `ainvoke` methods. • Adds `trace_inputs` parameter to `RunnableSeq` to customize how inputs are recorded in callbacks across `invoke`, `ainvoke`, `stream`, and `astream`. • Adds `run_coroutine_threadsafe` function in `langgraph.utils.future` for safely running coroutines from any thread context. • Adds `CONTEXT_NOT_SUPPORTED` flag in `langgraph.utils.future` to handle Python versions whose event loops do not support `contextvars`. • Adds `get_runnable_for_entrypoint` and `get_runnable_for_task` functions in `langgraph.pregel.call` for targeted handling of distinct execution contexts. • Moves the `call` function from `langgraph.func.__init__` to `langgraph.pregel.call` for better module organization. • Adds `_explode_args_trace_inputs` utility in `langgraph.pregel.call` to flatten function arguments in traces for improved debugging. • Enhances `chain_future` in `langgraph.utils.future` to return the destination future, enabling direct chaining. • Removes the restriction in `PregelRunner` that only coroutine functions could be called in an async context, and adds context detection to return the appropriate future type (async or sync) based on the calling context. https://github.com/langchain-ai/langgraph/releases/tag/0.2.65 https://github.com/langchain-ai/langgraph/releases/tag/0.2.65 Tue, 21 Jan 2025 02:45:16 GMT LangGraph 0.2.65 adds graph visualization for entrypoint functions and a new get_store() utility for easy store access. • New `EntrypointPregel` class exposes a get_graph() method to visualize entrypoint functions and their dependent tasks, including nested subgraphs via x-ray mode. • New get_store() utility function retrieves the `BaseStore` from the current config context without manual extraction. • Tasks decorated with `@task` now carry a `_is_pregel_task` attribute, making them automatically discoverable for graph visualization. Breaking changes: • The `entrypoint` decorator now returns an `EntrypointPregel` instance instead of a `Pregel` instance; code that type-checks or depends on the exact return type being `Pregel` will break. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.68 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.68 Mon, 20 Jan 2025 23:36:08 GMT LangGraph CLI 0.1.68 adds Bun package manager support and clearer JS-graph error guidance. • Supports Bun as a detected package manager: detects `bun.lockb` and runs `bun i` automatically for Bun-based projects. • Adds a clear error message when users attempt to run JS graphs with the Python CLI, directing them to use `npx @langchain/langgraph-cli` instead. https://github.com/langchain-ai/langgraph/releases/tag/0.2.64 https://github.com/langchain-ai/langgraph/releases/tag/0.2.64 Fri, 17 Jan 2025 20:35:39 GMT LangGraph 0.2.64 adds config schema validation and `previous` state access to the `entrypoint` decorator. • Adds `config_schema` parameter to the `entrypoint` decorator, enabling schema validation for workflow configuration. • Adds support for an optional `previous` parameter in `entrypoint`-decorated functions to access the prior return value in stateful Pregel graphs. • Adds automatic input/output type detection from function signatures in the `entrypoint` decorator, removing the need for manual type annotation wiring. https://github.com/langchain-ai/langgraph/releases/tag/0.2.63 https://github.com/langchain-ai/langgraph/releases/tag/0.2.63 Thu, 16 Jan 2025 14:35:51 GMT LangGraph 0.2.63 adds subgraph checkpointing, string model IDs in create_react_agent, human-interrupt types, and eager streaming. • Supports `checkpointer=True` on subgraphs to enable persistent checkpointing without passing a full checkpointer object. • Accepts string model identifiers in `create_react_agent`, e.g. create_react_agent("openai:gpt-4", tools). • Adds structured type definitions for human-in-the-loop interactions: `HumanInterruptConfig`, `ActionRequest`, `HumanInterrupt`, and `HumanResponse` in `langgraph.prebuilt.interrupt`. • Adds `stream_eager` option to `langgraph.pregel` to force stream events to emit eagerly. • Enables method chaining on `add_node`, `add_edge`, `add_sequence`, `add_conditional_edges`, `set_entry_point`, `set_conditional_entry_point`, and `set_finish_point` via updated `Self` return types. • Allows mixed Command and non-Command types in list commands, removing the requirement that all list items be Command objects. Breaking changes: • `get_configurable` in `langgraph.utils.config` is renamed to `get_config`; any code calling `get_configurable` will break. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.12 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.12 Wed, 15 Jan 2025 19:31:31 GMT langgraph-checkpoint-postgres 2.0.12 adds task_path tracking to checkpoint writes for better data organization. • Adds `task_path` parameter to put_writes() and aput_writes() on all saver classes (`PostgresSaver`, `AsyncPostgresSaver`, `ShallowPostgresSaver`, `AsyncShallowPostgresSaver`) to tag checkpoint writes with their originating task path. • Extends the `checkpoint_writes` table schema with a `task_path` column, enabling path-based ordering and querying of checkpoint write records. https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==2.0.3 https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==2.0.3 Wed, 15 Jan 2025 19:30:06 GMT LangGraph SQLite checkpointer adds `task_path` parameter to write-tracking methods for improved task traceability. • Adds optional `task_path` parameter to SqliteSaver.put_writes() for tracking which task path created a given set of writes. • Adds optional `task_path` parameter to AsyncSqliteSaver.put_writes() and AsyncSqliteSaver.aput_writes() for async task traceability. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.10 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.10 Wed, 15 Jan 2025 19:23:48 GMT LangGraph checkpoint 2.0.10 adds task path tracking to `put_writes`/`aput_writes` for consistent ordering in nested task graphs. • Adds `task_path` parameter to `put_writes` and `aput_writes` on `BaseCheckpointSaver` and `InMemorySaver` to track the nested path of tasks creating checkpoint writes. • Enables deterministic, consistent ordering of pending sends by sorting on task path, task ID, and sequence number during checkpoint retrieval. https://github.com/langchain-ai/langgraph/releases/tag/checkpointduckdb==2.0.2 https://github.com/langchain-ai/langgraph/releases/tag/checkpointduckdb==2.0.2 Tue, 14 Jan 2025 20:18:37 GMT LangGraph DuckDB checkpointer adds in-memory vector search support • Adds in-memory vector search capability to the DuckDB checkpointer https://github.com/langchain-ai/langgraph/releases/tag/0.2.62 https://github.com/langchain-ai/langgraph/releases/tag/0.2.62 Fri, 10 Jan 2025 19:53:30 GMT LangGraph 0.2.62 adds a `response_format` parameter to `create_react_agent` for structured, schema-validated agent outputs. • Adds `response_format` parameter to `create_react_agent` to enforce a schema on final agent output, returned in the `structured_response` state key. • Supports OpenAI function/tool schemas, JSON Schema, TypedDict classes, and Pydantic models as the response schema. • Accepts a (prompt, schema) tuple for `response_format` to supply a custom prompt when generating structured output. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.50 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.50 Thu, 09 Jan 2025 16:43:41 GMT LangGraph SDK 0.1.50 adds store authorization handlers and expands Command.update to accept tuple sequences. • Adds `auth.on.store` decorators to authorize store operations (put, get, search, list_namespaces, delete) at the handler level. • Introduces new TypedDict classes — `StoreGet`, `StoreSearch`, `StoreListNamespaces`, `StorePut`, `StoreDelete` — for typed store operation authorization. • Expands `Command.update` to accept sequences of tuples in addition to dictionaries, enabling more flexible graph state updates. https://github.com/langchain-ai/langgraph/releases/tag/0.2.61 https://github.com/langchain-ai/langgraph/releases/tag/0.2.61 Sun, 05 Jan 2025 23:01:32 GMT LangGraph 0.2.61 adds OpenAI-format message conversion to `add_messages` and a more flexible `task` decorator with async support. • Adds `format="langchain-openai"` parameter to `add_messages` to automatically convert message content (strings, text blocks, image_url blocks) to OpenAI-compatible format. • Enables `add_messages` as a partial function when called without arguments, improving flexibility in type annotations. • Rewrites the `task` decorator to support both direct (`@task`) and parameterized (@task(...)) usage, with proper coroutine detection and wrapping for async functions. • Expands `task` decorator function signature to accept `*args` and `**kwargs` and adds overloads for better IDE type inference. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.9 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.9 Fri, 20 Dec 2024 22:51:41 GMT LangGraph Postgres checkpointer adds ShallowPostgresSaver and AsyncShallowPostgresSaver for lightweight, history-free checkpoint storage. • Adds `ShallowPostgresSaver`, a drop-in replacement for `PostgresSaver` that stores only the most recent checkpoint, reducing storage when time travel is not needed. • Adds `AsyncShallowPostgresSaver`, the async counterpart to `ShallowPostgresSaver`, with the same lightweight storage semantics and a full async interface. Breaking changes: • The `batch` method has been removed from `AsyncPostgresStore`; callers must switch to `abatch` instead. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.48 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.48 Wed, 18 Dec 2024 19:43:03 GMT LangGraph SDK 0.1.48 adds StudioUser class for fine-grained authorization control over LangGraph Studio UI access. • Adds `StudioUser` class in `langgraph_sdk/auth/types.py` representing authenticated users from the LangGraph Studio UI, exposing properties for username, display name, identity, permissions, and auth status. • Enables custom authorization handlers to branch on Studio vs. non-Studio users via isinstance(user, StudioUser) checks. • Supports disabling Studio authentication entirely via `disable_studio_auth: true` in `langgraph.json`. https://github.com/langchain-ai/langgraph/releases/tag/0.2.60 https://github.com/langchain-ai/langgraph/releases/tag/0.2.60 Wed, 18 Dec 2024 13:59:54 GMT LangGraph 0.2.60 makes Command.update accept any type and relaxes tool node validation for multi-message responses. • Extends `Command.update` to accept any type of value (not just dicts or sequences of tuples), including `None`, enabling more diverse node-to-node command patterns. • Relaxes prebuilt `tool_node` validation to allow multiple tool messages in a command update, requiring only that at least one message matches the tool call ID. Breaking changes: • The default value of `Command.update` changed from () (empty tuple) to `None`; code that checks if command.update == () or relies on the empty-tuple default will behave differently. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.47 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.47 Tue, 17 Dec 2024 20:13:11 GMT LangGraph SDK 0.1.47 simplifies auth handlers and renames scopes to permissions in the Auth module. • Simplifies authentication handler return type: handlers now return a user representation directly (string, dict, or object) instead of a (scopes, user) tuple. • Adds `permissions` field to `MinimalUserDict` and `permissions` property to the `BaseUser` interface in `Auth.types`. • Updates `Authenticator` type signature to reflect the new single-object return format. Breaking changes: • The `scopes` field/property is renamed to `permissions` throughout the Auth module — any code referencing `scopes` on auth objects or `MinimalUserDict` will break. • Authentication handlers must now return a single user representation (string, dict with `identity`/`permissions`, or compatible object) instead of a tuple of (scopes, user). https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.64 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.64 Tue, 17 Dec 2024 00:34:54 GMT LangGraph CLI now validates `dependencies` in configuration, with graceful fallback when the field is absent. • Adds `dependencies` field validation to `validate_config`, ensuring dependency declarations are checked and included during config processing. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.46 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.46 Mon, 16 Dec 2024 19:10:04 GMT LangGraph SDK 0.1.46 adds HTTPException to auth handlers for precise HTTP error control • Adds `HTTPException` class to `Auth.exceptions`, letting auth handlers return custom HTTP status codes, error messages, and headers instead of generic failures. • Exposes `exceptions` module on the `Auth` class for clean, importable access to auth-related exception types. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.63 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.63 Sat, 14 Dec 2024 15:35:49 GMT LangGraph CLI 0.1.63 adds OpenAPI security scheme configuration to AuthConfig for customizing API auth settings. • Adds `SecurityConfig` TypedDict class for defining OpenAPI security schemes and requirements in authentication config. • Extends `AuthConfig` with a new `openapi` field of type `SecurityConfig`, enabling customization of API security settings such as OAuth2 scopes and token endpoints. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.62 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.62 Sat, 14 Dec 2024 01:28:05 GMT LangGraph CLI 0.1.62 adds auth configuration support for LangGraph Studio with a new AuthConfig type. • New `AuthConfig` TypedDict with `path` and `disable_studio_auth` fields enables custom authentication configuration for LangGraph Studio. • New `auth` field on the main `Config` TypedDict wires auth settings into config validation and Docker environment generation. • The `dev` command now accepts auth configuration, allowing Studio auth to be controlled at dev-server launch time. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.45 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.45 Sat, 14 Dec 2024 00:35:26 GMT LangGraph SDK 0.1.45 adds an `Auth` class with decorator-based authentication and fine-grained per-resource authorization. • Adds `Auth` class providing a unified authentication and authorization system for LangGraph applications. • Supports decorator-based auth handlers to verify credentials and return user scopes. • Enables fine-grained access control per resource (threads, assistants, crons) and per action (create, read, update, delete, search). • Implements a hierarchical handler system supporting global fallback handlers alongside specific per-action handlers. • Introduces a new types module with typed dictionaries (e.g., `ThreadsCreate`, `AssistantsRead`), protocol definitions for user objects and auth handlers, and strongly-typed context objects. https://github.com/langchain-ai/langgraph/releases/tag/0.2.59 https://github.com/langchain-ai/langgraph/releases/tag/0.2.59 Wed, 11 Dec 2024 21:58:40 GMT LangGraph 0.2.59 enables config-aware tool execution by passing configuration to prebuilt tool node invocations. • Enables prebuilt tool node to pass the configuration object to tools during both synchronous (`invoke`) and asynchronous (`ainvoke`) execution, allowing tools to access runtime configuration parameters. https://github.com/langchain-ai/langgraph/releases/tag/0.2.58 https://github.com/langchain-ai/langgraph/releases/tag/0.2.58 Tue, 10 Dec 2024 22:25:10 GMT LangGraph 0.2.58 adds string node names in Command.goto and richer config metadata with defaults and descriptions. • Supports string values in `Command.goto`, enabling direct node-name references instead of requiring `Send` objects for state transitions. • Adds `get_enhanced_type_hints` utility to extract type hints along with default values and descriptions, covering Pydantic models, TypedDict, and dataclasses. • Enriches `Pregel.config_specs` output with default values and descriptions for configuration fields via `get_enhanced_type_hints`. https://github.com/langchain-ai/langgraph/releases/tag/0.2.57 https://github.com/langchain-ai/langgraph/releases/tag/0.2.57 Tue, 10 Dec 2024 15:51:30 GMT LangGraph 0.2.57 adds a functional API with `@task`/`@entrypoint` decorators and lets tools return `Command` objects. • Adds `@task` decorator (`langgraph.func.task`) for creating parallel async tasks that return futures, with optional retry policies. • Adds `@entrypoint` decorator (`langgraph.func.entrypoint`) to wrap regular or generator functions into Pregel graphs as callable entry points. • Enables `Command` objects to be returned directly from LangChain tools via `ToolOutputMixin` compatibility and `ToolNode` support. • Adds `StateGraph` support for lists of `Command` objects and tuple-based state updates in node outputs. • Adds `_repr_mimebundle_` to `Graph` for inline Mermaid diagram visualization in Jupyter notebooks. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.43 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.43 Thu, 05 Dec 2024 01:34:26 GMT LangGraph SDK 0.1.43 adds query-param streaming and expands Command routing flexibility • Adds optional `params` argument to HttpClient.stream() (async and sync) so query parameters can be passed with streaming requests. • Expands `Command` TypedDict's `goto` field to accept `Send`, `str`, or a sequence of either, enabling richer graph routing in command structures. Breaking changes: • The `Command` TypedDict field `send` is renamed to `goto`; any code referencing Command(send=...) will break on upgrade. https://github.com/langchain-ai/langgraph/releases/tag/0.2.55 https://github.com/langchain-ai/langgraph/releases/tag/0.2.55 Thu, 05 Dec 2024 00:00:39 GMT LangGraph 0.2.55 overhauls interrupt/resume with scratchpad tracking and consolidates Send into the goto field • Adds `CONFIG_KEY_WRITES` constant exposing a read-only list of existing task writes to task configuration • Adds `CONFIG_KEY_SCRATCHPAD` constant providing temporary storage scoped to the current task • Rewrites the `interrupt` function with interrupt-count tracking to correctly handle multiple interrupts within the same node • Enables `goto` field on `Command` to accept both string node names and `Send` objects, unifying send/goto into one API • Deduplicates writes to special channels in `PregelLoop.put_writes` (last write wins) Breaking changes: • The `send` field is removed from the `Command` class; any code passing `send=` to `Command` will break — use `goto` instead. • The `CONFIG_KEY_RESUME_VALUE` constant is removed; code referencing it directly will break — use `CONFIG_KEY_WRITES` and `CONFIG_KEY_SCRATCHPAD` instead. https://github.com/langchain-ai/langgraph/releases/tag/0.2.54 https://github.com/langchain-ai/langgraph/releases/tag/0.2.54 Tue, 03 Dec 2024 21:51:57 GMT LangGraph 0.2.54 adds parent-graph command routing, empty-tool ReAct agents, and Command input support for RemoteGraph. • Adds `Command.PARENT` constant (`"__parent__"`) and a `graph` field on `Command` so nodes in a subgraph can route commands up to the parent graph. • Adds `GraphBubbleUp` base exception class and new `ParentCommand` exception to propagate parent-directed commands cleanly through the graph hierarchy. • Enables `create_react_agent` to accept an empty tools list, producing a simple LLM-only graph without tool-calling plumbing. • Enables `RemoteGraph.stream` and `RemoteGraph.invoke` to accept `Command` objects directly as input, with pass-through of additional client kwargs. • Graph validation now only requires at least one edge from START; unreachable nodes no longer cause a validation error. • Adds Python 3.11+ exception notes in retry mechanisms for richer error diagnostics when tasks fail. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.42 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.42 Tue, 03 Dec 2024 21:36:38 GMT LangGraph SDK 0.1.42 adds run status filtering, cancel-on-disconnect streaming, and command support in assistant APIs. • Adds `status` parameter to RunsAPI.list() to filter runs by execution status. • Adds `cancel_on_disconnect` parameter to RunsAPI.join_stream() to automatically cancel a run when the client disconnects from the stream. • Adds `command` parameter to AssistantAPI.stream(), .create(), and .wait() for finer control over assistant execution. • Adds `Interrupt` type definition and exposes interrupt information on the `Thread` schema for improved interrupt handling. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.7 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.7 Tue, 03 Dec 2024 01:59:57 GMT langgraph-checkpoint-postgres 2.0.7 adds configurable vector indices (HNSW, IVFFlat, flat) and improved vector search ordering. • Adds `ANNIndexConfig` with a `kind` field to select vector index type: `'hnsw'`, `'ivfflat'`, or `'flat'`. • Adds `HNSWConfig` class for tuning HNSW indices via `m` (max connections per layer) and `ef_construction` (dynamic candidate list size). • Adds `IVFFlatConfig` class for tuning IVFFlat indices via `nlist` (number of inverted lists/clusters). • Adds automatic vector index creation in `BasePostgresStore` based on the supplied index configuration. • Adds `condition` field to `Migration` to support conditional migration execution based on store configuration. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.61 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.61 Thu, 28 Nov 2024 20:26:57 GMT LangGraph CLI adds `--wait-for-client` flag for blocking debug startup and isolates store config into `LANGGRAPH_STORE`. • Adds `--wait-for-client` flag to the `dev` command that, combined with `--debug-port`, pauses server startup until a debugger client connects. • Introduces dedicated `LANGGRAPH_STORE` environment variable for store configuration in Docker environments, replacing the previous embedding inside `LANGGRAPH_CONFIG`. Breaking changes: • Store configuration in Docker environments is now passed via `LANGGRAPH_STORE` instead of `LANGGRAPH_CONFIG`; any tooling or scripts that read store config from `LANGGRAPH_CONFIG` will no longer receive it there. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.5 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.5 Thu, 28 Nov 2024 10:13:47 GMT langgraph-checkpoint-postgres 2.0.5 adds pgvector-powered semantic search to PostgreSQL-backed LangGraph stores. • Adds `PostgresIndexConfig` class to configure pgvector-backed vector search with configurable dimensions, distance metrics (l2, inner_product, cosine), and vector types (vector, halfvec). • Enables vector similarity search and embedding-based document indexing and retrieval in `BasePostgresStore`. • Adds async embedding and vector search support to `AsyncPostgresStore` for non-blocking document indexing and retrieval. • Introduces `_row_to_search_item` to surface similarity scores as float values alongside search results. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.60 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.60 Thu, 28 Nov 2024 10:00:58 GMT LangGraph CLI 0.1.60 adds vector store configuration with embedding specs, enabling semantic search in LangGraph projects. • Adds `IndexConfig` and `StoreConfig` configuration types to specify vector embedding dimensions (`dims`), model selection (`embed`), and custom field extraction (`fields`) for semantic search. • Enables the `dev` command to pass store configuration from `config.json` to the LangGraph server at runtime. • Supports store settings in Docker container deployments via environment variable pass-through. • Adds `python-dotenv` as an optional dependency for environment variable management. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.40 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.40 Thu, 28 Nov 2024 06:54:08 GMT LangGraph SDK 0.1.40 adds natural language search to the store with relevance scoring and fine-grained index control. • Adds `query` parameter to `search_items` (sync and async) enabling natural language search over stored items. • Introduces `SearchItem` class extending `Item` with an optional `score` field, so callers can rank results by relevance. • Updates `SearchItemsResponse` to return `list[SearchItem]` instead of `list[Item]`, surfacing relevance scores in all search results. • Adds `index` parameter to `put_item` (sync and async) to control per-item indexing: `None` for default, `False` to skip indexing, or a `list[str]` of field paths to index selectively. Breaking changes: • `SearchItemsResponse` now returns `list[SearchItem]` instead of `list[Item]`; code that type-checks or pattern-matches on `Item` from search results will need updating. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.7 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.7 Thu, 28 Nov 2024 04:53:15 GMT LangGraph checkpoint 2.0.7 adds vector/semantic search to stores, richer query filters, and embedding utilities. • Adds semantic similarity search to `BaseStore` via an updated `search`/`asearch` interface that returns ranked `SearchItem` instances with a `score` field. • Introduces `IndexConfig` class to configure vector search settings — embedding dimensions, embedding function, and which fields to index — per store. • Adds `index` parameter to `put`/`aput` (and `PutOp`) to control per-item vector indexing: use default indexing, disable with `False`, or specify custom field paths. • Adds `query` parameter to `SearchOp` for natural-language semantic search alongside existing namespace/filter queries. • Enhances query filtering in `SearchOp` with comparison operators (`$eq`, `$gt`, `$lt`, and others) including support for nested fields and array path expressions. • Adds `ensure_embeddings` utility to wrap any sync or async embedding function into LangChain's `Embeddings` interface, plus `EmbeddingsFunc`/`AEmbeddingsFunc` type definitions. • Adds `get_text_at_path` and `tokenize_path` utilities for extracting text from nested objects using path expressions with support for wildcards, array indexing, and multi-field selection. • Rewrites `InMemoryStore` with full vector search support and optional NumPy acceleration for vector operations. Breaking changes: • `NameSpacePath` is renamed to `NamespacePath`; code importing or referencing `NameSpacePath` will break. • `search` and `asearch` on `BaseStore` now return `SearchItem` instances instead of plain `Item` instances; code that expects `Item` objects from these methods may break. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.4 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.4 Tue, 26 Nov 2024 01:59:50 GMT langgraph-checkpoint-postgres 2.0.4 adds connection pooling, pipeline optimization, and last-write-wins deduplication for Postgres stores. • New `PoolConfig` TypedDict in `langgraph.store.postgres.base` lets you configure min/max connections and extra connection parameters for PostgreSQL connection pools. • Adds connection pooling support to both `PostgresStore` and `AsyncPostgresStore` for improved throughput under high concurrency. • Adds pipelined database operations to `PostgresStore` and `AsyncPostgresStore`, batching queries for higher throughput. • Adds last-write-wins deduplication semantics for concurrent operations on the same key in `PostgresStore`. • Adds thread locking (`PostgresStore`) and async locks (`AsyncPostgresStore`) for safe concurrent access. • Improves inheritance support in `PostgresSaver` and `AsyncPostgresSaver` by using `cls` instead of hardcoded class names, enabling reliable subclassing. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.6 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.6 Tue, 26 Nov 2024 01:58:37 GMT LangGraph checkpoint 2.0.6 adds async namespace listing and batch operation deduplication to AsyncBatchedBaseStore. • Adds `alist_namespaces` method to `AsyncBatchedBaseStore` for querying namespaces with filtering by prefix, suffix, depth, and pagination. • Improves batch performance in `AsyncBatchedBaseStore` via a new `_dedupe_ops` function that deduplicates identical get/search operations and consolidates multiple puts to the same key. • Extends `CheckpointMetadata.source` to accept `"fork"` as a valid value, identifying checkpoints created as copies of other checkpoints. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.59 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.59 Mon, 25 Nov 2024 20:08:44 GMT LangGraph CLI dev command now auto-loads config-file dependencies onto Python's path • Enables the `dev` command to read the `dependencies` field from the config file and add those directories to Python's path automatically. • Automatically adds the current working directory to Python's path when running the `dev` command, allowing seamless local module imports. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.58 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.58 Thu, 21 Nov 2024 16:38:12 GMT LangGraph CLI 0.1.58 adds `env` parameter to pass environment variables from config file to the dev server. • Supports passing environment variables from the configuration file to the development server via a new `env` parameter. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.56 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.56 Thu, 21 Nov 2024 01:42:26 GMT LangGraph CLI 0.1.56 adds Python 3.13 support and Node.js/package.json compatibility validation. • Supports Python 3.13 as a valid runtime in langgraph-cli config. • Adds validate_config_file() function that loads and validates config files in a single call. • Validates Node.js version compatibility against `package.json` when present in a project. • Introduces `MIN_NODE_VERSION` and `MIN_PYTHON_VERSION` constants for centralized version requirement enforcement. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.55 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.55 Tue, 19 Nov 2024 08:47:41 GMT LangGraph CLI gains a `langgraph dev` command for running the API server in development mode with hot reloading. • New `langgraph dev` command runs the LangGraph API server in development mode with hot reloading and options for `--host`, `--port`, `--no-reload`, `--config`, `--n-jobs-per-worker`, `--no-browser`, and `--debug-port`. • New `inmem` extras entry enables lightweight in-memory API support via `pip install "langgraph-cli[inmem]"`. https://github.com/langchain-ai/langgraph/releases/tag/0.2.51 https://github.com/langchain-ai/langgraph/releases/tag/0.2.51 Tue, 19 Nov 2024 00:11:28 GMT LangGraph 0.2.51 adds checkpoint forking to Pregel via a new `__copy__` node. • Adds checkpoint forking in `Pregel` via a new `__copy__` special node: when `as_node="__copy__"` and `values=None`, creates a copy of the checkpoint with a "fork" source marker and preserved parent metadata. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.5 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.5 Mon, 18 Nov 2024 16:22:23 GMT LangGraph checkpoint 2.0.5 adds disk-persistent checkpoints via PersistentDict and a configurable MemorySaver storage backend. • New `PersistentDict` class provides dictionary-like checkpoint storage backed by disk, using atomic writes for data safety. • Adds a `factory` parameter to `MemorySaver` to swap in custom storage backends, including the new `PersistentDict`. https://github.com/langchain-ai/langgraph/releases/tag/0.2.50 https://github.com/langchain-ai/langgraph/releases/tag/0.2.50 Fri, 15 Nov 2024 23:51:21 GMT LangGraph 0.2.50 adds the ability to create snapshot checkpoints without modifying graph state. • Enables creating checkpoint snapshots mid-execution via `aupdate_state` without applying any state changes (pass `values=None, as_node=None`). https://github.com/langchain-ai/langgraph/releases/tag/0.2.49 https://github.com/langchain-ai/langgraph/releases/tag/0.2.49 Fri, 15 Nov 2024 23:09:34 GMT LangGraph 0.2.49 adds checkpoint copying and a debug parameter to graph execution loops. • Supports copying the current checkpoint by calling `update_state` with both `values=None` and `as_node=None`. • Adds a `debug` parameter to loop creation in `Pregel` for improved visibility into graph execution. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.54 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.54 Fri, 15 Nov 2024 19:03:41 GMT LangGraph CLI gains a `new` project scaffolding command, Docker Compose generation, and five built-in agent templates. • Adds `new` command to scaffold LangGraph projects interactively from five built-in templates (minimal chatbot, ReAct Agent, Memory Agent, Retrieval Agent, Data-enrichment Agent). • Adds `--add-docker-compose` flag to the `dockerfile` command, generating a docker-compose.yml, .env, and .dockerignore alongside the Dockerfile. • Adds `--version` flag to display the installed CLI version. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.4 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.4 Thu, 14 Nov 2024 01:40:12 GMT langgraph-checkpoint 2.0.4 adds INTERRUPT and RESUME constants to support graph execution interruption and resumption. • Adds `INTERRUPT` and `RESUME` constants to `langgraph.checkpoint.serde.types`, enabling interrupt and resume operations in graph execution checkpointing. • Reserves checkpoint write index values -3 and -4 for interrupt and resume operation types in `WRITES_IDX_MAP`. Breaking changes: • The `CommandProtocol` class has been removed from `langgraph.checkpoint.serde.types` and its serialization handling dropped from `JsonPlusSerializer`; any code referencing `CommandProtocol` will break on upgrade. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.36 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.36 Thu, 14 Nov 2024 01:10:48 GMT LangGraph SDK 0.1.36 adds Command-based graph control, rollback cancellation, and a new messages-tuple stream mode. • Adds `command` parameter to stream(), create(), and wait() run methods, enabling direct node interaction and state manipulation without requiring input. • Adds new `Command` type with `send`, `update`, and `resume` operations for fine-grained graph execution control. • Adds `Send` typed dictionary to support direct node targeting during runs. • Enhances cancel() with a new `action` parameter supporting `"interrupt"` (default) or `"rollback"` modes to control cancellation behavior. • Adds `CancelAction` type to the schema to back the new cancellation modes. • Adds `"messages-tuple"` as a new `StreamMode` literal option. Breaking changes: • "running" has been removed from `RunStatus` literals, which will break any code that checks for or matches against that status value. https://github.com/langchain-ai/langgraph/releases/tag/0.2.47 https://github.com/langchain-ai/langgraph/releases/tag/0.2.47 Wed, 13 Nov 2024 22:09:52 GMT LangGraph 0.2.47 adds resumable interrupts via a new interrupt() function and Command(resume=…) parameter. • Adds interrupt() function in `langgraph.types` enabling nodes to pause and later resume with specific values, with namespace tracking for accurate resumption. • Adds a `resume` parameter to the `Command` class to control resumption of graph execution after an interrupt. • Adds `RESUME` constant in `langgraph.constants` to identify values used to resume a node after an interrupt. • Adds `NULL_TASK_ID` constant in `langgraph.constants` to handle writes not associated with any specific task, enabling global writes independent of task execution. • Supports pushing new tasks during graph execution, improving dynamic task scheduling. https://github.com/langchain-ai/langgraph/releases/tag/0.2.46 https://github.com/langchain-ai/langgraph/releases/tag/0.2.46 Wed, 13 Nov 2024 01:24:06 GMT LangGraph 0.2.46 adds `add_sequence` for linear node chains, `GraphCommand` class, and explicit checkpointing opt-out. • Adds add_sequence() method to `StateGraph` for declaratively building a linear chain of nodes with edges auto-wired between them. • Introduces `GraphCommand` class (replacing deprecated `Control`) with a `goto` parameter for directing graph flow and updating state. • Supports passing `False` to StateGraph.compile(checkpointer=False) to explicitly disable checkpointing in a graph or subgraph. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.3 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==2.0.3 Wed, 13 Nov 2024 01:19:10 GMT LangGraph Checkpoint 2.0.3 adds CommandProtocol serialization support in JSON and MessagePack formats. • New `CommandProtocol` interface in `langgraph.checkpoint.serde.types` enables serialization of command objects (including update and send operations) that mirror the `Command` type from LangGraph. • Extends `JsonPlusSerializer` to serialize `CommandProtocol` objects in both JSON and MessagePack formats by encoding their attributes. https://github.com/langchain-ai/langgraph/releases/tag/0.2.45 https://github.com/langchain-ai/langgraph/releases/tag/0.2.45 Mon, 04 Nov 2024 19:42:41 GMT LangGraph 0.2.45 adds a `Control` class so node functions can steer graph flow and send values to destination nodes directly. • New `Control` class lets node functions simultaneously update state and direct graph flow — including triggering specific next nodes or sending values to them. • Nodes can now declare their potential destination nodes via type annotations on their return type, enabling static graph validation of routing paths. • New `SELF` constant represents the implicit branch created to handle `Control` return values. • Metadata is now preserved across `update_state` / `aupdate_state` calls, so checkpoint metadata survives incremental updates. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.53 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.53 Mon, 04 Nov 2024 17:29:09 GMT LangGraph CLI 0.1.53 adds JavaScript/TypeScript project templates and arbitrary Docker build argument passthrough. • Adds a JavaScript/TypeScript project template for scaffolding LangGraph.js applications, including TypeScript config, ESLint, Jest, and sample StateAnnotation-based graph. • Enables passing arbitrary Docker build arguments directly to the Docker build process in the `build` command. • Adds automatic Node.js package manager detection (npm, yarn, pnpm) based on lock files, selecting the correct install and build commands automatically. Breaking changes: • The `--platform` option has been removed from the build command; use Docker's native passthrough parameters instead. • The deprecated `test` command has been removed; use the `run` command instead. https://github.com/langchain-ai/langgraph/releases/tag/0.2.44 https://github.com/langchain-ai/langgraph/releases/tag/0.2.44 Sat, 02 Nov 2024 00:38:06 GMT LangGraph 0.2.44 adds chat history validation for ReAct agents and messages-tuple stream mode for remote graphs. • Adds `INVALID_CHAT_HISTORY` error code and `_validate_chat_history` function to catch mismatched tool call / tool response pairs in chat history before they reach the LLM. • Supports `messages-tuple` stream mode format for `RemoteGraph`, automatically mapping it to the `messages` mode. • Improves `RemoteGraph` visualization by resolving meaningful node names from node data instead of falling back to an empty string. https://github.com/langchain-ai/langgraph/releases/tag/0.2.42 https://github.com/langchain-ai/langgraph/releases/tag/0.2.42 Thu, 31 Oct 2024 14:42:14 GMT LangGraph 0.2.42 improves nested streaming in RemoteGraph with proper parent-graph stream mode propagation. • Enables `RemoteGraph` to accept stream-mode configuration from parent graphs and propagate it correctly through nested graph hierarchies. • Supports namespace information propagation between parent and child graphs during streaming sessions. • Removes `events` stream mode support in Pregel, as it was never functional. Breaking changes: • The `events` stream mode is explicitly no longer supported in Pregel; any working setup that requested `events` as a stream mode will no longer function. https://github.com/langchain-ai/langgraph/releases/tag/0.2.40 https://github.com/langchain-ai/langgraph/releases/tag/0.2.40 Thu, 31 Oct 2024 01:05:57 GMT LangGraph 0.2.40 adds DuckDB checkpointing, richer ToolNode error handling, and concurrency limiting for async executors. • Adds DuckDB checkpointing support via the new `langgraph-checkpoint-duckdb` package. • Adds `messages_key` parameter to `ToolNode` and `tools_condition` for flexible integration with non-standard state schemas. • Enhances `ToolNode` error handling: accepts a boolean, custom string, callable, or tuple of exception types to selectively catch and format errors, and attaches `status="error"` to error tool messages. • Adds concurrency limiting to `AsyncBackgroundExecutor` via `max_concurrency` config parameter and semaphore-based `gated` utility. • Adds `node_finished` callback parameter to `PregelRunner` via `CONFIG_KEY_NODE_FINISHED` for node-completion hooks. • Improves schema inference in `StateGraph` for class method node functions via the extracted `_get_input_schema_from_type_hint` helper. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.35 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.35 Mon, 28 Oct 2024 22:31:57 GMT LangGraph SDK 0.1.35 adds error-handling control to `wait` and raises default timeouts to 300 s • Adds `raise_error` parameter to `LangGraphClient.wait` and `SyncLangGraphClient.wait`, letting callers suppress exception raising and inspect error objects directly. • Increases default read/write timeouts from 60 s to 300 s in `get_client` and `get_sync_client`, enabling reliable use with long-running graph operations. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.34 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.34 Fri, 25 Oct 2024 16:30:15 GMT LangGraph SDK 0.1.34 adds `if_not_exists` parameter and new `"error"` thread status for safer run handling. • Adds `if_not_exists` parameter to `stream`, `create`, and `wait` client methods, letting callers auto-create a missing thread (`"create"`) or reject the operation (`"reject"`) instead of always raising. • Adds `"error"` as a valid `ThreadStatus` value, surfacing when an exception occurred during task processing. • Widens type annotations for `stream_mode`, `interrupt_before`, `interrupt_after`, and `feedback_keys` from `list` to `Sequence`, accepting tuples and other sequences without casting. https://github.com/langchain-ai/langgraph/releases/tag/0.2.39 https://github.com/langchain-ai/langgraph/releases/tag/0.2.39 Fri, 18 Oct 2024 18:55:25 GMT LangGraph 0.2.39 adds TAG_NOSTREAM constant, structured error codes, and finer streaming control. • New `TAG_NOSTREAM` constant in `langgraph.constants` lets you tag chat models to suppress their output from the stream. • New `ErrorCode` enum in `langgraph.errors` provides standardized codes (`GRAPH_RECURSION_LIMIT`, `INVALID_CONCURRENT_GRAPH_UPDATE`, `INVALID_GRAPH_NODE_RETURN_VALUE`, `MULTIPLE_SUBGRAPHS`) for programmatic error handling. • New `create_error_message` helper in `langgraph.errors` generates consistent error messages with links to troubleshooting documentation. • `StreamMessagesHandler` now respects `TAG_NOSTREAM` on chat model starts and `TAG_HIDDEN` on chain starts for fine-grained control over what gets streamed. https://github.com/langchain-ai/langgraph/releases/tag/0.2.37 https://github.com/langchain-ai/langgraph/releases/tag/0.2.37 Tue, 15 Oct 2024 00:40:09 GMT LangGraph 0.2.37 adds RemainingSteps managed value and LoopProtocol for finer-grained loop termination control. • Adds `RemainingSteps` managed value to expose the number of remaining steps during loop execution, usable alongside `IsLastStep` for precise loop control. • Introduces `LoopProtocol` interface, giving managed values and channels structured access to loop execution context (config, store, stream, step, stop). • Improves checkpointing in nested loops with proper parent configuration propagation via updated `patch_checkpoint_map`. Breaking changes: • The `ManagedValue.__call__` signature no longer accepts a `step` parameter; callers that passed `step` explicitly will break. https://github.com/langchain-ai/langgraph/releases/tag/0.2.36 https://github.com/langchain-ai/langgraph/releases/tag/0.2.36 Mon, 14 Oct 2024 19:46:17 GMT LangGraph 0.2.36 adds RemoteGraph for interacting with hosted LangGraph deployments via the LangGraph API. • New `RemoteGraph` class enables invoking, streaming, and inspecting state on remote LangGraph deployments through the LangGraph API. • New `PregelProtocol` defines a standard interface for interacting with graphs, providing both sync and async methods for state management, visualization, subgraph traversal, and execution. • Adds a `result` field to `PregelTask` to store and access structured task execution results in state snapshots. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.33 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.33 Mon, 14 Oct 2024 19:38:42 GMT LangGraph SDK 0.1.33 adds wildcard node interrupts, custom stream mode, and richer update_state returns. • Supports passing `"*"` to `interrupt_before`/`interrupt_after` parameters in `RunsClient` and `CronClient` to interrupt all nodes without listing them individually. • Adds `"custom"` option to `StreamMode`, giving more flexibility in how streams are handled. • `update_state` now returns a `ThreadUpdateStateResponse` containing checkpoint information instead of `None`. • Expands `update_state` `values` parameter to accept `Sequence[dict]` in addition to a single `dict`, enabling multi-dictionary state updates. Breaking changes: • `update_state` on `ThreadsClient` and `SyncThreadsClient` now returns `ThreadUpdateStateResponse` instead of `None` — code that assumes a `None` return (e.g., ignores or asserts on the return value) will behave differently. https://github.com/langchain-ai/langgraph/releases/tag/0.2.35 https://github.com/langchain-ai/langgraph/releases/tag/0.2.35 Wed, 09 Oct 2024 13:36:25 GMT LangGraph 0.2.35 adds cross-thread memory for agents and a new `find_subgraph_pregel` utility for nested graph introspection. • Adds cross-thread memory support in agent executors, enabling agents to retain information across separate conversation threads. • Introduces `find_subgraph_pregel` utility to recursively locate Pregel subgraphs within runnable components — useful for checkpoint handling and graph introspection. • Enhances `map_debug_checkpoint` to include task state information and properly maintain checkpoint namespaces for nested subgraph debugging. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.1 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==2.0.1 Tue, 08 Oct 2024 07:04:51 GMT AsyncPostgresStore now inherits from AsyncBatchedBaseStore, enabling efficient batched async operations. • Enables batched async operations in `AsyncPostgresStore` via `AsyncBatchedBaseStore` inheritance, reducing round-trips for high-throughput workloads. • Adds explicit `ORDER BY updated_at DESC` to search queries in `PostgresStore`, providing consistent, deterministic result ordering. Breaking changes: • `BasePostgresStore` is no longer a direct subclass of `BaseStore`; code that relied on that inheritance chain (e.g., isinstance checks or super() calls through `BasePostgresStore`) will break. • `_deserializer` is now a class attribute on `BasePostgresStore` rather than an instance attribute set in `__init__`; subclasses that override or reference `self._deserializer` set during `__init__` may behave differently. https://github.com/langchain-ai/langgraph/releases/tag/0.2.34 https://github.com/langchain-ai/langgraph/releases/tag/0.2.34 Wed, 02 Oct 2024 21:49:26 GMT LangGraph 0.2.34 adds a `store` parameter to `create_react_agent` for cross-thread persistence. • Adds `store` parameter to `create_react_agent`, enabling data persistence across multiple threads (e.g., different users or conversations) alongside the existing `checkpointer` parameter. • Adds a warning when `InjectedStore` annotation is used without `langchain-core >= 0.3.8`, surfacing the dependency requirement at runtime. https://github.com/langchain-ai/langgraph/releases/tag/0.2.33 https://github.com/langchain-ai/langgraph/releases/tag/0.2.33 Wed, 02 Oct 2024 17:50:57 GMT LangGraph 0.2.33 adds InjectedStore annotation so tools can read/write the LangGraph store without exposing it to the model. • Adds `InjectedStore` annotation to inject LangGraph store objects directly into tool arguments, hiding them from the tool-calling model (similar to `InjectedState`). • Enhances `ToolNode` to automatically detect and inject the store for tools annotated with `InjectedStore`, with precomputed caching of state and store arguments for efficiency. • Enables `RunnableCallable` keyword arguments to override config values in `invoke` and `ainvoke`, giving callers finer control over execution. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.32 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.32 Tue, 01 Oct 2024 08:21:41 GMT LangGraph SDK 0.1.32 adds a key-value Store API with namespaced put, get, delete, search, and list operations for both async and sync clients. • New `StoreClient` and `SyncStoreClient` classes provide async and sync key-value storage with `put_item`, `get_item`, `delete_item`, `search_items`, and `list_namespaces` methods. • Adds `store` property to `LangGraphClient` and `SyncLangGraphClient` for direct access to the new store API. • Exposes `get_sync_client` in module exports for easier access to the synchronous client. • New `Item`, `ListNamespaceResponse`, and `SearchItemsResponse` TypedDicts formalize storage operation schemas. • Adds `output_schema` field to the `GraphSchema` TypedDict. • `HttpClient` and `SyncHttpClient` now support JSON payloads in DELETE requests. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==1.0.11 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==1.0.11 Mon, 30 Sep 2024 23:45:49 GMT LangGraph Postgres store now accepts a custom `deserializer` parameter for user-controlled JSON loading. • Adds optional `deserializer` parameter to `PostgresStore` and `AsyncPostgresStore` (via `BasePostgresStore`), enabling custom JSON deserialization when loading values from the database. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==1.0.10 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==1.0.10 Mon, 30 Sep 2024 21:30:32 GMT langgraph-checkpoint-postgres 1.0.10 adds sync and async PostgreSQL store implementations with batch ops, namespace listing, and schema migration. • New `PostgresStore` class provides a synchronous PostgreSQL-backed store with `get`, `put`, `search`, and namespace-listing operations. • New `AsyncPostgresStore` class mirrors `PostgresStore` with full async/await support via asyncio for non-blocking database access. • Both stores expose a from_conn_string() context manager for ergonomic connection management. • Both stores include a setup() method to initialize the database schema and run migrations automatically. • Explicit `__all__` exports added to the postgres store modules for cleaner programmatic imports. https://github.com/langchain-ai/langgraph/releases/tag/0.2.29 https://github.com/langchain-ai/langgraph/releases/tag/0.2.29 Mon, 30 Sep 2024 17:51:03 GMT LangGraph 0.2.29 expands create_react_agent to accept any LanguageModelLike and adds custom store support via configuration. • Expands `create_react_agent` to accept `LanguageModelLike` instead of only `BaseChatModel`, enabling use with a broader range of model types. • Adds support for custom stores via configuration in `Pregel`, with store parameter propagation through the execution stack. • Migrates store implementation to langgraph-checkpoint, updating namespace representation from strings to tuples and switching methods from `list/put` to `search/batch`. Breaking changes: • The store namespace representation in `SharedValue` changed from strings to tuples; any code relying on string namespaces will need to be updated. • Store method calls changed from `list/put` to `search/batch`; code calling the old store methods directly will break. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.13 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.13 Mon, 30 Sep 2024 17:48:04 GMT LangGraph Checkpoint 1.0.13 introduces a namespaced key-value store API with sync/async ops and an in-memory implementation. • Adds `BaseStore` abstract base class with sync and async CRUD operations (`get`/`aget`, `put`/`aput`, `delete`/`adelete`, `search`/`asearch`, `list_namespaces`/`alist_namespaces`, `batch`/`abatch`) for persistent, namespaced key-value storage. • Introduces `Item` as the core storage unit, carrying value data, key, namespace path, and timestamp metadata with equality comparison and dict conversion support. • Ships `InMemoryStore`, a fully-featured in-memory `BaseStore` implementation backed by Python dicts for prototyping and testing without external dependencies. • Adds `AsyncBatchedBaseStore`, which automatically coalesces async store operations into batches via a background task for higher throughput. • Extends `JsonPlusSerializer` to serialize `Item` objects, enabling store items to round-trip correctly through checkpoint persistence. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.12 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.12 Fri, 27 Sep 2024 18:29:29 GMT LangGraph checkpoint 1.0.12 adds secret-value serialization support in JsonPlusSerializer. • Supports serializing objects that implement get_secret_value() in `JsonPlusSerializer`, enabling proper handling of secure/secret values during checkpoint serialization and deserialization. https://github.com/langchain-ai/langgraph/releases/tag/0.2.27 https://github.com/langchain-ai/langgraph/releases/tag/0.2.27 Tue, 24 Sep 2024 17:49:10 GMT LangGraph 0.2.27 adds namespace filtering to subgraph traversal and broadens BaseStore value types. • Adds optional `namespace` parameter to `get_subgraphs` and `aget_subgraphs` for filtering subgraphs by name, improving performance in nested-subgraph graphs. • Automatically excludes subgraphs with checkpointing disabled (`checkpointer is False`) from subgraph enumeration. • Broadens `BaseStore` value type (`V`) from `dict[str, Any]` to `Any`, enabling storage of arbitrary value types. https://github.com/langchain-ai/langgraph/releases/tag/0.2.25 https://github.com/langchain-ai/langgraph/releases/tag/0.2.25 Mon, 23 Sep 2024 21:38:21 GMT LangGraph's ToolNode now supports multimodal tool responses, letting tools return images and structured data alongside text. • Enhances `ToolNode` to handle multimodal content in tool responses, preserving image, image_url, text, and json content blocks instead of converting everything to strings. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.31 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.31 Mon, 23 Sep 2024 19:20:35 GMT LangGraph SDK 0.1.31 adds assistant versioning, subgraph streaming, future run scheduling, and a richer Checkpoint type. • Adds `name` parameter to assistant `create` and `update` methods for human-readable assistant identification. • Adds `get_versions` method to retrieve the full version history of an assistant. • Adds `set_latest` method to promote a specific assistant version to active. • Adds `subgraphs` parameter to `get_state` to include subgraph state in thread state responses. • Adds `stream_subgraphs` parameter to run methods to stream outputs from subgraphs. • Adds `after_seconds` parameter to schedule runs for future execution. • Introduces new `Checkpoint` type for richer checkpoint representation across thread and run APIs. • Adds `AssistantVersion` class and `ThreadTask` model to the schema for version history and per-thread task tracking. Breaking changes: • The `patch_state` method has been removed from the Thread client in favor of updated state management via `update_state`. • The `config` field in thread state responses has been replaced by `checkpoint` (using the new `Checkpoint` type). • The `checkpoint_id` parameter is deprecated in `get_state` and run methods; the replacement is the new `checkpoint` parameter. https://github.com/langchain-ai/langgraph/releases/tag/0.2.24 https://github.com/langchain-ai/langgraph/releases/tag/0.2.24 Mon, 23 Sep 2024 15:34:10 GMT LangGraph 0.2.24 adds a new `langgraph.types` module and error detection for multiple subgraphs inside a single node. • Introduces `langgraph.types` module as the new canonical home for core data types including `Send` and `Interrupt`. • Adds `MultipleSubgraphsError` to detect and prevent multiple subgraphs from being invoked inside the same node. https://github.com/langchain-ai/langgraph/releases/tag/0.2.23 https://github.com/langchain-ai/langgraph/releases/tag/0.2.23 Fri, 20 Sep 2024 21:51:31 GMT LangGraph 0.2.23 adds token-by-token message streaming and custom node output streaming via two new stream modes. • Adds `stream_mode="messages"` to stream LLM output token-by-token in real time. • Adds `stream_mode="custom"` to emit arbitrary output from nodes via a `write` parameter. • Enhances `chat_agent_executor` with `route_tool_responses` to support tools configured with `return_direct`, bypassing the agent on return. • Introduces `AsyncQueue` and `SyncQueue` utilities for higher-performance concurrent streaming. Breaking changes: • In `chat_agent_executor`, `should_continue` now returns `"tools"` instead of `"continue"` and `"__end__"` instead of `"end"` — code that matches on those string values will break. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.10 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.10 Mon, 16 Sep 2024 22:01:33 GMT LangGraph checkpoint 1.0.10 adds MessagePack serialization, scheduled-task tracking, and namedtuple support. • Adds MessagePack integration to `JsonPlusSerializer` as a faster alternative to JSON serialization, with pooled encoders for throughput. • Adds a `SCHEDULED` special channel constant (value `-2`) in `WRITES_IDX_MAP` on `BaseCheckpointSaver` to track scheduled task status in the checkpoint system. • Adds `get_next_version` method to `InMemorySaver` to generate consistent, unique version identifiers for channels. • Extends `JsonPlusSerializer` to serialize objects exposing _asdict() (e.g., namedtuples). https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==1.0.7 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==1.0.7 Mon, 16 Sep 2024 21:53:04 GMT LangGraph Postgres checkpointer gains custom serializer support and smarter SQL write strategies in v1.0.7 • Adds optional `serde` parameter to AsyncPostgresSaver.from_conn_string() for injecting custom serializers. • Introduces dynamic SQL query selection for checkpoint writes, choosing between upsert and insert-only operations based on channel types in both `PostgresSaver` and `AsyncPostgresSaver`. • Adds new `INSERT_CHECKPOINT_WRITES_SQL` constant enabling insert-only checkpoint write operations alongside the existing upsert path. https://github.com/langchain-ai/langgraph/releases/tag/0.2.22 https://github.com/langchain-ai/langgraph/releases/tag/0.2.22 Mon, 16 Sep 2024 20:51:51 GMT LangGraph 0.2.22 adds `create_model` Pydantic utility and improved subgraph retry resumption. • Adds `langgraph.utils.pydantic.create_model`, a new utility function that creates Pydantic models compatible with both older and newer versions of langchain-core, supporting normal field definitions and root models through a consistent interface. • Adds a deprecation warning when `StateGraph` is initialized without an explicit `state_schema` parameter, prompting users to supply one explicitly. https://github.com/langchain-ai/langgraph/releases/tag/0.2.20 https://github.com/langchain-ai/langgraph/releases/tag/0.2.20 Fri, 13 Sep 2024 14:45:43 GMT LangGraph 0.2.20 adds dataclass schema support, ToolNode naming, and reduced dependency on langchain-core for config handling. • Adds dataclass support in `get_field_default`, enabling field defaults (including default factories) to be retrieved from dataclass-based state schemas. • Adds a `name` attribute (default `"ToolNode"`) to `ToolNode` for better graph node identification. • Adds local `ensure_config`, `get_callback_manager_for_config`, and `get_async_callback_manager_for_config` in `langgraph.utils.config`, removing the dependency on `langchain-core` for config handling. • Adds `__slots__` to `BaseChannel` and all channel subclasses, reducing per-instance memory overhead at scale. Breaking changes: • The `from_checkpoint` API on all channel classes now returns instances directly instead of using a context manager pattern — code that used `with channel.from_checkpoint(...) as ch:` will break. https://github.com/langchain-ai/langgraph/releases/tag/0.2.19 https://github.com/langchain-ai/langgraph/releases/tag/0.2.19 Fri, 06 Sep 2024 17:47:30 GMT LangGraph 0.2.19 adds Pydantic BaseModel support to ToolNode and improves async/sync runner responsiveness. • Supports Pydantic `BaseModel` as an input type in `ToolNode`, alongside existing list and dict inputs, for stronger type safety in tool-calling graphs. • Enables `ToolNode` to detect nested tool injections inside `Union` and `Annotated` types. • Improves `ToolNode` state extraction to work with object attributes via `getattr`, enabling object-like states alongside dictionaries. • Yields control back to the caller immediately at the start of `PregelRunner.tick` and `atick`, improving responsiveness in async and sync applications. https://github.com/langchain-ai/langgraph/releases/tag/0.2.18 https://github.com/langchain-ai/langgraph/releases/tag/0.2.18 Fri, 06 Sep 2024 00:34:21 GMT LangGraph 0.2.18 adds scheduled-task tracking, a TaskNotFound exception, and a Pregel.copy() method for cleaner graph customization. • Adds `SCHEDULED` constant (`"__scheduled__"`) to represent scheduled tasks, included in the `RESERVED` set of special keys. • Introduces `TaskNotFound` exception for explicit error handling when the executor cannot locate a task. • Adds Pregel.copy(update) method to create modified Pregel instances without mutating the original graph. • Adds `path: tuple[str, ...]` field to `PregelExecutableTask` to track a task's execution path through the graph. • Adds `scheduled: bool` field to `PregelExecutableTask` to indicate whether a task has been scheduled. • Changes `prepare_next_tasks` to return a `dict[str, PregelExecutableTask]` keyed by task ID, enabling O(1) task lookup in execution loops. Breaking changes: • The `tasks` attribute of `PregelLoop` changed from `Sequence[PregelExecutableTask]` to `dict[str, PregelExecutableTask]`; code that iterates or indexes `tasks` as a list will break. • `prepare_next_tasks` now returns a `dict[str, PregelExecutableTask]` instead of a list; callers that treat the return value as a sequence will break. https://github.com/langchain-ai/langgraph/releases/tag/0.2.17 https://github.com/langchain-ai/langgraph/releases/tag/0.2.17 Thu, 05 Sep 2024 21:17:56 GMT LangGraph 0.2.17 adds Pydantic v2 support, a new `get_field_default` utility, and a new `SUBSCRIPTIONS` constant for channel management. • Adds Pydantic v2 support across the library while maintaining Pydantic v1 compatibility, including in `ValidationNode` which now selects the correct validation method (`model_validate`/`model_dump_json` for v2, `validate`/`json` for v1) automatically. • Adds new `get_field_default` utility in `langgraph.utils.fields` for reliably resolving default values for state schema fields, with improved handling of optional fields, `Required`/`NotRequired` annotations, and type hints. • Adds new `SUBSCRIPTIONS` constant to `langgraph.constants`, included in the `RESERVED` set for channel management. • Expands `langchain-core` dependency range to allow versions up to v0.4.x. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==1.0.6 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==1.0.6 Tue, 03 Sep 2024 01:12:14 GMT AsyncPostgresSaver gains synchronous wrapper methods for use in mixed sync/async contexts. • Adds synchronous list(), get_tuple(), put(), and put_writes() methods to `AsyncPostgresSaver`, backed by asyncio.run_coroutine_threadsafe(), enabling use from synchronous code without restructuring the async saver. • Stores the running event loop on `AsyncPostgresSaver` instances via `self.loop` to support the new synchronous dispatch methods. https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==1.0.2 https://github.com/langchain-ai/langgraph/releases/tag/checkpointsqlite==1.0.2 Tue, 03 Sep 2024 01:02:06 GMT AsyncSqliteSaver gains synchronous get_tuple, list, put, and put_writes methods for mixed async/sync use. • Adds synchronous `get_tuple`, `list`, and `put` methods to `AsyncSqliteSaver`, running async equivalents via `asyncio.run_coroutine_threadsafe` for mixed-context use. • Adds new synchronous `put_writes` method to `AsyncSqliteSaver`. https://github.com/langchain-ai/langgraph/releases/tag/0.2.16 https://github.com/langchain-ai/langgraph/releases/tag/0.2.16 Sun, 01 Sep 2024 19:22:06 GMT LangGraph 0.2.16 improves nested subgraph detection for accurate visualization of complex graph structures. • Enhances `get_graph` with pre-computed subgraph resolution when using the `xray` parameter, enabling accurate visualization of complex nested graph structures. • Expands `get_subgraphs` to discover nested Pregel instances inside `RunnableSequence` steps, `RunnableLambda` dependencies, and `RunnableCallable` function nonlocals. https://github.com/langchain-ai/langgraph/releases/tag/0.2.15 https://github.com/langchain-ai/langgraph/releases/tag/0.2.15 Fri, 30 Aug 2024 21:50:08 GMT create_react_agent now accepts a ToolNode instance directly, enabling reuse of tool configurations across agents. • Enables passing a `ToolNode` instance directly to `create_react_agent`, so existing tool configurations can be reused across multiple agents without duplication. • Supports connecting `StateGraph` edges directly to the `END` node without explicitly adding it first, making graph construction more concise. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.30 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.30 Fri, 30 Aug 2024 21:36:39 GMT LangGraph SDK 0.1.30 adds state-value filtering for thread search and makes runs.join() return final thread state. • Adds `values` parameter to client.threads.search() for filtering threads by their state values. • Changes client.runs.join() to return a dictionary containing the final thread state instead of `None`. • Introduces `Json` type as a replacement for the `Metadata` type to better reflect its semantic purpose. Breaking changes: • The `Metadata` type is renamed to `Json`; code importing or referencing `Metadata` will break. • client.runs.join() now returns a dictionary containing the final thread state instead of `None`; code that assumes a `None` return value will break. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.7 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.7 Fri, 30 Aug 2024 21:26:31 GMT LangGraph Checkpoint 1.0.7 adds parent checkpoint references and pending-send tracking across checkpoint operations. • Adds `parents` field to `CheckpointMetadata`, mapping checkpoint namespace to checkpoint ID for relationship tracking between checkpoints. • Adds pending-send tracking in `InMemorySaver`: `get_tuple` now includes `pending_sends` from parent checkpoints, and `list` gains improved namespace filtering. Breaking changes: • The `score` field in `CheckpointMetadata` is replaced by the `parents` field — any code reading or writing `score` will break. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.52 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.52 Wed, 28 Aug 2024 16:22:58 GMT LangGraph CLI 0.1.52 adds Node.js/LangGraphJS deployment support with dedicated Docker configuration. • Adds `node_version` field to the LangGraph config TypedDict, enabling Node.js (LangGraphJS) project deployments alongside existing Python support. • Adds `node_config_to_docker` function to generate Docker configurations for Node.js projects, automatically selecting the `langchain/langgraphjs-api` base image. • Adds validation for the `node_version` config field (currently enforces version `"20"`) to catch misconfigured Node.js projects early. • Updates `build`, `prepare`, and deployment CLI commands to operate correctly against both Python and Node.js environments. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==1.0.4 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==1.0.4 Tue, 27 Aug 2024 15:38:13 GMT LangGraph Postgres checkpointer now accepts connection pools for high-concurrency deployments. • Adds `ConnectionPool` support to `PostgresSaver`, enabling psycopg connection pool usage alongside direct connections for high-concurrency scenarios. • Adds `AsyncConnectionPool` support to `AsyncPostgresSaver` for async workflows requiring pooled database connections. • Enhances list() and alist() methods to include pending writes in returned checkpoint tuples. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.29 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.29 Mon, 26 Aug 2024 22:30:53 GMT LangGraph SDK 0.1.29 adds disconnect/completion lifecycle controls and a new join_stream() method for live run output. • Adds `on_disconnect` parameter to stream() and wait() — set to `"cancel"` or `"continue"` to control what happens to a run when the client disconnects. • Adds `on_completion` parameter to stream(), create(), and wait() — set to `"delete"` or `"keep"` to control resource cleanup after a run finishes. • Adds join_stream() method to attach to an already-running run and receive its real-time output without buffering prior output. • Adds `DisconnectMode` and `OnCompletionBehavior` types for structured lifecycle control in typed clients. https://github.com/langchain-ai/langgraph/releases/tag/0.2.13 https://github.com/langchain-ai/langgraph/releases/tag/0.2.13 Fri, 23 Aug 2024 20:42:00 GMT LangGraph 0.2.13 adds runtime-only managed values and reimplements Context to skip unnecessary serialization. • Adds a `runtime` flag to `ManagedValue` that marks values as created at runtime and excluded from serialization/deserialization. • Adds `replace_runtime_values` and `replace_runtime_placeholders` methods to `ManagedValueMapping` for safe handling of runtime placeholders during graph serialization. • Reimplements `Context` as a managed value (`langgraph.managed.context.ContextManagedValue`) with `runtime=True`, integrating it with the managed value system instead of the channel system. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.51 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.51 Thu, 22 Aug 2024 22:40:22 GMT LangGraph CLI 0.1.51 adds Redis 6 to Docker Compose for caching and message queuing. • Adds Redis 6 as a managed Docker Compose service with health-check gating, so langgraph-api only starts after Redis is healthy. • Injects `REDIS_URI` environment variable (`redis://langgraph-redis:6379`) automatically into the langgraph-api service. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.4 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.4 Thu, 22 Aug 2024 19:49:02 GMT LangGraph Checkpoint 1.0.4 adds error-write support, an ERROR constant, and exception serialization in JsonPlusSerializer. • Adds `ERROR = "__error__"` constant in `langgraph.checkpoint.serde.types` to represent error types in checkpoint writes. • Supports special write types including error handling via `WRITES_IDX_MAP` in `InMemorySaver.put_writes`. • Enables `JsonPlusSerializer` to serialize `BaseException` objects by encoding them using their constructor arguments. • Includes pending writes in checkpoint list output from `InMemorySaver`. Breaking changes: • The `current_tasks` field is removed from the `Checkpoint` TypedDict; any code reading or writing `checkpoint["current_tasks"]` will break. • `empty_checkpoint`, `copy_checkpoint`, and `create_checkpoint` no longer include `current_tasks` in their returned dictionaries. https://github.com/langchain-ai/langgraph/releases/tag/0.2.10 https://github.com/langchain-ai/langgraph/releases/tag/0.2.10 Wed, 21 Aug 2024 23:40:40 GMT LangGraph 0.2.10 adds error and interrupt fields to debug task result payloads for richer execution tracing. • Adds `error: Optional[str]` and `interrupts: list[dict]` fields to `TaskResultPayload` for capturing task-level errors and interrupts in debug output. • Enhances `put_writes` on `PregelLoop` to automatically stream updates and debug information without manual wiring. • Adds `stream_keys` as a class attribute on `PregelLoop` for explicit management of streaming outputs. • Updates `map_debug_task_results` to accept task-writes pairs and support both string and sequence stream key formats. Breaking changes: • The `map_debug_task_results` function signature now accepts task-writes pairs instead of just tasks — callers passing tasks alone will break. • The `tick` method on `PregelLoop` has had parameters removed — code passing those now-removed parameters will break. • The `SyncPregelLoop` and `AsyncPregelLoop` constructor signatures have changed to support the new streaming architecture — existing instantiation code may break. • `map_output_updates` now expects the new task-writes tuple format — callers using the old format will break. • ERROR and INTERRUPT keys are now filtered out of regular output streams by `map_output_updates` — code relying on seeing those keys in regular output will no longer receive them. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.28 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.28 Wed, 21 Aug 2024 21:17:49 GMT LangGraph SDK 0.1.28 adds custom HTTP headers support and checkpoint namespace field for state configs. • Adds a `headers` parameter to `get_client` for injecting custom HTTP headers into all API requests, with validation blocking reserved headers like `x-api-key`. • Adds a `checkpoint_ns` field to state configurations in `get_state` and `create` for namespace-scoped checkpoint lookups. Breaking changes: • The `thread_ts` field is renamed to `checkpoint_id` in state configurations for `LangGraphClient.get_state` and `LangGraphClient.create` — any code referencing `thread_ts` will break. https://github.com/langchain-ai/langgraph/releases/tag/0.2.7 https://github.com/langchain-ai/langgraph/releases/tag/0.2.7 Wed, 21 Aug 2024 18:39:59 GMT LangGraph 0.2.7 adds SharedValue and a pluggable store system for persisting state across graph nodes. • New `SharedValue` class enables shared, writable state across graph nodes with optional scoping by configuration. • New `WritableManagedValue` abstract class extends the managed values system with update() and aupdate() methods for sync/async mutations. • New `store` parameter on StateGraph.compile() wires a persistent storage backend into the graph. • New `BaseStore` abstract class defines a standard interface (list/update, sync and async) for pluggable storage engines. • New `MemoryStore` provides a ready-to-use in-memory implementation of `BaseStore`. • New `AsyncBatchedStore` wraps any `BaseStore` to batch async operations for higher-throughput workloads. • New utility functions `is_readonly_managed_value` and `is_writable_managed_value` allow runtime inspection of managed value types. • New `ChannelKeyPlaceholder` and `ChannelTypePlaceholder` objects support dynamic injection of channel key and type metadata. https://github.com/langchain-ai/langgraph/releases/tag/0.2.6 https://github.com/langchain-ai/langgraph/releases/tag/0.2.6 Wed, 21 Aug 2024 16:28:34 GMT LangGraph 0.2.6 adds structured graph interrupts with timing context and a new NodeInterrupt exception for in-node signaling. • New `Interrupt` dataclass captures structured interruption events with a `when` field (`"before"`, `"during"`, `"after"`) and an optional `value`. • New `NodeInterrupt` exception lets node logic explicitly signal a mid-execution interrupt without raising a generic error. • Enhanced `GraphInterrupt` now stores a list of `Interrupt` objects, giving full context on when and how many interrupts occurred. • Adds `interrupts` field to `PregelTask` for per-task interrupt visibility useful in debugging and flow control. • Adds `CONFIG_KEY_TASK_ID` constant to track task identifiers through the configuration system. • `should_interrupt` now returns the list of executable tasks to be interrupted instead of a boolean, enabling precise per-task interrupt control. Breaking changes: • `langgraph.pregel.algo.should_interrupt` return type changed from `bool` to a list of executable tasks — any code that checks the return value as a boolean will behave incorrectly. https://github.com/langchain-ai/langgraph/releases/tag/0.2.5 https://github.com/langchain-ai/langgraph/releases/tag/0.2.5 Wed, 21 Aug 2024 00:07:12 GMT LangGraph 0.2.5 adds task-level error tracking in state snapshots and a new ERROR constant for consistent failure visibility. • Adds `ERROR = "__error__"` constant (reserved key) for consistent error tracking and propagation across graph execution. • Enhances `StateSnapshot` with a new `tasks` field that surfaces task-level error details in state history. • Introduces enhanced `PregelTask` class with `id` and optional `error` fields to uniquely identify tasks and capture exceptions. • Adds `tasks_w_writes` debug function to associate tasks with their writes and any errors for richer checkpoint debug output. • Extends `get_state` / `aget_state` on `Pregel` to include proper step numbers and task error information in returned snapshots. Breaking changes: • The `__call__` method of `ManagedValue` has its signature changed from __call__(self, step: int, task: PregelTaskDescription) to __call__(self, step: int) — any custom `ManagedValue` subclass that accepts a `task` parameter will break. • The `__call__` method of `IsLastStepManager` has its signature changed from __call__(self, step: int, task: PregelExecutableTask) to __call__(self, step: int) — any code calling this with a `task` argument will break. • `PregelTaskDescription` is replaced by the new `PregelTask` class — code that references or type-hints `PregelTaskDescription` directly will break. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.3 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.3 Thu, 15 Aug 2024 17:23:48 GMT JsonPlusSerializer gains native support for pathlib, regex, decimal, deque, IP address, and time types. • Supports serialization of `pathlib.Path`, `re.Pattern`, `decimal.Decimal`, `deque`, IPv4/IPv6 address types, `date`, `time`, and `ZoneInfo` in `JsonPlusSerializer`. • Deserialization now returns `None` gracefully when a module or attribute is missing, instead of raising an exception. https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==1.0.1 https://github.com/langchain-ai/langgraph/releases/tag/checkpointpostgres==1.0.1 Wed, 07 Aug 2024 19:18:42 GMT LangGraph PostgreSQL checkpointer gains versioned schema migrations and JSON+Plus metadata serialization. • Adds versioned database migrations (`MIGRATIONS` list) for both `PostgresSaver` and `AsyncPostgresSaver`, replacing one-shot static table creation. • Introduces `JsonPlusSerializer`-backed `_load_metadata` and `_dump_metadata` methods for consistent, richer metadata serialization across sync and async savers. Breaking changes: • The `is_setup` flag has been removed from `PostgresSaver` and `AsyncPostgresSaver` in favor of the new versioned setup method; any code that reads or sets `is_setup` will break. https://github.com/langchain-ai/langgraph/releases/tag/0.2.0 https://github.com/langchain-ai/langgraph/releases/tag/0.2.0 Wed, 07 Aug 2024 03:34:20 GMT LangGraph 0.2 ships dedicated checkpointer libraries for SQLite and Postgres, including the previously cloud-only PostgresSaver. • New `langgraph-checkpoint` package exposes `BaseCheckpointSaver`, `SerializationProtocol`, and `MemorySaver` as a standalone base library. • New `langgraph-checkpoint-sqlite` package provides `SqliteSaver` / `AsyncSqliteSaver` for local and experimental workflows. • New `langgraph-checkpoint-postgres` package open-sources the production-grade `PostgresSaver` previously available only in LangGraph Cloud. • New `new_versions` parameter in `BaseCheckpointSaver.put` enables further optimization of custom checkpointer implementations. • Graph stream output now includes outputs from all nodes, including nodes that return no state writes (previously silent nodes were omitted). Breaking changes: • `thread_ts` and `parent_ts` are renamed to `checkpoint_id` and `parent_checkpoint_id` respectively (via `langgraph_checkpoint==1.0.0`). • Re-exported imports like `from langgraph.checkpoint import BaseCheckpointSaver` no longer work; use `from langgraph.checkpoint.base import BaseCheckpointSaver` instead. • SQLite checkpointers have been moved to a separate library — `pip install langgraph-checkpoint-sqlite` is now required to use them. • The `.from_conn_string` method of `SqliteSaver` / `AsyncSqliteSaver` is now a context manager. • Graph stream output now emits `{'node_1': None}` for nodes that return no state writes, changing the shape of streamed output for graphs with such nodes. https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.1 https://github.com/langchain-ai/langgraph/releases/tag/checkpoint==1.0.1 Wed, 07 Aug 2024 02:41:46 GMT LangGraph checkpoint 1.0.1 adds binary serialization, channel-version API, and context-manager support for MemorySaver. • Adds `bytes` and `bytearray` serialization support to `JsonPlusSerializer`, enabling binary data in checkpointed state. • Introduces `ChannelVersions` type alias (`dict[str, Union[str, int, float]]`) for type-safe channel version handling. • Extends `BaseCheckpointSaver.put` and `aput` with a new `new_versions: ChannelVersions` parameter exposing channel version info at write time. • Implements sync and async context manager interfaces (`__enter__`/`__exit__`/`__aenter__`/`__aexit__`) on `MemorySaver` for explicit resource management. Breaking changes: • The `put` and `aput` methods on `BaseCheckpointSaver` (and `MemorySaver`) now require a `new_versions: ChannelVersions` parameter — any custom subclass that overrides these methods without the new parameter will break. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.27 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.27 Sat, 03 Aug 2024 18:50:18 GMT LangGraph SDK 0.1.27 adds optional URL client init, ASGI transport support, thread copy, and assistant if_exists dedup control. • Makes the `url` parameter optional in `get_client`, with intelligent defaults so local dev requires no explicit URL. • Adds ASGI transport support in `get_client` with correct root path configuration. • Adds `if_exists` parameter to `AssistantsAPI.create` for controlling behavior on duplicate assistant creation. • Adds a new `ThreadsAPI.copy` method for duplicating existing threads. • Makes `GraphSchema` fields (`input_schema`, `state_schema`, `config_schema`) optional for better TypeScript interoperability. https://github.com/langchain-ai/langgraph/releases/tag/0.1.17 https://github.com/langchain-ai/langgraph/releases/tag/0.1.17 Wed, 31 Jul 2024 01:35:50 GMT LangGraph 0.1.17 lets update_state() accept `None` values to preserve configuration without changing state. • Supports `None` as a valid `values` argument in Pregel.update_state(), enabling configuration-only state updates that leave channel values unchanged. https://github.com/langchain-ai/langgraph/releases/tag/0.1.10 https://github.com/langchain-ai/langgraph/releases/tag/0.1.10 Tue, 23 Jul 2024 18:22:00 GMT LangGraph 0.1.10 adds InjectedState for automatic graph-state injection into tools and improves parallel tool execution in ToolNode. • Adds `InjectedState` annotation to automatically inject graph state into tool arguments inside `ToolNode`, so tools can access state fields without the model generating them. • Improves parallel execution of tools in `ToolNode` using config lists via `get_config_list` from langchain-core. • Adds `GraphInterrupt` error class for structured handling of interruptions in nested graphs. • Adds `EmptyInputError` error class for clearer reporting when graphs receive empty inputs. • Enhances checkpoint parent-child relationship tracking and includes parent configuration data in checkpoint tuples, improving support for nested graphs. https://github.com/langchain-ai/langgraph/releases/tag/0.1.9 https://github.com/langchain-ai/langgraph/releases/tag/0.1.9 Thu, 18 Jul 2024 17:33:25 GMT LangGraph 0.1.9 adds `state_modifier` to `create_react_agent`, custom state schemas, retry policies, and new background executor classes. • Adds `state_modifier` parameter to `create_react_agent` for finer control over LLM inputs, replacing the now-deprecated `messages_modifier`. • Adds `state_schema` parameter to `create_react_agent`, enabling custom graph state definitions beyond the default `AgentState`. • Adds `BackgroundExecutor` and `AsyncBackgroundExecutor` classes in `langgraph.pregel` for structured background task management and cancellation. • Adds retry policies for nodes in `StateGraph`. • Adds custom input and output type support to `StateGraph`. • Adds equality comparison (`__eq__`) to all channel classes (`AnyValue`, `LastValue`, `Topic`, and others), enabling channel state comparisons. • Improves graph visualization to include type-hint hints for conditional edges and to create END nodes only when needed. • Adds node-existence validation in `update_state`, surfacing clear errors when a nonexistent node is targeted. Breaking changes: • The `messages_modifier` parameter of `create_react_agent` is deprecated; migrate to `state_modifier`. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.49 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.49 Thu, 18 Jul 2024 17:06:35 GMT LangGraph CLI 0.1.49 adds a `dockerfile` command to generate customized Dockerfiles for the LangGraph API server. • New `dockerfile` CLI command generates a Dockerfile for the LangGraph API server, accepting a save path and configuration file for customization. • Docker image generation now sets `PYTHONDONTWRITEBYTECODE=1` and passes `--no-cache-dir` to pip installs, producing smaller images. https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.26 https://github.com/langchain-ai/langgraph/releases/tag/sdk==0.1.26 Mon, 15 Jul 2024 17:47:53 GMT LangGraph SDK 0.1.26 adds batch run creation, cron job scheduling, and thread conflict handling • New `RunCreate` TypedDict enables structured background run creation with fields for thread_id, assistant_id, input, metadata, and run configuration options. • New `create_batch` method on `LangGraphClient` submits multiple runs in a single API call for more efficient batch operations. • New `Cron` class and `search` method support scheduled job management, with filtering by assistant_id and thread_id and pagination. • New `OnConflictBehavior` type (`"raise"` or `"do_nothing"`) controls what happens when a thread is created that already exists, via the new `if_exists` parameter on `Threads.create`. https://github.com/langchain-ai/langgraph/releases/tag/0.1.8 https://github.com/langchain-ai/langgraph/releases/tag/0.1.8 Fri, 12 Jul 2024 00:08:56 GMT LangGraph 0.1.8 adds node-level metadata support via `add_node`'s new `metadata` parameter and the `NodeSpec` class. • Adds an optional `metadata` parameter to `Graph.add_node` to attach arbitrary metadata to graph nodes, surfaced through `NodeSpec` instances. • Introduces `langgraph.graph.graph.NodeSpec`, a new class that stores a runnable alongside optional metadata for a node. • Propagates node `metadata` through `PregelNode.__init__` into the node's configuration. • Exposes node metadata in graph visualizations via the updated `CompiledGraph.get_graph` method. https://github.com/langchain-ai/langgraph/releases/tag/0.1.7 https://github.com/langchain-ai/langgraph/releases/tag/0.1.7 Wed, 10 Jul 2024 21:49:22 GMT LangGraph 0.1.7 adds persistent task-write checkpointing via new `put_writes`/`aput_writes` methods, enabling resilient interrupted-workflow recovery. • Adds `put_writes` and `aput_writes` methods to `BaseCheckpointer` (implemented across `Memory`, `SQLite`, and `AioSQLite` checkpointers) for storing task-specific writes mid-execution. • Adds `pending_writes` field to `CheckpointTuple` to carry per-task write state that is restored when a checkpoint is reloaded. • Tasks with pre-loaded `pending_writes` are skipped on restart, avoiding redundant re-execution when resuming interrupted workflows. https://github.com/langchain-ai/langgraph/releases/tag/0.1.6 https://github.com/langchain-ai/langgraph/releases/tag/0.1.6 Tue, 09 Jul 2024 16:39:04 GMT LangGraph 0.1.6 adds `RemoveMessage` support for message deletion by ID and `handle_tool_errors` parameter in `ToolNode`. • Adds `handle_tool_errors` parameter (defaults to `True`) to `ToolNode` in `langgraph.prebuilt.tool_node`, returning a friendly error message instead of raising an exception when a tool fails, so agents can continue the conversation after tool errors. • Adds support for `RemoveMessage` from `langchain-core` in `langgraph.graph.message.add_messages`, enabling deletion of specific messages by ID from message graphs, with validation that raises an error if the target message ID does not exist. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.48 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.48 Tue, 09 Jul 2024 01:49:00 GMT LangGraph CLI 0.1.48 adds `--debugger-base-url` to point the debugger at a custom LangGraph API URL • Adds `--debugger-base-url` CLI option to specify a custom URL for the debugger to access the LangGraph API, overriding the default `http://127.0.0.1:[PORT]`; also sets `VITE_STUDIO_LOCAL_GRAPH_URL` in the debugger container when the option is used. • Makes Docker base image pulls verbose during build to provide better visibility into the build process. https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.45 https://github.com/langchain-ai/langgraph/releases/tag/cli==0.1.45 Thu, 27 Jun 2024 16:15:08 GMT LangGraph CLI 0.1.45 adds a `test` command to validate graphs locally before deploying to LangGraph Cloud. • Adds `langgraph test` subcommand to start a local test server that validates graph compatibility with the LangGraph API server before deploying to LangGraph Cloud. • Improves environment variable handling in `config.config_to_compose` to support both string (env file) and dictionary formats, with proper quoting of values in Docker Compose configuration. • Enhances watch functionality in `config.config_to_compose` for better dependency tracking during development. Breaking changes: • The `langgraph-api-path` option has been removed from CLI commands.