langgraph-api 0.13.0.dev9__tar.gz → 0.13.0.dev10__tar.gz

{langgraph_api-0.13.0.dev9 → langgraph_api-0.13.0.dev10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langgraph-api
-Version: 0.13.0.dev9
+Version: 0.13.0.dev10
 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

langgraph_api-0.13.0.dev10/langgraph_api/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.13.0.dev10"

{langgraph_api-0.13.0.dev9 → langgraph_api-0.13.0.dev10}/langgraph_api/js/package.json

@@ -10,7 +10,7 @@
     "@hono/node-server": "^2.0.10",
     "@hono/zod-validator": "^0.9.0",
     "@langchain/core": "^1.2.3",
-    "@langchain/langgraph": "^1.4.8",
+    "@langchain/langgraph": "^1.4.9",
     "@langchain/langgraph-api": "^1.0.3",
     "@langchain/langgraph-checkpoint": "^1.1.3",
     "@langchain/langgraph-ui": "^1.4.3",

{langgraph_api-0.13.0.dev9 → langgraph_api-0.13.0.dev10}/langgraph_api/js/yarn.lock

@@ -325,7 +325,7 @@
   resolved "https://registry.yarnpkg.com/@langchain/langgraph-checkpoint/-/langgraph-checkpoint-1.1.3.tgz#891f2f9a2e96cf2ab0920f9240f9ad1e0a86a4ab"
   integrity sha512-wgzdQNeEsdw1e+4lvlj0tdq/RYR/k1vPin10g0ymGoehZDDgd9nvIllGXSXN4TFgF9sf5qQP/KTkOcLfeseIhA==
 
-"@langchain/langgraph-sdk@^1.5.4", "@langchain/langgraph-sdk@~1.9.26":
+"@langchain/langgraph-sdk@^1.5.4", "@langchain/langgraph-sdk@~1.9.28":
   version "1.9.28"
   resolved "https://registry.yarnpkg.com/@langchain/langgraph-sdk/-/langgraph-sdk-1.9.28.tgz#1664cc7b6f2c1509ddffecf17d805a26e70a7e1a"
   integrity sha512-4j3XuM0PvtmAbL8mPfBS99ez3+ytRfgbOpAR/nOeaejTRF3Q9dNw2QnaGLGng8wLPtGLoSj+SYgUOVxy9Bv9vg==
@@ -346,13 +346,13 @@
     esbuild-plugin-tailwindcss "^2.0.1"
     zod "^3.25.76 || ^4"
 
-"@langchain/langgraph@^1.4.8":
-  version "1.4.8"
-  resolved "https://registry.yarnpkg.com/@langchain/langgraph/-/langgraph-1.4.8.tgz#65ef5635b5554cd32f502a3808b92d8371998a99"
-  integrity sha512-DN1Np1XefdBEbp1qBKlt39cwoL743AAGpR5Ipja0gY2YbWvsoQnOTIrjnj/orSAhaUYsdTKS8VSWdFzsHZo6Ig==
+"@langchain/langgraph@^1.4.9":
+  version "1.4.9"
+  resolved "https://registry.yarnpkg.com/@langchain/langgraph/-/langgraph-1.4.9.tgz#8ec6f2ab1200f56dcf7b9e44d838c956b23b7a73"
+  integrity sha512-EvD9rS66Cya09y6rbMgD3Ir8miAkJQFo7FyJOPRPO736Kz3y5TeyeBDOS8ctff/jRc788bPijHx2NVFM79Qqig==
   dependencies:
     "@langchain/langgraph-checkpoint" "^1.1.3"
-    "@langchain/langgraph-sdk" "~1.9.26"
+    "@langchain/langgraph-sdk" "~1.9.28"
     "@langchain/protocol" "^0.0.18"
     "@standard-schema/spec" "1.1.0"
 
@@ -1451,7 +1451,15 @@ p-queue@6.6.2, p-queue@^6.6.2:
     eventemitter3 "^4.0.4"
     p-timeout "^3.2.0"
 
-p-queue@^9.0.1, p-queue@^9.3.1:
+p-queue@^9.0.1:
+  version "9.3.3"
+  resolved "https://registry.yarnpkg.com/p-queue/-/p-queue-9.3.3.tgz#c5e528c7eb361b7ba8eb5a9406902f7f2e75fc8f"
+  integrity sha512-NXAOdnEe5FsZJfT4oK84lE1Y5cFFdWlRuOo5tww8DyNMxyRXwn39fIkUtNLKppcPC+UYU/bXujNCUGDv01y7CA==
+  dependencies:
+    eventemitter3 "^5.0.4"
+    p-timeout "^7.0.0"
+
+p-queue@^9.3.1:
   version "9.3.1"
   resolved "https://registry.yarnpkg.com/p-queue/-/p-queue-9.3.1.tgz#f7bf8a4aef244150657fc7d2635a8a68bf1c304b"
   integrity sha512-POWdiIPmsUPGwb4FeQ4OBg46aqmcInSWe45CKDsGHiOBiVQM9chqfQTuqhuTzcg2Vz9faTI65at0KkVyVEiCHw==
@@ -1475,7 +1483,7 @@ p-timeout@^3.2.0:
 
 p-timeout@^7.0.0:
   version "7.0.1"
-  resolved "https://registry.npmjs.org/p-timeout/-/p-timeout-7.0.1.tgz"
+  resolved "https://registry.yarnpkg.com/p-timeout/-/p-timeout-7.0.1.tgz#95680a6aa693c530f14ac337b8bd32d4ec6ae4f0"
   integrity sha512-AxTM2wDGORHGEkPCt8yqxOTMgpfbEHqF51f/5fJCmwFC3C/zNcGT63SymH2ttOAaiIws2zVg4+izQCjrakcwHg==
 
 pathe@^2.0.3:

{langgraph_api-0.13.0.dev9 → langgraph_api-0.13.0.dev10}/langgraph_grpc_common/conversion/checkpoint.py

@@ -10,6 +10,7 @@ from langgraph.checkpoint.base import (
 )
 from langgraph.types import Send
 
+from langgraph_grpc_common.conversion._compat import TASKS
 from langgraph_grpc_common.conversion.config import (
     config_from_proto,
     config_from_proto_optional,
@@ -18,6 +19,7 @@ from langgraph_grpc_common.conversion.config import (
 from langgraph_grpc_common.conversion.struct import dict_from_raw_map, raw_map_from_dict
 from langgraph_grpc_common.conversion.value import (
     base_value_to_proto,
+    coerce_tasks_value,
     send_to_proto,
     value_from_proto,
     value_to_proto,
@@ -79,7 +81,27 @@ def checkpoint_to_proto(checkpoint: Checkpoint) -> engine_common_pb2.Checkpoint:
     # langgraph versions. update_state(values=..., as_node=None) on a thread
     # with no prior checkpoint produces None, which would crash extend().
     checkpoint_proto.updated_channels.extend(checkpoint.get("updated_channels") or ())
+    # Only TASKS is Send-aware. Other channels must stay on base_value_to_proto
+    # so user state that happens to hold a Command (or similar) still serializes.
+    # For TASKS we coerce JS `{lg_name: "Send", …}` dicts to real Send objects,
+    # then keep the historical encoding: single Send → Sends oneof, list/empty →
+    # msgpack. Routing empty TASKS through sends_to_proto would store `missing`
+    # instead of msgpack `[]` and break checkpoint compatibility snapshots.
     for k, v in checkpoint["channel_values"].items():
+        if k == TASKS:
+            v = coerce_tasks_value(v)
+            if isinstance(v, list):
+                for item in v:
+                    if not isinstance(item, Send):
+                        raise ValueError(
+                            "Task must be a list of Send objects."
+                            f" Got types={[type(x) for x in v]} values={v}",
+                        )
+            elif not isinstance(v, Send):
+                raise ValueError(
+                    "Task must be a Send object objects."
+                    f" Got type={type(v)} value={v}",
+                )
         if isinstance(v, Send):
             checkpoint_proto.channel_values[k].CopyFrom(
                 engine_common_pb2.ChannelValue(

{langgraph_api-0.13.0.dev9 → langgraph_api-0.13.0.dev10}/langgraph_grpc_common/conversion/value.py

@@ -57,26 +57,76 @@ def value_from_proto(value: engine_common_pb2.ChannelValue) -> Any:
     raise NotImplementedError(f"Unrecognized value kind: {value_kind}")
 
 
+def _send_timeout_unsupported_error(timeout: Any) -> ValueError:
+    return ValueError(
+        "Per-task Send timeouts are not supported. "
+        f"Omit timeout and retry. Got timeout={timeout!r}."
+    )
+
+
+def _coerce_send(value: Any) -> Any:
+    """Revive JS / JSON Send shapes into ``langgraph.types.Send``.
+
+    The JS sidecar checkpointers ``JSON.stringify`` ``Send`` instances, which
+    yields ``{lg_name: "Send", node, args, timeout?}``. Outbound Python→JS
+    helpers use ``{node, args}``, and the HTTP Command API uses
+    ``{node, input}``. Without revival, TASKS writes hit
+    ``isinstance(..., Send)`` and fail with HTTP 400.
+
+    ``timeout`` is rejected rather than accepted with changed semantics: the
+    gRPC ``Send`` protobuf only carries ``node`` and ``arg``, so a coerced
+    timeout would be dropped on ``sends_to_proto`` / ``value_from_proto``.
+    """
+    if isinstance(value, Send):
+        return value
+    if not isinstance(value, dict):
+        return value
+    node = value.get("node")
+    if not isinstance(node, str):
+        return value
+    if "arg" in value:
+        arg = value["arg"]
+    elif "args" in value:
+        arg = value["args"]
+    elif "input" in value:
+        arg = value["input"]
+    elif value.get("lg_name") == "Send":
+        arg = None
+    else:
+        return value
+    timeout = value.get("timeout")
+    if timeout is not None:
+        raise _send_timeout_unsupported_error(timeout)
+    return Send(node, arg)
+
+
+def coerce_tasks_value(value: Any) -> Any:
+    """Coerce JS/JSON Send shapes inside a TASKS channel value."""
+    if isinstance(value, list):
+        return [_coerce_send(v) for v in value]
+    return _coerce_send(value)
+
+
 def value_to_proto(
     channel_name: str | None, value: Any
 ) -> engine_common_pb2.ChannelValue:
     """Convert a Python value to a ChannelValue proto."""
     if channel_name == TASKS and value != MISSING:
-        if not isinstance(value, list):
-            if not isinstance(value, Send):
+        # Preserve empty TASKS as msgpack `[]` (not missing) for checkpoint
+        # blob compatibility with existing snapshots / Python savers.
+        if isinstance(value, list) and not value:
+            return base_value_to_proto([])
+        values = value if isinstance(value, list) else [value]
+        coerced: list[Send] = []
+        for v in values:
+            send = _coerce_send(v)
+            if not isinstance(send, Send):
                 raise ValueError(
                     "Task must be a Send object objects."
-                    f" Got type={type(value)} value={value}",
+                    f" Got type={type(v)} value={v}",
                 )
-            value = [value]
-        else:
-            for v in value:
-                if not isinstance(v, Send):
-                    raise ValueError(
-                        "Task must be a list of Send objects."
-                        f" Got types={[type(v) for v in value]} values={value}",
-                    )
-        return sends_to_proto(value)
+            coerced.append(send)
+        return sends_to_proto(coerced)
     if value == MISSING:
         return missing_to_proto()
     if isinstance(value, Command):
@@ -89,6 +139,9 @@ def value_to_proto(
 
 
 def send_to_proto(send: Send) -> engine_common_pb2.Send:
+    timeout = getattr(send, "timeout", None)
+    if timeout is not None:
+        raise _send_timeout_unsupported_error(timeout)
     encoding, ser_val = serde.get_serializer().dumps_typed(send.arg)
     return engine_common_pb2.Send(
         node=send.node,

langgraph_api-0.13.0.dev9/langgraph_api/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.13.0.dev9"