Changes since cli==0.4.16
Changes since cli==0.4.15
deploy list and deploy delete subcommands" (#7116)deploy list and deploy delete subcommands (#7106)Changes since 1.1.1
Changes since 1.1.0
Changes since sdk==0.3.10
Changes since 1.0.10
LangGraph 1.1 introduces version="v2" — a new opt-in streaming format that brings full type safety to stream(), astream(), invoke(), and ainvoke().
v1 (default, unchanged): stream() yields bare tuples like (stream_mode, data) or just data. invoke() returns a plain dict. Interrupts are mixed into the output dict under "__interrupt__".
v2 (opt-in): stream() yields strongly-typed StreamPart dicts with type, ns, data, and (for values) interrupts fields. invoke() returns a GraphOutput object with .value and .interrupts attributes. When your state schema is a Pydantic model or dataclass, outputs are automatically coerced to the correct type.
invoke() / ainvoke() with version="v2"from langgraph.types import GraphOutput
result = graph.invoke({"input": "hello"}, version="v2")
# result is a GraphOutput, not a dict
assert isinstance(result, GraphOutput)
result.value # your output — dict, Pydantic model, or dataclass
result.interrupts # tuple[Interrupt, ...], empty if none occurred
With a non-"values" stream mode, invoke(..., stream_mode="updates", version="v2") returns list[StreamPart] instead of list[tuple].
stream() / astream() with version="v2"for part in graph.stream({"input": "hello"}, version="v2"):
if part["type"] == "values":
part["data"] # OutputT — full state
part["interrupts"] # tuple[Interrupt, ...]
elif part["type"] == "updates":
part["data"] # dict[str, Any]
elif part["type"] == "messages":
part["data"] # tuple[BaseMessage, dict]
elif part["type"] == "custom":
part["data"] # Any
elif part["type"] == "tasks":
part["data"] # TaskPayload | TaskResultPayload
elif part["type"] == "debug":
part["data"] # DebugPayload
Each stream mode has its own TypedDict — ValuesStreamPart, UpdatesStreamPart, MessagesStreamPart, CustomStreamPart, CheckpointStreamPart, TasksStreamPart, DebugStreamPart — all importable from langgraph.types. The union type StreamPart is a discriminated union on part["type"], enabling full type narrowing in editors and type checkers.
When your graph's state schema is a Pydantic model or dataclass, version="v2" automatically coerces outputs to the declared type:
from pydantic import BaseModel
class MyState(BaseModel):
answer: str
count: int
graph = StateGraph(MyState)
# ... build graph ...
compiled = graph.compile()
result = compiled.invoke({"answer": "", "count": 0}, version="v2")
assert isinstance(result.value, MyState) # not a dict!
version="v1" — existing code works without changes.GraphOutput supports old-style best-effort access to graph values and interrupts. Dict-style access (result["key"], "key" in result, result["__interrupt__"]) still works and delegates to result.value / result.interrupts under the hood. However, this is deprecated and emits a LangGraphDeprecatedSinceV11 warning. It will be removed in v3.0 — migrate to result.value and result.interrupts at your convenience.result = graph.invoke({"input": "hello"}, version="v2")
# Old style — still works, but deprecated
result["input"] # delegates to result.value["input"]
result["__interrupt__"] # delegates to result.interrupts
"input" in result # delegates to "input" in result.value
# New style — preferred
result.value["input"]
result.interrupts
version="v1" remains the default. All existing code continues to work.version="v2" to individual invoke()/stream() calls to get typed outputs.GraphOutput, StreamPart, and individual part types from langgraph.types for type-safe code.Changes since cli==0.4.14
Changes since sdk==0.3.9
Changes since cli==0.4.12
make type target for type checking (#6748)Changes since checkpoint==4.0.1rc3
Changes since 1.0.10rc1
Changes since checkpoint==4.0.1rc2
Changes since checkpoint==4.0.1rc1
Changes since checkpoint==4.0.0
make type target for type checking (#6748)thread_id (#6515)uv lock --upgrade (#6671)Changes since 1.0.9
make type target for type checking (#6748)Changes since sdk==0.3.8
make type target for type checking (#6748)Changes since sdk==0.3.7
Changes since 1.0.8
Changes since prebuilt==1.0.7
create_react_agent (#6760)Runtime and ToolRuntime class descriptions for clarity (#6689)Changes since sdk==0.3.6