langgraph-api 0.0.31__tar.gz → 0.0.32__tar.gz

{langgraph_api-0.0.31 → langgraph_api-0.0.32}/PKG-INFO

@@ -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 → langgraph_api-0.0.32}/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-0.0.31 → langgraph_api-0.0.32}/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-0.0.31 → langgraph_api-0.0.32}/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-0.0.32/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-0.0.31 → langgraph_api-0.0.32}/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-0.0.31 → langgraph_api-0.0.32}/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-0.0.31 → langgraph_api-0.0.32}/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 → langgraph_api-0.0.32}/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(

{langgraph_api-0.0.31 → langgraph_api-0.0.32}/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": {

{langgraph_api-0.0.31 → langgraph_api-0.0.32}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "langgraph-api"
-version = "0.0.31"
+version = "0.0.32"
 description = ""
 authors = [
     "Nuno Campos <nuno@langchain.dev>",
@@ -35,7 +35,7 @@ jsonschema-rs = ">=0.20.0,<0.30"
 structlog = ">=24.1.0,<26"
 pyjwt = "^2.9.0"
 cryptography = "^43.0.3"
-langgraph-sdk = "^0.1.57"
+langgraph-sdk = "^0.1.58"
 
 [tool.poetry.group.dev.dependencies]
 ruff = "^0.6.2"
@@ -48,7 +48,7 @@ pytest-repeat = "^0.9.3"
 pytest-retry = "^1.6.3"
 pytest-httpserver = "^1.1.0"
 fastapi = "^0.115.8"
-langgraph = ">=0.3.9"
+langgraph = ">=0.3.17"
 pycryptodome = "^3.22.0"
 
 [tool.pytest.ini_options]