langgraph-api 0.12.0.dev14__tar.gz → 0.12.0.dev15__tar.gz

{langgraph_api-0.12.0.dev14 → langgraph_api-0.12.0.dev15}/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_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"}'
+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.12.0.dev14 → langgraph_api-0.12.0.dev15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langgraph-api
-Version: 0.12.0.dev14
+Version: 0.12.0.dev15
 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
@@ -29,7 +29,7 @@ Requires-Dist: prometheus-client>=0.0.1
 Requires-Dist: protobuf<7.0.0,>=6.32.1
 Requires-Dist: pyjwt>=2.13.0
 Requires-Dist: sse-starlette<3.4.0,>=2.1.3
-Requires-Dist: starlette>=0.38.6
+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.12.0.dev15/langgraph_api/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.12.0.dev15"

{langgraph_api-0.12.0.dev14 → langgraph_api-0.12.0.dev15}/langgraph_api/config/__init__.py

@@ -243,6 +243,8 @@ 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"
 
 
 def _validate_mount_prefix(mount_prefix: str | None) -> str | None:
@@ -668,6 +670,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",
@@ -715,6 +718,7 @@ __all__ = [
     "USES_STORE_TTL",
     "USES_THREAD_TTL",
     "USE_CUSTOM_CHECKPOINTER",
+    "USE_GRPC_STORE",
     "AuthConfig",
     "CheckpointerConfig",
     "CorsConfig",

{langgraph_api-0.12.0.dev14 → langgraph_api-0.12.0.dev15}/langgraph_api/grpc/ops/__init__.py

@@ -39,6 +39,7 @@ GRPC_STATUS_TO_HTTP_STATUS = {
     StatusCode.INVALID_ARGUMENT: HTTPStatus.UNPROCESSABLE_ENTITY,
     StatusCode.PERMISSION_DENIED: HTTPStatus.FORBIDDEN,
     StatusCode.UNAUTHENTICATED: HTTPStatus.UNAUTHORIZED,
+    StatusCode.RESOURCE_EXHAUSTED: HTTPStatus.TOO_MANY_REQUESTS,
 }
 
 
@@ -187,19 +188,33 @@ def _handle_grpc_error(error: AioRpcError) -> None:
     Always return detail as a string here.
     """
     error_details = error.details()
+    retry_after_seconds = None
     if error_details is not None:
         try:
             details = orjson.loads(error_details)
-            error_details = orjson.dumps(details.get("message", "")).decode()
+            retry_after_seconds = details.get("retry_after_seconds")
+            message = details.get("message", "")
+            # A string message is the detail verbatim; only re-encode structured
+            # (non-string) messages as JSON.
+            error_details = (
+                message if isinstance(message, str) else orjson.dumps(message).decode()
+            )
         except orjson.JSONDecodeError:
             # error details is not json, so just retun it as is
             pass
 
+    status_code = GRPC_STATUS_TO_HTTP_STATUS.get(
+        error.code(), HTTPStatus.INTERNAL_SERVER_ERROR
+    )
+    headers = None
+    if status_code == HTTPStatus.TOO_MANY_REQUESTS and retry_after_seconds:
+        # The Go core carries Retry-After as a structured integer (seconds).
+        headers = {"Retry-After": str(int(retry_after_seconds))}
+
     raise HTTPException(
-        status_code=GRPC_STATUS_TO_HTTP_STATUS.get(
-            error.code(), HTTPStatus.INTERNAL_SERVER_ERROR
-        ),
+        status_code=status_code,
         detail=error_details,
+        headers=headers,
     )
 
 

{langgraph_api-0.12.0.dev14 → langgraph_api-0.12.0.dev15}/langgraph_api/stream.py

@@ -339,7 +339,26 @@ async def astream_state(
                 ):
                     yield event["name"], event["data"]
                 # TODO support messages-tuple for js graphs
-                if event["event"] == "on_chain_stream" and event["run_id"] == run_id:
+                # For JS (BaseRemotePregel) with subgraphs=True, subgraph events
+                # carry the subgraph's own run_id. Accept them if the chunk is a
+                # proper 3-tuple [ns, mode, chunk] — that's the sidecar's
+                # normalized format. Limit this bypass to remote graphs only;
+                # Python child events must fall through to the raw "events"
+                # fallback below when the client requests stream_mode="events".
+                _chunk_data = (
+                    event["data"].get("chunk")
+                    if event["event"] == "on_chain_stream"
+                    else None
+                )
+                if event["event"] == "on_chain_stream" and (
+                    event["run_id"] == run_id
+                    or (
+                        subgraphs
+                        and is_remote_pregel
+                        and isinstance(_chunk_data, (list, tuple))
+                        and len(_chunk_data) == 3
+                    )
+                ):
                     if subgraphs:
                         ns, mode, chunk = event["data"]["chunk"]
                     else:

langgraph_api-0.12.0.dev15/langgraph_grpc_common/conversion/store.py

@@ -0,0 +1,208 @@
+"""Marshal langgraph.store.base GetOp/PutOp/Item/Result to and from store.proto."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import TYPE_CHECKING, Any, cast
+
+import orjson
+from google.protobuf import empty_pb2
+from langgraph.store.base import (
+    GetOp,
+    IndexConfig,
+    Item,
+    Op,
+    PutOp,
+    Result,
+    ensure_embeddings,
+    get_text_at_path,
+    tokenize_path,
+)
+
+from langgraph_grpc_common.proto import store_pb2
+
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+
+    from langchain_core.embeddings import Embeddings
+
+
+def _ensure_index_config(
+    index_config: IndexConfig,
+) -> tuple[Embeddings | None, IndexConfig]:
+    # Vendored from langgraph.store.postgres.base so grpc_common_py stays
+    # backend-agnostic (no langgraph-checkpoint-postgres / psycopg dependency).
+    index_config = index_config.copy()
+    tokenized: list[tuple[str, str | list[str]]] = []
+    tot = 0
+    fields = index_config.get("fields") or ["$"]
+    if isinstance(fields, str):
+        fields = [fields]
+    if not isinstance(fields, list):
+        raise ValueError(f"Text fields must be a list or a string. Got {fields}")
+    for p in fields:
+        if p == "$":
+            tokenized.append((p, "$"))
+            tot += 1
+        else:
+            toks = tokenize_path(p)
+            tokenized.append((p, toks))
+            tot += len(toks)
+    index_config["__tokenized_fields"] = tokenized  # ty: ignore[invalid-key]
+    index_config["__estimated_num_vectors"] = tot  # ty: ignore[invalid-key]
+    embeddings = ensure_embeddings(index_config.get("embed"))
+    return embeddings, index_config
+
+
+def _ttl_to_proto_minutes(ttl: float | None) -> int:
+    if ttl is None:
+        return 0
+    if ttl != int(ttl):
+        raise ValueError(
+            f"gRPC store only supports integer-minute TTL; got fractional ttl={ttl}"
+        )
+    return int(ttl)
+
+
+def op_to_proto(
+    op: Op,
+    *,
+    vectors: Sequence[store_pb2.VectorValue] | None = None,
+) -> store_pb2.Op:
+    if isinstance(op, GetOp):
+        return store_pb2.Op(
+            get=store_pb2.GetOp(
+                namespace=list(op.namespace),
+                key=str(op.key),
+                refreshTTL=op.refresh_ttl,
+            )
+        )
+    if isinstance(op, PutOp):
+        if op.value is None:
+            raise TypeError(
+                "PutOp with value=None (delete) is not supported by gRPC store"
+            )
+        put_kwargs: dict[str, Any] = {
+            "namespace": list(op.namespace),
+            "key": str(op.key),
+            "value_json": orjson.dumps(op.value),
+            "ttlMinutes": _ttl_to_proto_minutes(op.ttl),
+        }
+        if vectors is not None:
+            put_kwargs["vectors"] = list(vectors)
+        return store_pb2.Op(put=store_pb2.PutOp(**put_kwargs))
+    raise TypeError(f"unsupported op: {type(op).__name__}")
+
+
+def op_from_proto(msg: store_pb2.Op) -> Op:
+    kind = msg.WhichOneof("op")
+    if kind == "get":
+        g = msg.get
+        return GetOp(
+            namespace=tuple(g.namespace),
+            key=g.key,
+            refresh_ttl=g.refreshTTL,
+        )
+    if kind == "put":
+        p = msg.put
+        ttl: float | None = None
+        if p.ttlMinutes:
+            ttl = float(p.ttlMinutes)
+        return PutOp(
+            namespace=tuple(p.namespace),
+            key=p.key,
+            value=orjson.loads(p.value_json),
+            ttl=ttl,
+        )
+    raise ValueError("empty Op message (no oneof set)")
+
+
+def result_to_proto(result: Result, op: Op) -> store_pb2.OpResult:
+    if isinstance(op, GetOp):
+        if result is None:
+            return store_pb2.OpResult(none=empty_pb2.Empty())
+        if not isinstance(result, Item):
+            raise TypeError(
+                f"expected Item for GetOp result, got {type(result).__name__}"
+            )
+        return store_pb2.OpResult(item=_item_to_proto(result))
+    if isinstance(op, PutOp):
+        return store_pb2.OpResult(none=empty_pb2.Empty())
+    raise TypeError(f"unsupported op for result encoding: {type(op).__name__}")
+
+
+def result_from_proto(msg: store_pb2.OpResult) -> Result:
+    kind = msg.WhichOneof("result")
+    if kind == "none":
+        return None
+    if kind == "item":
+        return _item_from_proto(msg.item)
+    raise ValueError("empty OpResult message (no oneof set)")
+
+
+def _item_to_proto(item: Item) -> store_pb2.Item:
+    return store_pb2.Item(
+        namespace=list(item.namespace),
+        key=item.key,
+        value_json=orjson.dumps(item.value),
+        created_at=_format_dt(item.created_at),
+        updated_at=_format_dt(item.updated_at),
+    )
+
+
+def _item_from_proto(msg: store_pb2.Item) -> Item:
+    return Item(
+        namespace=tuple(msg.namespace),
+        key=msg.key,
+        value=orjson.loads(msg.value_json),
+        created_at=datetime.fromisoformat(msg.created_at),
+        updated_at=datetime.fromisoformat(msg.updated_at),
+    )
+
+
+def _format_dt(dt: datetime) -> str:
+    return dt.isoformat()
+
+
+async def vectors_for_put_op(
+    op: PutOp,
+    index_config: IndexConfig,
+    embeddings: Embeddings,
+) -> list[store_pb2.VectorValue]:
+    if op.index is False or op.value is None:
+        return []
+
+    value = op.value
+    if op.index is None:
+        paths = cast(
+            "list[tuple[str, str | list[str]]]",
+            index_config["__tokenized_fields"],  # ty: ignore[invalid-key]
+        )
+    else:
+        paths = [(ix, tokenize_path(ix)) for ix in op.index]
+
+    texts: list[str] = []
+    pathnames: list[str] = []
+    for path, tokenized_path in paths:
+        extracted = get_text_at_path(value, tokenized_path)
+        for i, text in enumerate(extracted):
+            pathname = f"{path}.{i}" if len(extracted) > 1 else path
+            pathnames.append(pathname)
+            texts.append(text)
+
+    if not texts:
+        return []
+
+    vectors = await embeddings.aembed_documents(texts)
+    return [
+        store_pb2.VectorValue(valuePath=pathname, embedding=vector)
+        for pathname, vector in zip(pathnames, vectors, strict=False)
+    ]
+
+
+def normalize_index_config(
+    index: IndexConfig | None,
+) -> tuple[Embeddings | None, IndexConfig | None]:
+    if not index:
+        return None, None
+    return _ensure_index_config(index)

{langgraph_api-0.12.0.dev14 → langgraph_api-0.12.0.dev15}/langgraph_grpc_common/proto/__init__.py

@@ -15,6 +15,8 @@ from . import engine_common_pb2
 from . import engine_common_pb2_grpc
 from . import checkpointer_pb2
 from . import checkpointer_pb2_grpc
+from . import store_pb2
+from . import store_pb2_grpc
 from . import encryption_pb2
 from . import encryption_pb2_grpc
 from . import errors_pb2
@@ -27,6 +29,8 @@ __all__ = [
     "engine_common_pb2_grpc",
     "checkpointer_pb2",
     "checkpointer_pb2_grpc",
+    "store_pb2",
+    "store_pb2_grpc",
     "encryption_pb2",
     "encryption_pb2_grpc",
     "errors_pb2",

langgraph_api-0.12.0.dev15/langgraph_grpc_common/proto/store_pb2.py

@@ -0,0 +1,54 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: store.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'store.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0bstore.proto\x12\x05store\x1a\x1bgoogle/protobuf/empty.proto\"&\n\x0c\x42\x61tchRequest\x12\x16\n\x03ops\x18\x01 \x03(\x0b\x32\t.store.Op\"1\n\rBatchResponse\x12 \n\x07results\x18\x01 \x03(\x0b\x32\x0f.store.OpResult\"D\n\x02Op\x12\x1b\n\x03get\x18\x01 \x01(\x0b\x32\x0c.store.GetOpH\x00\x12\x1b\n\x03put\x18\x02 \x01(\x0b\x32\x0c.store.PutOpH\x00\x42\x04\n\x02op\";\n\x05GetOp\x12\x11\n\tnamespace\x18\x01 \x03(\t\x12\x0b\n\x03key\x18\x02 \x01(\t\x12\x12\n\nrefreshTTL\x18\x03 \x01(\x08\"3\n\x0bVectorValue\x12\x11\n\tvaluePath\x18\x01 \x01(\t\x12\x11\n\tembedding\x18\x02 \x03(\x02\"t\n\x05PutOp\x12\x11\n\tnamespace\x18\x01 \x03(\t\x12\x0b\n\x03key\x18\x02 \x01(\t\x12\x12\n\nvalue_json\x18\x03 \x01(\x0c\x12\x12\n\nttlMinutes\x18\x04 \x01(\x05\x12#\n\x07vectors\x18\x05 \x03(\x0b\x32\x12.store.VectorValue\"Y\n\x08OpResult\x12\x1b\n\x04item\x18\x01 \x01(\x0b\x32\x0b.store.ItemH\x00\x12&\n\x04none\x18\x02 \x01(\x0b\x32\x16.google.protobuf.EmptyH\x00\x42\x08\n\x06result\"b\n\x04Item\x12\x11\n\tnamespace\x18\x01 \x03(\t\x12\x0b\n\x03key\x18\x02 \x01(\t\x12\x12\n\nvalue_json\x18\x03 \x01(\x0c\x12\x12\n\ncreated_at\x18\x04 \x01(\t\x12\x12\n\nupdated_at\x18\x05 \x01(\t2;\n\x05Store\x12\x32\n\x05\x42\x61tch\x12\x13.store.BatchRequest\x1a\x14.store.BatchResponseB?Z=github.com/langchain-ai/langgraph-api/core/internal/engine/pbb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'store_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z=github.com/langchain-ai/langgraph-api/core/internal/engine/pb'
+  _globals['_BATCHREQUEST']._serialized_start=51
+  _globals['_BATCHREQUEST']._serialized_end=89
+  _globals['_BATCHRESPONSE']._serialized_start=91
+  _globals['_BATCHRESPONSE']._serialized_end=140
+  _globals['_OP']._serialized_start=142
+  _globals['_OP']._serialized_end=210
+  _globals['_GETOP']._serialized_start=212
+  _globals['_GETOP']._serialized_end=271
+  _globals['_VECTORVALUE']._serialized_start=273
+  _globals['_VECTORVALUE']._serialized_end=324
+  _globals['_PUTOP']._serialized_start=326
+  _globals['_PUTOP']._serialized_end=442
+  _globals['_OPRESULT']._serialized_start=444
+  _globals['_OPRESULT']._serialized_end=533
+  _globals['_ITEM']._serialized_start=535
+  _globals['_ITEM']._serialized_end=633
+  _globals['_STORE']._serialized_start=635
+  _globals['_STORE']._serialized_end=694
+# @@protoc_insertion_point(module_scope)

langgraph_api-0.12.0.dev15/langgraph_grpc_common/proto/store_pb2.pyi

@@ -0,0 +1,246 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+"""
+
+from collections import abc as _abc
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import empty_pb2 as _empty_pb2
+from google.protobuf import message as _message
+from google.protobuf.internal import containers as _containers
+import builtins as _builtins
+import sys
+import typing as _typing
+
+if sys.version_info >= (3, 11):
+    from typing import TypeAlias as _TypeAlias, Never as _Never
+else:
+    from typing_extensions import TypeAlias as _TypeAlias, Never as _Never
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+@_typing.final
+class BatchRequest(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    OPS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def ops(self) -> _containers.RepeatedCompositeFieldContainer[Global___Op]: ...
+    def __init__(
+        self,
+        *,
+        ops: _abc.Iterable[Global___Op] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["ops", b"ops"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___BatchRequest: _TypeAlias = BatchRequest  # noqa: Y015
+
+@_typing.final
+class BatchResponse(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    RESULTS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def results(self) -> _containers.RepeatedCompositeFieldContainer[Global___OpResult]:
+        """Same length as BatchRequest.ops, same order."""
+
+    def __init__(
+        self,
+        *,
+        results: _abc.Iterable[Global___OpResult] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["results", b"results"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___BatchResponse: _TypeAlias = BatchResponse  # noqa: Y015
+
+@_typing.final
+class Op(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    GET_FIELD_NUMBER: _builtins.int
+    PUT_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def get(self) -> Global___GetOp: ...
+    @_builtins.property
+    def put(self) -> Global___PutOp: ...
+    def __init__(
+        self,
+        *,
+        get: Global___GetOp | None = ...,
+        put: Global___PutOp | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["get", b"get", "op", b"op", "put", b"put"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["get", b"get", "op", b"op", "put", b"put"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType_op: _TypeAlias = _typing.Literal["get", "put"]  # noqa: Y015
+    _WhichOneofArgType_op: _TypeAlias = _typing.Literal["op", b"op"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType_op) -> _WhichOneofReturnType_op | None: ...
+
+Global___Op: _TypeAlias = Op  # noqa: Y015
+
+@_typing.final
+class GetOp(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    NAMESPACE_FIELD_NUMBER: _builtins.int
+    KEY_FIELD_NUMBER: _builtins.int
+    REFRESHTTL_FIELD_NUMBER: _builtins.int
+    key: _builtins.str
+    refreshTTL: _builtins.bool
+    @_builtins.property
+    def namespace(self) -> _containers.RepeatedScalarFieldContainer[_builtins.str]:
+        """Hierarchical namespace path, e.g. ["users", "profiles"]."""
+
+    def __init__(
+        self,
+        *,
+        namespace: _abc.Iterable[_builtins.str] | None = ...,
+        key: _builtins.str = ...,
+        refreshTTL: _builtins.bool = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "namespace", b"namespace", "refreshTTL", b"refreshTTL"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___GetOp: _TypeAlias = GetOp  # noqa: Y015
+
+@_typing.final
+class VectorValue(_message.Message):
+    """Vector value for embedding support"""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    VALUEPATH_FIELD_NUMBER: _builtins.int
+    EMBEDDING_FIELD_NUMBER: _builtins.int
+    valuePath: _builtins.str
+    """path to the value in the document"""
+    @_builtins.property
+    def embedding(self) -> _containers.RepeatedScalarFieldContainer[_builtins.float]:
+        """embedding vector"""
+
+    def __init__(
+        self,
+        *,
+        valuePath: _builtins.str = ...,
+        embedding: _abc.Iterable[_builtins.float] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["embedding", b"embedding", "valuePath", b"valuePath"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___VectorValue: _TypeAlias = VectorValue  # noqa: Y015
+
+@_typing.final
+class PutOp(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    NAMESPACE_FIELD_NUMBER: _builtins.int
+    KEY_FIELD_NUMBER: _builtins.int
+    VALUE_JSON_FIELD_NUMBER: _builtins.int
+    TTLMINUTES_FIELD_NUMBER: _builtins.int
+    VECTORS_FIELD_NUMBER: _builtins.int
+    key: _builtins.str
+    value_json: _builtins.bytes
+    """JSON-encoded value (orjson)."""
+    ttlMinutes: _builtins.int
+    @_builtins.property
+    def namespace(self) -> _containers.RepeatedScalarFieldContainer[_builtins.str]: ...
+    @_builtins.property
+    def vectors(self) -> _containers.RepeatedCompositeFieldContainer[Global___VectorValue]:
+        """array of vector values for embedding support"""
+
+    def __init__(
+        self,
+        *,
+        namespace: _abc.Iterable[_builtins.str] | None = ...,
+        key: _builtins.str = ...,
+        value_json: _builtins.bytes = ...,
+        ttlMinutes: _builtins.int = ...,
+        vectors: _abc.Iterable[Global___VectorValue] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "namespace", b"namespace", "ttlMinutes", b"ttlMinutes", "value_json", b"value_json", "vectors", b"vectors"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___PutOp: _TypeAlias = PutOp  # noqa: Y015
+
+@_typing.final
+class OpResult(_message.Message):
+    """Result corresponds to langgraph.store.base.Result.
+    Kind is derived from the originating op:
+      GetOp -> item (or none if missing)
+      PutOp -> none
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    ITEM_FIELD_NUMBER: _builtins.int
+    NONE_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def item(self) -> Global___Item: ...
+    @_builtins.property
+    def none(self) -> _empty_pb2.Empty: ...
+    def __init__(
+        self,
+        *,
+        item: Global___Item | None = ...,
+        none: _empty_pb2.Empty | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["item", b"item", "none", b"none", "result", b"result"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["item", b"item", "none", b"none", "result", b"result"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType_result: _TypeAlias = _typing.Literal["item", "none"]  # noqa: Y015
+    _WhichOneofArgType_result: _TypeAlias = _typing.Literal["result", b"result"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType_result) -> _WhichOneofReturnType_result | None: ...
+
+Global___OpResult: _TypeAlias = OpResult  # noqa: Y015
+
+@_typing.final
+class Item(_message.Message):
+    DESCRIPTOR: _descriptor.Descriptor
+
+    NAMESPACE_FIELD_NUMBER: _builtins.int
+    KEY_FIELD_NUMBER: _builtins.int
+    VALUE_JSON_FIELD_NUMBER: _builtins.int
+    CREATED_AT_FIELD_NUMBER: _builtins.int
+    UPDATED_AT_FIELD_NUMBER: _builtins.int
+    key: _builtins.str
+    value_json: _builtins.bytes
+    """JSON-encoded value (orjson)."""
+    created_at: _builtins.str
+    """RFC 3339 / ISO 8601 strings, matching Item.dict()."""
+    updated_at: _builtins.str
+    @_builtins.property
+    def namespace(self) -> _containers.RepeatedScalarFieldContainer[_builtins.str]: ...
+    def __init__(
+        self,
+        *,
+        namespace: _abc.Iterable[_builtins.str] | None = ...,
+        key: _builtins.str = ...,
+        value_json: _builtins.bytes = ...,
+        created_at: _builtins.str = ...,
+        updated_at: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["created_at", b"created_at", "key", b"key", "namespace", b"namespace", "updated_at", b"updated_at", "value_json", b"value_json"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___Item: _TypeAlias = Item  # noqa: Y015