langgraph-api 0.4.40__py3-none-any.whl → 0.5.6__py3-none-any.whl

langgraph_api/metadata.py

@@ -2,6 +2,7 @@ import asyncio
 import os
 import uuid
 from datetime import UTC, datetime
+from typing import Any
 
 import langgraph.version
 import orjson
@@ -60,7 +61,7 @@ NODE_COUNTER = 0
 FROM_TIMESTAMP = datetime.now(UTC).isoformat()
 
 # Beacon endpoint for license key submissions
-BEACON_ENDPOINT = "https://api.smith.langchain.com/v1/metadata/submit"
+BEACON_ENDPOINT = "https://beacon.langchain.com/v1/beacon/metadata/submit"
 
 # LangChain auth endpoint for API key submissions
 LANGCHAIN_METADATA_ENDPOINT = None
@@ -123,6 +124,7 @@ async def metadata_loop() -> None:
         __version__ = None
     if not LANGGRAPH_CLOUD_LICENSE_KEY and not LANGSMITH_CONTROL_PLANE_API_KEY:
         return
+    lg_version = langgraph.version.__version__
 
     if (
         LANGGRAPH_CLOUD_LICENSE_KEY
@@ -135,6 +137,25 @@ async def metadata_loop() -> None:
     logger.info("Starting metadata loop")
 
     global RUN_COUNTER, NODE_COUNTER, FROM_TIMESTAMP
+    base_tags = _ensure_strings(
+        # Tag values must be strings.
+        {
+            "langgraph.python.version": lg_version,
+            "langgraph_api.version": __version__ or "",
+            "langgraph.platform.revision": REVISION or "",
+            "langgraph.platform.variant": VARIANT or "",
+            "langgraph.platform.host": HOST,
+            "langgraph.platform.tenant_id": TENANT_ID or "",
+            "langgraph.platform.project_id": PROJECT_ID or "",
+            "langgraph.platform.plan": PLAN,
+            # user app features
+            "user_app.uses_indexing": USES_INDEXING or "",
+            "user_app.uses_custom_app": USES_CUSTOM_APP or "",
+            "user_app.uses_custom_auth": USES_CUSTOM_AUTH or "",
+            "user_app.uses_thread_ttl": USES_THREAD_TTL or "",
+            "user_app.uses_store_ttl": USES_STORE_TTL or "",
+        }
+    )
     while True:
         # because we always read and write from coroutines in main thread
         # we don't need a lock as long as there's no awaits in this block
@@ -150,27 +171,10 @@ async def metadata_loop() -> None:
         base_payload = {
             "from_timestamp": from_timestamp,
             "to_timestamp": to_timestamp,
-            "tags": {
-                # Tag values must be strings.
-                "langgraph.python.version": langgraph.version.__version__,
-                "langgraph_api.version": __version__ or "",
-                "langgraph.platform.revision": REVISION or "",
-                "langgraph.platform.variant": VARIANT or "",
-                "langgraph.platform.host": HOST,
-                "langgraph.platform.tenant_id": TENANT_ID or "",
-                "langgraph.platform.project_id": PROJECT_ID or "",
-                "langgraph.platform.plan": PLAN,
-                # user app features
-                "user_app.uses_indexing": str(USES_INDEXING or ""),
-                "user_app.uses_custom_app": str(USES_CUSTOM_APP or ""),
-                "user_app.uses_custom_auth": str(USES_CUSTOM_AUTH),
-                "user_app.uses_thread_ttl": str(USES_THREAD_TTL),
-                "user_app.uses_store_ttl": str(USES_STORE_TTL),
-                **usage_tags,
-            },
+            "tags": base_tags | _ensure_strings(usage_tags),
             "measures": {
-                "langgraph.platform.runs": runs,
-                "langgraph.platform.nodes": nodes,
+                "langgraph.platform.runs": int(runs),
+                "langgraph.platform.nodes": int(nodes),
                 **usage_measures,
             },
             "logs": [],
@@ -238,3 +242,7 @@ async def metadata_loop() -> None:
             )
 
         await asyncio.sleep(INTERVAL)
+
+
+def _ensure_strings(payload: dict[str, Any]) -> dict[str, Any]:
+    return {k: "" if v is None else str(v) for k, v in payload.items()}

langgraph_api/queue_entrypoint.py

@@ -1,8 +1,6 @@
 # ruff: noqa: E402
 import os
 
-from langgraph_api.api.meta import METRICS_FORMATS
-
 if not (
     (disable_truststore := os.getenv("DISABLE_TRUSTSTORE"))
     and disable_truststore.lower() == "true"
@@ -45,6 +43,8 @@ async def health_and_metrics_server():
     from starlette.responses import JSONResponse, PlainTextResponse
     from starlette.routing import Route
 
+    from langgraph_api.api.meta import METRICS_FORMATS
+
     port = int(os.getenv("PORT", "8080"))
     host = os.getenv("LANGGRAPH_SERVER_HOST", "0.0.0.0")
 

langgraph_api/route.py

@@ -14,6 +14,7 @@ from starlette.responses import JSONResponse
 from starlette.routing import Route, compile_path, get_name
 from starlette.types import ASGIApp, Receive, Scope, Send
 
+from langgraph_api import config
 from langgraph_api.serde import json_dumpb
 from langgraph_api.utils import get_auth_ctx, with_user
 
@@ -58,10 +59,11 @@ class ApiResponse(JSONResponse):
 
 
 def _json_loads(content: bytearray, schema: SchemaType) -> typing.Any:
-    json = orjson.loads(content)
+    """Parse JSON and validate schema. Used by threadpool for large payloads."""
+    json_data = orjson.loads(content)
     if schema is not None:
-        schema.validate(json)
-    return json
+        schema.validate(json_data)
+    return json_data
 
 
 class ApiRequest(Request):
@@ -76,8 +78,16 @@ class ApiRequest(Request):
     async def json(self, schema: SchemaType = None) -> typing.Any:
         if not hasattr(self, "_json"):
             body = await self.body()
+
+            # Hybrid approach for optimal performance:
+            # - Small payloads: parse directly (fast, no queueing/thread pool limitations)
+            # - Large payloads: use dedicated thread pool (safer, doesn't block event loop)
             try:
-                self._json = await run_in_threadpool(_json_loads, body, schema)
+                self._json = (
+                    await run_in_threadpool(_json_loads, body, schema)
+                    if len(body) > config.JSON_THREAD_POOL_MINIMUM_SIZE_BYTES
+                    else _json_loads(body, schema)
+                )
             except orjson.JSONDecodeError as e:
                 raise HTTPException(
                     status_code=422, detail="Invalid JSON in request body"

langgraph_api/schema.py

@@ -249,8 +249,8 @@ class ThreadUpdateResponse(TypedDict):
 class QueueStats(TypedDict):
     n_pending: int
     n_running: int
-    max_age_secs: datetime | None
-    med_age_secs: datetime | None
+    pending_runs_wait_time_max_secs: float | None
+    pending_runs_wait_time_med_secs: float | None
 
 
 # Canonical field sets for select= validation and type aliases for ops

langgraph_api/self_hosted_metrics.py

@@ -109,6 +109,20 @@ def initialize_self_hosted_metrics():
             callbacks=[_get_running_runs_callback],
         )
 
+        meter.create_observable_gauge(
+            name="lg_api_pending_runs_wait_time_max",
+            description="The maximum time a run has been pending, in seconds",
+            unit="s",
+            callbacks=[_get_pending_runs_wait_time_max_callback],
+        )
+
+        meter.create_observable_gauge(
+            name="lg_api_pending_runs_wait_time_med",
+            description="The median pending wait time across runs, in seconds",
+            unit="s",
+            callbacks=[_get_pending_runs_wait_time_med_callback],
+        )
+
         if config.N_JOBS_PER_WORKER > 0:
             meter.create_observable_gauge(
                 name="lg_api_workers_max",
@@ -232,14 +246,24 @@ def _get_queue_stats():
                 return await Runs.stats(conn)
         except Exception as e:
             logger.warning("Failed to get queue stats from database", exc_info=e)
-            return {"n_pending": 0, "n_running": 0}
+            return {
+                "n_pending": 0,
+                "n_running": 0,
+                "pending_runs_wait_time_max_secs": 0,
+                "pending_runs_wait_time_med_secs": 0,
+            }
 
     try:
         future = lg_asyncio.run_coroutine_threadsafe(_fetch_queue_stats())
         return future.result(timeout=5)
     except Exception as e:
         logger.warning("Failed to get queue stats", exc_info=e)
-        return {"n_pending": 0, "n_running": 0}
+        return {
+            "n_pending": 0,
+            "n_running": 0,
+            "pending_runs_wait_time_max_secs": 0,
+            "pending_runs_wait_time_med_secs": 0,
+        }
 
 
 def _get_pool_stats():
@@ -280,6 +304,28 @@ def _get_running_runs_callback(options: CallbackOptions):
         return [Observation(0, attributes=_customer_attributes)]
 
 
+def _get_pending_runs_wait_time_max_callback(options: CallbackOptions):
+    try:
+        stats = _get_queue_stats()
+        value = stats.get("pending_runs_wait_time_max_secs")
+        value = 0 if value is None else value
+        return [Observation(value, attributes=_customer_attributes)]
+    except Exception as e:
+        logger.warning("Failed to get max pending wait time", exc_info=e)
+        return [Observation(0, attributes=_customer_attributes)]
+
+
+def _get_pending_runs_wait_time_med_callback(options: CallbackOptions):
+    try:
+        stats = _get_queue_stats()
+        value = stats.get("pending_runs_wait_time_med_secs")
+        value = 0 if value is None else value
+        return [Observation(value, attributes=_customer_attributes)]
+    except Exception as e:
+        logger.warning("Failed to get median pending wait time", exc_info=e)
+        return [Observation(0, attributes=_customer_attributes)]
+
+
 def _get_workers_max_callback(options: CallbackOptions):
     try:
         metrics_data = get_metrics()

langgraph_api/serde.py

@@ -3,7 +3,7 @@ import re
 import uuid
 from base64 import b64encode
 from collections import deque
-from collections.abc import Mapping
+from collections.abc import Callable, Mapping
 from datetime import timedelta, timezone
 from decimal import Decimal
 from ipaddress import (
@@ -16,7 +16,7 @@ from ipaddress import (
 )
 from pathlib import Path
 from re import Pattern
-from typing import Any, NamedTuple, cast
+from typing import Any, Literal, NamedTuple, cast
 from zoneinfo import ZoneInfo
 
 import cloudpickle
@@ -113,16 +113,24 @@ _option = orjson.OPT_SERIALIZE_NUMPY | orjson.OPT_NON_STR_KEYS
 _SURROGATE_RE = re.compile(r"[\ud800-\udfff]")
 
 
-def _strip_surr(s: str) -> str:
-    return s if _SURROGATE_RE.search(s) is None else _SURROGATE_RE.sub("", s)
+def _replace_surr(s: str) -> str:
+    return s if _SURROGATE_RE.search(s) is None else _SURROGATE_RE.sub("?", s)
 
 
 def _sanitise(o: Any) -> Any:
     if isinstance(o, str):
-        return _strip_surr(o)
+        return _replace_surr(o)
     if isinstance(o, Mapping):
         return {_sanitise(k): _sanitise(v) for k, v in o.items()}
     if isinstance(o, list | tuple | set):
+        if (
+            isinstance(o, tuple)
+            and hasattr(o, "_asdict")
+            and callable(o._asdict)
+            and hasattr(o, "_fields")
+            and isinstance(o._fields, tuple)
+        ):  # named tuple
+            return {f: _sanitise(ov) for f, ov in zip(o._fields, o, strict=True)}
         ctor = list if isinstance(o, list) else type(o)
         return ctor(_sanitise(x) for x in o)
     return o
@@ -158,18 +166,46 @@ async def ajson_loads(content: bytes | Fragment) -> Any:
 
 
 class Serializer(JsonPlusSerializer):
+    def __init__(
+        self,
+        __unpack_ext_hook__: Callable[[int, bytes], Any] | None = None,
+        pickle_fallback: bool | None = None,
+    ):
+        from langgraph_api.config import SERDE
+
+        allowed_json_modules: list[tuple[str, ...]] | Literal[True] | None = None
+        if SERDE and "allowed_json_modules" in SERDE:
+            allowed_ = SERDE["allowed_json_modules"]
+            if allowed_ is True:
+                allowed_json_modules = True
+            elif allowed_ is None:
+                allowed_json_modules = None
+            else:
+                allowed_json_modules = [tuple(x) for x in allowed_]
+        if pickle_fallback is None:
+            if SERDE and "pickle_fallback" in SERDE:
+                pickle_fallback = SERDE["pickle_fallback"]
+            else:
+                pickle_fallback = True
+
+        super().__init__(
+            allowed_json_modules=allowed_json_modules,
+            __unpack_ext_hook__=__unpack_ext_hook__,
+        )
+        self.pickle_fallback = pickle_fallback
+
     def dumps_typed(self, obj: Any) -> tuple[str, bytes]:
         try:
             return super().dumps_typed(obj)
         except TypeError:
             return "pickle", cloudpickle.dumps(obj)
 
-    def dumps(self, obj: Any) -> bytes:
-        # See comment above (in json_dumpb)
-        return super().dumps(obj).replace(rb"\\u0000", b"").replace(rb"\u0000", b"")
-
     def loads_typed(self, data: tuple[str, bytes]) -> Any:
         if data[0] == "pickle":
+            if not self.pickle_fallback:
+                raise ValueError(
+                    "Pickle fallback is disabled. Cannot deserialize pickled object."
+                )
             try:
                 return cloudpickle.loads(data[1])
             except Exception as e:
@@ -177,8 +213,16 @@ class Serializer(JsonPlusSerializer):
                     "Failed to unpickle object, replacing w None", exc_info=e
                 )
                 return None
-        return super().loads_typed(data)
-
-
-mpack_keys = {"method", "value"}
-SERIALIZER = Serializer()
+        try:
+            return super().loads_typed(data)
+        except Exception:
+            if data[0] == "json":
+                logger.exception(
+                    "Heads up! There was a deserialization error of an item stored using 'json'-type serialization."
+                    ' For security reasons, starting in langgraph-api version 0.5.0, we no longer serialize objects using the "json" type.'
+                    " If you would like to retain the ability to deserialize old checkpoints saved in this format, "
+                    'please set the "allowed_json_modules" option in your langgraph.json configuration to add the'
+                    " necessary module and type paths to an allow-list to be deserialized. You can alkso retain the"
+                    ' ability to insecurely deserialize custom types by setting it to "true".'
+                )
+            raise

langgraph_api/server.py

@@ -151,6 +151,9 @@ custom_middleware = (
 auth_before_custom_middleware = (
     config.HTTP_CONFIG and config.HTTP_CONFIG.get("middleware_order") == "auth_first"
 )
+enable_auth_on_custom_routes = config.HTTP_CONFIG and config.HTTP_CONFIG.get(
+    "enable_custom_route_auth"
+)
 # Custom middleware to be applied at the route/mount level, not globally (app level).
 route_level_custom_middleware = (
     custom_middleware if auth_before_custom_middleware else []
@@ -186,11 +189,22 @@ if user_router:
         #      custom middleware before *or* after authentication middleware,
         #      depending on the `middleware_order` config.
         user_app = apply_middleware(
-            routes=app.routes, middleware=route_level_custom_middleware
+            routes=app.routes,
+            middleware=(
+                middleware_for_protected_routes if enable_auth_on_custom_routes else []
+            )
+            + route_level_custom_middleware,
         )
         app.user_middleware = global_middleware
     else:
-        user_app = app.routes
+        user_app = (
+            apply_middleware(
+                routes=app.routes,
+                middleware=middleware_for_protected_routes,
+            )
+            if enable_auth_on_custom_routes
+            else app.routes
+        )
         app.user_middleware = custom_middleware + global_middleware
 
     app.router.routes = (

langgraph_api/worker.py

@@ -269,7 +269,7 @@ async def worker(
             elif isinstance(exception, TimeoutError):
                 status = "timeout"
                 await logger.awarning(
-                    "Background run timed out",
+                    "Background run timed out. To increase the timeout, set the BG_JOB_TIMEOUT_SECS environment variable (integer, defaults to 3600).",
                     **log_info,
                 )
                 if not temporary:

{langgraph_api-0.4.40.dist-info → langgraph_api-0.5.6.dist-info}/METADATA

@@ -1,21 +1,21 @@
 Metadata-Version: 2.4
 Name: langgraph-api
-Version: 0.4.40
-Author-email: Nuno Campos <nuno@langchain.dev>, Will Fu-Hinthorn <will@langchain.dev>
+Version: 0.5.6
+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
 Requires-Python: >=3.11
 Requires-Dist: cloudpickle>=3.0.0
 Requires-Dist: cryptography<45.0,>=42.0.0
-Requires-Dist: grpcio-tools<2.0.0,>=1.75.0
+Requires-Dist: grpcio-tools==1.75.1
 Requires-Dist: grpcio<2.0.0,>=1.75.0
 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.15.0,>=0.14.0
+Requires-Dist: langgraph-checkpoint<4,>=3.0.1
+Requires-Dist: langgraph-runtime-inmem<0.18.0,>=0.17.0
 Requires-Dist: langgraph-sdk>=0.2.0
-Requires-Dist: langgraph>=0.4.0
+Requires-Dist: langgraph<2,>=0.4.10
 Requires-Dist: langsmith>=0.3.45
 Requires-Dist: opentelemetry-api>=1.37.0
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.37.0

{langgraph_api-0.4.40.dist-info → langgraph_api-0.5.6.dist-info}/RECORD

@@ -1,27 +1,27 @@
-langgraph_api/__init__.py,sha256=pha_-Rd-dI-gM_t5o_SGFnaO84vxXW0uH3Bs10X8-DE,23
+langgraph_api/__init__.py,sha256=CMH34Gt1AqO7z_TqRj94XwohGoVCf8aes0djkqm45mk,22
 langgraph_api/asgi_transport.py,sha256=XtiLOu4WWsd-xizagBLzT5xUkxc9ZG9YqwvETBPjBFE,5161
 langgraph_api/asyncio.py,sha256=FEEkLm_N-15cbElo4vQ309MkDKBZuRqAYV8VJ1DocNw,9860
-langgraph_api/cli.py,sha256=Yl2GOChDChsoJcYAk8HhkuR1YKTy8rmbYlS5doqWBpk,19671
+langgraph_api/cli.py,sha256=aEI2pfztEEziIwUk2imiLkNVK1LapMp_3dxvcar1org,18341
 langgraph_api/command.py,sha256=Bh-rvuTLwdHCqFWryCjB1M8oWxPBwRBUjMNj_04KPxM,852
-langgraph_api/config.py,sha256=gO25XRPc19Room51P3FewE54pSFvfwuVDtvyjkDSzEs,13251
+langgraph_api/config.py,sha256=eWt3GhpW2CX7BIrensQCYGVXa-vXgVXiwWTd1hmJuqU,17144
 langgraph_api/cron_scheduler.py,sha256=25wYzEQrhPEivZrAPYOmzLPDOQa-aFogU37mTXc9TJk,2566
 langgraph_api/errors.py,sha256=zlnl3xXIwVG0oGNKKpXf1an9Rn_SBDHSyhe53hU6aLw,1858
 langgraph_api/executor_entrypoint.py,sha256=CaX813ygtf9CpOaBkfkQXJAHjFtmlScCkrOvTDmu4Aw,750
 langgraph_api/feature_flags.py,sha256=taZRhukeBV8r62EmEo92rxfBwYhIw56-P_UvSzQLzt8,576
-langgraph_api/graph.py,sha256=YDNncFFnjOjX_ylHDVY3Z4Ehj62zyHFJPaiRCkLAZus,25285
+langgraph_api/graph.py,sha256=e5_LHHxwJf5QuVgPv2POsrGAcSS4swHdVxz4IBV5p-c,25281
 langgraph_api/http.py,sha256=fyK-H-0UfNy_BzuVW3aWWGvhRavmGAVMkDwDArryJ_4,5659
 langgraph_api/http_metrics.py,sha256=vw3UT9uj9qgxQ_DwJq77HGZqh6LHSjyxylWhqkf2jAw,5095
 langgraph_api/http_metrics_utils.py,sha256=sjxF7SYGTzY0Wz_G0dzatsYNnWr31S6ujej4JmBG2yo,866
 langgraph_api/logging.py,sha256=o5iVARqtFYKIcRrK2nk1ymcKEiVYKd_dHmhXLF2khFI,6090
-langgraph_api/metadata.py,sha256=Z54bd-uf51qo3KR7_jxETbalp6vD9mWGe-UBeMw1AP4,8412
+langgraph_api/metadata.py,sha256=Ah5x5TB8O1VAypzDa1UTrsptS1hjy9z-PuNF8WYl3VM,8597
 langgraph_api/patch.py,sha256=J0MmcfpZG15SUVaVcI0Z4x_c0-0rbbT7Pwh9fDAQOpA,1566
-langgraph_api/queue_entrypoint.py,sha256=z3ZUBl3CpnMm0KFPqCuGvSohPAmYQbhAdyRizSJSClM,8481
-langgraph_api/route.py,sha256=EBhELuJ1He-ZYcAnR5YTImcIeDtWthDae5CHELBxPkM,5056
-langgraph_api/schema.py,sha256=spZ_XPT4AMJfw2YatsdnMZZLzgB9Sm3YR8n0SlgGdJ8,8480
+langgraph_api/queue_entrypoint.py,sha256=VtelUvo_WB1GplliLCetHeTjLC8DCVYQkqIhI8pL2fo,8485
+langgraph_api/route.py,sha256=wh2vMKksTpXJRQ_rLLrFXBSlG608fSMJguZATSWu0Y8,5593
+langgraph_api/schema.py,sha256=vqCw9OE6cerlEK1WH1xxtHfhi-unLH4Z8Z8G0S_wCb0,8512
 langgraph_api/self_hosted_logs.py,sha256=9ljOz3KH3O1SwsD7eTKnreyJ80NbeR7nj7SuxBlrmCc,4422
-langgraph_api/self_hosted_metrics.py,sha256=3FFezxjU0Vs-bsH39f4Dcwn7fporTLHV9REQ3UQ315A,14004
-langgraph_api/serde.py,sha256=Jkww6ixP5o2YZmnXtM7ihuAYC6YSuNDNPvE-8ILoqVo,5499
-langgraph_api/server.py,sha256=h4qeDzcEYF8NFCrTkpL1gsXXFbd7P2JN_wVpmy1Fgwg,9658
+langgraph_api/self_hosted_metrics.py,sha256=u1HstgccqJbtUEwTle-89CS9T2rbHv86lA0OBknxnNQ,15760
+langgraph_api/serde.py,sha256=iFq_7CI7OHvUdVKx19MxJvYeorAqaDBRSu8KvzywnVY,7663
+langgraph_api/server.py,sha256=PExNHgem0tY_KkRFiFzj8m8Np6TrP4M0XJsEw6O2SAU,10112
 langgraph_api/sse.py,sha256=SLdtZmTdh5D8fbWrQjuY9HYLd2dg8Rmi6ZMmFMVc2iE,4204
 langgraph_api/state.py,sha256=AjkLbUQakIwK7oGzJ8oqubazRsXxG3vDMnRa0s0mzDM,4716
 langgraph_api/store.py,sha256=NIoNZojs6NbtG3VLBPQEFNttvp7XPkHAfjbQ3gY7aLY,4701
@@ -30,50 +30,54 @@ langgraph_api/thread_ttl.py,sha256=KyHnvD0e1p1cV4Z_ZvKNVzDztuI2RBCUsUO2V7GlOSw,1
 langgraph_api/traceblock.py,sha256=Qq5CUdefnMDaRDnyvBSWGBClEj-f3oO7NbH6fedxOSE,630
 langgraph_api/validation.py,sha256=-ZJy-HY3Qs6dJ4J67m1eDhIF0oA-P57VrsUXl0Vy-Bc,5381
 langgraph_api/webhook.py,sha256=SvSM1rdnNtiH4q3JQYmAqJUk2Sable5xAcwOLuRhtlo,1723
-langgraph_api/worker.py,sha256=HHgf590xElF7v02lgn0lG0iK2v2sENMjdx7TVFCvYXY,15399
+langgraph_api/worker.py,sha256=DAEFhnlSV_2N91JiSd6QmnDCEKe5gYXc7s6v3sa3RTA,15503
 langgraph_api/api/__init__.py,sha256=wrnxz_204b2Vhv4-N0WpiPf-ZpDDlmIQkbh-TiXPnOo,5997
 langgraph_api/api/a2a.py,sha256=HIHZkLnIcM1u1FJti-L2NH-h1I9BZ_d-QW9z3gFonn8,53995
-langgraph_api/api/assistants.py,sha256=tRJse7Gr2BTeTZPljL05UvGkFiULpA-6hy03nBx9PF4,18177
+langgraph_api/api/assistants.py,sha256=4JRZGImv1hnuQu26RdH1GTkU_UV169xjGSSKCmv67fY,17977
 langgraph_api/api/mcp.py,sha256=qe10ZRMN3f-Hli-9TI8nbQyWvMeBb72YB1PZVbyqBQw,14418
-langgraph_api/api/meta.py,sha256=_jG61UKs0J_alsCDgIwCAx1rX5pYuUwKrmOEpWnzR1I,4817
+langgraph_api/api/meta.py,sha256=EMT2wzn4O45GmG8J3uI3e0ef20Kaio3k2TRwzKTM5IE,5610
 langgraph_api/api/openapi.py,sha256=If-z1ckXt-Yu5bwQytK1LWyX_T7G46UtLfixgEP8hwc,11959
 langgraph_api/api/runs.py,sha256=keHlFu1iy-l1IICJHc6AKrSUoQA-LZi6FYsja7la9Xw,25436
 langgraph_api/api/store.py,sha256=xGcPFx4v-VxlK6HRU9uCjzCQ0v66cvc3o_PB5_g7n0Q,5550
-langgraph_api/api/threads.py,sha256=5-ZEcs48bL3vot_yCt3ImuA9hzg93LxuAd_DXd2xj4Y,12915
+langgraph_api/api/threads.py,sha256=16YkaHN_bZ131lenPFNqtKswTiXXg-IpP0AHp0_zHzc,13116
 langgraph_api/api/ui.py,sha256=_genglTUy5BMHlL0lkQypX524yFv6Z5fraIvnrxp7yE,2639
 langgraph_api/auth/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langgraph_api/auth/custom.py,sha256=psETw_GpLWClBbd_ESVPRLUz9GLQ0_XNsuUDSVbtZy0,22522
+langgraph_api/auth/custom.py,sha256=JzKS1x3iNqSyL9rC1QeaMycP3d04zuXsTdVbXM668uw,22849
 langgraph_api/auth/middleware.py,sha256=jDA4t41DUoAArEY_PNoXesIUBJ0nGhh85QzRdn5EPD0,1916
 langgraph_api/auth/noop.py,sha256=Bk6Nf3p8D_iMVy_OyfPlyiJp_aEwzL-sHrbxoXpCbac,586
 langgraph_api/auth/studio_user.py,sha256=fojJpexdIZYI1w3awiqOLSwMUiK_M_3p4mlfQI0o-BE,454
 langgraph_api/auth/langsmith/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langgraph_api/auth/langsmith/backend.py,sha256=JVf8-q1IvB5EeiLJge3cOtPvDg6qHzK_4cR-R8hPXXQ,3753
 langgraph_api/auth/langsmith/client.py,sha256=79kwCVeHU64nsHsxWipfZhf44lM6vfs2nlfTxlJF6LU,4142
-langgraph_api/grpc_ops/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langgraph_api/grpc_ops/client.py,sha256=VB740C9QMhJJrpAEjsADmasN-uGd0apGYtuv_ho0Rl8,2452
-langgraph_api/grpc_ops/ops.py,sha256=VFmFIgXZmE3Xi1tGx-eZrqls6qMG0w5a2Ym7w2Wm9Iw,19733
-langgraph_api/grpc_ops/generated/__init__.py,sha256=dRiB_iGscPKdMpuLp9ueLwAmIfRaNjNXC64ABtb4cg8,135
-langgraph_api/grpc_ops/generated/core_api_pb2.py,sha256=fY01nY_MwlujYiyZcNMvR2DGEnyIkYbZ59p6mNjQKZE,42149
-langgraph_api/grpc_ops/generated/core_api_pb2.pyi,sha256=-vJ6C020K9Kt44mH7-S9sy0QBLMXJsyB3T9AKIH1s4g,49184
-langgraph_api/grpc_ops/generated/core_api_pb2_grpc.py,sha256=Qav2DuCMUSmR8nP4-fVtUBbY0Vc42jqjCs3L4LdIl-0,52467
+langgraph_api/grpc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langgraph_api/grpc/client.py,sha256=Qr07JVaJrMr3jWQKFHngyC3gqsj-VNLzahbnpj1vDO8,5753
+langgraph_api/grpc/config_conversion.py,sha256=IYQdA6atMFNyMXMpCnYrTUkT4Er4YdrS-LOSw8qgVcg,7560
+langgraph_api/grpc/ops.py,sha256=7_Pp__lq3bpBU2McMtg7-Pv6881igvHfCys4Eg48YDc,32922
+langgraph_api/grpc/generated/__init__.py,sha256=dRiB_iGscPKdMpuLp9ueLwAmIfRaNjNXC64ABtb4cg8,135
+langgraph_api/grpc/generated/core_api_pb2.py,sha256=3NwuQd9_BvXE8sfoDR7iUwWs8V4QChGugbeVL7h9pGk,42064
+langgraph_api/grpc/generated/core_api_pb2.pyi,sha256=nNg9_t8N6dvfUJ-l45vUPxgGpN1AcUZTUYJoqFP-7Tg,49507
+langgraph_api/grpc/generated/core_api_pb2_grpc.py,sha256=Qav2DuCMUSmR8nP4-fVtUBbY0Vc42jqjCs3L4LdIl-0,52467
+langgraph_api/grpc/generated/engine_common_pb2.py,sha256=NlwfuIO7nz27hfN1Oba-7k8GVoJX8VqM7-Jlk3j4oNE,24531
+langgraph_api/grpc/generated/engine_common_pb2.pyi,sha256=bsJumLkaYk3rtOwv5U7j4qquldd8zKONt5ew9x9MBgs,32805
+langgraph_api/grpc/generated/engine_common_pb2_grpc.py,sha256=ChVXQ2OvT6i5OsWWvS-Cn2ldyXDbaPP1LwWmZfU3ya8,894
 langgraph_api/js/.gitignore,sha256=l5yI6G_V6F1600I1IjiUKn87f4uYIrBAYU1MOyBBhg4,59
 langgraph_api/js/.prettierrc,sha256=0es3ovvyNIqIw81rPQsdt1zCQcOdBqyR_DMbFE4Ifms,19
 langgraph_api/js/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langgraph_api/js/base.py,sha256=CJihwc51MwOVkis80f8zudRa1fQz_5jrom4rY8trww8,1133
-langgraph_api/js/build.mts,sha256=wguMiExRjJYpnxol_IxNHuC65CnJFsasQhZiIVSZZq8,3377
-langgraph_api/js/client.http.mts,sha256=ZnikriJdcRSkBmUTBFMpLB3GKgK4xbiSqtUE-l9nqeM,4880
-langgraph_api/js/client.mts,sha256=gDvYiW7Qfl4re2YhZ5oNqtuvffnW_Sf7DK5aUbKB3vw,32330
+langgraph_api/js/build.mts,sha256=-LVN4xxh5tY0JvJFZKT8vE6uT-O4oXjQlgCp9NwmVnQ,3380
+langgraph_api/js/client.http.mts,sha256=FeVM53vduTPCyMPaYs__kmB3iWcz0k0om811DG0JvH0,4883
+langgraph_api/js/client.mts,sha256=8T5wp_114c2wGPfktY77StTnejhYL3ZWBmLwaUvp5XU,32333
 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=TLyPB9pZyZ1KQXC08NvbBbf8X5dKAF8WXc5cyjFtWZE,1335
+langgraph_api/js/package.json,sha256=V0QYOBlL7oHw2XOefDsoTJ8F1f6ApSQc-sU0JKixpf8,1330
 langgraph_api/js/remote.py,sha256=gBk273R7esmXg8aR6InxasNFc5E6Qju2bv2DhmmGJyU,38676
 langgraph_api/js/schema.py,sha256=M4fLtr50O1jck8H1hm_0W4cZOGYGdkrB7riLyCes4oY,438
 langgraph_api/js/sse.py,sha256=hHkbncnYnXNIbHhAWneGWYkHp4UhhhGB7-MYtDrY264,4141
 langgraph_api/js/traceblock.mts,sha256=QtGSN5VpzmGqDfbArrGXkMiONY94pMQ5CgzetT_bKYg,761
 langgraph_api/js/tsconfig.json,sha256=imCYqVnqFpaBoZPx8k1nO4slHIWBFsSlmCYhO73cpBs,341
 langgraph_api/js/ui.py,sha256=l9regrvKIxLOjH5SIYE2nhr8QCKLK1Q_1pZgxdL71X4,2488
-langgraph_api/js/yarn.lock,sha256=FCizZGxfI4SVoeAZWbezvonYBXsuvlWMUHX-1yACFz8,84352
-langgraph_api/js/src/graph.mts,sha256=9zTQNdtanI_CFnOwNRoamoCVHHQHGbNlbm91aRxDeOc,2675
+langgraph_api/js/yarn.lock,sha256=rgbpcHxgQ9jk3SkPAJiDsYKJKUcZ8M-43jO25AKzNj0,81970
+langgraph_api/js/src/graph.mts,sha256=etZd27NaoVevyitJ-LAUue0HeR7V3F2YNeSGwWHm13s,3417
 langgraph_api/js/src/load.hooks.mjs,sha256=xNVHq75W0Lk6MUKl1pQYrx-wtQ8_neiUyI6SO-k0ecM,2235
 langgraph_api/js/src/preload.mjs,sha256=8m3bYkf9iZLCQzKAYAdU8snxUwAG3dVLwGvAjfGfgIc,959
 langgraph_api/js/src/utils/files.mts,sha256=nU09Y8lN8SYsg0x2ffmbIW8LEDBl-SWkmxsoXunFU0M,219
@@ -110,8 +114,8 @@ langgraph_runtime/store.py,sha256=7mowndlsIroGHv3NpTSOZDJR0lCuaYMBoTnTrewjslw,11
 LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
 logging.json,sha256=3RNjSADZmDq38eHePMm1CbP6qZ71AmpBtLwCmKU9Zgo,379
 openapi.json,sha256=Oi2tU1b8PsXb-6XNHafQvcZv934vLNQhBNPYXr9e2nU,172620
-langgraph_api-0.4.40.dist-info/METADATA,sha256=jkZKHqP86HksHgYEeZRc-IZwhLeB1AOvLRlSv13eNYI,4156
-langgraph_api-0.4.40.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-langgraph_api-0.4.40.dist-info/entry_points.txt,sha256=hGedv8n7cgi41PypMfinwS_HfCwA7xJIfS0jAp8htV8,78
-langgraph_api-0.4.40.dist-info/licenses/LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
-langgraph_api-0.4.40.dist-info/RECORD,,
+langgraph_api-0.5.6.dist-info/METADATA,sha256=nfAnUIWvt7D3GyDrgbUdxIexl7LuvrjbpaXFLmBZOEg,4190
+langgraph_api-0.5.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+langgraph_api-0.5.6.dist-info/entry_points.txt,sha256=hGedv8n7cgi41PypMfinwS_HfCwA7xJIfS0jAp8htV8,78
+langgraph_api-0.5.6.dist-info/licenses/LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
+langgraph_api-0.5.6.dist-info/RECORD,,

langgraph_api/grpc_ops/client.py

@@ -1,80 +0,0 @@
-"""gRPC client wrapper for LangGraph persistence services."""
-
-import os
-
-import structlog
-from grpc import aio  # type: ignore[import]
-
-from .generated.core_api_pb2_grpc import AdminStub, AssistantsStub
-
-logger = structlog.stdlib.get_logger(__name__)
-
-
-class GrpcClient:
-    """gRPC client for LangGraph persistence services."""
-
-    def __init__(
-        self,
-        server_address: str | None = None,
-    ):
-        """Initialize the gRPC client.
-
-        Args:
-            server_address: The gRPC server address (default: localhost:50051)
-        """
-        self.server_address = server_address or os.getenv(
-            "GRPC_SERVER_ADDRESS", "localhost:50051"
-        )
-        self._channel: aio.Channel | None = None
-        self._assistants_stub: AssistantsStub | None = None
-        self._admin_stub: AdminStub | None = None
-
-    async def __aenter__(self):
-        """Async context manager entry."""
-        await self.connect()
-        return self
-
-    async def __aexit__(self, exc_type, exc_val, exc_tb):
-        """Async context manager exit."""
-        await self.close()
-
-    async def connect(self):
-        """Connect to the gRPC server."""
-        if self._channel is not None:
-            return
-
-        self._channel = aio.insecure_channel(self.server_address)
-
-        self._assistants_stub = AssistantsStub(self._channel)
-        self._admin_stub = AdminStub(self._channel)
-
-        await logger.adebug(
-            "Connected to gRPC server", server_address=self.server_address
-        )
-
-    async def close(self):
-        """Close the gRPC connection."""
-        if self._channel is not None:
-            await self._channel.close()
-            self._channel = None
-            self._assistants_stub = None
-            self._admin_stub = None
-            await logger.adebug("Closed gRPC connection")
-
-    @property
-    def assistants(self) -> AssistantsStub:
-        """Get the assistants service stub."""
-        if self._assistants_stub is None:
-            raise RuntimeError(
-                "Client not connected. Use async context manager or call connect() first."
-            )
-        return self._assistants_stub
-
-    @property
-    def admin(self) -> AdminStub:
-        """Get the admin service stub."""
-        if self._admin_stub is None:
-            raise RuntimeError(
-                "Client not connected. Use async context manager or call connect() first."
-            )
-        return self._admin_stub