langgraph-api 0.0.38__py3-none-any.whl → 0.0.40__py3-none-any.whl

langgraph_api/js/tests/compose-postgres.yml

@@ -34,7 +34,7 @@ services:
         ADD . /deps/graphs
         WORKDIR /deps/graphs
         RUN yarn install --frozen-lockfile
-        ENV LANGSERVE_GRAPHS='{"agent":"./agent.mts:graph", "nested": "./nested.mts:graph", "weather": "./weather.mts:graph", "error": "./error.mts:graph", "delay": "./delay.mts:graph"}'
+        ENV LANGSERVE_GRAPHS='{"agent":"./agent.mts:graph", "nested": "./nested.mts:graph", "weather": "./weather.mts:graph", "error": "./error.mts:graph", "delay": "./delay.mts:graph", "dynamic": "./dynamic.mts:graph"}'
         ENV LANGGRAPH_CONFIG='{"agent": {"configurable": {"model_name": "openai"}}}'
         RUN tsx /api/langgraph_api/js/build.mts
     depends_on:

langgraph_api/js/tests/graphs/dynamic.mts

@@ -0,0 +1,24 @@
+import { StateGraph, Annotation } from "@langchain/langgraph";
+
+export const graph = async (config: {
+  configurable?: { nodeName: string };
+}) => {
+  const node = config.configurable?.nodeName ?? "default";
+
+  const state = Annotation.Root({
+    node: Annotation<string>,
+    messages: Annotation<string[]>({
+      default: () => [],
+      reducer: (a: string[], b: string[] | string) => {
+        if (Array.isArray(b)) return [...a, ...b];
+        return [...a, b];
+      },
+    }),
+  });
+
+  return new StateGraph(state)
+    .addNode(node, () => ({ node, messages: [node] }))
+    .addEdge("__start__", node)
+    .addEdge(node, "__end__")
+    .compile();
+};

langgraph_api/js/tests/graphs/langgraph.json

@@ -4,6 +4,7 @@
     "agent": "./agent.mts:graph",
     "subgraph": "./subgraph.mts:graph",
     "nested": "./nested.mts:graph",
+    "dynamic": "./dynamic.mts:graph",
     "delay": "./delay.mts:graph"
   }
 }

langgraph_api/js/tests/utils.mts

@@ -1,17 +1,17 @@
 export async function gatherIterator<T>(
-  i: AsyncIterable<T> | Promise<AsyncIterable<T>>,
+  i: AsyncIterable<T> | Promise<AsyncIterable<T>>
 ): Promise<Array<T>> {
   const out: T[] = [];
   for await (const item of await i) out.push(item);
   return out;
 }
 
-export function findLast<T>(
+export function findLast<T, S extends T>(
   lst: Array<T>,
-  predicate: (item: T) => boolean,
-): T | undefined {
+  predicate: (item: T) => item is S
+): S | undefined {
   for (let i = lst.length - 1; i >= 0; i--) {
-    if (predicate(lst[i])) return lst[i];
+    if (predicate(lst[i])) return lst[i] as S;
   }
   return undefined;
 }

langgraph_api/js/yarn.lock

@@ -198,10 +198,10 @@
     zod "^3.22.4"
     zod-to-json-schema "^3.22.3"
 
-"@langchain/langgraph-api@~0.0.14":
-  version "0.0.14"
-  resolved "https://registry.yarnpkg.com/@langchain/langgraph-api/-/langgraph-api-0.0.14.tgz#fcecea45c22ca193631702d21197c38bf3f95026"
-  integrity sha512-/lh6ug9kXBhL5zrX56MA4xxNt99kzLQqNuYqQRd2PWflVNATMRJNMfWhLjh91Hbn0yf3CWQoIX/6mPQiwCfrKg==
+"@langchain/langgraph-api@~0.0.19":
+  version "0.0.19"
+  resolved "https://registry.yarnpkg.com/@langchain/langgraph-api/-/langgraph-api-0.0.19.tgz#e4b8054a1f4e7943bc53787fb6335470b55f4b1d"
+  integrity sha512-vsWnVUMVdr3i0ooI3Pcq4tbRKyRiDFGtUyyusCs2zZ/AHNIOV1ieHVTYubhZ04F+jNEwe0SwSMqtM0/Vg+cbTw==
   dependencies:
     "@babel/code-frame" "^7.26.2"
     "@hono/node-server" "^1.12.0"
@@ -238,10 +238,10 @@
   dependencies:
     uuid "^10.0.0"
 
-"@langchain/langgraph-sdk@^0.0.31":
-  version "0.0.31"
-  resolved "https://registry.yarnpkg.com/@langchain/langgraph-sdk/-/langgraph-sdk-0.0.31.tgz#186cc2d31bb504d301e227dc7448dd22a8ee1933"
-  integrity sha512-oYZWoC3x7vH9bAL1Y30XjtuWnic1j3knXD4BbldsY0chFLxwIT5i6/GMThNy3Oiwb4SB+c6gvaSuxBNDkp7dkw==
+"@langchain/langgraph-sdk@^0.0.60":
+  version "0.0.60"
+  resolved "https://registry.yarnpkg.com/@langchain/langgraph-sdk/-/langgraph-sdk-0.0.60.tgz#eee259632f362298b23712ccf393903daf8affc9"
+  integrity sha512-7ndeAdw1afVY72HpKEGw7AyuDlD7U3e4jxaJflxA+PXaFPiE0d/hQYvlPT84YmvqNzJN605hv7YcrOju2573bQ==
   dependencies:
     "@types/json-schema" "^7.0.15"
     p-queue "^6.6.2"

langgraph_api/worker.py

@@ -10,6 +10,7 @@ from starlette.exceptions import HTTPException
 
 from langgraph_api.auth.custom import SimpleUser, normalize_user
 from langgraph_api.config import (
+    BG_JOB_ISOLATED_LOOPS,
     BG_JOB_MAX_RETRIES,
     BG_JOB_TIMEOUT_SECS,
 )
@@ -34,6 +35,11 @@ try:
 except ImportError:
     InFailedSqlTransaction = ()
 
+try:
+    from blockbuster import BlockingError
+except ImportError:
+    BlockingError = ()
+
 logger = structlog.stdlib.get_logger(__name__)
 
 
@@ -110,7 +116,22 @@ async def worker(
 
         try:
             if attempt > BG_JOB_MAX_RETRIES:
-                raise RuntimeError(f"Run {run['run_id']} exceeded max attempts")
+                await logger.aerror("Run exceeded max attempts", run_id=run["run_id"])
+
+                error_message = (
+                    f"Run {run['run_id']} exceeded max attempts ({BG_JOB_MAX_RETRIES}).\n\n"
+                    "This may happen if your code blocks the event loop with synchronous I/O bound calls (network requests, database queries, etc.).\n\n"
+                    "If that is the case, your issues may be resolved by converting synchronous operations to async (e.g., use aiohttp instead of requests).\n\n"
+                )
+
+                if not BG_JOB_ISOLATED_LOOPS:
+                    error_message += (
+                        "Also consider setting BG_JOB_ISOLATED_LOOPS=true in your environment. This will isolate I/O-bound operations to avoid"
+                        " blocking the main API server.\n\n"
+                        "See: https://langchain-ai.github.io/langgraph/cloud/reference/env_var/#bg_job_isolated_loops\n\n"
+                    )
+
+                raise RuntimeError(error_message)
             if temporary:
                 stream = astream_state(
                     AsyncExitStack(), conn, cast(Run, run), attempt, done
@@ -150,6 +171,7 @@ async def worker(
                 run_started_at=run_started_at.isoformat(),
                 run_ended_at=run_ended_at,
                 run_exec_ms=ms(datetime.now(UTC), run_started_at),
+                graph_id=_get_graph_id(run),
             )
             await Runs.set_status(conn, run_id, "timeout")
         except UserRollback as e:
@@ -166,6 +188,7 @@ async def worker(
                     run_started_at=run_started_at.isoformat(),
                     run_ended_at=run_ended_at,
                     run_exec_ms=ms(datetime.now(UTC), run_started_at),
+                    graph_id=_get_graph_id(run),
                 )
 
             except InFailedSqlTransaction as e:
@@ -203,6 +226,7 @@ async def worker(
                 run_started_at=run_started_at.isoformat(),
                 run_ended_at=run_ended_at,
                 run_exec_ms=ms(datetime.now(UTC), run_started_at),
+                graph_id=_get_graph_id(run),
             )
             await Runs.set_status(conn, run_id, "interrupted")
         except RETRIABLE_EXCEPTIONS as e:
@@ -218,10 +242,28 @@ async def worker(
                 run_started_at=run_started_at.isoformat(),
                 run_ended_at=run_ended_at,
                 run_exec_ms=ms(datetime.now(UTC), run_started_at),
+                graph_id=_get_graph_id(run),
             )
             await Runs.set_status(conn, run_id, "pending")
             raise
         except Exception as exc:
+            if isinstance(exc, BlockingError):
+                # Only occurs in the dev server
+                exc.add_note(
+                    "Heads up! LangGraph identified a synchronous blocking call in your code. "
+                    "When running in an ASGI web server, blocking calls can degrade performance for everyone since they tie up the event loop.\n\n"
+                    "Here are your options to fix this:\n\n"
+                    "1. Best approach: Convert any blocking code to use async/await patterns\n"
+                    "   For example, use 'await aiohttp.get()' instead of 'requests.get()'\n\n"
+                    "2. Quick fix: Move blocking operations to a separate thread\n"
+                    "   Example: 'await asyncio.to_thread(your_blocking_function)'\n\n"
+                    "3. Override (if you can't change the code):\n"
+                    "   - For development: Run 'langgraph dev --allow-blocking'\n"
+                    "   - For deployment: Set 'BG_JOB_ISOLATED_LOOPS=true' environment variable\n\n"
+                    "These blocking operations can prevent health checks and slow down other runs in your deployment. "
+                    "Following these recommendations will help keep your LangGraph application running smoothly!"
+                )
+
             exception = exc
             status = "error"
             run_ended_at = datetime.now(UTC).isoformat()
@@ -234,6 +276,7 @@ async def worker(
                 run_started_at=run_started_at.isoformat(),
                 run_ended_at=run_ended_at,
                 run_exec_ms=ms(datetime.now(UTC), run_started_at),
+                graph_id=_get_graph_id(run),
             )
             await Runs.set_status(conn, run_id, "error")
         set_auth_ctx(None, None)
@@ -266,3 +309,11 @@ async def worker(
 
 def ms(after: datetime, before: datetime) -> int:
     return int((after - before).total_seconds() * 1000)
+
+
+def _get_graph_id(run: Run) -> str | None:
+    try:
+        return run["kwargs"]["config"]["configurable"]["graph_id"]
+    except Exception:
+        logger.info(f"Failed to get graph_id from run {run['run_id']}")
+        return "Unknown"

{langgraph_api-0.0.38.dist-info → langgraph_api-0.0.40.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: langgraph-api
-Version: 0.0.38
+Version: 0.0.40
 Summary: 
 License: Elastic-2.0
 Author: Nuno Campos
@@ -10,6 +10,8 @@ Classifier: License :: Other/Proprietary License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: blockbuster (>=1.5.24,<2.0.0)
 Requires-Dist: cloudpickle (>=3.0.0,<4.0.0)
 Requires-Dist: cryptography (>=43.0.3,<44.0.0)
 Requires-Dist: httpx (>=0.25.0)

{langgraph_api-0.0.38.dist-info → langgraph_api-0.0.40.dist-info}/RECORD

@@ -1,6 +1,6 @@
 LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
 langgraph_api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langgraph_api/api/__init__.py,sha256=iDxgg0arqzZ0-roCSuWo3f8zXmKcl4fuU3Jw0-lqtZs,5447
+langgraph_api/api/__init__.py,sha256=qNcg8QJydef0gM-vYJlxITMRZw-9r1vw8zqm2raqqYE,5493
 langgraph_api/api/assistants.py,sha256=nU6tnbgdr_6Utlq0A9nw2a6xxpUM_DNuCFI42_Kcs_o,14233
 langgraph_api/api/mcp.py,sha256=KbR19dtFCpJEiKYj3IfepAuJij8YZVELuVp7JY_yu_o,13754
 langgraph_api/api/meta.py,sha256=ifJ_Ki0Qf2DYbmY6OKlqKhLGxbt55gm0lEqH1A0cJbw,2790
@@ -18,23 +18,23 @@ langgraph_api/auth/langsmith/client.py,sha256=eKchvAom7hdkUXauD8vHNceBDDUijrFgdT
 langgraph_api/auth/middleware.py,sha256=jU8aDSIZHdzCGdifejRF7ndHkSjBtqIHcBwFIuUdHEA,1875
 langgraph_api/auth/noop.py,sha256=Bk6Nf3p8D_iMVy_OyfPlyiJp_aEwzL-sHrbxoXpCbac,586
 langgraph_api/auth/studio_user.py,sha256=FzFQRROKDlA9JjtBuwyZvk6Mbwno5M9RVYjDO6FU3F8,186
-langgraph_api/cli.py,sha256=76wJLx1ekaRmXR5DxGy1_RuA0lQq2jBUzHAAVUKV2Ho,12163
+langgraph_api/cli.py,sha256=X76TYnErQPjRkZhK-n6gthCUmtItkwqVrRPvwZswF5Y,12335
 langgraph_api/command.py,sha256=3O9v3i0OPa96ARyJ_oJbLXkfO8rPgDhLCswgO9koTFA,768
-langgraph_api/config.py,sha256=MwTyJUr2wwZdUbL0gIvol_cCGi24Py9DvBnSozE1ai8,9342
+langgraph_api/config.py,sha256=y-dmkmd929WDosIO0nUmcQicZN2XozJrVHzeBGtLhUg,9418
 langgraph_api/cron_scheduler.py,sha256=9yzbbGxzNgJdIg4ZT7yu2oTwT_wRuPxD1c2sbbd52xs,2630
 langgraph_api/errors.py,sha256=Bu_i5drgNTyJcLiyrwVE_6-XrSU50BHf9TDpttki9wQ,1690
-langgraph_api/graph.py,sha256=5Lo9FghptdPIFJoeTDkLjoIQLuNy49RWtAHJmzOCrZI,17209
+langgraph_api/graph.py,sha256=jpMMMgn8uHqDc3gPu02tF7B8af0TV153t2F_kodcBvI,18799
 langgraph_api/http.py,sha256=gYbxxjY8aLnsXeJymcJ7G7Nj_yToOGpPYQqmZ1_ggfA,5240
 langgraph_api/js/.gitignore,sha256=l5yI6G_V6F1600I1IjiUKn87f4uYIrBAYU1MOyBBhg4,59
-langgraph_api/js/base.py,sha256=BpE8-xkUp8HFPRjSKx1tfUQubvoV4jYl6OwZdre3veI,209
-langgraph_api/js/build.mts,sha256=ArAEn74HHY_KXt0JCne76FTyGP34VQCHMe6OfPyxLM8,2915
-langgraph_api/js/client.mts,sha256=2dptAX8fMowV9OC4DU4khjpZUgALBLVBTu3jTQbeUJY,24394
+langgraph_api/js/base.py,sha256=xkBp5bwRrbpMFaAMViEU-qIlnsJuu3X_G8sa1pqNZK0,227
+langgraph_api/js/build.mts,sha256=PZGeFTOhmRIBxkbFaaUOpTacqg1Z7kUkZWTU2l9a7FY,3077
+langgraph_api/js/client.mts,sha256=n6ecWwJBP2wp1jCaam55GxffH-YesVrV-7ZTml-k4Oc,26137
 langgraph_api/js/errors.py,sha256=Cm1TKWlUCwZReDC5AQ6SgNIVGD27Qov2xcgHyf8-GXo,361
-langgraph_api/js/global.d.ts,sha256=cLJRZfYVGmgQ6o_xFevVNNTIi918ZUdxVRnpLVSjiAY,133
-langgraph_api/js/package.json,sha256=j6DMoVgwRqWqTwdd7R1f-kvmiTUAbO3HaUhM8K64lbE,1224
-langgraph_api/js/remote.py,sha256=g0H2x3W7kejxswhgZfFaljzl4Y7agMCnO5BdNVj1rDY,23474
+langgraph_api/js/global.d.ts,sha256=yDusqAyzVYhxfwqqcERUzucu2Pw9ma3-ug4DFyUvQfs,167
+langgraph_api/js/package.json,sha256=uA_2KV86yMJmqfQd9Xe4w2PPjH6DmttBpSxi1PlSq3U,1224
+langgraph_api/js/remote.py,sha256=jtzzkCBZ6eUE8g1JCn1lguaKF1RkpUmKbdblI6-NWgQ,24607
 langgraph_api/js/schema.py,sha256=7idnv7URlYUdSNMBXQcw7E4SxaPxCq_Oxwnlml8q5ik,408
-langgraph_api/js/src/graph.mts,sha256=mRyMUp03Fwd5DlmNIFl3RiUCQuJ5XwmFp1AfAeKDfVc,3169
+langgraph_api/js/src/graph.mts,sha256=otgztTNzNJpeF2IOrpNuuwbSbpAy4eFE5dHtUd7eQwU,3742
 langgraph_api/js/src/hooks.mjs,sha256=XtktgmIHlls_DsknAuwib-z7TqCm0haRoTXvnkgzMuo,601
 langgraph_api/js/src/parser/parser.mts,sha256=c7WLEtMMwtVzir9O8VpJFVHKuLjtI86rde-In2lvaM0,13217
 langgraph_api/js/src/parser/parser.worker.mjs,sha256=2K6D0GlUmkk7LE39I8mryB8VZVE3-N9Cblji-ArPhFo,386
@@ -44,22 +44,23 @@ langgraph_api/js/src/utils/importMap.mts,sha256=pX4TGOyUpuuWF82kXcxcv3-8mgusRezO
 langgraph_api/js/src/utils/pythonSchemas.mts,sha256=98IW7Z_VP7L_CHNRMb3_MsiV3BgLE2JsWQY_PQcRR3o,685
 langgraph_api/js/src/utils/serde.mts,sha256=OuyyO9btvwWd55rU_H4x91dFEJiaPxL-lL9O6Zgo908,742
 langgraph_api/js/sse.py,sha256=lsfp4nyJyA1COmlKG9e2gJnTttf_HGCB5wyH8OZBER8,4105
-langgraph_api/js/tests/api.test.mts,sha256=RTJb9ZMX_IhqUPcShK61LZG9v_-xzdIZ0oEmOIjbJ4c,57709
-langgraph_api/js/tests/compose-postgres.yml,sha256=wV1Kws7WwUWVIudPkB--v58MOPL9hOcV0MUK-cvNrpA,1738
+langgraph_api/js/tests/api.test.mts,sha256=GlCTOTuSGc2m2vdsw6PSZrDPgfcvJi0A5v4A9xGaZi4,60004
+langgraph_api/js/tests/compose-postgres.yml,sha256=pV1dW6aCgTTJ1WHSDeCqlVgFE9PbyWW5WbwrsiJcgoA,1772
 langgraph_api/js/tests/graphs/.gitignore,sha256=26J8MarZNXh7snXD5eTpV3CPFTht5Znv8dtHYCLNfkw,12
 langgraph_api/js/tests/graphs/agent.css,sha256=QgcOC0W7IBsrg4pSqqpull-WTgtULZfx_lF_5ZxLdag,23
 langgraph_api/js/tests/graphs/agent.mts,sha256=E9WMv0alMv0njUEECqEsqoRk9NXJUgXW7SyQJ3GOZ8k,5396
 langgraph_api/js/tests/graphs/agent.ui.tsx,sha256=JDFJdpdIS6rglkXTaROSb1Is0j1kt5wN9ML8W4cuht8,175
 langgraph_api/js/tests/graphs/delay.mts,sha256=CFneKxqI4bGGK0lYjSbe80QirowPQlsRSuhDUKfydhk,703
+langgraph_api/js/tests/graphs/dynamic.mts,sha256=Wf_-keF7lkEfp_iyI45nlFGCeU8ARLQ8axc0LXh7TyE,659
 langgraph_api/js/tests/graphs/error.mts,sha256=l4tk89449dj1BnEF_0ZcfPt0Ikk1gl8L1RaSnRfr3xo,487
-langgraph_api/js/tests/graphs/langgraph.json,sha256=frxd7ZWILdeMYSZgUBH6UO-IR7I2YJSOfOlx2mnO1sI,189
+langgraph_api/js/tests/graphs/langgraph.json,sha256=iZL7XpAy3-QnCUHCRSj__Fxp3A-JPuYBJ_XQIxeyQfU,227
 langgraph_api/js/tests/graphs/nested.mts,sha256=4G7jSOSaFVQAza-_ARbK-Iai1biLlF2DIPDZXf7PLIY,1245
 langgraph_api/js/tests/graphs/package.json,sha256=Kv2kdlTNeWl00vYQAhngorQ6rLab4SMc7g1AgZslrHQ,118
 langgraph_api/js/tests/graphs/weather.mts,sha256=A7mLK3xW8h5B-ZyJNAyX2M2fJJwzPJzXs4DYesJwreQ,1655
 langgraph_api/js/tests/graphs/yarn.lock,sha256=i2AAIgXA3XBLM8-oU45wgUefCSG-Tne4ghWHmUCUKVk,10407
 langgraph_api/js/tests/parser.test.mts,sha256=dEC8KTqKygeb1u39ZvpPqCT4HtfPD947nLmITt2buxA,27883
-langgraph_api/js/tests/utils.mts,sha256=2kTybJ3O7Yfe1q3ehDouqV54ibXkNzsPZ_wBZLJvY-4,421
-langgraph_api/js/yarn.lock,sha256=W89dVYZMThcec08lJMcYnvEEnQK7VM5cPglvwpIdRv0,82773
+langgraph_api/js/tests/utils.mts,sha256=q1V9gvT63v95onlfK9W4iv3n9ZJO3h-0RD9TdDYuRyY,439
+langgraph_api/js/yarn.lock,sha256=JtMDtRVX9kr9lK0rbWRQsGHYbkQSmzNa4NwTunBv58U,82773
 langgraph_api/lifespan.py,sha256=0F4Xn6IC4wUfvBWbm6KCJ-jiF0S7iWDOHJYJZ-A3o3s,2739
 langgraph_api/logging.py,sha256=JJIzbNIgLCN6ClQ3tA-Mm5ffuBGvpRDSZsEvnIlsuu4,3693
 langgraph_api/metadata.py,sha256=5Mu3MUtUc-iIocU3X2SZDoGIqnUmTdT3517MhP94npI,3495
@@ -81,23 +82,23 @@ langgraph_api/thread_ttl.py,sha256=ubkWMymTR7p9nGWd60-WKEOQ20ZgIkWB6WGstQUmRS4,1
 langgraph_api/utils.py,sha256=92mSti9GfGdMRRWyESKQW5yV-75Z9icGHnIrBYvdypU,3619
 langgraph_api/validation.py,sha256=Qo3EkSRXzIRe3GRuqRWbElTcUXRMXMyA1w0VbMvdwME,4934
 langgraph_api/webhook.py,sha256=1ncwO0rIZcj-Df9sxSnFEzd1gP1bfS4okeZQS8NSRoE,1382
-langgraph_api/worker.py,sha256=zlkk2yg1tOBQHYwN-WHjc9NJgd3CAvsl8ET0-7tqQIk,9838
+langgraph_api/worker.py,sha256=CLmohk3B03OTsKHq_ZPhujMHFSuc694qeEL4VNSxHvg,12679
 langgraph_license/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langgraph_license/middleware.py,sha256=_ODIYzQkymr6W9_Fp9wtf1kAQspnpsmr53xuzyF2GA0,612
 langgraph_license/validation.py,sha256=Uu_G8UGO_WTlLsBEY0gTVWjRR4czYGfw5YAD3HLZoj0,203
 langgraph_storage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langgraph_storage/checkpoint.py,sha256=Qq0y6vdh27qdF3h5nOLT5CcX9Rj2bcFqkVOMeCaGoK4,4036
-langgraph_storage/database.py,sha256=I0AgFeJ-NSTT34vxKxQBUf1z2syFP0S8QpKCqTixrzY,5652
-langgraph_storage/inmem_stream.py,sha256=8bxkILIuFpr7P7RQ37SQAxrpRKvmbHdRB_nbfFiomlk,3263
-langgraph_storage/ops.py,sha256=S0QHbnquEXvAM63NQMgqtyTjm-8nlq0pOvgJgFD38Z8,75312
-langgraph_storage/queue.py,sha256=UDgsUTtUMfBSRDrQ8Onis-FJO4n7KTsX6sdpbY8Hs0A,5055
+langgraph_storage/database.py,sha256=ys2glLtQaspfIY-_EgqEOT3b7a5WqBwuE_9I5VAh6FM,5821
+langgraph_storage/inmem_stream.py,sha256=LjJSAxsh_E0ywqEMzdWJk8Hy_Jn9oQByzycss-fANng,3264
+langgraph_storage/ops.py,sha256=6NxeirfuDAKghHc328zejnbTsijg6U80Rlt5rXTC2dc,75392
+langgraph_storage/queue.py,sha256=wyBcY1V_8zah0Z2e5hpovs_dsIPPPfUJQCly2rxFWvo,7039
 langgraph_storage/retry.py,sha256=XmldOP4e_H5s264CagJRVnQMDFcEJR_dldVR1Hm5XvM,763
 langgraph_storage/store.py,sha256=JB9jZ87GE19MVN9wgl3-esgR2eIkeipws9q6qsPWkgc,3399
 langgraph_storage/ttl_dict.py,sha256=FlpEY8EANeXWKo_G5nmIotPquABZGyIJyk6HD9u6vqY,1533
 logging.json,sha256=3RNjSADZmDq38eHePMm1CbP6qZ71AmpBtLwCmKU9Zgo,379
 openapi.json,sha256=-25y3NRQ88e_944UXo76Goa34HJhC7pj6I9tjYUwvuE,131492
-langgraph_api-0.0.38.dist-info/LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
-langgraph_api-0.0.38.dist-info/METADATA,sha256=kv_c0bBL9Vp6pM0NQOUv1uyruDkf5K67X74nSICrekw,4071
-langgraph_api-0.0.38.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-langgraph_api-0.0.38.dist-info/entry_points.txt,sha256=3EYLgj89DfzqJHHYGxPH4A_fEtClvlRbWRUHaXO7hj4,77
-langgraph_api-0.0.38.dist-info/RECORD,,
+langgraph_api-0.0.40.dist-info/LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
+langgraph_api-0.0.40.dist-info/METADATA,sha256=CsN_X-9ths2igUx9E7DdiRHbrqRUFgBa7TnlqHDjTC0,4167
+langgraph_api-0.0.40.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+langgraph_api-0.0.40.dist-info/entry_points.txt,sha256=3EYLgj89DfzqJHHYGxPH4A_fEtClvlRbWRUHaXO7hj4,77
+langgraph_api-0.0.40.dist-info/RECORD,,

{langgraph_api-0.0.38.dist-info → langgraph_api-0.0.40.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.9.0
+Generator: poetry-core 2.1.2
 Root-Is-Purelib: true
 Tag: py3-none-any

langgraph_storage/database.py

@@ -161,12 +161,12 @@ async def start_pool() -> None:
                 "\n  - Pulled updates that modified class definitions in a way that's incompatible with the cache"
                 "\n\nRemoving invalid cache data stored at path: .langgraph_api"
             )
-            os.remove(OPS_FILENAME)
-            os.remove(RETRY_COUNTER_FILENAME)
+            await asyncio.to_thread(os.remove, OPS_FILENAME)
+            await asyncio.to_thread(os.remove, RETRY_COUNTER_FILENAME)
         except Exception as e:
             logger.error("Failed to load cached data: %s", str(e))
-            os.remove(OPS_FILENAME)
-            os.remove(RETRY_COUNTER_FILENAME)
+            await asyncio.to_thread(os.remove, OPS_FILENAME)
+            await asyncio.to_thread(os.remove, RETRY_COUNTER_FILENAME)
     for k in ["runs", "threads", "assistants", "assistant_versions"]:
         if not GLOBAL_STORE.get(k):
             GLOBAL_STORE[k] = []
@@ -177,12 +177,12 @@ async def start_pool() -> None:
 
 
 async def stop_pool() -> None:
-    GLOBAL_STORE.close()
-    GLOBAL_RETRY_COUNTER.close()
+    await asyncio.to_thread(GLOBAL_STORE.close)
+    await asyncio.to_thread(GLOBAL_RETRY_COUNTER.close)
     from langgraph_storage.checkpoint import Checkpointer
     from langgraph_storage.store import STORE
 
-    STORE.close()
+    await asyncio.to_thread(STORE.close)
 
     async with Checkpointer():
         pass

langgraph_storage/inmem_stream.py

@@ -92,6 +92,7 @@ async def stop_stream() -> None:
     # Send 'done' message to all active queues before clearing
     for run_id in list(stream_manager.queues.keys()):
         control_message = Message(topic=f"run:{run_id}:control".encode(), data=b"done")
+
         for queue in stream_manager.queues[run_id]:
             try:
                 await queue.put(control_message)

langgraph_storage/ops.py

@@ -985,7 +985,9 @@ class Threads(Authenticated):
             ctx: Auth.types.BaseAuthContext | None = None,
         ) -> StateSnapshot:
             """Get state for a thread."""
-            checkpointer = Checkpointer(conn, unpack_hook=_msgpack_ext_hook_to_json)
+            checkpointer = await asyncio.to_thread(
+                Checkpointer, conn, unpack_hook=_msgpack_ext_hook_to_json
+            )
             thread_id = _ensure_uuid(config["configurable"]["thread_id"])
             # Auth will be applied here so no need to use filters downstream
             thread_iter = await Threads.get(conn, thread_id, ctx=ctx)
@@ -1206,8 +1208,8 @@ class Threads(Authenticated):
                 async with get_graph(
                     graph_id,
                     thread_config,
-                    checkpointer=Checkpointer(
-                        conn, unpack_hook=_msgpack_ext_hook_to_json
+                    checkpointer=await asyncio.to_thread(
+                        Checkpointer, conn, unpack_hook=_msgpack_ext_hook_to_json
                     ),
                 ) as graph:
                     # Convert before parameter if it's a string

langgraph_storage/queue.py

@@ -1,6 +1,9 @@
 import asyncio
+import os
 
 import structlog
+from blockbuster import BlockBuster
+from langsmith import env as ls_env
 
 from langgraph_api.config import (
     BG_JOB_HEARTBEAT,
@@ -27,6 +30,20 @@ async def queue():
     last_sweep_secs: int | None = None
     semaphore = asyncio.Semaphore(concurrency)
     WEBHOOKS: set[asyncio.Task] = set()
+    enable_blocking = os.getenv("LANGGRAPH_ALLOW_BLOCKING", "false").lower() == "true"
+
+    # raise exceptions when a blocking call is detected inside an async function
+    if enable_blocking:
+        bb = None
+        await logger.awarning(
+            "Heads up: You've set --allow-blocking, which allows synchronous blocking I/O operations."
+            " Be aware that blocking code in one run may tie up the shared event loop"
+            " and slow down ALL other server operations. For best performance, either convert blocking"
+            " code to async patterns or set BG_JOB_ISOLATED_LOOPS=true in production"
+            " to isolate each run in its own event loop."
+        )
+    else:
+        bb = _enable_blockbuster()
 
     def cleanup(task: asyncio.Task):
         WORKERS.remove(task)
@@ -120,6 +137,8 @@ async def queue():
                 semaphore.release()
                 await exit.aclose()
     finally:
+        if bb:
+            bb.deactivate()
         logger.info("Shutting down background workers")
         for task in WORKERS:
             task.cancel()
@@ -129,3 +148,28 @@ async def queue():
             asyncio.gather(*WORKERS, *WEBHOOKS, return_exceptions=True),
             SHUTDOWN_GRACE_PERIOD_SECS,
         )
+
+
+def _enable_blockbuster() -> BlockBuster:
+    ls_env.get_runtime_environment()  # this gets cached
+    bb = BlockBuster(excluded_modules=["logging"])
+    bb.activate()
+    # Note, we've cached this call in langsmith==0.3.21 so it shouldn't raise anyway
+    # but we don't want to raise teh minbound just for that.
+    for func in ["os.stat", "io.TextIOWrapper.read"]:
+        bb.functions[func].can_block_in("langsmith/client.py", "_default_retry_config")
+        # Only triggers in python 3.11 for getting subgraphs
+        # Will be unnecessary once we cache the assistant schemas
+        bb.functions[func].can_block_in(
+            "langgraph/pregel/utils.py", "get_function_nonlocals"
+        )
+    for module, func in [
+        ("uvicorn/lifespan/on.py", "startup"),
+        ("uvicorn/lifespan/on.py", "shutdown"),
+        ("ansitowin32.py", "write_plain_text"),
+        ("logging/__init__.py", "flush"),
+        ("logging/__init__.py", "emit"),
+    ]:
+        bb.functions["io.TextIOWrapper.write"].can_block_in(module, func)
+        bb.functions["io.BufferedWriter.write"].can_block_in(module, func)
+    return bb