langgraph-sdk 0.4.4__tar.gz → 0.4.6__tar.gz

{langgraph_sdk-0.4.4 → langgraph_sdk-0.4.6}/.gitignore

@@ -76,6 +76,7 @@ __pypackages__/
 
 # Environments
 .env
+.env.*
 .envrc
 *.crt
 *.key

{langgraph_sdk-0.4.4 → langgraph_sdk-0.4.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: langgraph-sdk
-Version: 0.4.4
+Version: 0.4.6
 Summary: SDK for interacting with LangGraph API
 Project-URL: Source, https://github.com/langchain-ai/langgraph/tree/main/libs/sdk-py
 Project-URL: Twitter, https://x.com/langchain_oss

{langgraph_sdk-0.4.4 → langgraph_sdk-0.4.6}/langgraph_sdk/__init__.py

@@ -3,7 +3,7 @@ from langgraph_sdk.client import get_client, get_sync_client
 from langgraph_sdk.encryption import Encryption
 from langgraph_sdk.encryption.types import DecryptResult, EncryptionContext
 
-__version__ = "0.4.4"
+__version__ = "0.4.6"
 
 __all__ = [
     "Auth",

{langgraph_sdk-0.4.4 → langgraph_sdk-0.4.6}/langgraph_sdk/_async/stream.py

@@ -24,6 +24,7 @@ from langchain_core.language_models.chat_model_stream import AsyncChatModelStrea
 from langchain_protocol import Event, SubscribeParams
 
 from langgraph_sdk._async.http import HttpClient
+from langgraph_sdk._shared.utilities import _quote_path_param
 from langgraph_sdk.schema import LangSmithTracing, QueryParamTypes
 from langgraph_sdk.stream.controller import _SeenEventIds
 from langgraph_sdk.stream.decoders import (
@@ -151,7 +152,7 @@ class _AgentModule:
             query_params.update(dict(params))
         request_headers = {**self._owner._headers, **dict(headers or {})}
         return await self._owner._http.get(
-            f"/assistants/{self._owner.assistant_id}/graph",
+            f"/assistants/{_quote_path_param(self._owner.assistant_id)}/graph",
             params=query_params,
             headers=request_headers or None,
         )
@@ -1902,7 +1903,7 @@ class AsyncThreadStream:
     async def _fetch_state(self) -> dict[str, Any]:
         """Fetch the current thread state from the REST endpoint."""
         return await self._http.get(
-            f"/threads/{self.thread_id}/state",
+            f"/threads/{_quote_path_param(self.thread_id)}/state",
             headers=self._headers or None,
         )
 

{langgraph_sdk-0.4.4 → langgraph_sdk-0.4.6}/langgraph_sdk/_sync/stream.py

@@ -22,6 +22,7 @@ from typing import Any, Literal, TypedDict, cast
 from langchain_core.language_models.chat_model_stream import ChatModelStream
 from langchain_protocol import Event, SubscribeParams
 
+from langgraph_sdk._shared.utilities import _quote_path_param
 from langgraph_sdk._sync.http import SyncHttpClient
 from langgraph_sdk.schema import LangSmithTracing, QueryParamTypes
 from langgraph_sdk.stream.decoders import (
@@ -194,7 +195,7 @@ class _SyncAgentModule:
             query_params.update(dict(params))
         request_headers = {**self._owner._headers, **dict(headers or {})}
         return self._owner._http.get(
-            f"/assistants/{self._owner.assistant_id}/graph",
+            f"/assistants/{_quote_path_param(self._owner.assistant_id)}/graph",
             params=query_params,
             headers=request_headers or None,
         )
@@ -1552,7 +1553,7 @@ class SyncThreadStream:
     def _fetch_state(self) -> dict[str, Any]:
         """Fetch the current thread state from the REST endpoint."""
         return self._http.get(
-            f"/threads/{self.thread_id}/state",
+            f"/threads/{_quote_path_param(self.thread_id)}/state",
             headers=self._headers or None,
         )
 

{langgraph_sdk-0.4.4 → langgraph_sdk-0.4.6}/langgraph_sdk/auth/__init__.py

@@ -312,7 +312,7 @@ class _ActionHandler(typing.Protocol[V]):
     ) -> types.HandlerResult: ...
 
 
-T = typing.TypeVar("T", covariant=True)
+T = typing.TypeVar("T")
 
 
 class _ResourceActionOn(typing.Generic[T]):

{langgraph_sdk-0.4.4 → langgraph_sdk-0.4.6}/langgraph_sdk/schema.py

@@ -295,6 +295,8 @@ class Interrupt(TypedDict):
     """The value associated with the interrupt."""
     id: str
     """The ID of the interrupt. Can be used to resume the interrupt."""
+    response_schema: NotRequired[dict[str, Any]]
+    """JSON Schema for the value expected when resuming this interrupt, if the graph provided one."""
 
 
 class Thread(TypedDict):

{langgraph_sdk-0.4.4 → langgraph_sdk-0.4.6}/pyproject.toml

@@ -36,7 +36,7 @@ test = [
     "pytest-watch",
 ]
 lint = [
-    "ruff==0.16.1",
+    "ruff==0.16.9",
     "codespell",
     "ty",
     "starlette",

{langgraph_sdk-0.4.4 → langgraph_sdk-0.4.6}/tests/streaming/test_sync_extensions_projection.py

@@ -29,7 +29,10 @@ def test_sync_extension_projection_yields_matching_custom_payloads():
         {"name": "progress", "step": 1},
         {"name": "progress", "step": 2},
     ]
-    assert "custom:progress" in fake.stream_request_bodies[-1]["channels"]
+    assert any(
+        "custom:progress" in body.get("channels", [])
+        for body in fake.stream_request_bodies
+    )
 
 
 def test_sync_extension_projection_supports_namespace_scope_on_subgraph_handle():

{langgraph_sdk-0.4.4 → langgraph_sdk-0.4.6}/tests/streaming/test_sync_thread_stream.py

@@ -590,10 +590,10 @@ def test_v3_streaming_sync_surface_smoke():
     assert results["values"] == fake.state["values"]
     messages_result = results["messages"]
     assert isinstance(messages_result, list)
-    assert [str(m.text) for m in messages_result] == ["hi"]  # ty: ignore[unresolved-attribute]
+    assert [str(m.text) for m in messages_result] == ["hi"]
     tools_result = results["tools"]
     assert isinstance(tools_result, list)
-    assert tools_result[0].name == "search"  # ty: ignore[unresolved-attribute]
+    assert tools_result[0].name == "search"
     assert results["progress"] == [{"name": "progress", "step": 1}]
     assert final == {"final": True}
 

langgraph_sdk-0.4.6/tests/streaming/test_thread_stream_path_encoding.py

@@ -0,0 +1,92 @@
+"""Thread stream REST helpers must percent-encode `thread_id` and `assistant_id`
+so a value containing reserved characters or dot-segments stays an opaque path
+segment instead of being normalized into a different path by the HTTP stack.
+
+Each test drives a public entry point (`threads.stream(...)` followed by
+`thread.output` or `thread.agent.get_tree()`) with an identifier containing
+`..`, `/`, and `#`, and asserts the request path keeps it as one segment.
+"""
+
+from __future__ import annotations
+
+import httpx
+
+from langgraph_sdk._async.http import HttpClient
+from langgraph_sdk._async.threads import ThreadsClient
+from langgraph_sdk._sync.http import SyncHttpClient
+from langgraph_sdk._sync.threads import SyncThreadsClient
+
+# Interpolated raw, httpx would collapse the `..` segments and treat `#` as a
+# fragment, producing `/assistants/a/graph` and `/other/path`.
+THREAD_ID = "../assistants/a/graph#"
+ASSISTANT_ID = "../../other/path#"
+ENCODED_STATE_PATH = "/threads/..%2Fassistants%2Fa%2Fgraph%23/state"
+ENCODED_GRAPH_PATH = "/assistants/..%2F..%2Fother%2Fpath%23/graph"
+
+TERMINAL_STATE = {"values": {"ok": True}, "next": [], "tasks": []}
+
+
+def _recording_handler(gets: list[str]):
+    def handler(request: httpx.Request) -> httpx.Response:
+        if request.method == "GET":
+            path = request.url.raw_path.decode("ascii").split("?", 1)[0]
+            gets.append(path)
+            return httpx.Response(200, json=TERMINAL_STATE)
+        # Lifecycle watcher subscription: an empty event stream.
+        return httpx.Response(
+            200, headers={"content-type": "text/event-stream"}, content=b""
+        )
+
+    return handler
+
+
+async def test_async_output_encodes_thread_id():
+    gets: list[str] = []
+    async with httpx.AsyncClient(
+        transport=httpx.MockTransport(_recording_handler(gets)),
+        base_url="https://example.com",
+    ) as raw:
+        threads = ThreadsClient(HttpClient(raw))
+        async with threads.stream(thread_id=THREAD_ID, assistant_id="agent") as thread:
+            assert await thread.output == {"ok": True}
+
+    assert gets == [ENCODED_STATE_PATH]
+
+
+async def test_async_agent_get_tree_encodes_assistant_id():
+    gets: list[str] = []
+    async with httpx.AsyncClient(
+        transport=httpx.MockTransport(_recording_handler(gets)),
+        base_url="https://example.com",
+    ) as raw:
+        threads = ThreadsClient(HttpClient(raw))
+        async with threads.stream(thread_id="t-1", assistant_id=ASSISTANT_ID) as thread:
+            await thread.agent.get_tree()
+
+    assert gets == [ENCODED_GRAPH_PATH]
+
+
+def test_sync_output_encodes_thread_id():
+    gets: list[str] = []
+    with httpx.Client(
+        transport=httpx.MockTransport(_recording_handler(gets)),
+        base_url="https://example.com",
+    ) as raw:
+        threads = SyncThreadsClient(SyncHttpClient(raw))
+        with threads.stream(thread_id=THREAD_ID, assistant_id="agent") as thread:
+            assert thread.output == {"ok": True}
+
+    assert gets == [ENCODED_STATE_PATH]
+
+
+def test_sync_agent_get_tree_encodes_assistant_id():
+    gets: list[str] = []
+    with httpx.Client(
+        transport=httpx.MockTransport(_recording_handler(gets)),
+        base_url="https://example.com",
+    ) as raw:
+        threads = SyncThreadsClient(SyncHttpClient(raw))
+        with threads.stream(thread_id="t-1", assistant_id=ASSISTANT_ID) as thread:
+            thread.agent.get_tree()
+
+    assert gets == [ENCODED_GRAPH_PATH]