langgraph-api 0.4.7__py3-none-any.whl → 0.4.9__py3-none-any.whl

langgraph_api/api/assistants.py

@@ -24,6 +24,7 @@ from langgraph_api.utils import (
     validate_select_columns,
     validate_uuid,
 )
+from langgraph_api.utils.headers import get_configurable_headers
 from langgraph_api.validation import (
     AssistantCountRequest,
     AssistantCreate,
@@ -240,6 +241,9 @@ async def get_assistant_graph(
         assistant_ = await Assistants.get(conn, assistant_id)
         assistant = await fetchone(assistant_)
     config = await ajson_loads(assistant["config"])
+    configurable = config.setdefault("configurable", {})
+    configurable.update(get_configurable_headers(request.headers))
+
     async with get_graph(
         assistant["graph_id"],
         config,
@@ -294,6 +298,8 @@ async def get_assistant_subgraphs(
         assistant_ = await Assistants.get(conn, assistant_id)
         assistant = await fetchone(assistant_)
         config = await ajson_loads(assistant["config"])
+        configurable = config.setdefault("configurable", {})
+        configurable.update(get_configurable_headers(request.headers))
         async with get_graph(
             assistant["graph_id"],
             config,
@@ -340,6 +346,8 @@ async def get_assistant_schemas(
         # TODO Implementa  cache so we can de-dent and release this connection.
         assistant = await fetchone(assistant_)
         config = await ajson_loads(assistant["config"])
+        configurable = config.setdefault("configurable", {})
+        configurable.update(get_configurable_headers(request.headers))
         async with get_graph(
             assistant["graph_id"],
             config,

langgraph_api/api/threads.py

@@ -16,6 +16,7 @@ from langgraph_api.utils import (
     validate_stream_id,
     validate_uuid,
 )
+from langgraph_api.utils.headers import get_configurable_headers
 from langgraph_api.validation import (
     ThreadCountRequest,
     ThreadCreate,
@@ -47,12 +48,17 @@ async def create_thread(
             if_exists=payload.get("if_exists") or "raise",
             ttl=payload.get("ttl"),
         )
-
+        config = {
+            "configurable": {
+                **get_configurable_headers(request.headers),
+                "thread_id": thread_id,
+            }
+        }
         if supersteps := payload.get("supersteps"):
             try:
                 await Threads.State.bulk(
                     conn,
-                    config={"configurable": {"thread_id": thread_id}},
+                    config=config,
                     supersteps=supersteps,
                 )
             except HTTPException as e:
@@ -77,6 +83,7 @@ async def search_threads(
             status=payload.get("status"),
             values=payload.get("values"),
             metadata=payload.get("metadata"),
+            ids=payload.get("ids"),
             limit=limit,
             offset=offset,
             sort_by=payload.get("sort_by"),
@@ -114,10 +121,14 @@ async def get_thread_state(
     validate_uuid(thread_id, "Invalid thread ID: must be a UUID")
     subgraphs = request.query_params.get("subgraphs") in ("true", "True")
     async with connect() as conn:
+        config = {
+            "configurable": {
+                **get_configurable_headers(request.headers),
+                "thread_id": thread_id,
+            }
+        }
         state = state_snapshot_to_thread_state(
-            await Threads.State.get(
-                conn, {"configurable": {"thread_id": thread_id}}, subgraphs=subgraphs
-            )
+            await Threads.State.get(conn, config=config, subgraphs=subgraphs)
         )
     return ApiResponse(state)
 
@@ -131,15 +142,17 @@ async def get_thread_state_at_checkpoint(
     validate_uuid(thread_id, "Invalid thread ID: must be a UUID")
     checkpoint_id = request.path_params["checkpoint_id"]
     async with connect() as conn:
+        config = {
+            "configurable": {
+                **get_configurable_headers(request.headers),
+                "thread_id": thread_id,
+                "checkpoint_id": checkpoint_id,
+            }
+        }
         state = state_snapshot_to_thread_state(
             await Threads.State.get(
                 conn,
-                {
-                    "configurable": {
-                        "thread_id": thread_id,
-                        "checkpoint_id": checkpoint_id,
-                    }
-                },
+                config=config,
                 subgraphs=request.query_params.get("subgraphs") in ("true", "True"),
             )
         )
@@ -155,10 +168,17 @@ async def get_thread_state_at_checkpoint_post(
     validate_uuid(thread_id, "Invalid thread ID: must be a UUID")
     payload = await request.json(ThreadStateCheckpointRequest)
     async with connect() as conn:
+        config = {
+            "configurable": {
+                **payload["checkpoint"],
+                **get_configurable_headers(request.headers),
+                "thread_id": thread_id,
+            }
+        }
         state = state_snapshot_to_thread_state(
             await Threads.State.get(
                 conn,
-                {"configurable": {"thread_id": thread_id, **payload["checkpoint"]}},
+                config=config,
                 subgraphs=payload.get("subgraphs", False),
             )
         )
@@ -183,6 +203,7 @@ async def update_thread_state(
             config["configurable"]["user_id"] = user_id
     except AssertionError:
         pass
+    config["configurable"].update(get_configurable_headers(request.headers))
     async with connect() as conn:
         inserted = await Threads.State.post(
             conn,
@@ -206,7 +227,13 @@ async def get_thread_history(
     except ValueError:
         raise HTTPException(status_code=422, detail=f"Invalid limit {limit_}") from None
     before = request.query_params.get("before")
-    config = {"configurable": {"thread_id": thread_id, "checkpoint_ns": ""}}
+    config = {
+        "configurable": {
+            "thread_id": thread_id,
+            "checkpoint_ns": "",
+            **get_configurable_headers(request.headers),
+        }
+    }
     async with connect() as conn:
         states = [
             state_snapshot_to_thread_state(c)
@@ -227,6 +254,7 @@ async def get_thread_history_post(
     payload = await request.json(ThreadStateSearch)
     config = {"configurable": {"thread_id": thread_id, "checkpoint_ns": ""}}
     config["configurable"].update(payload.get("checkpoint", {}))
+    config["configurable"].update(get_configurable_headers(request.headers))
     async with connect() as conn:
         states = [
             state_snapshot_to_thread_state(c)

langgraph_api/models/run.py

@@ -1,13 +1,11 @@
 import asyncio
 import contextlib
 import time
-import urllib.parse
 import uuid
 from collections.abc import Mapping, Sequence
 from typing import Any, NamedTuple, cast
 from uuid import UUID
 
-import orjson
 import structlog
 from starlette.authentication import BaseUser
 from starlette.exceptions import HTTPException
@@ -27,7 +25,7 @@ from langgraph_api.schema import (
     StreamMode,
 )
 from langgraph_api.utils import AsyncConnectionProto, get_auth_ctx
-from langgraph_api.utils.headers import should_include_header
+from langgraph_api.utils.headers import get_configurable_headers
 from langgraph_api.utils.uuids import uuid7
 from langgraph_runtime.ops import Runs
 
@@ -180,69 +178,6 @@ def get_user_id(user: BaseUser | None) -> str | None:
             pass
 
 
-LANGSMITH_METADATA = "langsmith-metadata"
-LANGSMITH_TAGS = "langsmith-tags"
-LANGSMITH_PROJECT = "langsmith-project"
-
-
-# Default headers to exclude from run configuration for security
-DEFAULT_RUN_HEADERS_EXCLUDE = {"x-api-key", "x-tenant-id", "x-service-key"}
-
-
-def get_configurable_headers(headers: Mapping[str, str]) -> dict[str, str]:
-    """Extract headers that should be added to run configuration.
-
-    This function handles special cases like langsmith-trace and baggage headers,
-    while respecting the configurable header patterns.
-    """
-    configurable = {}
-
-    for key, value in headers.items():
-        # First handle tracing stuff - always included regardless of patterns
-        if key == "langsmith-trace":
-            configurable[key] = value
-            if baggage := headers.get("baggage"):
-                for item in baggage.split(","):
-                    baggage_key, baggage_value = item.split("=")
-                    if (
-                        baggage_key == LANGSMITH_METADATA
-                        and baggage_key not in configurable
-                    ):
-                        configurable[baggage_key] = orjson.loads(
-                            urllib.parse.unquote(baggage_value)
-                        )
-                    elif baggage_key == LANGSMITH_TAGS:
-                        configurable[baggage_key] = urllib.parse.unquote(
-                            baggage_value
-                        ).split(",")
-                    elif baggage_key == LANGSMITH_PROJECT:
-                        configurable[baggage_key] = urllib.parse.unquote(baggage_value)
-            continue
-
-        # Check if header should be included based on patterns
-        # For run configuration, we have specific default behavior for x-* headers
-        if key.startswith("x-"):
-            # Check against default excludes for x-* headers
-            if key in DEFAULT_RUN_HEADERS_EXCLUDE:
-                # Check if explicitly included via patterns
-                if should_include_header(key):
-                    configurable[key] = value
-                continue
-            # Other x-* headers are included by default unless patterns exclude them
-            if should_include_header(key):
-                configurable[key] = value
-        elif key == "user-agent":
-            # user-agent is included by default unless excluded by patterns
-            if should_include_header(key):
-                configurable[key] = value
-        else:
-            # All other headers only included if patterns allow
-            if should_include_header(key):
-                configurable[key] = value
-
-    return configurable
-
-
 async def create_valid_run(
     conn: AsyncConnectionProto,
     thread_id: str | None,
@@ -319,7 +254,7 @@ async def create_valid_run(
         configurable["__langsmith_example_id__"] = ls_tracing.get("example_id")
     if request_start_time:
         configurable["__request_start_time_ms__"] = request_start_time
-    after_seconds = payload.get("after_seconds", 0)
+    after_seconds = cast(int, payload.get("after_seconds", 0))
     configurable["__after_seconds__"] = after_seconds
     put_time_start = time.time()
     if_not_exists = payload.get("if_not_exists", "reject")

langgraph_api/utils/headers.py

@@ -2,6 +2,16 @@
 
 import functools
 import re
+import urllib.parse
+from collections.abc import Mapping
+
+import orjson
+
+LANGSMITH_METADATA = "langsmith-metadata"
+LANGSMITH_TAGS = "langsmith-tags"
+LANGSMITH_PROJECT = "langsmith-project"
+# For security, don't include these in configuration
+DEFAULT_RUN_HEADERS_EXCLUDE = {"x-api-key", "x-tenant-id", "x-service-key"}
 
 
 def translate_pattern(pat: str) -> re.Pattern[str]:
@@ -23,6 +33,62 @@ def translate_pattern(pat: str) -> re.Pattern[str]:
     return re.compile(rf"(?s:{pattern})\Z")
 
 
+def get_configurable_headers(headers: Mapping[str, str]) -> dict[str, str]:
+    """Extract headers that should be added to run configuration.
+
+    This function handles special cases like langsmith-trace and baggage headers,
+    while respecting the configurable header patterns.
+    """
+    configurable = {}
+    if not headers:
+        return configurable
+
+    for key, value in headers.items():
+        # First handle tracing stuff - always included regardless of patterns
+        if key == "langsmith-trace":
+            configurable[key] = value
+            if baggage := headers.get("baggage"):
+                for item in baggage.split(","):
+                    baggage_key, baggage_value = item.split("=")
+                    if (
+                        baggage_key == LANGSMITH_METADATA
+                        and baggage_key not in configurable
+                    ):
+                        configurable[baggage_key] = orjson.loads(
+                            urllib.parse.unquote(baggage_value)
+                        )
+                    elif baggage_key == LANGSMITH_TAGS:
+                        configurable[baggage_key] = urllib.parse.unquote(
+                            baggage_value
+                        ).split(",")
+                    elif baggage_key == LANGSMITH_PROJECT:
+                        configurable[baggage_key] = urllib.parse.unquote(baggage_value)
+            continue
+
+        # Check if header should be included based on patterns
+        # For run configuration, we have specific default behavior for x-* headers
+        if key.startswith("x-"):
+            # Check against default excludes for x-* headers
+            if key in DEFAULT_RUN_HEADERS_EXCLUDE:
+                # Check if explicitly included via patterns
+                if should_include_header(key):
+                    configurable[key] = value
+                continue
+            # Other x-* headers are included by default unless patterns exclude them
+            if should_include_header(key):
+                configurable[key] = value
+        elif key == "user-agent":
+            # user-agent is included by default unless excluded by patterns
+            if should_include_header(key):
+                configurable[key] = value
+        else:
+            # All other headers only included if patterns allow
+            if should_include_header(key):
+                configurable[key] = value
+
+    return configurable
+
+
 @functools.lru_cache(maxsize=1)
 def get_header_patterns(
     key: str,
@@ -93,5 +159,5 @@ def pattern_matches(
         # If include patterns are specified, only include headers matching them
         return any(pattern.match(key) for pattern in include_patterns)
 
-    # Default behavior - include if not excluded
-    return True
+    # Default behavior - exclude
+    return False

{langgraph_api-0.4.7.dist-info → langgraph_api-0.4.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langgraph-api
-Version: 0.4.7
+Version: 0.4.9
 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.10.0,>=0.9.0
+Requires-Dist: langgraph-runtime-inmem<0.11.0,>=0.10.0
 Requires-Dist: langgraph-sdk>=0.2.0
 Requires-Dist: langgraph>=0.4.0
 Requires-Dist: langsmith>=0.3.45

{langgraph_api-0.4.7.dist-info → langgraph_api-0.4.9.dist-info}/RECORD

@@ -1,4 +1,4 @@
-langgraph_api/__init__.py,sha256=MHGyAIWXVeovtteWUUSzLq9UGWJLLooUZCXB9KGpNK8,22
+langgraph_api/__init__.py,sha256=LdxLMJM_JXsCQBeSvnxCNyGWmINE0yWfna3DQaT41Vs,22
 langgraph_api/asgi_transport.py,sha256=XtiLOu4WWsd-xizagBLzT5xUkxc9ZG9YqwvETBPjBFE,5161
 langgraph_api/asyncio.py,sha256=NjHFvZStKryAAfGOrl3-efHtCzibvpDx-dl8PnrE1Tk,9588
 langgraph_api/cli.py,sha256=-ruIeKi1imvS6GriOfRDZY-waV4SbWiJ0BEFAciPVYI,16330
@@ -25,18 +25,18 @@ langgraph_api/store.py,sha256=NIoNZojs6NbtG3VLBPQEFNttvp7XPkHAfjbQ3gY7aLY,4701
 langgraph_api/stream.py,sha256=V8jWwA3wBRenMk3WIFkt0OLXm_LhPwg_Yj_tP4Dc6iI,18970
 langgraph_api/thread_ttl.py,sha256=7H3gFlWcUiODPoaEzcwB0LR61uvcuyjD0ew_4BztB7k,1902
 langgraph_api/traceblock.py,sha256=Qq5CUdefnMDaRDnyvBSWGBClEj-f3oO7NbH6fedxOSE,630
-langgraph_api/utils.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langgraph_api/validation.py,sha256=86jftgOsMa7tkeshBw6imYe7zyUXPoVuf5Voh6dFiR8,5285
 langgraph_api/webhook.py,sha256=SvSM1rdnNtiH4q3JQYmAqJUk2Sable5xAcwOLuRhtlo,1723
 langgraph_api/worker.py,sha256=M9WQdxEzVGDZqdjz3LHEHhM1g6isPcf3k1V4PEkcSY8,15343
-langgraph_api/api/__init__.py,sha256=WHy6oNLWtH1K7AxmmsU9RD-Vm6WP-Ov16xS8Ey9YCmQ,6090
-langgraph_api/api/assistants.py,sha256=5gVvU58Y1-EftBhCHGbEaOi_7cqGMKWhOt_GVfBC0Gg,16836
+langgraph_api/api/__init__.py,sha256=raFkYH50tsO-KjRmDbGVoHCuxuH58u1lrZbr-MlITIY,6262
+langgraph_api/api/a2a.py,sha256=HralDXn_sbTnZIKfRfC-1Gl2SHX3Z74vYkTkBA-mlyw,35143
+langgraph_api/api/assistants.py,sha256=JFaBYp9BAXGaJ0yfy1SG_Mr-3xjeWSkdCHtmXpiAqP4,17290
 langgraph_api/api/mcp.py,sha256=qe10ZRMN3f-Hli-9TI8nbQyWvMeBb72YB1PZVbyqBQw,14418
 langgraph_api/api/meta.py,sha256=dFD9ZgykbKARLdVSaJD9vO3CShvEyBmGpkjE8tqii0c,4448
 langgraph_api/api/openapi.py,sha256=If-z1ckXt-Yu5bwQytK1LWyX_T7G46UtLfixgEP8hwc,11959
 langgraph_api/api/runs.py,sha256=Dzqg3Klnp_7QVHl26J51DpSlMvBhgUdwcKeeMQdqa4Y,22127
 langgraph_api/api/store.py,sha256=xGcPFx4v-VxlK6HRU9uCjzCQ0v66cvc3o_PB5_g7n0Q,5550
-langgraph_api/api/threads.py,sha256=dw176K8gFh0BIxADmkyZw68brzlOqUZbtpFBNQPxvow,11998
+langgraph_api/api/threads.py,sha256=5L-NLqCazjxNZYBUWKo8HFYw7BdMVJd87prMVOH4gjE,12824
 langgraph_api/api/ui.py,sha256=_genglTUy5BMHlL0lkQypX524yFv6Z5fraIvnrxp7yE,2639
 langgraph_api/auth/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langgraph_api/auth/custom.py,sha256=psETw_GpLWClBbd_ESVPRLUz9GLQ0_XNsuUDSVbtZy0,22522
@@ -55,9 +55,6 @@ langgraph_api/js/client.http.mts,sha256=cvn8JV9go4pUMWkcug8FfSYWsp1wTaT8SgJaskqE
 langgraph_api/js/client.mts,sha256=gDvYiW7Qfl4re2YhZ5oNqtuvffnW_Sf7DK5aUbKB3vw,32330
 langgraph_api/js/errors.py,sha256=Cm1TKWlUCwZReDC5AQ6SgNIVGD27Qov2xcgHyf8-GXo,361
 langgraph_api/js/global.d.ts,sha256=j4GhgtQSZ5_cHzjSPcHgMJ8tfBThxrH-pUOrrJGteOU,196
-langgraph_api/js/isolate-0x130008000-46649-46649-v8.log,sha256=s6h4v7ZtOBK9tKJ0zzPojnob7MBV2j-nyLVPGbgotdg,2641826
-langgraph_api/js/isolate-0x138008000-44681-44681-v8.log,sha256=knAbmQTmz2umDoqMXKuThsmgc4Q6b1HBwZ2ZFUcFu40,2644591
-langgraph_api/js/package-lock.json,sha256=bGM4LYdWJxAb5JE6Tap1-WA_IqRE_CzBjxZTCcMt1_U,117589
 langgraph_api/js/package.json,sha256=syy2fEcmTxGQVfz4P9MUTgoTxHr1MUcA1rDXemAig2U,1335
 langgraph_api/js/remote.py,sha256=aeszJ0HGbcL9oExyeWYHb0xLV75U3KgVSxjm3ZK_a48,38403
 langgraph_api/js/schema.py,sha256=M4fLtr50O1jck8H1hm_0W4cZOGYGdkrB7riLyCes4oY,438
@@ -78,13 +75,13 @@ langgraph_api/middleware/http_logger.py,sha256=2LABfhzTAUtqT8nf1ACy8cYXteatkwraB
 langgraph_api/middleware/private_network.py,sha256=eYgdyU8AzU2XJu362i1L8aSFoQRiV7_aLBPw7_EgeqI,2111
 langgraph_api/middleware/request_id.py,sha256=SDj3Yi3WvTbFQ2ewrPQBjAV8sYReOJGeIiuoHeZpR9g,1242
 langgraph_api/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langgraph_api/models/run.py,sha256=21VmE9R1GeHEgshDYGm462ADFo7tkBx-JJGDOAdrDcA,15894
+langgraph_api/models/run.py,sha256=HAMvpmIVnGcuOaKoDcpEfeRWo00-bmX_Gvp6lqo7VO0,13223
 langgraph_api/tunneling/cloudflare.py,sha256=iKb6tj-VWPlDchHFjuQyep2Dpb-w2NGfJKt-WJG9LH0,3650
 langgraph_api/utils/__init__.py,sha256=yCMq7pOMlmeNmi2Fh8U7KLiljBdOMcF0L2SfpobnKKE,5703
 langgraph_api/utils/cache.py,sha256=SrtIWYibbrNeZzLXLUGBFhJPkMVNQnVxR5giiYGHEfI,1810
 langgraph_api/utils/config.py,sha256=Tbp4tKDSLKXQJ44EKr885wAQupY-9VWNJ6rgUU2oLOY,4162
 langgraph_api/utils/future.py,sha256=lXsRQPhJwY7JUbFFZrK-94JjgsToLu-EWU896hvbUxE,7289
-langgraph_api/utils/headers.py,sha256=eN7CXh7X7iFtLicKFdKX0jhhmWWyxAAfrths7mKNtO4,2942
+langgraph_api/utils/headers.py,sha256=NDBmKSSVOOYeYN0HfK1a3xbYtAg35M_JO1G9yklpZsA,5682
 langgraph_api/utils/uuids.py,sha256=AW_9-1iFqK2K5hljmi-jtaNzUIoBshk5QPt8LbpbD2g,2975
 langgraph_license/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langgraph_license/validation.py,sha256=CU38RUZ5xhP1S8F_y8TNeV6OmtO-tIGjCXbXTwJjJO4,612
@@ -99,9 +96,9 @@ langgraph_runtime/retry.py,sha256=V0duD01fO7GUQ_btQkp1aoXcEOFhXooGVP6q4yMfuyY,11
 langgraph_runtime/store.py,sha256=7mowndlsIroGHv3NpTSOZDJR0lCuaYMBoTnTrewjslw,114
 LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
 logging.json,sha256=3RNjSADZmDq38eHePMm1CbP6qZ71AmpBtLwCmKU9Zgo,379
-openapi.json,sha256=FC4L4qGt6Twl933Z78v2y99WA_sNk74-TTQdG9MzFgE,164038
-langgraph_api-0.4.7.dist-info/METADATA,sha256=kmNYIc3yTunNik1q9Fcd_ArzoV-aB65cF1ksp0YWvF4,3891
-langgraph_api-0.4.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-langgraph_api-0.4.7.dist-info/entry_points.txt,sha256=hGedv8n7cgi41PypMfinwS_HfCwA7xJIfS0jAp8htV8,78
-langgraph_api-0.4.7.dist-info/licenses/LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
-langgraph_api-0.4.7.dist-info/RECORD,,
+openapi.json,sha256=N5FnZvLNotTOGU_CU7tTpcX1hOwIVeYdSnFsdFrPKOg,171975
+langgraph_api-0.4.9.dist-info/METADATA,sha256=0RuwP4ixFFYBGR7vkq64zXa_F7CLPoThZVmNtnLW3q0,3892
+langgraph_api-0.4.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+langgraph_api-0.4.9.dist-info/entry_points.txt,sha256=hGedv8n7cgi41PypMfinwS_HfCwA7xJIfS0jAp8htV8,78
+langgraph_api-0.4.9.dist-info/licenses/LICENSE,sha256=ZPwVR73Biwm3sK6vR54djCrhaRiM4cAD2zvOQZV8Xis,3859
+langgraph_api-0.4.9.dist-info/RECORD,,

openapi.json

@@ -29,6 +29,10 @@
       "name": "Store",
       "description": "Store is an API for managing persistent key-value store (long-term memory) that is available from any thread."
     },
+    {
+      "name": "A2A",
+      "description": "Agent-to-Agent Protocol related endpoints for exposing assistants as A2A-compliant agents."
+    },
     {
       "name": "MCP",
       "description": "Model Context Protocol related endpoints for exposing an agent as an MCP server."
@@ -3182,6 +3186,195 @@
         }
       }
     },
+    "/a2a/{assistant_id}": {
+      "post": {
+        "operationId": "post_a2a",
+        "summary": "A2A Post",
+        "description": "Communicate with an assistant using the Agent-to-Agent Protocol.\nSends a JSON-RPC 2.0 message to the assistant.\n\n- **Request**: Provide an object with `jsonrpc`, `id`, `method`, and optional `params`.\n- **Response**: Returns a JSON-RPC response with task information or error.\n\n**Supported Methods:**\n- `message/send`: Send a message to the assistant\n- `tasks/get`: Get the status and result of a task\n\n**Notes:**\n- Supports threaded conversations via thread context\n- Messages can contain text and data parts\n- Tasks run asynchronously and return completion status\n",
+        "parameters": [
+          {
+            "name": "assistant_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "description": "The ID of the assistant to communicate with"
+          },
+          {
+            "name": "Accept",
+            "in": "header",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "enum": ["application/json"]
+            },
+            "description": "Must be application/json"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "jsonrpc": {
+                    "type": "string",
+                    "enum": ["2.0"],
+                    "description": "JSON-RPC version"
+                  },
+                  "id": {
+                    "type": "string",
+                    "description": "Request identifier"
+                  },
+                  "method": {
+                    "type": "string",
+                    "enum": ["message/send", "tasks/get"],
+                    "description": "The method to invoke"
+                  },
+                  "params": {
+                    "type": "object",
+                    "description": "Method parameters",
+                    "oneOf": [
+                      {
+                        "title": "Message Send Parameters",
+                        "properties": {
+                          "message": {
+                            "type": "object",
+                            "properties": {
+                              "role": {
+                                "type": "string",
+                                "enum": ["user", "assistant"],
+                                "description": "Message role"
+                              },
+                              "parts": {
+                                "type": "array",
+                                "items": {
+                                  "oneOf": [
+                                    {
+                                      "title": "Text Part",
+                                      "type": "object",
+                                      "properties": {
+                                        "kind": {
+                                          "type": "string",
+                                          "enum": ["text"]
+                                        },
+                                        "text": {
+                                          "type": "string"
+                                        }
+                                      },
+                                      "required": ["kind", "text"]
+                                    },
+                                    {
+                                      "title": "Data Part", 
+                                      "type": "object",
+                                      "properties": {
+                                        "kind": {
+                                          "type": "string",
+                                          "enum": ["data"]
+                                        },
+                                        "data": {
+                                          "type": "object"
+                                        }
+                                      },
+                                      "required": ["kind", "data"]
+                                    }
+                                  ]
+                                },
+                                "description": "Message parts"
+                              },
+                              "messageId": {
+                                "type": "string",
+                                "description": "Unique message identifier"
+                              }
+                            },
+                            "required": ["role", "parts", "messageId"]
+                          },
+                          "thread": {
+                            "type": "object",
+                            "properties": {
+                              "threadId": {
+                                "type": "string",
+                                "description": "Thread identifier for conversation context"
+                              }
+                            },
+                            "description": "Optional thread context"
+                          }
+                        },
+                        "required": ["message"]
+                      },
+                      {
+                        "title": "Task Get Parameters",
+                        "properties": {
+                          "taskId": {
+                            "type": "string",
+                            "description": "Task identifier to retrieve"
+                          }
+                        },
+                        "required": ["taskId"]
+                      }
+                    ]
+                  }
+                },
+                "required": ["jsonrpc", "id", "method"]
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "JSON-RPC response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "jsonrpc": {
+                      "type": "string",
+                      "enum": ["2.0"]
+                    },
+                    "id": {
+                      "type": "string"
+                    },
+                    "result": {
+                      "type": "object",
+                      "description": "Success result containing task information or task details"
+                    },
+                    "error": {
+                      "type": "object",
+                      "properties": {
+                        "code": {
+                          "type": "integer"
+                        },
+                        "message": {
+                          "type": "string"
+                        }
+                      },
+                      "description": "Error information if request failed"
+                    }
+                  },
+                  "required": ["jsonrpc", "id"]
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request - invalid JSON-RPC or missing Accept header"
+          },
+          "404": {
+            "description": "Assistant not found"
+          },
+          "500": {
+            "description": "Internal server error"
+          }
+        },
+        "tags": [
+          "A2A"
+        ]
+      }
+    },
     "/mcp/": {
       "post": {
         "operationId": "post_mcp",
@@ -4822,6 +5015,12 @@
       },
       "ThreadSearchRequest": {
         "properties": {
+          "ids": {
+            "type": "array",
+            "items": {"type": "string", "format": "uuid"},
+            "title": "Ids",
+            "description": "List of thread IDs to include. Others are excluded."
+          },
           "metadata": {
             "type": "object",
             "title": "Metadata",