langgraph-api 0.2.109__py3-none-any.whl → 0.2.111__py3-none-any.whl

langgraph_api/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.109"
+__version__ = "0.2.111"

langgraph_api/api/runs.py

@@ -116,7 +116,8 @@ async def stream_run(
             run["run_id"],
             thread_id=thread_id,
             cancel_on_disconnect=on_disconnect == "cancel",
-            stream_mode=await sub,
+            stream_channel=await sub,
+            stream_mode=payload.get("stream_mode", []),
             last_event_id=None,
         ),
         headers={
@@ -157,7 +158,8 @@ async def stream_run_stateless(
             thread_id=run["thread_id"],
             ignore_404=True,
             cancel_on_disconnect=on_disconnect == "cancel",
-            stream_mode=await sub,
+            stream_channel=await sub,
+            stream_mode=payload.get("stream_mode", []),
             last_event_id=None,
         ),
         headers={
@@ -172,17 +174,6 @@ async def wait_run(request: ApiRequest):
     """Create a run, wait for the output."""
     thread_id = request.path_params["thread_id"]
     payload = await request.json(RunCreateStateful)
-
-    # Ensure stream_mode always includes "values" and "updates" while respecting other modes
-    user_stream_mode = payload.get("stream_mode", ["values"])
-    if isinstance(user_stream_mode, str):
-        user_stream_mode = [user_stream_mode]
-
-    # Always include "values" and "updates" if not already present
-    required_modes = {"values", "updates"}
-    final_stream_mode = list(set(user_stream_mode) | required_modes)
-    payload["stream_mode"] = final_stream_mode
-
     on_disconnect = payload.get("on_disconnect", "continue")
     run_id = uuid6()
     sub = asyncio.create_task(Runs.Stream.subscribe(run_id))
@@ -211,7 +202,8 @@ async def wait_run(request: ApiRequest):
             Runs.Stream.join(
                 run["run_id"],
                 thread_id=run["thread_id"],
-                stream_mode=await sub,
+                stream_channel=await sub,
+                stream_mode=["updates", "values", "error"],
                 cancel_on_disconnect=on_disconnect == "cancel",
             )
         ) as stream:
@@ -266,17 +258,6 @@ async def wait_run(request: ApiRequest):
 async def wait_run_stateless(request: ApiRequest):
     """Create a stateless run, wait for the output."""
     payload = await request.json(RunCreateStateless)
-
-    # Ensure stream_mode always includes "values" and "updates" while respecting other modes
-    user_stream_mode = payload.get("stream_mode", ["values"])
-    if isinstance(user_stream_mode, str):
-        user_stream_mode = [user_stream_mode]
-
-    # Always include "values" and "updates" if not already present
-    required_modes = {"values", "updates"}
-    final_stream_mode = list(set(user_stream_mode) | required_modes)
-    payload["stream_mode"] = final_stream_mode
-
     on_disconnect = payload.get("on_disconnect", "continue")
     run_id = uuid6()
     sub = asyncio.create_task(Runs.Stream.subscribe(run_id))
@@ -305,7 +286,8 @@ async def wait_run_stateless(request: ApiRequest):
             Runs.Stream.join(
                 run["run_id"],
                 thread_id=run["thread_id"],
-                stream_mode=await sub,
+                stream_channel=await sub,
+                stream_mode=["updates", "values", "error"],
                 ignore_404=True,
                 cancel_on_disconnect=on_disconnect == "cancel",
             )
@@ -424,7 +406,7 @@ async def join_run_stream(request: ApiRequest):
     cancel_on_disconnect = cancel_on_disconnect_str.lower() in {"true", "yes", "1"}
     validate_uuid(thread_id, "Invalid thread ID: must be a UUID")
     validate_uuid(run_id, "Invalid run ID: must be a UUID")
-    stream_mode = request.query_params.get("stream_mode") or None
+    stream_mode = request.query_params.get("stream_mode") or []
     last_event_id = request.headers.get("last-event-id") or None
     return EventSourceResponse(
         Runs.Stream.join(

langgraph_api/js/client.mts

@@ -344,6 +344,7 @@ const handleStream = <T extends z.ZodType<any>>(
       };
 
       try {
+        timer = setTimeout(sendHeartbeat, HEARTBEAT_MS);
         for await (const data of handler({ graph_id: graphId, ...body })) {
           await sendSSE(name, data);
         }
@@ -1094,14 +1095,13 @@ async function main() {
   }
 
   app.get("/ok", (c) => c.json({ ok: true }));
-  
+
   app.get("/debug/heapdump", async (c) => {
     try {
-      const target =
-        `/tmp/heapdump-${Date.now()}.heapsnapshot`;
+      const target = `/tmp/heapdump-${Date.now()}.heapsnapshot`;
       await fs.mkdir(path.dirname(target), { recursive: true });
       const written = writeHeapSnapshot(target);
-      return c.json({ ok: true, written });     // 200
+      return c.json({ ok: true, written }); // 200
     } catch (error) {
       if (error instanceof HTTPException) {
         return c.json(serializeError(error), error.status);

langgraph_api/models/run.py

@@ -86,6 +86,9 @@ class RunCreateDict(TypedDict):
     - "updates": Stream the state updates returned by each node.
     - "events": Stream all events produced by sub-runs (eg. nodes, LLMs, etc.).
     - "custom": Stream custom events produced by your nodes.
+    
+    Note: __interrupt__ events are always included in the updates stream, even when "updates" 
+    is not explicitly requested, to ensure interrupt events are always visible.
     """
     stream_subgraphs: bool | None
     """Stream output from subgraphs. By default, streams only the top graph."""

langgraph_api/stream.py

@@ -118,6 +118,9 @@ async def astream_state(
     if "messages-tuple" in stream_modes_set and not isinstance(graph, BaseRemotePregel):
         stream_modes_set.remove("messages-tuple")
         stream_modes_set.add("messages")
+    if "updates" not in stream_modes_set:
+        stream_modes_set.add("updates")
+        only_interrupt_updates = True
     # attach attempt metadata
     config["metadata"]["run_attempt"] = attempt
     # attach langgraph metadata
@@ -226,7 +229,12 @@ async def astream_state(
                                 ),
                                 [message_chunk_to_message(messages[msg.id])],
                             )
-                    elif mode in stream_mode:
+                    elif mode in stream_mode or (
+                        mode == "updates"
+                        and isinstance(chunk, dict)
+                        and "__interrupt__" in chunk
+                        and only_interrupt_updates
+                    ):
                         if subgraphs and ns:
                             yield f"{mode}|{'|'.join(ns)}", chunk
                         else:
@@ -292,7 +300,12 @@ async def astream_state(
                             ),
                             [message_chunk_to_message(messages[msg.id])],
                         )
-                elif mode in stream_mode:
+                elif mode in stream_mode or (
+                    mode == "updates"
+                    and isinstance(chunk, dict)
+                    and "__interrupt__" in chunk
+                    and only_interrupt_updates
+                ):
                     if subgraphs and ns:
                         yield f"{mode}|{'|'.join(ns)}", chunk
                     else:

{langgraph_api-0.2.109.dist-info → langgraph_api-0.2.111.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langgraph-api
-Version: 0.2.109
+Version: 0.2.111
 Author-email: Nuno Campos <nuno@langchain.dev>, Will Fu-Hinthorn <will@langchain.dev>
 License: Elastic-2.0
 License-File: LICENSE
@@ -11,7 +11,7 @@ Requires-Dist: httpx>=0.25.0
 Requires-Dist: jsonschema-rs<0.30,>=0.20.0
 Requires-Dist: langchain-core>=0.3.64
 Requires-Dist: langgraph-checkpoint>=2.0.23
-Requires-Dist: langgraph-runtime-inmem<0.7,>=0.6.0
+Requires-Dist: langgraph-runtime-inmem<0.7,>=0.6.5
 Requires-Dist: langgraph-sdk>=0.2.0
 Requires-Dist: langgraph>=0.4.0
 Requires-Dist: langsmith>=0.3.45

{langgraph_api-0.2.109.dist-info → langgraph_api-0.2.111.dist-info}/RECORD

@@ -1,4 +1,4 @@
-langgraph_api/__init__.py,sha256=jybh32HGdmuQqiTixok8D7itMnnyyRPSwIriUxJaMoM,24
+langgraph_api/__init__.py,sha256=1vHLiVVqXa26VwB4MICUFKzbta25Fuuf7oCnCAdaCCk,24
 langgraph_api/asgi_transport.py,sha256=eqifhHxNnxvI7jJqrY1_8RjL4Fp9NdN4prEub2FWBt8,5091
 langgraph_api/asyncio.py,sha256=Wv4Rwm-a-Cf6JpfgJmVuVlXQ7SlwrjbTn0eq1ux8I2Q,9652
 langgraph_api/cli.py,sha256=xQojITwmmKSJw48Lr2regcnRPRq2FJqWlPpeyr5TgbU,16158
@@ -21,7 +21,7 @@ langgraph_api/server.py,sha256=Z_VL-kIphybTRDWBIqHMfRhgCmAFyTRqAGlgnHQF0Zg,6973
 langgraph_api/sse.py,sha256=SLdtZmTdh5D8fbWrQjuY9HYLd2dg8Rmi6ZMmFMVc2iE,4204
 langgraph_api/state.py,sha256=P2mCo-0bqPu2v9FSFGJtUCjPPNvv6wLUKQh8SdxAtc8,4387
 langgraph_api/store.py,sha256=srRI0fQXNFo_RSUs4apucr4BEp_KrIseJksZXs32MlQ,4635
-langgraph_api/stream.py,sha256=f22caNhIPeF67wBD3xtoaodyimya0fiBlmVOAznEkOY,13851
+langgraph_api/stream.py,sha256=rV7VpTBjqMZcmYm-EJ7DtdSQwIylmgF4toe8IPIYl9Y,14401
 langgraph_api/thread_ttl.py,sha256=-Ox8NFHqUH3wGNdEKMIfAXUubY5WGifIgCaJ7npqLgw,1762
 langgraph_api/traceblock.py,sha256=2aWS6TKGTcQ0G1fOtnjVrzkpeGvDsR0spDbfddEqgRU,594
 langgraph_api/utils.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -33,7 +33,7 @@ langgraph_api/api/assistants.py,sha256=e6da5aYMVAxj2rZG9RxZbBKFM0bP_f8Xbx0P5UhK8
 langgraph_api/api/mcp.py,sha256=qe10ZRMN3f-Hli-9TI8nbQyWvMeBb72YB1PZVbyqBQw,14418
 langgraph_api/api/meta.py,sha256=fmc7btbtl5KVlU_vQ3Bj4J861IjlqmjBKNtnxSV-S-Q,4198
 langgraph_api/api/openapi.py,sha256=KToI2glOEsvrhDpwdScdBnL9xoLOqkTxx5zKq2pMuKQ,11957
-langgraph_api/api/runs.py,sha256=DxmGkRnZsQgr5bmflguDKXEvY3J9Q-bt7YwbuSFAMxU,21579
+langgraph_api/api/runs.py,sha256=whjpK5Kn3nQy9g9qQK94F_rTlX4oG65WODUyj5TSOwM,20877
 langgraph_api/api/store.py,sha256=TSeMiuMfrifmEnEbL0aObC2DPeseLlmZvAMaMzPgG3Y,5535
 langgraph_api/api/threads.py,sha256=nQMlGnsrFD1F4S-ID_q0HZrF2GZ0Pm7aV04Sh1eYgds,9588
 langgraph_api/api/ui.py,sha256=17QrRy2XVzP7x_0RdRw7pmSv-n1lmnb54byHCGGeNhM,2490
@@ -51,7 +51,7 @@ langgraph_api/js/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,
 langgraph_api/js/base.py,sha256=GORqRDbGAOQX2ygT6dMcqBDCA9tdAp8EpG4bfqUPMg4,1198
 langgraph_api/js/build.mts,sha256=bRQo11cglDFXlLN7Y48CQPTSMLenp7MqIWuP1DkSIo0,3139
 langgraph_api/js/client.http.mts,sha256=AGA-p8J85IcNh2oXZjDxHQ4PnQdJmt-LPcpZp6j0Cws,4687
-langgraph_api/js/client.mts,sha256=wizpsqiM95KWnPw4ByT9_3nELrGHVvquQB2pABw597w,31957
+langgraph_api/js/client.mts,sha256=CEz5oOtI_mwqsvsC33S_2TQbxD6mW-AKl6shsRI5G18,32000
 langgraph_api/js/errors.py,sha256=Cm1TKWlUCwZReDC5AQ6SgNIVGD27Qov2xcgHyf8-GXo,361
 langgraph_api/js/global.d.ts,sha256=j4GhgtQSZ5_cHzjSPcHgMJ8tfBThxrH-pUOrrJGteOU,196
 langgraph_api/js/package.json,sha256=BpNAO88mbE-Gv4WzQfj1TLktCWGqm6XBqI892ObuOUw,1333
@@ -74,7 +74,7 @@ langgraph_api/middleware/http_logger.py,sha256=L7ZhypmQjlHBfm93GqZaqUXzu0r-ieaoO
 langgraph_api/middleware/private_network.py,sha256=eYgdyU8AzU2XJu362i1L8aSFoQRiV7_aLBPw7_EgeqI,2111
 langgraph_api/middleware/request_id.py,sha256=SDj3Yi3WvTbFQ2ewrPQBjAV8sYReOJGeIiuoHeZpR9g,1242
 langgraph_api/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langgraph_api/models/run.py,sha256=M4NfATGKkXIuB5MLh0CUSp3bP6iG83ZZVvlqE2A_n1E,14855
+langgraph_api/models/run.py,sha256=RX2LaE1kmTruX8o8HgvqeEt5YpPGHILWByChjMZVJ58,15035
 langgraph_api/tunneling/cloudflare.py,sha256=iKb6tj-VWPlDchHFjuQyep2Dpb-w2NGfJKt-WJG9LH0,3650
 langgraph_api/utils/__init__.py,sha256=92mSti9GfGdMRRWyESKQW5yV-75Z9icGHnIrBYvdypU,3619
 langgraph_api/utils/cache.py,sha256=SrtIWYibbrNeZzLXLUGBFhJPkMVNQnVxR5giiYGHEfI,1810
@@ -94,8 +94,8 @@ langgraph_runtime/store.py,sha256=7mowndlsIroGHv3NpTSOZDJR0lCuaYMBoTnTrewjslw,11
 LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
 logging.json,sha256=3RNjSADZmDq38eHePMm1CbP6qZ71AmpBtLwCmKU9Zgo,379
 openapi.json,sha256=jyQZW5U4V15zWciiIvaDPasYZd3k1iMiQ2vkPxf3zb4,145614
-langgraph_api-0.2.109.dist-info/METADATA,sha256=GSTrpgEsD1WR4TOV-Fqqbafi7TCj5elx_qrXzO0DFMs,3890
-langgraph_api-0.2.109.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-langgraph_api-0.2.109.dist-info/entry_points.txt,sha256=hGedv8n7cgi41PypMfinwS_HfCwA7xJIfS0jAp8htV8,78
-langgraph_api-0.2.109.dist-info/licenses/LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
-langgraph_api-0.2.109.dist-info/RECORD,,
+langgraph_api-0.2.111.dist-info/METADATA,sha256=udH8QNksRyKI6_9ZWKNEMdzr5WM8ftswNyowGia9DrM,3890
+langgraph_api-0.2.111.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+langgraph_api-0.2.111.dist-info/entry_points.txt,sha256=hGedv8n7cgi41PypMfinwS_HfCwA7xJIfS0jAp8htV8,78
+langgraph_api-0.2.111.dist-info/licenses/LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
+langgraph_api-0.2.111.dist-info/RECORD,,