langgraph-api 0.2.26__tar.gz → 0.2.28__tar.gz

langgraph_api-0.2.28/.dockerignore

@@ -0,0 +1,14 @@
+.venv
+.envrc
+tests
+compose.yml
+.mypy_cache
+.pytest_cache
+.ruff_cache
+poetry.lock
+uv.lock
+Dockerfile
+Dockerfile.node
+*.sock
+node_modules
+langgraph_api/js/node_modules

langgraph_api-0.2.28/.gitignore

@@ -0,0 +1,5 @@
+.envrc
+.ipynb_checkpoints
+.langgraph-data
+*.sock
+langgraph_api.duckdb*

langgraph_api-0.2.28/Makefile

@@ -0,0 +1,114 @@
+.PHONY: build release lint format test test_watch start start-inmem start-inmem-license-oss start check-version
+
+# lint commands
+
+lint:
+	uv run ruff check .
+	uv run ruff format . --diff
+
+format:
+	uv run ruff check --fix .
+	uv run ruff format .
+
+# test commands
+
+TEST ?= "tests/integration_tests/"
+AUTH_TEST ?= "tests/integration_tests/test_custom_auth.py"
+LANGGRAPH_HTTP ?= {"disable_mcp": false}
+LANGGRAPH_AES_KEY ?= '1234567890123456'
+
+ifeq ($(LANGGRAPH_HTTP),fastapi)
+	HTTP_CONFIG := {"app": "./tests/graphs/my_router.py:app", "disable_mcp": false, "mount_prefix": "/my-cool/api"}
+else
+	HTTP_CONFIG := $(LANGGRAPH_HTTP)
+endif
+
+LANGGRAPH_STORE ?= ""
+ifeq ($(LANGGRAPH_STORE),custom)
+	STORE_CONFIG := {"path": "./tests/graphs/custom_store.py:generate_store"}
+else
+	STORE_CONFIG := {"index": {"dims": 500, "embed": "./tests/graphs/test_utils/embeddings.py:embeddings"}}
+endif
+
+REVISION ?= $(shell git rev-parse --short HEAD)
+
+test-license-oss:
+	LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_HTTP='$(HTTP_CONFIG)' LANGGRAPH_STORE='$(STORE_CONFIG)' REDIS_URI=_FAKE DATABASE_URI=:memory: MIGRATIONS_PATH=__inmem__ uv run pytest -v $(TEST)
+
+test-watch-oss:
+	LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_HTTP='$(HTTP_CONFIG)' REDIS_URI=_FAKE DATABASE_URI=:memory: MIGRATIONS_PATH=__inmem__ uv run ptw . -- -x -vv --ff --capture=no $(TEST)
+
+test: test-license-oss
+test-watch: test-watch-oss
+
+test-auth:
+	LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_AUTH='{"path": "./tests/graphs/fastapi_jwt_auth.py:get_current_active_user"}' REDIS_URI=_FAKE DATABASE_URI=:memory: MIGRATIONS_PATH=__inmem__ uv run pytest -v $(AUTH_TEST)
+
+test-auth-watch:
+	LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_AUTH='{"path": "./tests/graphs/fastapi_jwt_auth.py:get_current_active_user"}' REDIS_URI=_FAKE DATABASE_URI=:memory: MIGRATIONS_PATH=__inmem__ uv run ptw . -- -x -vv --ff --capture=no $(AUTH_TEST)
+
+# dev commands
+
+start:
+	LANGGRAPH_HTTP='$(HTTP_CONFIG)' \
+	LANGGRAPH_RUNTIME_EDITION=inmem \
+	LANGGRAPH_AES_KEY='$(LANGGRAPH_AES_KEY)' \
+	N_JOBS_PER_WORKER=2 \
+	LANGGRAPH_CONFIG='{"agent": {"configurable": {"model_name": "openai"}}}' \
+	LANGSERVE_GRAPHS='{"agent": "./tests/graphs/agent.py:graph", "single_node": "./tests/graphs/single_node.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"}' \
+	LANGGRAPH_STORE='$(STORE_CONFIG)' \
+	LANGGRAPH_CONFIG='{"agent": {"configurable": {"model_name": "openai"}}}' \
+	LANGSMITH_LANGGRAPH_API_VARIANT=test \
+	REDIS_URI=fake \
+	DATABASE_URI=:memory: \
+	MIGRATIONS_PATH=__inmem \
+	uv run uvicorn \
+		"langgraph_api.server:app" \
+		--reload \
+		--port 9123 \
+		--reload-dir langgraph_api \
+		--no-access-log
+
+
+start-license-oss: start
+
+
+start-auth-jwt:
+	LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_HTTP='$(HTTP_CONFIG)' \
+	LANGGRAPH_AES_KEY='$(LANGGRAPH_AES_KEY)' \
+	N_JOBS_PER_WORKER=2 \
+	LANGSERVE_GRAPHS='{"agent": "./tests/graphs/agent.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"}' \
+	LANGGRAPH_STORE='$(STORE_CONFIG)' \
+	LANGGRAPH_AUTH='{"path": "tests/graphs/jwt_auth.py:auth"}' \
+	LANGSMITH_LANGGRAPH_API_VARIANT=test \
+	REDIS_URI=fake \
+	DATABASE_URI=:memory: \
+	MIGRATIONS_PATH=__inmem \
+	uv run uvicorn \
+		"langgraph_api.server:app" \
+		--reload \
+		--port 9123 \
+		--reload-dir langgraph_api \
+		--no-access-log
+
+start-auth-fastapi-jwt:
+	LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_HTTP='$(HTTP_CONFIG)' \
+	N_JOBS_PER_WORKER=2 \
+	LANGSERVE_GRAPHS='{"agent": "./tests/graphs/agent.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"}' \
+	LANGGRAPH_STORE='$(STORE_CONFIG)' \
+	LANGGRAPH_AUTH='{"path": "./tests/graphs/fastapi_jwt_auth.py:auth"}' \
+	LANGSMITH_LANGGRAPH_API_VARIANT=test \
+	REDIS_URI=fake \
+	DATABASE_URI=:memory: \
+	MIGRATIONS_PATH=__inmem \
+	uv run uvicorn \
+		"langgraph_api.server:app" \
+		--reload \
+		--port 9123 \
+		--reload-dir langgraph_api \
+		--no-access-log
+
+VERSION_KIND ?= patch
+
+bump-version:
+	uv run --with hatch hatch version $(VERSION_KIND)

{langgraph_api-0.2.26 → langgraph_api-0.2.28}/PKG-INFO

@@ -1,35 +1,29 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: langgraph-api
-Version: 0.2.26
-Summary: 
+Version: 0.2.28
+Author-email: Nuno Campos <nuno@langchain.dev>, Will Fu-Hinthorn <will@langchain.dev>
 License: Elastic-2.0
-Author: Nuno Campos
-Author-email: nuno@langchain.dev
+License-File: LICENSE
 Requires-Python: >=3.11
-Classifier: License :: Other/Proprietary License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: cloudpickle (>=3.0.0,<4.0.0)
-Requires-Dist: cryptography (>=42.0.0,<45.0)
-Requires-Dist: httpx (>=0.25.0)
-Requires-Dist: jsonschema-rs (>=0.20.0,<0.30)
-Requires-Dist: langchain-core (>=0.2.38) ; python_version < "4.0"
-Requires-Dist: langgraph (>=0.3.27) ; python_version < "4.0"
-Requires-Dist: langgraph-checkpoint (>=2.0.23) ; python_version < "4.0"
-Requires-Dist: langgraph-runtime-inmem (>=0.0.9,<0.1)
-Requires-Dist: langgraph-sdk (>=0.1.66,<0.2.0) ; python_version < "4.0"
-Requires-Dist: langsmith (>=0.1.63)
-Requires-Dist: orjson (>=3.9.7)
-Requires-Dist: pyjwt (>=2.9.0,<3.0.0)
-Requires-Dist: sse-starlette (>=2.1.0,<2.2.0)
-Requires-Dist: starlette (>=0.38.6)
-Requires-Dist: structlog (>=24.1.0,<26)
-Requires-Dist: tenacity (>=8.0.0)
-Requires-Dist: truststore (>=0.1)
-Requires-Dist: uvicorn (>=0.26.0)
-Requires-Dist: watchfiles (>=0.13)
+Requires-Dist: cloudpickle>=3.0.0
+Requires-Dist: cryptography<45.0,>=42.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: jsonschema-rs<0.30,>=0.20.0
+Requires-Dist: langchain-core>=0.2.38
+Requires-Dist: langgraph-checkpoint>=2.0.23
+Requires-Dist: langgraph-runtime-inmem<0.2,>=0.1.0
+Requires-Dist: langgraph-sdk>=0.1.66
+Requires-Dist: langgraph>=0.3.27
+Requires-Dist: langsmith>=0.1.112
+Requires-Dist: orjson>=3.9.7
+Requires-Dist: pyjwt>=2.9.0
+Requires-Dist: sse-starlette<2.2.0,>=2.1.0
+Requires-Dist: starlette>=0.38.6
+Requires-Dist: structlog<26,>=24.1.0
+Requires-Dist: tenacity>=8.0.0
+Requires-Dist: truststore>=0.1
+Requires-Dist: uvicorn>=0.26.0
+Requires-Dist: watchfiles>=0.13
 Description-Content-Type: text/markdown
 
 # LangGraph API
@@ -132,4 +126,4 @@ Options:
 
 ## License
 
-This project is licensed under the Elastic License 2.0 - see the [LICENSE](./LICENSE) file for details.
+This project is licensed under the Elastic License 2.0 - see the [LICENSE](./LICENSE) file for details.

langgraph_api-0.2.28/benchmark/weather.js

@@ -0,0 +1,75 @@
+import http from "k6/http";
+import { check } from "k6";
+
+export const options = {
+  vus: 100,
+  duration: "30s",
+};
+
+const ORIGIN = "http://localhost:9123";
+
+export function setup() {
+  const assistant = http.post(
+    `${ORIGIN}/assistants`,
+    JSON.stringify({ graph_id: "weather" }),
+    { headers: { "Content-Type": "application/json" } }
+  );
+
+  check(assistant, { "assistant status is 200": (r) => r.status === 200 });
+
+  return assistant.json();
+}
+
+export default function main(assistant) {
+  const thread = http.post(`${ORIGIN}/threads`, JSON.stringify({}), {
+    params: { headers: { "Content-Type": "application/json" } },
+  });
+
+  check(thread, { "thread status is 200": (r) => r.status === 200 });
+
+  const wait = http.post(
+    `${ORIGIN}/threads/${thread.json().thread_id}/runs/wait`,
+    JSON.stringify({
+      input: {
+        messages: [{ role: "human", content: "SF", id: "initial-message" }],
+      },
+      assistant_id: assistant.assistant_id,
+    }),
+    { headers: { "Content-Type": "application/json" } }
+  );
+
+  check(wait, {
+    "interrupted run status is 200": (r) => r.status === 200,
+    "interrupted run has values": (r) => {
+      const json = r.json();
+      if (json.route !== "weather") return false;
+      if (json.messages.length !== 1) return false;
+      if (json.messages[0].id !== "initial-message") return false;
+      if (json.messages[0].content !== "SF") return false;
+      return true;
+    },
+  });
+
+  const continueWait = http.post(
+    `${ORIGIN}/threads/${thread.json().thread_id}/runs/wait`,
+    JSON.stringify({
+      input: null,
+      assistant_id: assistant.assistant_id,
+    }),
+    { headers: { "Content-Type": "application/json" } }
+  );
+
+  check(continueWait, {
+    "run status is 200": (r) => r.status === 200,
+    "run has values": (r) => {
+      const json = r.json();
+      if (json.route !== "weather") return false;
+      if (json.messages.length !== 2) return false;
+      if (json.messages[0].id !== "initial-message") return false;
+      if (json.messages[0].content !== "SF") return false;
+      if (json.messages[1].content !== "It's sunny in San Francisco!")
+        return false;
+      return true;
+    },
+  });
+}

langgraph_api-0.2.28/constraints.txt

@@ -0,0 +1,19 @@
+# When editing this file, also update docs pages:
+# https://github.com/langchain-ai/langgraph/blob/main/docs/docs/cloud/deployment/setup.md
+# https://github.com/langchain-ai/langgraph/blob/main/docs/docs/cloud/deployment/setup_pyproject.md
+langgraph>=0.3.27
+langgraph-sdk>=0.1.66
+langgraph-checkpoint>=2.0.23
+langchain-core>=0.2.43
+langsmith>=0.1.112
+orjson>=3.9.7,<3.10.17
+httpx>=0.25.0
+tenacity>=8.0.0
+uvicorn>=0.26.0
+sse-starlette>=2.1.0,<2.2.0
+uvloop>=0.18.0
+httptools>=0.5.0
+jsonschema-rs>=0.20.0
+structlog>=24.1.0
+cloudpickle>=3.0.0
+truststore>=0.1

langgraph_api-0.2.28/forbidden.txt

@@ -0,0 +1,2 @@
+# Block user overrides of the base api.
+langgraph-api>=0.1.0

langgraph_api-0.2.28/healthcheck.py

@@ -0,0 +1,18 @@
+import json
+import os
+import urllib.request
+
+prefix = ""
+# Override prefix if it's set in the http config
+if (http := os.environ.get("LANGGRAPH_HTTP")) and (
+    mount_prefix := json.loads(http).get("mount_prefix")
+):
+    prefix = mount_prefix
+# Override that
+if os.environ.get("MOUNT_PREFIX"):
+    prefix = os.environ["MOUNT_PREFIX"]
+
+with urllib.request.urlopen(
+    f"http://localhost:{os.environ['PORT']}{prefix}/ok"
+) as response:
+    assert response.status == 200

langgraph_api-0.2.28/langgraph_api/__init__.py

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

{langgraph_api-0.2.26 → langgraph_api-0.2.28}/langgraph_api/api/assistants.py

@@ -9,6 +9,7 @@ from starlette.exceptions import HTTPException
 from starlette.responses import Response
 from starlette.routing import BaseRoute
 
+from langgraph_api import store as api_store
 from langgraph_api.graph import get_assistant_id, get_graph
 from langgraph_api.js.base import BaseRemotePregel
 from langgraph_api.route import ApiRequest, ApiResponse, ApiRoute
@@ -25,7 +26,6 @@ from langgraph_runtime.checkpoint import Checkpointer
 from langgraph_runtime.database import connect
 from langgraph_runtime.ops import Assistants
 from langgraph_runtime.retry import retry_db
-from langgraph_runtime.store import Store
 
 logger = structlog.stdlib.get_logger(__name__)
 
@@ -194,7 +194,7 @@ async def get_assistant_graph(
             assistant["graph_id"],
             config,
             checkpointer=Checkpointer(conn),
-            store=Store(),
+            store=(await api_store.get_store()),
         ) as graph:
             xray: bool | int = False
             xray_query = request.query_params.get("xray")
@@ -240,7 +240,7 @@ async def get_assistant_subgraphs(
             assistant["graph_id"],
             config,
             checkpointer=Checkpointer(conn),
-            store=Store(),
+            store=(await api_store.get_store()),
         ) as graph:
             namespace = request.path_params.get("namespace")
 
@@ -286,7 +286,7 @@ async def get_assistant_schemas(
             assistant["graph_id"],
             config,
             checkpointer=Checkpointer(conn),
-            store=Store(),
+            store=(await api_store.get_store()),
         ) as graph:
             if isinstance(graph, BaseRemotePregel):
                 schemas = await graph.fetch_state_schema()

{langgraph_api-0.2.26 → langgraph_api-0.2.28}/langgraph_api/api/store.py

@@ -6,6 +6,7 @@ from starlette.routing import BaseRoute
 
 from langgraph_api.auth.custom import handle_event as _handle_event
 from langgraph_api.route import ApiRequest, ApiResponse, ApiRoute
+from langgraph_api.store import get_store
 from langgraph_api.utils import get_auth_ctx
 from langgraph_api.validation import (
     StoreDeleteRequest,
@@ -14,7 +15,6 @@ from langgraph_api.validation import (
     StoreSearchRequest,
 )
 from langgraph_runtime.retry import retry_db
-from langgraph_runtime.store import Store
 
 
 def _validate_namespace(namespace: tuple[str, ...]) -> Response | None:
@@ -57,7 +57,9 @@ async def put_item(request: ApiRequest):
         "value": payload["value"],
     }
     await handle_event("put", handler_payload)
-    await Store().aput(namespace, handler_payload["key"], handler_payload["value"])
+    await (await get_store()).aput(
+        namespace, handler_payload["key"], handler_payload["value"]
+    )
     return Response(status_code=204)
 
 
@@ -75,7 +77,7 @@ async def get_item(request: ApiRequest):
         "key": key,
     }
     await handle_event("get", handler_payload)
-    result = await Store().aget(namespace, key)
+    result = await (await get_store()).aget(namespace, key)
     return ApiResponse(result.dict() if result is not None else None)
 
 
@@ -91,7 +93,9 @@ async def delete_item(request: ApiRequest):
         "key": payload["key"],
     }
     await handle_event("delete", handler_payload)
-    await Store().adelete(handler_payload["namespace"], handler_payload["key"])
+    await (await get_store()).adelete(
+        handler_payload["namespace"], handler_payload["key"]
+    )
     return Response(status_code=204)
 
 
@@ -114,7 +118,7 @@ async def search_items(request: ApiRequest):
         "query": query,
     }
     await handle_event("search", handler_payload)
-    items = await Store().asearch(
+    items = await (await get_store()).asearch(
         handler_payload["namespace"],
         filter=handler_payload["filter"],
         limit=handler_payload["limit"],
@@ -145,7 +149,7 @@ async def list_namespaces(request: ApiRequest):
         "offset": offset,
     }
     await handle_event("list_namespaces", handler_payload)
-    result = await Store().alist_namespaces(
+    result = await (await get_store()).alist_namespaces(
         prefix=handler_payload["namespace"],
         suffix=handler_payload["suffix"],
         max_depth=handler_payload["max_depth"],

langgraph_api-0.2.28/langgraph_api/asgi_transport.py

@@ -0,0 +1,171 @@
+"""ASGI transport that lets you schedule to the main loop.
+
+Adapted from: https://github.com/encode/httpx/blob/6c7af967734bafd011164f2a1653abc87905a62b/httpx/_transports/asgi.py#L1
+"""
+
+from __future__ import annotations
+
+import typing
+
+from httpx import ASGITransport as ASGITransportBase
+from httpx import AsyncByteStream, Request, Response
+
+if typing.TYPE_CHECKING:  # pragma: no cover
+    import asyncio
+
+    import trio
+
+    Event = asyncio.Event | trio.Event
+
+__all__ = ["ASGITransport"]
+
+
+def is_running_trio() -> bool:
+    try:
+        # sniffio is a dependency of trio.
+
+        # See https://github.com/python-trio/trio/issues/2802
+        import sniffio
+
+        if sniffio.current_async_library() == "trio":
+            return True
+    except ImportError:  # pragma: nocover
+        pass
+
+    return False
+
+
+def create_event() -> Event:
+    if is_running_trio():
+        import trio
+
+        return trio.Event()
+
+    import asyncio
+
+    return asyncio.Event()
+
+
+class ASGIResponseStream(AsyncByteStream):
+    def __init__(self, body: list[bytes]) -> None:
+        self._body = body
+
+    async def __aiter__(self) -> typing.AsyncIterator[bytes]:
+        yield b"".join(self._body)
+
+
+class ASGITransport(ASGITransportBase):
+    """
+    A custom AsyncTransport that handles sending requests directly to an ASGI app.
+
+    ```python
+    transport = httpx.ASGITransport(
+        app=app,
+        root_path="/submount",
+        client=("1.2.3.4", 123)
+    )
+    client = httpx.AsyncClient(transport=transport)
+    ```
+
+    Arguments:
+
+    * `app` - The ASGI application.
+    * `raise_app_exceptions` - Boolean indicating if exceptions in the application
+       should be raised. Default to `True`. Can be set to `False` for use cases
+       such as testing the content of a client 500 response.
+    * `root_path` - The root path on which the ASGI application should be mounted.
+    * `client` - A two-tuple indicating the client IP and port of incoming requests.
+    ```
+    """
+
+    async def handle_async_request(
+        self,
+        request: Request,
+    ) -> Response:
+        from langgraph_api.asyncio import call_soon_in_main_loop
+
+        assert isinstance(request.stream, AsyncByteStream)
+
+        # ASGI scope.
+        scope = {
+            "type": "http",
+            "asgi": {"version": "3.0"},
+            "http_version": "1.1",
+            "method": request.method,
+            "headers": [(k.lower(), v) for (k, v) in request.headers.raw],
+            "scheme": request.url.scheme,
+            "path": request.url.path,
+            "raw_path": request.url.raw_path.split(b"?")[0],
+            "query_string": request.url.query,
+            "server": (request.url.host, request.url.port),
+            "client": self.client,
+            "root_path": self.root_path,
+        }
+
+        # Request.
+        request_body_chunks = request.stream.__aiter__()
+        request_complete = False
+
+        # Response.
+        status_code = None
+        response_headers = None
+        body_parts = []
+        response_started = False
+        response_complete = create_event()
+
+        # ASGI callables.
+
+        async def receive() -> dict[str, typing.Any]:
+            nonlocal request_complete
+
+            if request_complete:
+                await response_complete.wait()
+                return {"type": "http.disconnect"}
+
+            try:
+                body = await request_body_chunks.__anext__()
+            except StopAsyncIteration:
+                request_complete = True
+                return {"type": "http.request", "body": b"", "more_body": False}
+            return {"type": "http.request", "body": body, "more_body": True}
+
+        async def send(message: typing.MutableMapping[str, typing.Any]) -> None:
+            nonlocal status_code, response_headers, response_started
+
+            if message["type"] == "http.response.start":
+                assert not response_started
+
+                status_code = message["status"]
+                response_headers = message.get("headers", [])
+                response_started = True
+
+            elif message["type"] == "http.response.body":
+                assert not response_complete.is_set()
+                body = message.get("body", b"")
+                more_body = message.get("more_body", False)
+
+                if body and request.method != "HEAD":
+                    body_parts.append(body)
+
+                if not more_body:
+                    response_complete.set()
+
+        try:
+            await call_soon_in_main_loop(self.app(scope, receive, send))
+        except Exception:  # noqa: PIE-786
+            if self.raise_app_exceptions:
+                raise
+
+            response_complete.set()
+            if status_code is None:
+                status_code = 500
+            if response_headers is None:
+                response_headers = {}
+
+        assert response_complete.is_set()
+        assert status_code is not None
+        assert response_headers is not None
+
+        stream = ASGIResponseStream(body_parts)
+
+        return Response(status_code, headers=response_headers, stream=stream)

{langgraph_api-0.2.26 → langgraph_api-0.2.28}/langgraph_api/asyncio.py

@@ -6,6 +6,7 @@ from functools import partial
 from typing import Any, Generic, TypeVar
 
 import structlog
+from langgraph.utils.future import chain_future
 
 T = TypeVar("T")
 
@@ -19,6 +20,12 @@ def set_event_loop(loop: asyncio.AbstractEventLoop) -> None:
     _MAIN_LOOP = loop
 
 
+def get_event_loop() -> asyncio.AbstractEventLoop:
+    if _MAIN_LOOP is None:
+        raise RuntimeError("No event loop set")
+    return _MAIN_LOOP
+
+
 async def sleep_if_not_done(delay: float, done: asyncio.Event) -> None:
     try:
         await asyncio.wait_for(done.wait(), delay)
@@ -118,6 +125,16 @@ def run_coroutine_threadsafe(
     return future
 
 
+def call_soon_in_main_loop(coro: Coroutine[Any, Any, T]) -> asyncio.Future[T]:
+    """Run a coroutine in the main event loop."""
+    if _MAIN_LOOP is None:
+        raise RuntimeError("No event loop set")
+    main_loop_fut = asyncio.ensure_future(coro, loop=_MAIN_LOOP)
+    this_loop_fut = asyncio.get_running_loop().create_future()
+    _MAIN_LOOP.call_soon_threadsafe(chain_future, main_loop_fut, this_loop_fut)
+    return this_loop_fut
+
+
 class SimpleTaskGroup(AbstractAsyncContextManager["SimpleTaskGroup"]):
     """An async task group that can be configured to wait and/or cancel tasks on exit.
 

{langgraph_api-0.2.26 → langgraph_api-0.2.28}/langgraph_api/config.py

@@ -109,6 +109,7 @@ class TTLConfig(TypedDict, total=False):
 
 
 class StoreConfig(TypedDict, total=False):
+    path: str
     index: IndexConfig
     ttl: TTLConfig