langgraph-api 0.0.31__py3-none-any.whl → 0.0.32__py3-none-any.whl

langgraph_api/api/assistants.py

@@ -87,7 +87,13 @@ def _graph_schemas(graph: Pregel) -> dict:
             f"Failed to get output schema for graph {graph.name} with error: `{str(e)}`"
         )
         output_schema = None
-    state_schema = _state_jsonschema(graph)
+    try:
+        state_schema = _state_jsonschema(graph)
+    except Exception as e:
+        logger.warning(
+            f"Failed to get state schema for graph {graph.name} with error: `{str(e)}`"
+        )
+        state_schema = None
     try:
         config_schema = _get_configurable_jsonschema(graph)
     except Exception as e:

langgraph_api/api/threads.py

@@ -28,12 +28,21 @@ async def create_thread(
     if thread_id := payload.get("thread_id"):
         validate_uuid(thread_id, "Invalid thread ID: must be a UUID")
     async with connect() as conn:
+        thread_id = thread_id or str(uuid4())
         iter = await Threads.put(
             conn,
-            thread_id or uuid4(),
+            thread_id,
             metadata=payload.get("metadata"),
             if_exists=payload.get("if_exists") or "raise",
         )
+
+        if supersteps := payload.get("supersteps"):
+            await Threads.State.bulk(
+                conn,
+                config={"configurable": {"thread_id": thread_id}},
+                supersteps=supersteps,
+            )
+
     return ApiResponse(await fetchone(iter, not_found_code=409))
 
 

langgraph_api/cli.py

@@ -129,6 +129,7 @@ def run_server(
     store: typing.Optional["StoreConfig"] = None,
     auth: AuthConfig | None = None,
     http: typing.Optional["HttpConfig"] = None,
+    studio_url: str | None = None,
     **kwargs: typing.Any,
 ):
     """Run the LangGraph API server."""
@@ -192,11 +193,11 @@ def run_server(
         ALLOW_PRIVATE_NETWORK="true",
         **(env_vars or {}),
     ):
-        studio_origin = _get_ls_origin() or "https://smith.langchain.com"
-        studio_url = f"{studio_origin}/studio/?baseUrl={local_url}"
+        studio_origin = studio_url or _get_ls_origin() or "https://smith.langchain.com"
+        full_studio_url = f"{studio_origin}/studio/?baseUrl={local_url}"
 
         def _open_browser():
-            nonlocal studio_origin, studio_url
+            nonlocal studio_origin, full_studio_url
             import time
             import urllib.request
             import webbrowser
@@ -218,7 +219,7 @@ def run_server(
                                 try:
                                     org_id = org_id_future.result(timeout=3.0)
                                     if org_id:
-                                        studio_url = f"{studio_origin}/studio/?baseUrl={local_url}&organizationId={org_id}"
+                                        full_studio_url = f"{studio_origin}/studio/?baseUrl={local_url}&organizationId={org_id}"
                                 except TimeoutError as e:
                                     thread_logger.debug(
                                         f"Failed to get organization ID: {str(e)}"
@@ -230,8 +231,8 @@ def run_server(
                                 thread_logger.info(
                                     "🎨 Opening Studio in your browser..."
                                 )
-                                thread_logger.info("URL: " + studio_url)
-                                webbrowser.open(studio_url)
+                                thread_logger.info("URL: " + full_studio_url)
+                                webbrowser.open(full_studio_url)
                                 return
                     except urllib.error.URLError:
                         pass
@@ -246,7 +247,7 @@ def run_server(
 ╩═╝┴ ┴┘└┘└─┘╚═╝┴└─┴ ┴┴  ┴ ┴
 
 - 🚀 API: \033[36m{local_url}\033[0m
-- 🎨 Studio UI: \033[36m{studio_url}\033[0m
+- 🎨 Studio UI: \033[36m{full_studio_url}\033[0m
 - 📚 API Docs: \033[36m{local_url}/docs\033[0m
 
 This in-memory server is designed for development and testing.

langgraph_api/command.py

@@ -0,0 +1,29 @@
+from langgraph.types import Command, Send
+
+from langgraph_api.schema import RunCommand
+
+
+def map_cmd(cmd: RunCommand) -> Command:
+    goto = cmd.get("goto")
+    if goto is not None and not isinstance(goto, list):
+        goto = [cmd.get("goto")]
+
+    update = cmd.get("update")
+    if isinstance(update, tuple | list) and all(
+        isinstance(t, tuple | list) and len(t) == 2 and isinstance(t[0], str)
+        for t in update
+    ):
+        update = [tuple(t) for t in update]
+
+    return Command(
+        update=update,
+        goto=(
+            [
+                it if isinstance(it, str) else Send(it["node"], it["input"])
+                for it in goto
+            ]
+            if goto
+            else None
+        ),
+        resume=cmd.get("resume"),
+    )

langgraph_api/js/remote.py

@@ -1,8 +1,10 @@
 import asyncio
+import logging
 import os
 import shutil
 import ssl
 from collections.abc import AsyncIterator
+from contextlib import AbstractContextManager
 from typing import Any, Literal
 
 import certifi
@@ -605,60 +607,79 @@ async def run_remote_checkpointer():
     await server.serve()
 
 
+class DisableHttpxLoggingContextManager(AbstractContextManager):
+    """
+    Disable HTTP/1.1 200 OK logs spamming stdout.
+    """
+
+    filter: logging.Filter
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        return "200 OK" not in record.getMessage()
+
+    def __enter__(self):
+        logging.getLogger("httpx").addFilter(self.filter)
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        logging.getLogger("httpx").removeFilter(self.filter)
+
+
 async def wait_until_js_ready():
-    async with (
-        httpx.AsyncClient(
-            base_url=f"http://localhost:{GRAPH_PORT}",
-            limits=httpx.Limits(max_connections=1),
-            transport=httpx.AsyncHTTPTransport(verify=SSL),
-        ) as graph_client,
-        httpx.AsyncClient(
-            base_url=f"http://localhost:{REMOTE_PORT}",
-            limits=httpx.Limits(max_connections=1),
-            transport=httpx.AsyncHTTPTransport(verify=SSL),
-        ) as checkpointer_client,
-    ):
-        attempt = 0
-        while not asyncio.current_task().cancelled():
+    with DisableHttpxLoggingContextManager():
+        async with (
+            httpx.AsyncClient(
+                base_url=f"http://localhost:{GRAPH_PORT}",
+                limits=httpx.Limits(max_connections=1),
+                transport=httpx.AsyncHTTPTransport(verify=SSL),
+            ) as graph_client,
+            httpx.AsyncClient(
+                base_url=f"http://localhost:{REMOTE_PORT}",
+                limits=httpx.Limits(max_connections=1),
+                transport=httpx.AsyncHTTPTransport(verify=SSL),
+            ) as checkpointer_client,
+        ):
+            attempt = 0
+            while not asyncio.current_task().cancelled():
+                try:
+                    res = await graph_client.get("/ok")
+                    res.raise_for_status()
+                    res = await checkpointer_client.get("/ok")
+                    res.raise_for_status()
+                    return
+                except httpx.HTTPError:
+                    if attempt > 240:
+                        raise
+                    else:
+                        attempt += 1
+                        await asyncio.sleep(0.5)
+
+
+async def js_healthcheck():
+    with DisableHttpxLoggingContextManager():
+        async with (
+            httpx.AsyncClient(
+                base_url=f"http://localhost:{GRAPH_PORT}",
+                limits=httpx.Limits(max_connections=1),
+                transport=httpx.AsyncHTTPTransport(verify=SSL),
+            ) as graph_client,
+            httpx.AsyncClient(
+                base_url=f"http://localhost:{REMOTE_PORT}",
+                limits=httpx.Limits(max_connections=1),
+                transport=httpx.AsyncHTTPTransport(verify=SSL),
+            ) as checkpointer_client,
+        ):
             try:
                 res = await graph_client.get("/ok")
                 res.raise_for_status()
                 res = await checkpointer_client.get("/ok")
                 res.raise_for_status()
-                return
-            except httpx.HTTPError:
-                if attempt > 240:
-                    raise
-                else:
-                    attempt += 1
-                    await asyncio.sleep(0.5)
-
-
-async def js_healthcheck():
-    async with (
-        httpx.AsyncClient(
-            base_url=f"http://localhost:{GRAPH_PORT}",
-            limits=httpx.Limits(max_connections=1),
-            transport=httpx.AsyncHTTPTransport(verify=SSL),
-        ) as graph_client,
-        httpx.AsyncClient(
-            base_url=f"http://localhost:{REMOTE_PORT}",
-            limits=httpx.Limits(max_connections=1),
-            transport=httpx.AsyncHTTPTransport(verify=SSL),
-        ) as checkpointer_client,
-    ):
-        try:
-            res = await graph_client.get("/ok")
-            res.raise_for_status()
-            res = await checkpointer_client.get("/ok")
-            res.raise_for_status()
-            return True
-        except httpx.HTTPError as exc:
-            logger.warning(
-                "JS healthcheck failed. Either the JS server is not running or the event loop is blocked by a CPU-intensive task.",
-                error=exc,
-            )
-            raise HTTPException(
-                status_code=500,
-                detail="JS healthcheck failed. Either the JS server is not running or the event loop is blocked by a CPU-intensive task.",
-            ) from exc
+                return True
+            except httpx.HTTPError as exc:
+                logger.warning(
+                    "JS healthcheck failed. Either the JS server is not running or the event loop is blocked by a CPU-intensive task.",
+                    error=exc,
+                )
+                raise HTTPException(
+                    status_code=500,
+                    detail="JS healthcheck failed. Either the JS server is not running or the event loop is blocked by a CPU-intensive task.",
+                ) from exc

langgraph_api/stream.py

@@ -19,15 +19,15 @@ from langgraph.errors import (
     InvalidUpdateError,
 )
 from langgraph.pregel.debug import CheckpointPayload, TaskResultPayload
-from langgraph.types import Command, Send
 from pydantic import ValidationError
 from pydantic.v1 import ValidationError as ValidationErrorLegacy
 
 from langgraph_api.asyncio import ValueEvent, wait_if_not_done
+from langgraph_api.command import map_cmd
 from langgraph_api.graph import get_graph
 from langgraph_api.js.base import BaseRemotePregel
 from langgraph_api.metadata import HOST, PLAN, incr_nodes
-from langgraph_api.schema import Run, RunCommand, StreamMode
+from langgraph_api.schema import Run, StreamMode
 from langgraph_api.serde import json_dumpb
 from langgraph_api.utils import AsyncConnectionProto
 from langgraph_storage.checkpoint import Checkpointer
@@ -70,32 +70,6 @@ def _preprocess_debug_checkpoint(payload: CheckpointPayload | None) -> dict[str,
     return payload
 
 
-def _map_cmd(cmd: RunCommand) -> Command:
-    goto = cmd.get("goto")
-    if goto is not None and not isinstance(goto, list):
-        goto = [cmd.get("goto")]
-
-    update = cmd.get("update")
-    if isinstance(update, tuple | list) and all(
-        isinstance(t, tuple | list) and len(t) == 2 and isinstance(t[0], str)
-        for t in update
-    ):
-        update = [tuple(t) for t in update]
-
-    return Command(
-        update=update,
-        goto=(
-            [
-                it if isinstance(it, str) else Send(it["node"], it["input"])
-                for it in goto
-            ]
-            if goto
-            else None
-        ),
-        resume=cmd.get("resume"),
-    )
-
-
 async def astream_state(
     stack: AsyncExitStack,
     conn: AsyncConnectionProto,
@@ -125,7 +99,7 @@ async def astream_state(
     )
     input = kwargs.pop("input")
     if cmd := kwargs.pop("command"):
-        input = _map_cmd(cmd)
+        input = map_cmd(cmd)
     stream_mode: list[StreamMode] = kwargs.pop("stream_mode")
     feedback_keys = kwargs.pop("feedback_keys", None)
     stream_modes_set: set[StreamMode] = set(stream_mode) - {"events"}

langgraph_api/validation.py

@@ -27,7 +27,18 @@ AssistantVersionChange = jsonschema_rs.validator_for(
     openapi["components"]["schemas"]["AssistantVersionChange"]
 )
 ThreadCreate = jsonschema_rs.validator_for(
-    openapi["components"]["schemas"]["ThreadCreate"]
+    {
+        **openapi["components"]["schemas"]["ThreadCreate"],
+        "components": {
+            "schemas": {
+                "ThreadSuperstepUpdate": openapi["components"]["schemas"][
+                    "ThreadSuperstepUpdate"
+                ],
+                "Command": openapi["components"]["schemas"]["Command"],
+                "Send": openapi["components"]["schemas"]["Send"],
+            }
+        },
+    }
 )
 ThreadPatch = jsonschema_rs.validator_for(
     openapi["components"]["schemas"]["ThreadPatch"]
@@ -42,6 +53,7 @@ ThreadStateUpdate = jsonschema_rs.validator_for(
         },
     }
 )
+
 ThreadStateCheckpointRequest = jsonschema_rs.validator_for(
     {
         **openapi["components"]["schemas"]["ThreadStateCheckpointRequest"],

{langgraph_api-0.0.31.dist-info → langgraph_api-0.0.32.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: langgraph-api
-Version: 0.0.31
+Version: 0.0.32
 Summary: 
 License: Elastic-2.0
 Author: Nuno Campos
@@ -16,7 +16,7 @@ Requires-Dist: jsonschema-rs (>=0.20.0,<0.30)
 Requires-Dist: langchain-core (>=0.2.38,<0.4.0)
 Requires-Dist: langgraph (>=0.2.56,<0.4.0)
 Requires-Dist: langgraph-checkpoint (>=2.0.21,<3.0)
-Requires-Dist: langgraph-sdk (>=0.1.57,<0.2.0)
+Requires-Dist: langgraph-sdk (>=0.1.58,<0.2.0)
 Requires-Dist: langsmith (>=0.1.63,<0.4.0)
 Requires-Dist: orjson (>=3.9.7)
 Requires-Dist: pyjwt (>=2.9.0,<3.0.0)

{langgraph_api-0.0.31.dist-info → langgraph_api-0.0.32.dist-info}/RECORD

@@ -1,12 +1,12 @@
 LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
 langgraph_api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langgraph_api/api/__init__.py,sha256=B2kHOBhKjBRdNiWPljYuJFxP__wYPCvgtgTaWYKZGTQ,5129
-langgraph_api/api/assistants.py,sha256=2HEIcxaOJJ4_JQ00TKT1ehx7DMbYCGpvhShK0ZiWsSE,14043
+langgraph_api/api/assistants.py,sha256=nU6tnbgdr_6Utlq0A9nw2a6xxpUM_DNuCFI42_Kcs_o,14233
 langgraph_api/api/meta.py,sha256=ifJ_Ki0Qf2DYbmY6OKlqKhLGxbt55gm0lEqH1A0cJbw,2790
 langgraph_api/api/openapi.py,sha256=f9gfmWN2AMKNUpLCpSgZuw_aeOF9jCXPdOtFT5PaTWM,10960
 langgraph_api/api/runs.py,sha256=_RWKtmjD89ALnTk56dwo2rJwEi2oghk2Tqp0l1aCcZg,16677
 langgraph_api/api/store.py,sha256=VzAJVOwO0IxosBB7km5TTf2rhlWGyPkVz_LpvbxetVY,5437
-langgraph_api/api/threads.py,sha256=taU61XPcCEhBPCYPZcMDsgVDwwWUWJs8p-PrXFXWY48,8661
+langgraph_api/api/threads.py,sha256=meaDGF3R2bYkx0KRa_le4Ka5nOSeqlMDWtLdnEhVYSY,8930
 langgraph_api/api/ui.py,sha256=LiOZVewKOPbKEykCm30hCEaOA7vuS_Ti5hB32EEy4vw,2082
 langgraph_api/asyncio.py,sha256=ipxOGL0CuKZeHw8895ojtfoBU2fj0iJOp48uhiLAmss,7786
 langgraph_api/auth/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -17,7 +17,8 @@ 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=3SAwPv8EDKqJx52oD3CB3h0vN7m-LI3lT0RmYFMfkNM,11671
+langgraph_api/cli.py,sha256=zzlGrMgiRXITuvztQ12y26ljOgEXk93Vq2quKYhbaD8,11750
+langgraph_api/command.py,sha256=3O9v3i0OPa96ARyJ_oJbLXkfO8rPgDhLCswgO9koTFA,768
 langgraph_api/config.py,sha256=XMJEVfPe1LrmVKGM5sisQs1eZOUDyU3JwscwJOm0q_k,8572
 langgraph_api/cron_scheduler.py,sha256=9yzbbGxzNgJdIg4ZT7yu2oTwT_wRuPxD1c2sbbd52xs,2630
 langgraph_api/errors.py,sha256=Bu_i5drgNTyJcLiyrwVE_6-XrSU50BHf9TDpttki9wQ,1690
@@ -30,7 +31,7 @@ langgraph_api/js/client.mts,sha256=2dptAX8fMowV9OC4DU4khjpZUgALBLVBTu3jTQbeUJY,2
 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=jUUgdskUbDR_tuhZFrJo4OewbndQ76joczBv-mZHG9k,22637
+langgraph_api/js/remote.py,sha256=g0H2x3W7kejxswhgZfFaljzl4Y7agMCnO5BdNVj1rDY,23474
 langgraph_api/js/schema.py,sha256=7idnv7URlYUdSNMBXQcw7E4SxaPxCq_Oxwnlml8q5ik,408
 langgraph_api/js/src/graph.mts,sha256=mRyMUp03Fwd5DlmNIFl3RiUCQuJ5XwmFp1AfAeKDfVc,3169
 langgraph_api/js/src/hooks.mjs,sha256=XtktgmIHlls_DsknAuwib-z7TqCm0haRoTXvnkgzMuo,601
@@ -74,9 +75,9 @@ langgraph_api/serde.py,sha256=VoJ7Z1IuqrQGXFzEP1qijAITtWCrmjtVqlCRuScjXJI,3533
 langgraph_api/server.py,sha256=CiNK327zTsEpoVGeJK1JOtZHvOBYRoz0CnBTZUmsC7c,4567
 langgraph_api/sse.py,sha256=2wNodCOP2eg7a9mpSu0S3FQ0CHk2BBV_vv0UtIgJIcc,4034
 langgraph_api/state.py,sha256=8jx4IoTCOjTJuwzuXJKKFwo1VseHjNnw_CCq4x1SW14,2284
-langgraph_api/stream.py,sha256=LKXxol0y9xEsrgnbsDwyeKIPBDE-75uVz01OcLI-_QE,11976
+langgraph_api/stream.py,sha256=AgDjVxE8Tf3_TAB5td36mVy7_-9OwKcZJpHRWJdVCSM,11281
 langgraph_api/utils.py,sha256=92mSti9GfGdMRRWyESKQW5yV-75Z9icGHnIrBYvdypU,3619
-langgraph_api/validation.py,sha256=McizHlz-Ez8Jhdbc79mbPSde7GIuf2Jlbjx2yv_l6dA,4475
+langgraph_api/validation.py,sha256=LnEdfgID2Z0HP75R_hqWxCn5d5ULGcDJ3r1xaDVv6-w,4845
 langgraph_api/webhook.py,sha256=1ncwO0rIZcj-Df9sxSnFEzd1gP1bfS4okeZQS8NSRoE,1382
 langgraph_api/worker.py,sha256=7yQfZBANt1kgJDOEs5B5c3Xy65lzNMmngVbBqLs-r5s,9802
 langgraph_license/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -86,15 +87,15 @@ langgraph_storage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU
 langgraph_storage/checkpoint.py,sha256=V4t2GwYEJdPCHbhq_4Udhlv0TWKDzlMu_rlNPdTDc50,3589
 langgraph_storage/database.py,sha256=I0AgFeJ-NSTT34vxKxQBUf1z2syFP0S8QpKCqTixrzY,5652
 langgraph_storage/inmem_stream.py,sha256=8bxkILIuFpr7P7RQ37SQAxrpRKvmbHdRB_nbfFiomlk,3263
-langgraph_storage/ops.py,sha256=6qj3zh3T7KZco_vz9FW1cI82sbrefo6u2BRmrUDXvZI,69529
+langgraph_storage/ops.py,sha256=0DhtDQllBnV495DPrwhbR_bQUg7ZrGBe0FxSZcicz5g,72469
 langgraph_storage/queue.py,sha256=UDgsUTtUMfBSRDrQ8Onis-FJO4n7KTsX6sdpbY8Hs0A,5055
 langgraph_storage/retry.py,sha256=XmldOP4e_H5s264CagJRVnQMDFcEJR_dldVR1Hm5XvM,763
 langgraph_storage/store.py,sha256=33-J5-Xvobb9ArSa-GezP5KtfXgzWkHUHPyjRYmdw-E,2985
 langgraph_storage/ttl_dict.py,sha256=FlpEY8EANeXWKo_G5nmIotPquABZGyIJyk6HD9u6vqY,1533
 logging.json,sha256=3RNjSADZmDq38eHePMm1CbP6qZ71AmpBtLwCmKU9Zgo,379
-openapi.json,sha256=8NhoZn3Dse6Ia0i7fXCB46sdGnEg5qAhov_8of-6m0o,125282
-langgraph_api-0.0.31.dist-info/LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
-langgraph_api-0.0.31.dist-info/METADATA,sha256=lSR24lckxz9BgmrjjqG7b04Q22m5m1W49dHtggG6BeY,4027
-langgraph_api-0.0.31.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-langgraph_api-0.0.31.dist-info/entry_points.txt,sha256=3EYLgj89DfzqJHHYGxPH4A_fEtClvlRbWRUHaXO7hj4,77
-langgraph_api-0.0.31.dist-info/RECORD,,
+openapi.json,sha256=6okfuwPAKB2Hi1tup-EFza49pmN_iD2Yt5JktMALcq4,127984
+langgraph_api-0.0.32.dist-info/LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
+langgraph_api-0.0.32.dist-info/METADATA,sha256=LrWNwNTUVge4rKtDDFwJyFKdE5WRTPCLPj8MjSHsDvc,4027
+langgraph_api-0.0.32.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+langgraph_api-0.0.32.dist-info/entry_points.txt,sha256=3EYLgj89DfzqJHHYGxPH4A_fEtClvlRbWRUHaXO7hj4,77
+langgraph_api-0.0.32.dist-info/RECORD,,

langgraph_storage/ops.py

@@ -22,6 +22,7 @@ from starlette.exceptions import HTTPException
 
 from langgraph_api.asyncio import SimpleTaskGroup, ValueEvent, create_task
 from langgraph_api.auth.custom import handle_event
+from langgraph_api.command import map_cmd
 from langgraph_api.errors import UserInterrupt, UserRollback
 from langgraph_api.graph import get_graph
 from langgraph_api.schema import (
@@ -1081,6 +1082,78 @@ class Threads(Authenticated):
             else:
                 raise HTTPException(status_code=400, detail="Thread has no graph ID.")
 
+        @staticmethod
+        async def bulk(
+            conn: InMemConnectionProto,
+            *,
+            config: Config,
+            supersteps: Sequence[dict],
+            ctx: Auth.types.BaseAuthContext | None = None,
+        ) -> ThreadUpdateResponse:
+            """Update a thread with a batch of state updates."""
+
+            from langgraph.pregel.types import StateUpdate
+
+            thread_id = _ensure_uuid(config["configurable"]["thread_id"])
+            filters = await Threads.handle_event(
+                ctx,
+                "update",
+                Auth.types.ThreadsUpdate(thread_id=thread_id),
+            )
+
+            thread_iter = await Threads.get(conn, thread_id, ctx=ctx)
+            thread = await fetchone(
+                thread_iter, not_found_detail=f"Thread {thread_id} not found."
+            )
+
+            thread_config = thread["config"]
+            metadata = thread["metadata"]
+
+            if not thread:
+                raise HTTPException(status_code=404, detail="Thread not found")
+
+            if not _check_filter_match(metadata, filters):
+                raise HTTPException(status_code=403, detail="Forbidden")
+
+            if graph_id := metadata.get("graph_id"):
+                config["configurable"].setdefault("graph_id", graph_id)
+                config["configurable"].setdefault("checkpoint_ns", "")
+
+                async with get_graph(
+                    graph_id, thread_config, checkpointer=Checkpointer(conn)
+                ) as graph:
+                    next_config = await graph.abulk_update_state(
+                        config,
+                        [
+                            [
+                                StateUpdate(
+                                    map_cmd(update.get("command"))
+                                    if update.get("command")
+                                    else update.get("values"),
+                                    update.get("as_node"),
+                                )
+                                for update in superstep.get("updates", [])
+                            ]
+                            for superstep in supersteps
+                        ],
+                    )
+
+                    state = await Threads.State.get(
+                        conn, config, subgraphs=False, ctx=ctx
+                    )
+
+                    # update thread values
+                    for thread in conn.store["threads"]:
+                        if thread["thread_id"] == thread_id:
+                            thread["values"] = state.values
+                            break
+
+                    return ThreadUpdateResponse(
+                        checkpoint=next_config["configurable"],
+                    )
+            else:
+                raise HTTPException(status_code=400, detail="Thread has no graph ID")
+
         @staticmethod
         async def list(
             conn: InMemConnectionProto,
@@ -1905,7 +1978,8 @@ class Crons:
         conn: InMemConnectionProto,
         ctx: Auth.types.BaseAuthContext | None = None,
     ) -> AsyncIterator[Cron]:
-        raise NotImplementedError
+        yield
+        raise NotImplementedError("The in-mem server does not implement Crons.")
 
     @staticmethod
     async def set_next_run_date(

openapi.json

@@ -805,6 +805,58 @@
         }
       }
     },
+    "/threads/state/bulk": {
+      "post": {
+        "tags": [
+          "Threads"
+        ],
+        "summary": "Bulk Update Thread State",
+        "description": "Create a new thread from a batch of state updates.",
+        "operationId": "bulk_update_thread_state_post",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ThreadStateBulkUpdate"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Thread"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Conflict",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/threads/{thread_id}/state": {
       "get": {
         "tags": [
@@ -3906,6 +3958,19 @@
             "title": "If Exists",
             "description": "How to handle duplicate creation. Must be either 'raise' (raise error if duplicate), or 'do_nothing' (return existing thread).",
             "default": "raise"
+          },
+          "supersteps": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "updates": {
+                  "type": "array",
+                  "items": { "$ref": "#/components/schemas/ThreadSuperstepUpdate" }
+                }
+              },
+              "required": ["updates"]
+            }
           }
         },
         "type": "object",
@@ -4094,6 +4159,43 @@
         "title": "ThreadStateUpdate",
         "description": "Payload for updating the state of a thread."
       },
+      "ThreadSuperstepUpdate": {
+        "properties": {
+          "values": {
+            "anyOf": [
+              {
+                "type": "array",
+                "items": {
+                  "type": "object"
+                }
+              },
+              {
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "command": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/Command"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The command associated with the update."
+          },
+          "as_node": {
+            "type": "string",
+            "description": "Update the state as if this node had just executed."
+          }
+        },
+        "required": ["as_node"],
+        "type": "object"
+      },
       "ThreadStateUpdateResponse": {
         "properties": {
           "checkpoint": {