langgraph-api 0.18.0.dev10__py3-none-any.whl → 0.18.0.dev11__py3-none-any.whl

langgraph_api/__init__.py

@@ -1 +1 @@
-__version__ = "0.18.0.dev10"
+__version__ = "0.18.0.dev11"

langgraph_api/api/threads.py

@@ -7,6 +7,7 @@ from starlette.responses import Response
 from starlette.routing import BaseRoute
 
 from langgraph_api import config as lg_api_config
+from langgraph_api.api.runs import parse_stream_mode_param
 from langgraph_api.config import USE_CUSTOM_CHECKPOINTER
 from langgraph_api.encryption.shared import (
     using_encryption,
@@ -589,24 +590,20 @@ async def join_thread_stream(request: ApiRequest):
         last_event_id, "Invalid last-event-id: must be a valid Redis stream ID"
     )
 
-    # Parse stream_modes parameter - can be single string or comma-separated list
-    stream_modes_param = request.query_params.get("stream_modes")
-    if stream_modes_param:
-        if "," in stream_modes_param:
-            # Handle comma-separated list
-            stream_modes = [mode.strip() for mode in stream_modes_param.split(",")]
-        else:
-            # Handle single value
-            stream_modes = [stream_modes_param]
-        # Validate each mode
-        for mode in stream_modes:
-            if mode not in get_args(ThreadStreamMode):
-                raise HTTPException(
-                    status_code=422, detail=f"Invalid stream mode: {mode}"
-                )
-    else:
-        # Default to run_modes
-        stream_modes = ["run_modes"]
+    # The SDKs send ``stream_mode``: once per mode, or as one JSON array from
+    # JS SDKs before 1.12.
+    params = request.query_params
+    values = params.getlist("stream_modes") or params.getlist("stream_mode")
+    stream_modes = [
+        mode.strip()
+        for value in values
+        if value
+        for item in parse_stream_mode_param(value)
+        for mode in str(item).split(",")
+    ] or ["run_modes"]
+    for mode in stream_modes:
+        if mode not in get_args(ThreadStreamMode):
+            raise HTTPException(status_code=422, detail=f"Invalid stream mode: {mode}")
 
     return EventSourceResponse(
         Threads.Stream.join(

langgraph_api/graph.py

@@ -375,7 +375,10 @@ async def get_graph(
                 CONFIG_KEY_RUNTIME,
             )
 
-            if use_langgraph_runtime:
+            if use_langgraph_runtime or access_context in (
+                "threads.read",
+                "threads.update",
+            ):
                 # xray draw calls runtime.override(), which the SDK ServerRuntime lacks (LSD-1713).
                 from langgraph.runtime import Runtime  # noqa: PLC0415
 

langgraph_api/models/run.py

@@ -233,15 +233,12 @@ async def create_valid_run(
             detail="Cannot specify both configurable and context. Prefer setting context alone. Context was introduced in LangGraph 0.6.0 and is the long term planned replacement for configurable.",
         )
 
-    # ``tools`` and ``lifecycle`` are emitted only by the protocol v2
-    # streaming pipeline (``stream_v2.py`` / ``StreamMessagesHandlerV2``
-    # plus the registered stream transformers). Accepting them on legacy
-    # streaming routes would either no-op (``lifecycle``, never emitted
-    # without a transformer) or leak v2-shaped events into v1 consumers
-    # (``tools``). Reject up front so callers get a clear 422 instead of
-    # a silently empty stream.
+    # ``lifecycle`` is emitted only by the protocol v2 streaming pipeline
+    # (``stream_v2.py`` plus the registered stream transformers), so legacy
+    # routes reject it up front instead of returning a silently empty stream.
+    # ``tools`` is accepted on legacy routes and dropped in ``stream.py``.
     if not configurable.get(EVENT_STREAMING_V2_CONFIG_KEY):
-        v2_only = {"tools", "lifecycle"}.intersection(stream_mode)
+        v2_only = {"lifecycle"}.intersection(stream_mode)
         if v2_only:
             raise HTTPException(
                 status_code=422,

langgraph_api/stream.py

@@ -265,6 +265,11 @@ async def astream_state(
         # ``capabilities.py`` documents this behavior — keep them in sync.
         stream_modes_set.discard("tools")
         stream_modes_set.discard("lifecycle")
+    elif not event_streaming_v2_run:
+        # The v1 React ``useStream`` hook asks for ``tools`` whenever an app
+        # listens for tool events, but it cannot parse the events graphs emit
+        # for this mode and throws on the first one.
+        stream_modes_set.discard("tools")
     if "debug" not in stream_modes_set:
         stream_modes_set.add("debug")
     if "messages-tuple" in stream_modes_set and not is_remote_pregel:

{langgraph_api-0.18.0.dev10.dist-info → langgraph_api-0.18.0.dev11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langgraph-api
-Version: 0.18.0.dev10
+Version: 0.18.0.dev11
 Author-email: Will Fu-Hinthorn <will@langchain.dev>, Josh Rogers <josh@langchain.dev>, Parker Rule <parker@langchain.dev>
 License: Elastic-2.0
 License-File: LICENSE
@@ -24,7 +24,7 @@ Requires-Dist: langsmith[otel]>=0.6.3
 Requires-Dist: mcp<3,>=2.3.0
 Requires-Dist: opentelemetry-api>=0.0.1
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=0.0.1
-Requires-Dist: opentelemetry-exporter-prometheus<0.64,>=0.63b1
+Requires-Dist: opentelemetry-exporter-prometheus<0.67,>=0.63b1
 Requires-Dist: opentelemetry-sdk>=0.0.1
 Requires-Dist: orjson>=3.9.7
 Requires-Dist: packaging>=23.2

{langgraph_api-0.18.0.dev10.dist-info → langgraph_api-0.18.0.dev11.dist-info}/RECORD

@@ -1,4 +1,4 @@
-langgraph_api/__init__.py,sha256=-bIIVjTdPEAZN8A072q6cjv1tdFUQmeHn9FYvYC-Q14,29
+langgraph_api/__init__.py,sha256=zeFov3xLvG2epwG3vyAlMksHDixxntffxrOokaDZ19c,29
 langgraph_api/_factory_utils.py,sha256=_FqW0olMu2PGLsnRq0ylt3a4jDCe12YIFHExMXI6Nyo,5976
 langgraph_api/asgi_transport.py,sha256=XApY3lIWBZTMbbsl8dDJzl0cLGirmAGE0SifqZUnXvs,11896
 langgraph_api/asyncio.py,sha256=-p-Vx89TnErypdPcWb-2EdbsSvhdIdHfriCFG7UP7ls,12444
@@ -10,7 +10,7 @@ langgraph_api/cron_scheduler.py,sha256=H1jPymC68A1MYyjfdApX4-hELiGBlJpGgSOsN8qhc
 langgraph_api/drain.py,sha256=MLUm3fDq3R8yxrZ-1W3TeCfhNzgNSzUA7TvB-D6K2_s,6108
 langgraph_api/errors.py,sha256=x6yhf0JrgSNweFRJw7l3ZK8De4T76d2v6MRvoDU_C-U,3312
 langgraph_api/feature_flags.py,sha256=NB1X5jO19c40hI3WDxGk9qwD6EZUROO0ooFSd1QTniM,3985
-langgraph_api/graph.py,sha256=uQaC_yOWRFZIZwQt5WGdjnVW5iB0WaaBniUcUV82Y5Q,40594
+langgraph_api/graph.py,sha256=aWj1o4bYU2prIWpAVAWOH7CHbjvZKYfWV2CtF-hzPko,40697
 langgraph_api/http.py,sha256=7hPxKbj-xoAKcm7iucBpT5nM_hXOgGVCPbBsCD693Cw,6977
 langgraph_api/http_metrics.py,sha256=etxbZNmYxdb58DVLNkHP7S-N6njXPTiQh2OWKMaIZi8,5336
 langgraph_api/http_metrics_utils.py,sha256=sjxF7SYGTzY0Wz_G0dzatsYNnWr31S6ujej4JmBG2yo,866
@@ -32,7 +32,7 @@ langgraph_api/server.py,sha256=_DG7dCL2wtlaXdppTce2e0k8PunCcSRj79ncQfqmK_Q,10305
 langgraph_api/sse.py,sha256=cChZ7raQUHp8p5BreE_5wMBR8lFO0n7746sV8_HQOrc,4822
 langgraph_api/state.py,sha256=Py8HG8k7u0FRAj4Ok89_uR9GerkyeFm90gSMTbWWQX0,8356
 langgraph_api/store.py,sha256=OXcdQSVCDKOzfS8S2aJHXbfuI5iYRoQBiW9WYKnCyx8,7122
-langgraph_api/stream.py,sha256=SMrditrbTJ7QtKW-ThpYAPiVsQD-ot_tQeGJIp9PKGI,36519
+langgraph_api/stream.py,sha256=FcmDN5lZmSwnbsRuuzz1En07iZG6Rr2otYWnHVw18sU,36806
 langgraph_api/stream_v2.py,sha256=AieeCAXQsthy9n6crCibMB7unbN1W_o1xkpJ2v11RSY,10822
 langgraph_api/traceblock.py,sha256=GhgAtLhAQ8Z8LHtRQq3par-rfPpRBQp2Q7WBACJq1NI,677
 langgraph_api/tracing_session.py,sha256=gmfv-BW1XRar6suVur1P4rTVKWkjElDEb2hhkBduWOs,728
@@ -53,7 +53,7 @@ langgraph_api/api/openapi.py,sha256=hS4yhfJfWAYilm0Pv8iC08bK7CMDG4PIVc-77y9Y7Ts,
 langgraph_api/api/profile.py,sha256=CA1ZkHALOuP8orYTICnEhcG_JnnA2wnyjbWyeb117jA,3455
 langgraph_api/api/runs.py,sha256=0ogQnEQyKeVTuEUY6UD4KMShUA6Qq7_Zyp0Z70zGSzs,32577
 langgraph_api/api/store.py,sha256=5d1GOxsVDK-8PPngYG2rjYF_B2qNevDvPos-nB8YPCI,7710
-langgraph_api/api/threads.py,sha256=OQSoveEmKE-mErF4AbvivHpTexLE_BJ_raGDgH8YZ44,23031
+langgraph_api/api/threads.py,sha256=JT7TpAs7zJBokxzGl_DmUNEnfAVfTRdJRiLwuP4D1EM,22916
 langgraph_api/api/ui.py,sha256=A1cRxaMK_4pb192mrZ_LMxLSFb8NriYwwvjeDdNDD7k,2803
 langgraph_api/api/a2ui_schemas/README.md,sha256=fZCc9rSK-qeUHsbJ17EYxMZjS3yUrYQdoQLX7ltgP8M,298
 langgraph_api/api/a2ui_schemas/client_capabilities.json,sha256=3YAHlRfeOn9dUH6uAek1loCL4caeSUuQzhrtWKWW9nU,1906
@@ -149,7 +149,7 @@ langgraph_api/middleware/http_logger.py,sha256=79iMlqKdSP5sS6G-iuEAHl2h0Z2ygYDxs
 langgraph_api/middleware/private_network.py,sha256=eQEzWI8epBNUCiNsMu9O27ofHBQ45M0p2OZy5YdUYos,2097
 langgraph_api/middleware/request_id.py,sha256=-p230Q5jDJAJLmSZRqQvB4dFFkJS9B4Vwg6pUgQtI24,1259
 langgraph_api/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langgraph_api/models/run.py,sha256=MW7Q17G3veh3WCPwwyDVA9qkk-ih8MPo3QKqY-_Wyho,15795
+langgraph_api/models/run.py,sha256=XHlx9m3Odr61CGuHjNdAqJEU_B325rxRn-98AeAgV4M,15625
 langgraph_api/timing/__init__.py,sha256=UDMuNBmc5NqX0m5T-9PUFioCa1lNvd4Wv4juPIBRb-w,877
 langgraph_api/timing/profiler.py,sha256=_n0qJYJMjCGo95RDuH5z8FIzePGNSNbnm3cvGmcgn6A,6186
 langgraph_api/timing/startup.py,sha256=1Jp4-tquBhiE5glWQhXGX5XS2_006myJXHHZMOi15ng,6161
@@ -182,7 +182,7 @@ langgraph_runtime/store.py,sha256=7mowndlsIroGHv3NpTSOZDJR0lCuaYMBoTnTrewjslw,11
 LICENSE,sha256=SCVQGLQfwOllsRFa9-Z3m8IYu4pnR9Vh2oANUCJiKqI,3860
 hatch_build.py,sha256=Nn9N-EFfVqmH5q3iCUrhqX6zc7qT1jLI3gWSBN2xgYQ,1738
 logging.json,sha256=sBy8HDDPuucpLbLUD6e8t5fsiQjJoklZsbVHi2qQ7aQ,367
-openapi.json,sha256=-3ATf5OgeAsoctzGUcZRXFyPBAHz49VCNqKaWt8yvQc,228738
+openapi.json,sha256=AX8OyPP9M3JCJ4J09DU0KdmPxTTlHl12YLm8e-u7Fg4,229573
 langgraph_grpc_common/__init__.py,sha256=sO7jFHekQxt6zZPhTPZAWLYLB_S8w7-VuJ7NyWFlFNo,97
 langgraph_grpc_common/checkpointer.py,sha256=FwY4a4zIdRFy_Fw2jd_dxIhBpWBIMi5kJqye2VkzzUg,16505
 langgraph_grpc_common/serde.py,sha256=8q290nZ6TdxbEhCTzwEs44XGi2b-3pfrUeMYY5WGlTY,6179
@@ -260,8 +260,8 @@ langgraph_grpc_common/proto/store_pb2.py,sha256=VWJ7wtzL9pVmZZKbxMzOzCoiFn58bB2g
 langgraph_grpc_common/proto/store_pb2.pyi,sha256=atXejijuYEb9tE0stGQdZcfA9ucMFj-ytTMwvkxwviM,29322
 langgraph_grpc_common/proto/store_pb2_grpc.py,sha256=Kyt8eV2NXkjh3be_BYytGdD19kNf74961cruonMvCrw,3300
 langgraph_grpc_common/proto/store_pb2_grpc.pyi,sha256=oS1h2cDoq2OjyM8xazcmc8LwRDC5oCAD0zto2QUmPQw,2027
-langgraph_api-0.18.0.dev10.dist-info/METADATA,sha256=p4UUfXDSWLBDQK7btVt4IGOL7teL42UEJs6_uJ2Hxpo,5940
-langgraph_api-0.18.0.dev10.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-langgraph_api-0.18.0.dev10.dist-info/entry_points.txt,sha256=hGedv8n7cgi41PypMfinwS_HfCwA7xJIfS0jAp8htV8,78
-langgraph_api-0.18.0.dev10.dist-info/licenses/LICENSE,sha256=SCVQGLQfwOllsRFa9-Z3m8IYu4pnR9Vh2oANUCJiKqI,3860
-langgraph_api-0.18.0.dev10.dist-info/RECORD,,
+langgraph_api-0.18.0.dev11.dist-info/METADATA,sha256=JsSSrPQRSnu9t4RnAMogw7UfrH64t16WkNW5eRo3iZo,5940
+langgraph_api-0.18.0.dev11.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+langgraph_api-0.18.0.dev11.dist-info/entry_points.txt,sha256=hGedv8n7cgi41PypMfinwS_HfCwA7xJIfS0jAp8htV8,78
+langgraph_api-0.18.0.dev11.dist-info/licenses/LICENSE,sha256=SCVQGLQfwOllsRFa9-Z3m8IYu4pnR9Vh2oANUCJiKqI,3860
+langgraph_api-0.18.0.dev11.dist-info/RECORD,,

openapi.json

@@ -1666,6 +1666,28 @@
             },
             "name": "stream_modes",
             "in": "query"
+          },
+          {
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "enum": ["lifecycle", "run_modes", "state_update"]
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": ["lifecycle", "run_modes", "state_update"]
+                  }
+                }
+              ],
+              "title": "Stream Mode",
+              "description": "Alias of `stream_modes`, the name the SDKs send. Ignored when `stream_modes` is set."
+            },
+            "name": "stream_mode",
+            "in": "query"
           }
         ],
         "responses": {
@@ -5308,7 +5330,8 @@
                     "updates",
                     "events",
                     "debug",
-                    "custom"
+                    "custom",
+                    "tools"
                   ]
                 },
                 "type": "array"
@@ -5324,7 +5347,8 @@
                   "updates",
                   "events",
                   "debug",
-                  "custom"
+                  "custom",
+                  "tools"
                 ]
               }
             ],
@@ -5506,7 +5530,8 @@
                     "updates",
                     "events",
                     "debug",
-                    "custom"
+                    "custom",
+                    "tools"
                   ]
                 },
                 "type": "array"
@@ -5522,7 +5547,8 @@
                   "updates",
                   "events",
                   "debug",
-                  "custom"
+                  "custom",
+                  "tools"
                 ]
               }
             ],