langgraph-api 0.2.117__tar.gz → 0.2.123__tar.gz

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/Makefile

@@ -54,7 +54,7 @@ start:
 	LANGGRAPH_RUNTIME_EDITION=inmem \
 	LANGGRAPH_AES_KEY='$(LANGGRAPH_AES_KEY)' \
 	N_JOBS_PER_WORKER=2 \
-	LANGSERVE_GRAPHS='{"agent": "./tests/graphs/agent.py:graph", "single_node": "./tests/graphs/single_node.py:graph", "benchmark": "./tests/graphs/benchmark.py:graph", "other": "./tests/graphs/other.py:make_graph", "weather": "./tests/graphs/weather.py:mk_weather_graph", "searchy": "./tests/graphs/searchy.py:graph", "agent_simple": "./tests/graphs/agent_simple.py:graph", "simple_runtime": "./tests/graphs/simple_runtime.py:graph"}' \
+	LANGSERVE_GRAPHS='{"agent": "./tests/graphs/agent.py:graph", "custom_lifespan": "./tests/graphs/my_router.py:graph", "single_node": "./tests/graphs/single_node.py:graph", "benchmark": "./tests/graphs/benchmark.py:graph", "other": "./tests/graphs/other.py:make_graph", "weather": "./tests/graphs/weather.py:mk_weather_graph", "searchy": "./tests/graphs/searchy.py:graph", "agent_simple": "./tests/graphs/agent_simple.py:graph", "simple_runtime": "./tests/graphs/simple_runtime.py:graph"}' \
 	LANGGRAPH_STORE='$(STORE_CONFIG)' \
 	LANGGRAPH_CONFIG='{"agent": {"configurable": {"model_name": "openai"}}}' \
 	LANGSMITH_LANGGRAPH_API_VARIANT=test \

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langgraph-api
-Version: 0.2.117
+Version: 0.2.123
 Author-email: Nuno Campos <nuno@langchain.dev>, Will Fu-Hinthorn <will@langchain.dev>
 License: Elastic-2.0
 License-File: LICENSE
@@ -11,7 +11,7 @@ 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.7,>=0.6.8
+Requires-Dist: langgraph-runtime-inmem<0.7,>=0.6.9
 Requires-Dist: langgraph-sdk>=0.2.0
 Requires-Dist: langgraph>=0.4.0
 Requires-Dist: langsmith>=0.3.45

langgraph_api-0.2.123/langgraph_api/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.123"

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/langgraph_api/api/runs.py

@@ -117,7 +117,6 @@ async def stream_run(
             thread_id=thread_id,
             cancel_on_disconnect=on_disconnect == "cancel",
             stream_channel=await sub,
-            stream_mode=payload.get("stream_mode", []),
             last_event_id=None,
         ),
         headers={
@@ -159,7 +158,6 @@ async def stream_run_stateless(
             ignore_404=True,
             cancel_on_disconnect=on_disconnect == "cancel",
             stream_channel=await sub,
-            stream_mode=payload.get("stream_mode", []),
             last_event_id=None,
         ),
         headers={
@@ -203,7 +201,6 @@ async def wait_run(request: ApiRequest):
                 run["run_id"],
                 thread_id=run["thread_id"],
                 stream_channel=await sub,
-                stream_mode=["updates", "values", "error"],
                 cancel_on_disconnect=on_disconnect == "cancel",
             )
         ) as stream:
@@ -211,7 +208,6 @@ async def wait_run(request: ApiRequest):
                 if mode == b"values":
                     vchunk = chunk
                 elif mode == b"updates" and b"__interrupt__" in chunk:
-                    # Include the interrupt message in the values
                     vchunk = chunk
                 elif mode == b"error":
                     vchunk = orjson.dumps({"__error__": orjson.Fragment(chunk)})
@@ -287,7 +283,6 @@ async def wait_run_stateless(request: ApiRequest):
                 run["run_id"],
                 thread_id=run["thread_id"],
                 stream_channel=await sub,
-                stream_mode=["updates", "values", "error"],
                 ignore_404=True,
                 cancel_on_disconnect=on_disconnect == "cancel",
             )
@@ -296,7 +291,6 @@ async def wait_run_stateless(request: ApiRequest):
                 if mode == b"values":
                     vchunk = chunk
                 elif mode == b"updates" and b"__interrupt__" in chunk:
-                    # Include the interrupt message in the values
                     vchunk = chunk
                 elif mode == b"error":
                     vchunk = orjson.dumps({"__error__": orjson.Fragment(chunk)})

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/langgraph_api/api/ui.py

@@ -1,5 +1,6 @@
 import json
 import os
+import re
 
 from anyio import open_file
 from orjson import loads
@@ -58,6 +59,7 @@ async def handle_ui(request: ApiRequest) -> Response:
             return host.startswith(needle + ":") or host == needle
 
         protocol = "http:" if is_host("localhost") or is_host("127.0.0.1") else ""
+        valid_js_name = re.sub(r"[^a-zA-Z0-9]", "_", graph_id)
 
         if ext == ".css":
             result.append(
@@ -66,7 +68,7 @@ async def handle_ui(request: ApiRequest) -> Response:
         elif ext == ".js":
             result.append(
                 f'<script src="{protocol}//{host}/ui/{graph_id}/{basename}" '
-                f"onload='__LGUI_{graph_id}.render({json.dumps(message['name'])}, \"{{{{shadowRootId}}}}\")'>"
+                f"onload='__LGUI_{valid_js_name}.render({json.dumps(message['name'])}, \"{{{{shadowRootId}}}}\")'>"
                 "</script>"
             )
 

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/langgraph_api/js/client.mts

@@ -576,6 +576,8 @@ export class RemoteStore extends BaseStore {
 const StreamModeSchema = z.union([
   z.literal("updates"),
   z.literal("debug"),
+  z.literal("tasks"),
+  z.literal("checkpoints"),
   z.literal("values"),
   z.literal("custom"),
 ]);
@@ -654,7 +656,13 @@ async function* streamEventsRequest(
         : [payload.stream_mode];
 
   const graphStreamMode: Set<
-    "updates" | "debug" | "values" | "messages" | "custom"
+    | "updates"
+    | "debug"
+    | "values"
+    | "tasks"
+    | "checkpoints"
+    | "messages"
+    | "custom"
   > = new Set();
   if (payload.stream_mode) {
     for (const mode of userStreamMode) {

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/langgraph_api/js/package.json

@@ -9,11 +9,11 @@
   "dependencies": {
     "@hono/node-server": "^1.12.0",
     "@hono/zod-validator": "^0.2.2",
-    "@langchain/core": "^0.3.44",
+    "@langchain/core": "^0.3.59",
     "@langchain/langgraph": "^0.2.65",
-    "@langchain/langgraph-api": "~0.0.38",
+    "@langchain/langgraph-api": "~0.0.56",
+    "@langchain/langgraph-ui": "~0.0.56",
     "@langchain/langgraph-checkpoint": "~0.0.18",
-    "@langchain/langgraph-ui": "~0.0.38",
     "@types/json-schema": "^7.0.15",
     "@typescript/vfs": "^1.6.0",
     "dedent": "^1.5.3",
@@ -27,14 +27,14 @@
     "uuid": "^10.0.0",
     "vite": "^6.1.6",
     "winston": "^3.17.0",
-    "zod": "^3.23.8"
+    "zod": "^3.25.32"
   },
   "resolutions": {
     "esbuild": "^0.25.0",
     "vite": "^6.1.6"
   },
   "devDependencies": {
-    "@langchain/langgraph-sdk": "^0.0.84",
+    "@langchain/langgraph-sdk": "^0.0.104",
     "@types/node": "^22.2.0",
     "@types/react": "^19.0.8",
     "@types/react-dom": "^19.0.3",

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/langgraph_api/js/yarn.lock

@@ -185,40 +185,40 @@
   resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.0.tgz#3188bcb273a414b0d215fd22a58540b989b9409a"
   integrity sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==
 
-"@langchain/core@^0.3.44":
-  version "0.3.44"
-  resolved "https://registry.yarnpkg.com/@langchain/core/-/core-0.3.44.tgz#b449646ab31d0cefd3e9fa3ec02a0fb6a78f7ef6"
-  integrity sha512-3BsSFf7STvPPZyl2kMANgtVnCUvDdyP4k+koP+nY2Tczd5V+RFkuazIn/JOj/xxy/neZjr4PxFU4BFyF1aKXOA==
+"@langchain/core@^0.3.59":
+  version "0.3.66"
+  resolved "https://registry.yarnpkg.com/@langchain/core/-/core-0.3.66.tgz#cd20687f29a07148436cd8b72b88c66d076c500c"
+  integrity sha512-d3SgSDOlgOjdIbReIXVQl9HaQzKqO/5+E+o3kJwoKXLGP9dxi7+lMyaII7yv7G8/aUxMWLwFES9zc1jFoeJEZw==
   dependencies:
     "@cfworker/json-schema" "^4.0.2"
     ansi-styles "^5.0.0"
     camelcase "6"
     decamelize "1.2.0"
     js-tiktoken "^1.0.12"
-    langsmith ">=0.2.8 <0.4.0"
+    langsmith "^0.3.46"
     mustache "^4.2.0"
     p-queue "^6.6.2"
     p-retry "4"
     uuid "^10.0.0"
-    zod "^3.22.4"
+    zod "^3.25.32"
     zod-to-json-schema "^3.22.3"
 
-"@langchain/langgraph-api@~0.0.38":
-  version "0.0.38"
-  resolved "https://registry.yarnpkg.com/@langchain/langgraph-api/-/langgraph-api-0.0.38.tgz#dc456473c1538c2204cd1b6aa23308fa4a9b905f"
-  integrity sha512-pyWejPoCWbB8oT8yAcodUjzTQPgx1dUBbaDAX4hVBtODNaS9K+xKginQUTv9KAGBOF8DDlBoX9fBrhSNgvoKyA==
+"@langchain/langgraph-api@~0.0.56":
+  version "0.0.56"
+  resolved "https://registry.yarnpkg.com/@langchain/langgraph-api/-/langgraph-api-0.0.56.tgz#9e0a6e5dd9af2f6ec259a32ca9081b19457a0825"
+  integrity sha512-BhrbMKSc3f4CXXDXgvHR8mE2bsgD/G6dDzr+yDkEC7a9eeFI7C8bPhkGmegFJ+q7i6GWtqlQOYSCWHqQFZxynQ==
   dependencies:
     "@babel/code-frame" "^7.26.2"
     "@hono/node-server" "^1.12.0"
     "@hono/zod-validator" "^0.2.2"
-    "@langchain/langgraph-ui" "0.0.38"
+    "@langchain/langgraph-ui" "0.0.56"
     "@types/json-schema" "^7.0.15"
     "@typescript/vfs" "^1.6.0"
     dedent "^1.5.3"
     dotenv "^16.4.7"
     exit-hook "^4.0.0"
     hono "^4.5.4"
-    langsmith "^0.2.15"
+    langsmith "^0.3.33"
     open "^10.1.0"
     semver "^7.7.1"
     stacktrace-parser "^0.1.10"
@@ -236,10 +236,10 @@
   dependencies:
     uuid "^10.0.0"
 
-"@langchain/langgraph-sdk@^0.0.84":
-  version "0.0.84"
-  resolved "https://registry.yarnpkg.com/@langchain/langgraph-sdk/-/langgraph-sdk-0.0.84.tgz#91f1bb431838c0f945326755681dcf3465ca4962"
-  integrity sha512-l0PFQyJ+6m6aclORNPPWlcRwgKcXVXsPaJCbCUYFABR3yf4cOpsjhUNR0cJ7+2cS400oieHjGRdGGyO/hbSjhg==
+"@langchain/langgraph-sdk@^0.0.104":
+  version "0.0.104"
+  resolved "https://registry.yarnpkg.com/@langchain/langgraph-sdk/-/langgraph-sdk-0.0.104.tgz#1a7c4a56442f13094e288b068de1767de8f99d06"
+  integrity sha512-wUO6GMy65Y7DsWtjTJ3dA59enrZy2wN4o48AMYN7dF7u/PMXXYyBjBCKSzgVWqO6uWH2yNpyGDrcMwKuk5kQLA==
   dependencies:
     "@types/json-schema" "^7.0.15"
     p-queue "^6.6.2"
@@ -256,10 +256,10 @@
     p-retry "4"
     uuid "^9.0.0"
 
-"@langchain/langgraph-ui@0.0.38", "@langchain/langgraph-ui@~0.0.38":
-  version "0.0.38"
-  resolved "https://registry.yarnpkg.com/@langchain/langgraph-ui/-/langgraph-ui-0.0.38.tgz#52ba614af4093614855af84e6b847f32325e852b"
-  integrity sha512-0FwkMeoKFIMLaqhIjkDvs31+vDnauD94bgtK2d9hzC0Ze7khC5oar2s2+xwibScu2dFd7udafZ4Cxsk7Q+9mVw==
+"@langchain/langgraph-ui@0.0.56", "@langchain/langgraph-ui@~0.0.56":
+  version "0.0.56"
+  resolved "https://registry.yarnpkg.com/@langchain/langgraph-ui/-/langgraph-ui-0.0.56.tgz#b566afa4ad940fc6bd942205a00b3afac7fd7363"
+  integrity sha512-cRU+fMCz1NAOjRLcreNa64Gap89yio0p8baRigehtL1SNsXJEaZ2xdGjbnjaWIl8rTrriDak4oisx07whwcBjQ==
   dependencies:
     "@commander-js/extra-typings" "^13.0.0"
     commander "^13.0.0"
@@ -738,11 +738,6 @@ colorspace@1.1.x:
     color "^3.1.3"
     text-hex "1.0.x"
 
-commander@^10.0.1:
-  version "10.0.1"
-  resolved "https://registry.yarnpkg.com/commander/-/commander-10.0.1.tgz#881ee46b4f77d1c1dccc5823433aa39b022cbe06"
-  integrity sha512-y4Mg2tXshplEbSGzx7amzPwKKOCGuoSRP/CjEdwwk0FOGlUbq6lKuoyDZTNZkmxHdJtp54hdfY/JUrdL7Xfdug==
-
 commander@^13.0.0:
   version "13.1.0"
   resolved "https://registry.yarnpkg.com/commander/-/commander-13.1.0.tgz#776167db68c78f38dcce1f9b8d7b8b9a488abf46"
@@ -1060,10 +1055,10 @@ kuler@^2.0.0:
   resolved "https://registry.yarnpkg.com/kuler/-/kuler-2.0.0.tgz#e2c570a3800388fb44407e851531c1d670b061b3"
   integrity sha512-Xq9nH7KlWZmXAtodXDDRE7vs6DU1gTU8zYDHDiWLSip45Egwq3plLHzPn27NgvzL2r1LMPC1vdqh98sQxtqj4A==
 
-"langsmith@>=0.2.8 <0.4.0":
-  version "0.3.3"
-  resolved "https://registry.yarnpkg.com/langsmith/-/langsmith-0.3.3.tgz#fcb61454842cf2f85c937f536fa0729544c7c467"
-  integrity sha512-B9B0ThaPYwNdTg9ck6bWF2Mjd1TJvVKLfLedufIudmO8aPDslcc2uVlyPEtskZFEdmfjfVHEqDnhnuAhyifrZQ==
+langsmith@^0.3.33, langsmith@^0.3.46:
+  version "0.3.48"
+  resolved "https://registry.yarnpkg.com/langsmith/-/langsmith-0.3.48.tgz#32cdbe5e7e5ca73866ed3a38a654468bac034155"
+  integrity sha512-oEsj0Z8S2Chgb3vJzRX2vplLu4RWR1cpraIaVwv2PsNZ57VbHgZEdXdeh5kh16iP8PAv04JkBncP+KLRoKBFEw==
   dependencies:
     "@types/uuid" "^10.0.0"
     chalk "^4.1.2"
@@ -1073,18 +1068,6 @@ kuler@^2.0.0:
     semver "^7.6.3"
     uuid "^10.0.0"
 
-langsmith@^0.2.15:
-  version "0.2.15"
-  resolved "https://registry.yarnpkg.com/langsmith/-/langsmith-0.2.15.tgz#0692a00fc310817cb9b5939488468c93d4ba2c9d"
-  integrity sha512-homtJU41iitqIZVuuLW7iarCzD4f39KcfP9RTBWav9jifhrsDa1Ez89Ejr+4qi72iuBu8Y5xykchsGVgiEZ93w==
-  dependencies:
-    "@types/uuid" "^10.0.0"
-    commander "^10.0.1"
-    p-queue "^6.6.2"
-    p-retry "4"
-    semver "^7.6.3"
-    uuid "^10.0.0"
-
 lightningcss-darwin-arm64@1.29.2:
   version "1.29.2"
   resolved "https://registry.yarnpkg.com/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.29.2.tgz#6ceff38b01134af48e859394e1ca21e5d49faae6"
@@ -1743,7 +1726,7 @@ zod-to-json-schema@^3.22.3:
   resolved "https://registry.yarnpkg.com/zod-to-json-schema/-/zod-to-json-schema-3.23.5.tgz#ec23def47dcafe3a4d640eba6a346b34f9a693a5"
   integrity sha512-5wlSS0bXfF/BrL4jPAbz9da5hDlDptdEppYfe+x4eIJ7jioqKG9uUxOwPzqof09u/XeVdrgFu29lZi+8XNDJtA==
 
-zod@^3.22.4, zod@^3.23.8:
-  version "3.23.8"
-  resolved "https://registry.yarnpkg.com/zod/-/zod-3.23.8.tgz#e37b957b5d52079769fb8097099b592f0ef4067d"
-  integrity sha512-XBx9AXhXktjUqnepgTiE5flcKIYWi/rme0Eaj+5Y0lftuGBq+jyRu/md4WnuxqgP1ubdpNCsYEYPxrzVHD8d6g==
+zod@^3.23.8, zod@^3.25.32:
+  version "3.25.76"
+  resolved "https://registry.yarnpkg.com/zod/-/zod-3.25.76.tgz#26841c3f6fd22a6a2760e7ccb719179768471e34"
+  integrity sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/langgraph_api/queue_entrypoint.py

@@ -17,6 +17,7 @@ import logging.config
 import os
 import pathlib
 import signal
+from contextlib import asynccontextmanager
 
 import structlog
 import uvloop
@@ -94,11 +95,26 @@ async def health_and_metrics_server():
 
 async def entrypoint():
     from langgraph_api import logging as lg_logging
+    from langgraph_api.api import user_router
 
     lg_logging.set_logging_context({"entrypoint": "python-queue"})
     tasks: set[asyncio.Task] = set()
     tasks.add(asyncio.create_task(health_and_metrics_server()))
-    async with lifespan(None, with_cron_scheduler=False, taskset=tasks):
+
+    original_lifespan = user_router.router.lifespan_context if user_router else None
+
+    @asynccontextmanager
+    async def combined_lifespan(app, with_cron_scheduler=False, taskset=None):
+        async with lifespan(
+            app, with_cron_scheduler=with_cron_scheduler, taskset=taskset
+        ):
+            if original_lifespan:
+                async with original_lifespan(app):
+                    yield
+            else:
+                yield
+
+    async with combined_lifespan(None, with_cron_scheduler=False, taskset=tasks):
         await asyncio.gather(*tasks)
 
 

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/langgraph_api/schema.py

@@ -14,7 +14,9 @@ RunStatus = Literal["pending", "running", "error", "success", "timeout", "interr
 
 ThreadStatus = Literal["idle", "busy", "interrupted", "error"]
 
-StreamMode = Literal["values", "messages", "updates", "events", "debug", "custom"]
+StreamMode = Literal[
+    "values", "messages", "updates", "events", "debug", "tasks", "checkpoints", "custom"
+]
 
 MultitaskStrategy = Literal["reject", "rollback", "interrupt", "enqueue"]
 

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/langgraph_api/stream.py

@@ -229,16 +229,25 @@ async def astream_state(
                                 ),
                                 [message_chunk_to_message(messages[msg.id])],
                             )
-                    elif mode in stream_mode or (
+                    elif mode in stream_mode:
+                        if subgraphs and ns:
+                            yield f"{mode}|{'|'.join(ns)}", chunk
+                        else:
+                            yield mode, chunk
+                    elif (
                         mode == "updates"
                         and isinstance(chunk, dict)
                         and "__interrupt__" in chunk
+                        and len(chunk["__interrupt__"]) > 0
                         and only_interrupt_updates
                     ):
+                        # We always want to return interrupt events by default.
+                        # If updates aren't specified as a stream mode, we return these as values events.
+                        # If the interrupt doesn't have any actions (e.g. interrupt before or after a node is specified), we don't return the interrupt at all today.
                         if subgraphs and ns:
-                            yield f"{mode}|{'|'.join(ns)}", chunk
+                            yield f"values|{'|'.join(ns)}", chunk
                         else:
-                            yield mode, chunk
+                            yield "values", chunk
                     # --- end shared logic with astream ---
                 elif "events" in stream_mode:
                     yield "events", event
@@ -300,16 +309,25 @@ async def astream_state(
                             ),
                             [message_chunk_to_message(messages[msg.id])],
                         )
-                elif mode in stream_mode or (
+                elif mode in stream_mode:
+                    if subgraphs and ns:
+                        yield f"{mode}|{'|'.join(ns)}", chunk
+                    else:
+                        yield mode, chunk
+                elif (
                     mode == "updates"
                     and isinstance(chunk, dict)
                     and "__interrupt__" in chunk
+                    and len(chunk["__interrupt__"]) > 0
                     and only_interrupt_updates
                 ):
+                    # We always want to return interrupt events by default.
+                    # If updates aren't specified as a stream mode, we return these as values events.
+                    # If the interrupt doesn't have any actions (e.g. interrupt before or after a node is specified), we don't return the interrupt at all today.
                     if subgraphs and ns:
-                        yield f"{mode}|{'|'.join(ns)}", chunk
+                        yield "values|{'|'.join(ns)}", chunk
                     else:
-                        yield mode, chunk
+                        yield "values", chunk
                 # --- end shared logic with astream_events ---
     if is_remote_pregel:
         # increment the remote runs

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/langgraph_api/thread_ttl.py

@@ -29,6 +29,7 @@ async def thread_ttl_sweep_loop():
         strategy=strategy,
         interval_minutes=sweep_interval_minutes,
     )
+    loop = asyncio.get_running_loop()
 
     from langgraph_runtime.ops import Threads
 
@@ -36,12 +37,14 @@ async def thread_ttl_sweep_loop():
         await asyncio.sleep(sweep_interval_minutes * 60)
         try:
             async with connect() as conn:
+                sweep_start = loop.time()
                 threads_processed, threads_deleted = await Threads.sweep_ttl(conn)
                 if threads_processed > 0:
                     await logger.ainfo(
                         f"Thread TTL sweep completed. Processed {threads_processed}",
                         threads_processed=threads_processed,
                         threads_deleted=threads_deleted,
+                        duration=loop.time() - sweep_start,
                     )
         except Exception as exc:
             logger.exception("Thread TTL sweep iteration failed", exc_info=exc)

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/openapi.json

@@ -28,6 +28,14 @@
     {
       "name": "Store",
       "description": "Store is an API for managing persistent key-value store (long-term memory) that is available from any thread."
+    },
+    {
+      "name": "MCP",
+      "description": "Model Context Protocol related endpoints for exposing an agent as an MCP server."
+    },
+    {
+      "name": "System",
+      "description": "System endpoints for health checks, metrics, and server information."
     }
   ],
   "paths": {
@@ -2996,6 +3004,153 @@
           "MCP"
         ]
       }
+    },
+    "/info": {
+      "get": {
+        "tags": [
+          "System"
+        ],
+        "summary": "Server Information",
+        "description": "Get server version information, feature flags, and metadata.",
+        "operationId": "server_info_info_get",
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "version": {
+                      "type": "string",
+                      "title": "Version",
+                      "description": "LangGraph API version"
+                    },
+                    "langgraph_py_version": {
+                      "type": "string",
+                      "title": "LangGraph Python Version",
+                      "description": "LangGraph Python library version"
+                    },
+                    "flags": {
+                      "type": "object",
+                      "title": "Feature Flags",
+                      "description": "Enabled features and capabilities"
+                    },
+                    "metadata": {
+                      "type": "object",
+                      "title": "Metadata",
+                      "description": "Server deployment metadata"
+                    }
+                  },
+                  "required": ["version", "langgraph_py_version", "flags", "metadata"],
+                  "title": "ServerInfo"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/metrics": {
+      "get": {
+        "tags": [
+          "System"
+        ],
+        "summary": "System Metrics",
+        "description": "Get system metrics in Prometheus or JSON format for monitoring and observability.",
+        "operationId": "system_metrics_metrics_get",
+        "parameters": [
+          {
+            "name": "format",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": ["prometheus", "json"],
+              "default": "prometheus",
+              "title": "Output Format",
+              "description": "Response format: prometheus (default) or json"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "string",
+                  "title": "Prometheus Metrics",
+                  "description": "Metrics in Prometheus exposition format"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "title": "JSON Metrics",
+                  "description": "Metrics in JSON format including queue stats, worker stats, and HTTP metrics"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/ok": {
+      "get": {
+        "tags": [
+          "System"
+        ],
+        "summary": "Health Check",
+        "description": "Check the health status of the server. Optionally check database connectivity.",
+        "operationId": "health_check_ok_get",
+        "parameters": [
+          {
+            "name": "check_db",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "enum": [0, 1],
+              "default": 0,
+              "title": "Check Database",
+              "description": "Whether to check database connectivity (0=false, 1=true)"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "ok": {
+                      "type": "boolean",
+                      "const": true,
+                      "title": "OK",
+                      "description": "Indicates the server is healthy"
+                    }
+                  },
+                  "required": ["ok"],
+                  "title": "HealthResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal Server Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
     }
   },
   "components": {
@@ -3852,6 +4007,8 @@
                     "values",
                     "messages",
                     "messages-tuple",
+                    "tasks",
+                    "checkpoints",
                     "updates",
                     "events",
                     "debug",
@@ -3866,6 +4023,8 @@
                   "values",
                   "messages",
                   "messages-tuple",
+                  "tasks",
+                  "checkpoints",
                   "updates",
                   "events",
                   "debug",
@@ -4096,6 +4255,8 @@
                     "values",
                     "messages",
                     "messages-tuple",
+                    "tasks",
+                    "checkpoints",
                     "updates",
                     "events",
                     "debug",
@@ -4110,6 +4271,8 @@
                   "values",
                   "messages",
                   "messages-tuple",
+                  "tasks",
+                  "checkpoints",
                   "updates",
                   "events",
                   "debug",

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/pyproject.toml

@@ -31,7 +31,7 @@ dependencies = [
     "cryptography>=42.0.0,<45.0",
     "langgraph-sdk>=0.2.0",
     "cloudpickle>=3.0.0",
-    "langgraph-runtime-inmem>=0.6.8,<0.7",
+    "langgraph-runtime-inmem>=0.6.9,<0.7",
     "truststore>=0.1",
 ]
 

{langgraph_api-0.2.117 → langgraph_api-0.2.123}/uv.lock

@@ -25,16 +25,16 @@ wheels = [
 
 [[package]]
 name = "anyio"
-version = "4.9.0"
+version = "4.10.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "idna" },
     { name = "sniffio" },
     { name = "typing-extensions", marker = "python_full_version < '3.13'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/95/7d/4c1bd541d4dffa1b52bd83fb8527089e097a106fc90b467a7313b105f840/anyio-4.9.0.tar.gz", hash = "sha256:673c0c244e15788651a4ff38710fea9675823028a6f08a5eda409e0c9840a028", size = 190949, upload-time = "2025-03-17T00:02:54.77Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/f1/b4/636b3b65173d3ce9a38ef5f0522789614e590dab6a8d505340a4efe4c567/anyio-4.10.0.tar.gz", hash = "sha256:3f3fae35c96039744587aa5b8371e7e8e603c0702999535961dd336026973ba6", size = 213252, upload-time = "2025-08-04T08:54:26.451Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a1/ee/48ca1a7c89ffec8b6a0c5d02b89c305671d5ffd8d3c94acf8b8c408575bb/anyio-4.9.0-py3-none-any.whl", hash = "sha256:9f76d541cad6e36af7beb62e978876f3b41e3e04f2c1fbf0884604c0a9c4d93c", size = 100916, upload-time = "2025-03-17T00:02:52.713Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/12/e5e0282d673bb9746bacfb6e2dba8719989d3660cdb2ea79aee9a9651afb/anyio-4.10.0-py3-none-any.whl", hash = "sha256:60e474ac86736bbfd6f210f7a61218939c318f43f9972497381f1c5e930ed3d1", size = 107213, upload-time = "2025-08-04T08:54:24.882Z" },
 ]
 
 [[package]]
@@ -51,11 +51,11 @@ wheels = [
 
 [[package]]
 name = "certifi"
-version = "2025.7.14"
+version = "2025.8.3"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/b3/76/52c535bcebe74590f296d6c77c86dabf761c41980e1347a2422e4aa2ae41/certifi-2025.7.14.tar.gz", hash = "sha256:8ea99dbdfaaf2ba2f9bac77b9249ef62ec5218e7c2b2e903378ed5fccf765995", size = 163981, upload-time = "2025-07-14T03:29:28.449Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/dc/67/960ebe6bf230a96cda2e0abcf73af550ec4f090005363542f0765df162e0/certifi-2025.8.3.tar.gz", hash = "sha256:e564105f78ded564e3ae7c923924435e1daa7463faeab5bb932bc53ffae63407", size = 162386, upload-time = "2025-08-03T03:07:47.08Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/4f/52/34c6cf5bb9285074dc3531c437b3919e825d976fde097a7a73f79e726d03/certifi-2025.7.14-py3-none-any.whl", hash = "sha256:6b31f564a415d79ee77df69d757bb49a5bb53bd9f756cbbe24394ffd6fc1f4b2", size = 162722, upload-time = "2025-07-14T03:29:26.863Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/48/1549795ba7742c948d2ad169c1c8cdbae65bc450d6cd753d124b17c8cd32/certifi-2025.8.3-py3-none-any.whl", hash = "sha256:f6c12493cfb1b06ba2ff328595af9350c65d6644968e5d3a2ffd78699af217a5", size = 161216, upload-time = "2025-08-03T03:07:45.777Z" },
 ]
 
 [[package]]
@@ -376,7 +376,7 @@ wheels = [
 
 [[package]]
 name = "langgraph"
-version = "0.6.2"
+version = "0.6.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "langchain-core" },
@@ -386,9 +386,9 @@ dependencies = [
     { name = "pydantic" },
     { name = "xxhash" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/67/4a/09a7732620f1b04a22069730a07eec8db8aa78f482a759534f3a72302073/langgraph-0.6.2.tar.gz", hash = "sha256:ac8784ac21224b3fa6d55061c28748fb2341cbfb509b0b16cbb28208a2ffea93", size = 451164, upload-time = "2025-07-30T20:41:03.787Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/7d/d8/ecedf01b3e90ad288343eeb06d91d8511e049ee0b16d7f3c146baeed2a49/langgraph-0.6.3.tar.gz", hash = "sha256:0d2280d295133dc34ccc12eae1ad4d82ee847b009c59801de418068fa9248e1b", size = 452277, upload-time = "2025-08-03T11:21:35.74Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/5c/3e/42e8fbf430fb321465bd6dddbcfe31b1d0cfd76afb45b5e11298006ff2b3/langgraph-0.6.2-py3-none-any.whl", hash = "sha256:b838dd9e56d8cf9d3f5124cad527cec6e03414aaf1a3c284003eaae89d21f32e", size = 152188, upload-time = "2025-07-30T20:41:02.203Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/93/7836486f6c18b0b11e6bde5bc0f318947e610637aa5231081bd4adf79eb9/langgraph-0.6.3-py3-none-any.whl", hash = "sha256:733efd8c59b9915e582619da40f2ab5ebb121319a4d7718adef82d6db07547eb", size = 152463, upload-time = "2025-08-03T11:21:34.002Z" },
 ]
 
 [[package]]
@@ -517,15 +517,15 @@ wheels = [
 
 [[package]]
 name = "langgraph-prebuilt"
-version = "0.6.2"
+version = "0.6.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "langchain-core" },
     { name = "langgraph-checkpoint" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/d6/9f/f0b611e7da5331018fb85dac34c060d1007b73aa69a4e7e10835022c0aaa/langgraph_prebuilt-0.6.2.tar.gz", hash = "sha256:fb9f4f96d8f26f88bbf997b5b2122ba366d0edf7f3160c653ffa649dff2ec062", size = 125316, upload-time = "2025-07-30T20:32:10.703Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/2d/6a/7f662e24eb89bf74fcf2fd109f350ec023373d196b16d12b54e66961f145/langgraph_prebuilt-0.6.3.tar.gz", hash = "sha256:5e1ca7ba98f53ce98400f34bdb0afe47f71d0167c4108b11d4aeed4c6d4a1d3d", size = 125368, upload-time = "2025-08-03T11:16:24.789Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/04/48/f1996f8b37cb8e2bc44e3668f2bdfaa441cfb1bd418a32097372aab6b17b/langgraph_prebuilt-0.6.2-py3-none-any.whl", hash = "sha256:0c7bb1cc36da8ee3b1dd7cdd20c4023ed1f57b61e70e425bea4b16cac030117d", size = 28858, upload-time = "2025-07-30T20:32:09.712Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/27/049a9e07d1d75c39e0109445e93c9df8bc4a8c51730655be561ecdf04dee/langgraph_prebuilt-0.6.3-py3-none-any.whl", hash = "sha256:cea830fc73d1a6fb871c5c6739e894bffcb7b7a07343198b56f263d3113ae8d6", size = 28917, upload-time = "2025-08-03T11:16:23.695Z" },
 ]
 
 [[package]]
@@ -576,7 +576,7 @@ wheels = [
 
 [[package]]
 name = "langsmith"
-version = "0.4.8"
+version = "0.4.13"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
@@ -587,9 +587,9 @@ dependencies = [
     { name = "requests-toolbelt" },
     { name = "zstandard" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/46/38/0da897697ce29fb78cdaacae2d0fa3a4bc2a0abf23f84f6ecd1947f79245/langsmith-0.4.8.tar.gz", hash = "sha256:50eccb744473dd6bd3e0fe024786e2196b1f8598f8defffce7ac31113d6c140f", size = 352414, upload-time = "2025-07-18T19:36:06.082Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/be/7a/a4265a1ae549cb2480dae97867dd6841edaf2b419755d307ef998fa87854/langsmith-0.4.13.tar.gz", hash = "sha256:1ae7dbb5d8150647406f49885a2dd16ab12bd990254b5dc23718838b3d086fde", size = 920911, upload-time = "2025-08-06T20:09:53.041Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/19/4f/481324462c44ce21443b833ad73ee51117031d41c16fec06cddbb7495b26/langsmith-0.4.8-py3-none-any.whl", hash = "sha256:ca2f6024ab9d2cd4d091b2e5b58a5d2cb0c354a0c84fe214145a89ad450abae0", size = 367975, upload-time = "2025-07-18T19:36:04.025Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/04/171205d95baa3e5e8867416ffeb90510c3f17036a96e6aa9948ba4920db0/langsmith-0.4.13-py3-none-any.whl", hash = "sha256:dab7b16ee16986995007bf5a777f45c18f8bf7453f67ae2ebcb46ce43c214297", size = 372682, upload-time = "2025-08-06T20:09:51.026Z" },
 ]
 
 [[package]]

langgraph_api-0.2.117/langgraph_api/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.2.117"