langgraph-api 0.10.2__tar.gz → 0.11.0__tar.gz

{langgraph_api-0.10.2 → langgraph_api-0.11.0}/Makefile

@@ -1,7 +1,7 @@
 .PHONY: build release lint format test test_watch start start-inmem start-inmem-license-oss start start-js-server build-go-server start-go-server stop-go-server check-version check-base-imports test-a2a-tck test-a2a-tck-mandatory start-test-a2a-tck start-test-a2a-tck-mandatory start-test-a2a-tck-watch test-mcp-conformance start-test-mcp-conformance list-mcp-scenarios test-auth-read-only-assistant
 
 # Environment variables
-LANGSERVE_GRAPHS_ALL = '{"agent": {"path": "./tests/graphs/agent.py:graph", "description": "agent"}, "assistant_id_runtime": "./tests/graphs/assistant_id_runtime.py:graph", "custom_lifespan": "./tests/graphs/my_router.py:graph", "single_node": "./tests/graphs/single_node.py:graph", "benchmark": "./tests/graphs/benchmark.py:graph", "config_graph": "./tests/graphs/config_graph.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", "agent_interrupt": "./tests/graphs/agent_interrupt.py:graph", "agent_parallel_interrupt": "./tests/graphs/agent_parallel_interrupt.py:graph", "message_type_test": "./tests/graphs/message_type_test.py:graph", "remote_subgraph_parent": "./tests/graphs/remote_subgraph_parent.py:graph", "simple_remote": "./tests/graphs/simple_remote.py:graph", "nested_subgraphs": "./tests/graphs/nested_subgraphs.py:graph", "functional_fibonacci": "./tests/graphs/functional_fibonacci.py:fibonacci", "state_graph_fibonacci": "./tests/graphs/state_graph_fibonacci.py:fibonacci", "max_concurrency_graph": "./tests/graphs/max_concurrency_graph.py:graph", "unserializable_subgraph": "./tests/graphs/unserializable_subgraph.py:graph", "agent_interrupt_text": "./tests/graphs/agent_interrupt_text.py:graph", "agent_echo_stream": "./tests/graphs/agent_echo_stream.py:graph", "agent_tool_stream": "./tests/graphs/agent_tool_stream.py:graph", "runtime_graph": "./tests/graphs/runtime_graph.py:graph", "tool_call_chunk_stream": "./tests/graphs/tool_call_chunk_stream.py:graph", "ui_tool_call_stream": "./tests/graphs/ui_tool_call_stream.py:graph", "agent_metrics_stream": "./tests/graphs/agent_metrics_stream.py:graph", "agent_multimodal_stream": "./tests/graphs/agent_multimodal_stream.py:graph", "agent_bedtime_story": "./tests/graphs/agent_bedtime_story.py:graph", "delta_channel": "./tests/graphs/delta_channel.py:graph", "delta_channel_freq": "./tests/graphs/delta_channel_freq.py:graph", "delta_channel_files": "./tests/graphs/delta_channel_files.py:graph", "delta_channel_files_freq": "./tests/graphs/delta_channel_files_freq.py:graph", "delta_channel_legacy": "./tests/graphs/delta_channel_migration.py:graph_legacy", "delta_channel_delta": "./tests/graphs/delta_channel_migration.py:graph_delta", "delta_channel_messages_freq": "./tests/graphs/delta_channel_messages.py:graph_freq", "delta_channel_messages": "./tests/graphs/delta_channel_messages.py:graph", "delta_channel_messages_legacy": "./tests/graphs/delta_channel_messages.py:graph_legacy", "delta_channel_messages_remove": "./tests/graphs/delta_channel_messages.py:graph_remove", "delta_channel_messages_update": "./tests/graphs/delta_channel_messages.py:graph_update", "delta_channel_messages_delta": "./tests/graphs/delta_channel_messages.py:graph_delta"}'
+LANGSERVE_GRAPHS_ALL = '{"agent": {"path": "./tests/graphs/agent.py:graph", "description": "agent"}, "assistant_id_runtime": "./tests/graphs/assistant_id_runtime.py:graph", "custom_lifespan": "./tests/graphs/my_router.py:graph", "single_node": "./tests/graphs/single_node.py:graph", "benchmark": "./tests/graphs/benchmark.py:graph", "config_graph": "./tests/graphs/config_graph.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", "agent_interrupt": "./tests/graphs/agent_interrupt.py:graph", "agent_parallel_interrupt": "./tests/graphs/agent_parallel_interrupt.py:graph", "message_type_test": "./tests/graphs/message_type_test.py:graph", "remote_subgraph_parent": "./tests/graphs/remote_subgraph_parent.py:graph", "simple_remote": "./tests/graphs/simple_remote.py:graph", "nested_subgraphs": "./tests/graphs/nested_subgraphs.py:graph", "functional_fibonacci": "./tests/graphs/functional_fibonacci.py:fibonacci", "state_graph_fibonacci": "./tests/graphs/state_graph_fibonacci.py:fibonacci", "max_concurrency_graph": "./tests/graphs/max_concurrency_graph.py:graph", "unserializable_subgraph": "./tests/graphs/unserializable_subgraph.py:graph", "agent_interrupt_text": "./tests/graphs/agent_interrupt_text.py:graph", "agent_echo_stream": "./tests/graphs/agent_echo_stream.py:graph", "agent_tool_stream": "./tests/graphs/agent_tool_stream.py:graph", "runtime_graph": "./tests/graphs/runtime_graph.py:graph", "tool_call_chunk_stream": "./tests/graphs/tool_call_chunk_stream.py:graph", "ui_tool_call_stream": "./tests/graphs/ui_tool_call_stream.py:graph", "agent_metrics_stream": "./tests/graphs/agent_metrics_stream.py:graph", "agent_multimodal_stream": "./tests/graphs/agent_multimodal_stream.py:graph", "agent_bedtime_story": "./tests/graphs/agent_bedtime_story.py:graph", "delta_channel": "./tests/graphs/delta_channel.py:graph", "delta_channel_freq": "./tests/graphs/delta_channel_freq.py:graph", "delta_channel_files": "./tests/graphs/delta_channel_files.py:graph", "delta_channel_files_freq": "./tests/graphs/delta_channel_files_freq.py:graph", "delta_channel_legacy": "./tests/graphs/delta_channel_migration.py:graph_legacy", "delta_channel_delta": "./tests/graphs/delta_channel_migration.py:graph_delta", "delta_channel_delta_filter": "./tests/graphs/delta_channel_migration.py:graph_delta_filter", "delta_channel_messages_freq": "./tests/graphs/delta_channel_messages.py:graph_freq", "delta_channel_messages": "./tests/graphs/delta_channel_messages.py:graph", "delta_channel_messages_legacy": "./tests/graphs/delta_channel_messages.py:graph_legacy", "delta_channel_messages_remove": "./tests/graphs/delta_channel_messages.py:graph_remove", "delta_channel_messages_update": "./tests/graphs/delta_channel_messages.py:graph_update", "delta_channel_messages_delta": "./tests/graphs/delta_channel_messages.py:graph_delta", "store_e2e_async": "./tests/graphs/store_e2e.py:graph_async", "store_e2e_sync": "./tests/graphs/store_e2e.py:graph_sync"}'
 LANGSERVE_GRAPHS_AUTH = '{"agent": {"path": "./tests/graphs/agent.py:graph", "description": "agent"}, "assistant_id_runtime": "./tests/graphs/assistant_id_runtime.py:graph", "config_graph": "./tests/graphs/config_graph.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", "agent_parallel_interrupt": "./tests/graphs/agent_parallel_interrupt.py:graph", "functional_fibonacci": "./tests/graphs/functional_fibonacci.py:fibonacci", "state_graph_fibonacci": "./tests/graphs/state_graph_fibonacci.py:fibonacci", "runtime_graph": "./tests/graphs/runtime_graph.py:graph"}'
 
 # Go server management

{langgraph_api-0.10.2 → langgraph_api-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langgraph-api
-Version: 0.10.2
+Version: 0.11.0
 Author-email: Will Fu-Hinthorn <will@langchain.dev>, Josh Rogers <josh@langchain.dev>, Parker Rule <parker@langchain.dev>
 License: Elastic-2.0
 License-File: LICENSE
@@ -14,20 +14,22 @@ Requires-Dist: httptools>=0.5.0; platform_system != 'Windows'
 Requires-Dist: httpx>=0.25.0
 Requires-Dist: jsonschema-rs<0.45,>=0.20.0
 Requires-Dist: langchain-core>=0.3.64
-Requires-Dist: langchain-protocol<0.1,>=0.0.16
+Requires-Dist: langchain-protocol<0.1,>=0.0.18
 Requires-Dist: langgraph-checkpoint<5,>=3.0.1
-Requires-Dist: langgraph-runtime-inmem<0.31.0.dev0,>=0.30.0.dev0
+Requires-Dist: langgraph-runtime-inmem<0.32.0.dev0,>=0.31.0.dev0
 Requires-Dist: langgraph-sdk>=0.3.5
 Requires-Dist: langgraph<2,>=0.4.10
 Requires-Dist: langsmith[otel]>=0.6.3
 Requires-Dist: opentelemetry-api>=0.0.1
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=0.0.1
+Requires-Dist: opentelemetry-exporter-prometheus<0.59,>=0.58b0
 Requires-Dist: opentelemetry-sdk>=0.0.1
 Requires-Dist: orjson>=3.9.7
+Requires-Dist: prometheus-client>=0.0.1
 Requires-Dist: protobuf<7.0.0,>=6.32.1
-Requires-Dist: pyjwt>=2.9.0
+Requires-Dist: pyjwt>=2.13.0
 Requires-Dist: sse-starlette<3.4.0,>=2.1.3
-Requires-Dist: starlette>=1.0.1
+Requires-Dist: starlette>=1.3.1
 Requires-Dist: structlog<26,>=24.1.0
 Requires-Dist: tenacity>=8.0.0
 Requires-Dist: truststore>=0.1

{langgraph_api-0.10.2 → langgraph_api-0.11.0}/benchmark/continuous/pyproject.toml

@@ -4,10 +4,10 @@ version = "0.1.0"
 description = "Continuous stress test for Agent Server"
 requires-python = ">=3.13"
 dependencies = [
-    "langgraph-sdk>=0.3.13",
-    "click>=8.3.3",
+    "langgraph-sdk>=0.3.15",
+    "click>=8.4.1",
     "structlog>=24.1.0",
-    "datadog-api-client>=2.0.0",
+    "datadog-api-client>=2.55.0",
     "python-dateutil>=2.8.0",
     "httpx>=0.27.0",
 ]

{langgraph_api-0.10.2 → langgraph_api-0.11.0}/benchmark/continuous/uv.lock

@@ -25,14 +25,14 @@ wheels = [
 
 [[package]]
 name = "click"
-version = "8.3.3"
+version = "8.4.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "colorama", marker = "sys_platform == 'win32'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/bb/63/f9e1ea081ce35720d8b92acde70daaedace594dc93b693c869e0d5910718/click-8.3.3.tar.gz", hash = "sha256:398329ad4837b2ff7cbe1dd166a4c0f8900c3ca3a218de04466f38f6497f18a2", size = 328061, upload-time = "2026-04-22T15:11:27.506Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/9b/98/518d8e5081007684232226f475082b30087d0f585e8457db087298259f49/click-8.4.1.tar.gz", hash = "sha256:918b5633eddf6b41c32d4f454bf0de810065c74e3f7dbf8ee5452f8be88d3e96", size = 353007, upload-time = "2026-05-22T04:08:37.769Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ae/44/c1221527f6a71a01ec6fbad7fa78f1d50dfa02217385cf0fa3eec7087d59/click-8.3.3-py3-none-any.whl", hash = "sha256:a2bf429bb3033c89fa4936ffb35d5cb471e3719e1f3c8a7c3fff0b8314305613", size = 110502, upload-time = "2026-04-22T15:11:25.044Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/0d/67e5b4109ea4a837e80daa87c2c696711955e40449a97e8926672534def2/click-8.4.1-py3-none-any.whl", hash = "sha256:482be17c6991b8c19c5429a1e995d9b0efdbb63172824c41f99965dc0ade8ec2", size = 116639, upload-time = "2026-05-22T04:08:35.26Z" },
 ]
 
 [[package]]
@@ -46,7 +46,7 @@ wheels = [
 
 [[package]]
 name = "datadog-api-client"
-version = "2.53.0"
+version = "2.55.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "certifi" },
@@ -54,9 +54,9 @@ dependencies = [
     { name = "typing-extensions" },
     { name = "urllib3" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/20/37/4f537b327906ff5fdf26531f2b3ec8994ffa41630d4bf1e130bb2cacb202/datadog_api_client-2.53.0.tar.gz", hash = "sha256:85e44f269d0a9757821a7af4ee35e324355a11ebe0efaabf6688efd9fa169d85", size = 4537088, upload-time = "2026-04-01T15:29:44.503Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/ee/8d/6f7ddd04cc701cc590eab111a45e54c92158eddbff943ad4a1dbb5925b21/datadog_api_client-2.55.0.tar.gz", hash = "sha256:c56767c867a15b928da08d5c6077a7ac466e029a10a5045e80d79d76e92afaa3", size = 4994403, upload-time = "2026-05-15T17:20:06.825Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/e9/a1/78ccb200fa3d037465cef14b0163005279757026429e76b5807e392dca1b/datadog_api_client-2.53.0-py3-none-any.whl", hash = "sha256:f965c10f846da03d3d1abe99f20331e42933c8736b7ee176f0a420ca019f1b17", size = 5925406, upload-time = "2026-04-01T15:29:41.128Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/28/9af04e1cccb57bc9754a5d4cd2fc5a006183e95b234336e9115fe95e5f12/datadog_api_client-2.55.0-py3-none-any.whl", hash = "sha256:fef8dcadbdcd1f7fbe89d97825cfc06c9a1e3577b61f04834b8d250c881d59a7", size = 6644614, upload-time = "2026-05-15T17:20:03.927Z" },
 ]
 
 [[package]]
@@ -120,25 +120,25 @@ dependencies = [
 
 [package.metadata]
 requires-dist = [
-    { name = "click", specifier = ">=8.3.3" },
-    { name = "datadog-api-client", specifier = ">=2.0.0" },
+    { name = "click", specifier = ">=8.4.1" },
+    { name = "datadog-api-client", specifier = ">=2.55.0" },
     { name = "httpx", specifier = ">=0.27.0" },
-    { name = "langgraph-sdk", specifier = ">=0.3.13" },
+    { name = "langgraph-sdk", specifier = ">=0.3.15" },
     { name = "python-dateutil", specifier = ">=2.8.0" },
     { name = "structlog", specifier = ">=24.1.0" },
 ]
 
 [[package]]
 name = "langgraph-sdk"
-version = "0.3.14"
+version = "0.3.15"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
     { name = "orjson" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/02/f1/134046c20bc4a4a15d410d1d21c9e298a3e9923777b4cc867b8669bc636b/langgraph_sdk-0.3.14.tar.gz", hash = "sha256:acd1674c538e97f3cdaa610f6dd7e34bc9bad30167f0ccc482dcd563325e81f5", size = 198162, upload-time = "2026-05-05T18:40:03.524Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/66/af/cdd4d6f3c05b3c1112ed3f12ef830faf15951b21d22cbc622a4becbbe25c/langgraph_sdk-0.3.15.tar.gz", hash = "sha256:29e805003d2c6e296823dd71992610976fd0428cefaa8b3304fd91f2247037de", size = 201924, upload-time = "2026-05-22T16:54:27.678Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/34/96/1c9f9fbfe756ddd850a2585e7f1949d8ebb97fdaa7a5eff8f45ed1314670/langgraph_sdk-0.3.14-py3-none-any.whl", hash = "sha256:68935bf6f4924eda92617a9e5dfb4f4281197508c648cb9d62ff083907607f9d", size = 97028, upload-time = "2026-05-05T18:40:02.099Z" },
+    { url = "https://files.pythonhosted.org/packages/be/a5/0196d9c05749c25bc198e4909d68c998bc3120297e14944921baf2f4c384/langgraph_sdk-0.3.15-py3-none-any.whl", hash = "sha256:3838773acf7456d158165385d49f48f1e856f28b56ccd99ea139a8f27004815d", size = 98166, upload-time = "2026-05-22T16:54:26.013Z" },
 ]
 
 [[package]]

langgraph_api-0.11.0/langgraph_api/__init__.py

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

{langgraph_api-0.10.2 → langgraph_api-0.11.0}/langgraph_api/_checkpointer/_adapter.py

@@ -24,6 +24,14 @@ from langgraph_grpc_common.checkpointer import GrpcCheckpointer
 from langgraph_api import config, timing
 from langgraph_api.asyncio import as_asynccontextmanager
 from langgraph_api.grpc.client import get_shared_client
+
+# Used as the per-instance serializer for ``GrpcCheckpointer`` below so
+# checkpoint payloads honour the same ``USE_PICKLE_FALLBACK`` /
+# encryption / ``allowed_json_modules`` policy as the in-process Python
+# ``Checkpointer``. Scoped to checkpointer RPCs only (via the contextvar
+# in ``langgraph_grpc_common.serde``) so non-checkpointer gRPC ops keep
+# using the safer ``JsonPlusSerializer`` default.
+from langgraph_api.serde import Serializer as _ApiSerializer
 from langgraph_api.timing import profiled_import
 from langgraph_api.utils.config import run_in_executor
 
@@ -320,7 +328,24 @@ async def get_checkpointer(
     ):
         return cast(
             "FullCheckpointerProtocol",
-            GrpcCheckpointer(get_stub=_get_shared_checkpointer_stub),
+            GrpcCheckpointer(
+                get_stub=_get_shared_checkpointer_stub,
+                serializer=_ApiSerializer(),
+            ),
+        )
+
+    from langgraph_api.feature_flags import (  # noqa: PLC0415
+        IS_POSTGRES_BACKEND,
+        PREFER_GRPC_CHECKPOINTER,
+    )
+
+    if IS_POSTGRES_BACKEND and PREFER_GRPC_CHECKPOINTER:
+        return cast(
+            "FullCheckpointerProtocol",
+            GrpcCheckpointer(
+                get_stub=_get_shared_checkpointer_stub,
+                serializer=_ApiSerializer(),
+            ),
         )
 
     from langgraph_runtime.checkpoint import Checkpointer  # noqa: PLC0415

langgraph_api-0.11.0/langgraph_api/api/meta.py

@@ -0,0 +1,123 @@
+import langgraph.version
+import structlog
+from prometheus_client import CONTENT_TYPE_LATEST, generate_latest
+from starlette.responses import JSONResponse, PlainTextResponse
+
+from langgraph_api import __version__, config, metadata
+from langgraph_api.feature_flags import IS_POSTGRES_OR_GRPC_BACKEND
+from langgraph_api.http_metrics import HTTP_METRICS_COLLECTOR
+from langgraph_api.route import ApiRequest
+from langgraph_api.schema import PoolStats, PostgresPoolStats, RedisPoolStats
+from langgraph_runtime.database import connect, pool_stats
+from langgraph_runtime.metrics import get_metrics
+
+if IS_POSTGRES_OR_GRPC_BACKEND:
+    from langgraph_api.grpc.ops import Runs
+else:
+    from langgraph_runtime.ops import Runs
+
+METRICS_FORMATS = {"prometheus", "json"}
+
+logger = structlog.stdlib.get_logger(__name__)
+
+
+def _merge_pool_stats(local: PoolStats, remote: PoolStats) -> PoolStats:
+    """Merge local and remote pool stats by summing numeric values. Used to aggregate Python + Go pool metrics."""
+    merged: PoolStats = {}
+    if "postgres" in local or "postgres" in remote:
+        lp = local.get("postgres") or {}
+        rp = remote.get("postgres") or {}
+        merged["postgres"] = PostgresPoolStats(
+            pool_max=lp.get("pool_max", 0) + rp.get("pool_max", 0),
+            pool_size=lp.get("pool_size", 0) + rp.get("pool_size", 0),
+            pool_available=lp.get("pool_available", 0) + rp.get("pool_available", 0),
+            requests_queued=lp.get("requests_queued", 0) + rp.get("requests_queued", 0),
+            requests_errors=lp.get("requests_errors", 0) + rp.get("requests_errors", 0),
+        )
+    if "redis" in local or "redis" in remote:
+        lr = local.get("redis") or {}
+        rr = remote.get("redis") or {}
+        merged["redis"] = RedisPoolStats(
+            idle_connections=lr.get("idle_connections", 0)
+            + rr.get("idle_connections", 0),
+            in_use_connections=lr.get("in_use_connections", 0)
+            + rr.get("in_use_connections", 0),
+            max_connections=lr.get("max_connections", 0) + rr.get("max_connections", 0),
+        )
+    return merged
+
+
+async def _grpc_pool_stats() -> PoolStats:
+    """Fetch connection pool stats from the Core API (Go) via gRPC for metrics aggregation. Returns {} on error."""
+    if not IS_POSTGRES_OR_GRPC_BACKEND:
+        return {}
+    try:
+        return await Runs.pool_stats()
+    except Exception as e:
+        await logger.awarning(
+            "Failed to fetch Core API pool stats for aggregation", exc_info=e
+        )
+        return {}
+
+
+async def meta_pool_stats() -> PoolStats:
+    local_pool_stats: PoolStats = pool_stats()
+
+    # Aggregate with Core API (Go) pool stats when using gRPC backend
+    grpc_pool_stats = await _grpc_pool_stats()
+    return _merge_pool_stats(local_pool_stats, grpc_pool_stats)
+
+
+async def meta_info(request: ApiRequest):
+    return JSONResponse(
+        {
+            "version": __version__,
+            "langgraph_py_version": langgraph.version.__version__,
+            "flags": {
+                "assistants": True,
+                "crons": True,
+                "langsmith": bool(config.LANGSMITH_CONTROL_PLANE_API_KEY)
+                and bool(config.TRACING),
+                "langsmith_tracing_replicas": True,
+                "langsmith_tracing_session_on_runs": True,
+            },
+            "host": {
+                "kind": metadata.HOST,
+                "project_id": metadata.PROJECT_ID,
+                "host_revision_id": metadata.HOST_REVISION_ID,
+                "revision_id": metadata.REVISION,
+                "tenant_id": metadata.TENANT_ID,
+            },
+        }
+    )
+
+
+async def meta_metrics(request: ApiRequest):
+    # determine output format
+    metrics_format = request.query_params.get("format", "prometheus")
+    if metrics_format not in METRICS_FORMATS:
+        metrics_format = "prometheus"
+
+    if metrics_format == "prometheus":
+        # Served straight from the OTLP Prometheus client's registry (see
+        # metrics_otlp._LSDPrometheusReader).
+        return PlainTextResponse(generate_latest(), media_type=CONTENT_TYPE_LATEST)
+
+    # JSON: hand-built snapshot of workers, queue depth, HTTP, and pool stats.
+    worker_metrics = get_metrics()["workers"]
+    http_metrics = HTTP_METRICS_COLLECTOR.get_metrics(
+        metadata.PROJECT_ID,
+        metadata.HOST_REVISION_ID,
+        metrics_format,
+        metadata.DEPLOYMENT_TYPE,
+    )
+    merged_pool_stats = await meta_pool_stats()
+    async with connect() as conn:
+        resp = {
+            **merged_pool_stats,
+            "queue": await Runs.stats(conn),
+            **http_metrics,
+        }
+        if config.N_JOBS_PER_WORKER > 0:
+            resp["workers"] = worker_metrics
+        return JSONResponse(resp)

{langgraph_api-0.10.2 → langgraph_api-0.11.0}/langgraph_api/api/runs.py

@@ -787,7 +787,9 @@ async def create_cron(request: ApiRequest):
 
     enabled = payload.get("enabled", True)
 
-    async with connect(supports_core_api=False) as conn:
+    # gRPC/postgres Crons route through core-api and ignore ``conn`` (the default
+    # ``connect()`` yields None there); inmem uses the yielded connection.
+    async with connect() as conn:
         cron = await Crons.put(
             conn,
             thread_id=None,
@@ -834,7 +836,7 @@ async def create_thread_cron(request: ApiRequest):
             CRON_PAYLOAD_ENCRYPTION_SUBFIELDS,
         )
 
-    async with connect(supports_core_api=False) as conn:
+    async with connect() as conn:
         cron = await Crons.put(
             conn,
             thread_id=thread_id,
@@ -890,7 +892,7 @@ async def patch_cron(request: ApiRequest):
             CRON_PAYLOAD_ENCRYPTION_SUBFIELDS,
         )
 
-    async with connect(supports_core_api=False) as conn:
+    async with connect() as conn:
         cron = await Crons.update(
             conn,
             cron_id=cron_id,
@@ -917,7 +919,7 @@ async def delete_cron(request: ApiRequest):
     validate_uuid(cron_id, "Invalid cron ID: must be a UUID")
 
     try:
-        async with connect(supports_core_api=False) as conn:
+        async with connect() as conn:
             cid = await Crons.delete(
                 conn,
                 cron_id=cron_id,
@@ -940,7 +942,7 @@ async def search_crons(request: ApiRequest):
         validate_uuid(thread_id, "Invalid thread ID: must be a UUID")
 
     offset = int(payload.get("offset", 0))
-    async with connect(supports_core_api=False) as conn:
+    async with connect() as conn:
         crons_iter, next_offset = await Crons.search(
             conn,
             assistant_id=assistant_id,
@@ -972,7 +974,7 @@ async def count_crons(request: ApiRequest):
     if thread_id := payload.get("thread_id"):
         validate_uuid(thread_id, "Invalid thread ID: must be a UUID")
 
-    async with connect(supports_core_api=False) as conn:
+    async with connect() as conn:
         count = await Crons.count(
             conn,
             assistant_id=assistant_id,

{langgraph_api-0.10.2 → langgraph_api-0.11.0}/langgraph_api/api/threads.py

@@ -13,7 +13,10 @@ from langgraph_api.encryption.shared import (
     using_aes_encryption,
     using_custom_encryption,
 )
-from langgraph_api.feature_flags import IS_POSTGRES_OR_GRPC_BACKEND
+from langgraph_api.feature_flags import (
+    IS_POSTGRES_OR_GRPC_BACKEND,
+    PREFER_GRPC_CHECKPOINTER,
+)
 from langgraph_api.route import ApiRequest, ApiResponse, ApiRoute
 from langgraph_api.schema import (
     THREAD_ENCRYPTION_FIELDS,
@@ -82,7 +85,7 @@ async def create_thread(
         )
     else:
         # Need connection for inmem put or gRPC State.bulk
-        async with connect(supports_core_api=False) as conn:
+        async with connect(supports_core_api=PREFER_GRPC_CHECKPOINTER) as conn:
             iter = await Threads.put(
                 conn,
                 thread_id,
@@ -226,7 +229,7 @@ async def get_thread_state(
     thread_id = request.path_params["thread_id"]
     validate_uuid(thread_id, "Invalid thread ID: must be a UUID")
     subgraphs = request.query_params.get("subgraphs") in ("true", "True")
-    async with connect(supports_core_api=False) as conn:
+    async with connect(supports_core_api=PREFER_GRPC_CHECKPOINTER) as conn:
         config = {
             "configurable": {
                 **get_configurable_headers(request.headers),
@@ -247,7 +250,7 @@ async def get_thread_state_at_checkpoint(
     thread_id = request.path_params["thread_id"]
     validate_uuid(thread_id, "Invalid thread ID: must be a UUID")
     checkpoint_id = request.path_params["checkpoint_id"]
-    async with connect(supports_core_api=False) as conn:
+    async with connect(supports_core_api=PREFER_GRPC_CHECKPOINTER) as conn:
         config = {
             "configurable": {
                 **get_configurable_headers(request.headers),
@@ -273,7 +276,7 @@ async def get_thread_state_at_checkpoint_post(
     thread_id = request.path_params["thread_id"]
     validate_uuid(thread_id, "Invalid thread ID: must be a UUID")
     payload = await request.json(ThreadStateCheckpointRequest)
-    async with connect(supports_core_api=False) as conn:
+    async with connect(supports_core_api=PREFER_GRPC_CHECKPOINTER) as conn:
         config = {
             "configurable": {
                 **payload["checkpoint"],
@@ -311,7 +314,7 @@ async def update_thread_state(
         pass
     config["configurable"].update(get_configurable_headers(request.headers))
     config["configurable"]["thread_id"] = thread_id
-    async with connect(supports_core_api=False) as conn:
+    async with connect(supports_core_api=PREFER_GRPC_CHECKPOINTER) as conn:
         inserted = await Threads.State.post(
             conn,
             config,
@@ -341,7 +344,7 @@ async def get_thread_history(
             **get_configurable_headers(request.headers),
         }
     }
-    async with connect(supports_core_api=False) as conn:
+    async with connect(supports_core_api=PREFER_GRPC_CHECKPOINTER) as conn:
         states = [
             state_snapshot_to_thread_state(c)
             for c in await Threads.State.list(
@@ -363,7 +366,7 @@ async def get_thread_history_post(
     config["configurable"].update(payload.get("checkpoint", {}))
     config["configurable"].update(get_configurable_headers(request.headers))
     config["configurable"]["thread_id"] = thread_id
-    async with connect(supports_core_api=False) as conn:
+    async with connect(supports_core_api=PREFER_GRPC_CHECKPOINTER) as conn:
         states = [
             state_snapshot_to_thread_state(c)
             for c in await Threads.State.list(

{langgraph_api-0.10.2 → langgraph_api-0.11.0}/langgraph_api/cli.py

@@ -109,7 +109,12 @@ def _find_open_port(host: str) -> int:
 
 
 def _resolve_server_url(
-    host: str, port: int, *, mount_prefix: str | None, tunnel: bool
+    host: str,
+    port: int,
+    *,
+    mount_prefix: str | None,
+    tunnel: bool,
+    is_ssl: bool,
 ) -> str:
     """Return the public-facing base URL for the server.
 
@@ -119,11 +124,15 @@ def _resolve_server_url(
     """
     from langgraph_api.utils.network import format_hostport  # noqa: PLC0415
 
-    upstream_url = f"http://{format_hostport(host, port)}"
+    upstream_url = (
+        f"http://{format_hostport(host, port)}"
+        if not is_ssl
+        else f"https://{format_hostport(host, port)}"
+    )
     if mount_prefix:
         upstream_url += mount_prefix
 
-    if not tunnel:
+    if not tunnel or is_ssl:
         return upstream_url
 
     logger.info("Starting Cloudflare Tunnel...")
@@ -185,6 +194,8 @@ def run_server(
     allow_blocking: bool = False,
     runtime_edition: Literal["inmem", "community", "postgres"] = "inmem",
     server_level: str = "WARNING",
+    ssl_certfile: str | pathlib.Path | None = None,
+    ssl_keyfile: str | pathlib.Path | None = None,
     __redis_uri__: str | None = "fake",
     __database_uri__: str | None = ":memory:",
     __migrations_path__: str | None = "__inmem",
@@ -282,8 +293,13 @@ def run_server(
             to_patch[k] = v
 
     with patch_environment(**to_patch):
+        is_ssl = ssl_certfile is not None and ssl_keyfile is not None
         local_url = _resolve_server_url(
-            host, port, mount_prefix=mount_prefix, tunnel=tunnel
+            host,
+            port,
+            mount_prefix=mount_prefix,
+            tunnel=tunnel,
+            is_ssl=is_ssl,
         )
         os.environ["LANGGRAPH_API_URL"] = local_url
 
@@ -292,6 +308,7 @@ def run_server(
 
         def _open_browser():
             nonlocal studio_origin, full_studio_url
+            import ssl  # noqa: PLC0415
             import webbrowser  # noqa: PLC0415
 
             thread_logger = logging.getLogger("browser_opener")
@@ -302,10 +319,17 @@ def run_server(
 
             with ThreadPoolExecutor(max_workers=1) as executor:
                 org_id_future = executor.submit(_get_org_id)
+                context = (
+                    ssl._create_unverified_context()
+                    if ssl_certfile and ssl_keyfile
+                    else None
+                )
 
                 while True:
                     try:
-                        with urllib.request.urlopen(f"{local_url}/ok") as response:
+                        with urllib.request.urlopen(
+                            f"{local_url}/ok", context=context
+                        ) as response:
                             if response.status == 200:
                                 try:
                                     org_id = org_id_future.result(timeout=3.0)
@@ -373,6 +397,8 @@ For production use, please use LangSmith Deployment.
             access_log=False,
             reload_includes=list(reload_includes) if reload_includes else None,
             reload_excludes=list(reload_excludes) if reload_excludes else None,
+            ssl_certfile=ssl_certfile,
+            ssl_keyfile=ssl_keyfile,
             log_config={
                 "version": 1,
                 "incremental": False,

{langgraph_api-0.10.2 → langgraph_api-0.11.0}/langgraph_api/config/__init__.py

@@ -4,7 +4,7 @@ from typing import TYPE_CHECKING, Annotated, Literal, TypeVar, cast
 
 import structlog
 from pydantic.functional_validators import AfterValidator
-from starlette.config import Config, undefined
+from starlette.config import Config
 from starlette.datastructures import CommaSeparatedStrings
 
 from langgraph_api import traceblock
@@ -41,7 +41,14 @@ STATS_INTERVAL_SECS = env("STATS_INTERVAL_SECS", cast=int, default=60)
 # storage
 
 # Not in public docs: infrastructure, set by platform
-DATABASE_URI = env("DATABASE_URI", cast=str, default=getenv("POSTGRES_URI", undefined))
+# Optional: persistence can go through the Go core over gRPC, so the Python
+# runtime can start without a direct DB connection string. When unset, the
+# Postgres runtime skips creating a psycopg pool (see database._startup_needs /
+# database.start_pool). Callers that still require a direct connection fail
+# loudly via connect()'s "Postgres pool not initialized" guard.
+DATABASE_URI: str | None = env(
+    "DATABASE_URI", cast=str, default=getenv("POSTGRES_URI", None)
+)
 # Not in public docs: infrastructure, set by platform
 MIGRATIONS_PATH = env("MIGRATIONS_PATH", cast=str, default="/storage/migrations")
 POSTGRES_POOL_MAX_SIZE = env("LANGGRAPH_POSTGRES_POOL_MAX_SIZE", cast=int, default=150)
@@ -243,6 +250,12 @@ WEBHOOKS_ENABLED = HTTP_CONFIG and HTTP_CONFIG.get("disable_webhooks")
 STORE_CONFIG = env(
     "LANGGRAPH_STORE", cast=_parse.parse_schema(StoreConfig), default=None
 )
+LANGGRAPH_STORE_BACKEND = env("LANGGRAPH_STORE_BACKEND", cast=str, default="python")
+USE_GRPC_STORE = LANGGRAPH_STORE_BACKEND == "grpc"
+
+# When true, the Go core-server owns Postgres schema setup (DB migrations +
+# vector index)
+DB_MIGRATION_BY_CORE_API = env("DB_MIGRATION_BY_CORE_API", cast=bool, default=False)
 
 
 def _validate_mount_prefix(mount_prefix: str | None) -> str | None:
@@ -320,7 +333,6 @@ if (
 # queue
 
 BG_JOB_HEARTBEAT = 120  # seconds
-BG_JOB_INTERVAL = 30  # seconds
 BG_JOB_MAX_RETRIES = env("BG_JOB_MAX_RETRIES", cast=int, default=3)
 BG_JOB_ISOLATED_LOOPS = env("BG_JOB_ISOLATED_LOOPS", cast=bool, default=False)
 BG_JOB_SHUTDOWN_GRACE_PERIOD_SECS = env(
@@ -578,6 +590,13 @@ METRIC_MAX_EMITTING_TIER = env(
     "METRIC_MAX_EMITTING_TIER", cast=int, default=_METRIC_MAX_EMITTING_TIER_DEFAULT
 )
 DATADOG_METRICS_ENABLED = bool(LSD_DD_API_KEY)
+# When true, the Prometheus scrape (/metrics) exposes ALL metrics, not just the
+# lsd_web_metric (Deployment-UI) set. Record-time tier filtering
+# (METRIC_MAX_EMITTING_TIER) still applies, so internal metrics must be within the
+# max emitting tier to be recorded at all.
+EXPOSE_INTERNAL_METRICS_PROMETHEUS = env(
+    "EXPOSE_INTERNAL_METRICS_PROMETHEUS", cast=bool, default=False
+)
 LANGGRAPH_LOGS_ENDPOINT = env("LANGGRAPH_LOGS_ENDPOINT", cast=str, default=None)
 LANGGRAPH_LOGS_ENABLED = env("LANGGRAPH_LOGS_ENABLED", cast=bool, default=False)
 
@@ -620,7 +639,6 @@ __all__ = [
     "ALLOW_PRIVATE_NETWORK",
     "API_VARIANT",
     "BG_JOB_HEARTBEAT",
-    "BG_JOB_INTERVAL",
     "BG_JOB_ISOLATED_LOOPS",
     "BG_JOB_MAX_RETRIES",
     "BG_JOB_SHUTDOWN_GRACE_PERIOD_SECS",
@@ -635,6 +653,8 @@ __all__ = [
     "CRON_SCHEDULER_SLEEP_TIME",
     "DATABASE_URI",
     "DATADOG_METRICS_ENABLED",
+    "DB_MIGRATION_BY_CORE_API",
+    "EXPOSE_INTERNAL_METRICS_PROMETHEUS",
     "FF_CRONS_ENABLED",
     "FF_LOG_DROPPED_EVENTS",
     "FF_LOG_QUERY_AND_PARAMS",
@@ -662,6 +682,7 @@ __all__ = [
     "LANGGRAPH_METRICS_ENDPOINT",
     "LANGGRAPH_METRICS_EXPORT_INTERVAL_MS",
     "LANGGRAPH_POSTGRES_EXTENSIONS",
+    "LANGGRAPH_STORE_BACKEND",
     "LANGSMITH_API_KEY",
     "LANGSMITH_AUTH_ENDPOINT",
     "LANGSMITH_AUTH_VERIFY_TENANT_ID",
@@ -709,6 +730,7 @@ __all__ = [
     "USES_STORE_TTL",
     "USES_THREAD_TTL",
     "USE_CUSTOM_CHECKPOINTER",
+    "USE_GRPC_STORE",
     "AuthConfig",
     "CheckpointerConfig",
     "CorsConfig",