langgraph-api 0.17.0.dev2__tar.gz → 0.17.0.dev3__tar.gz

{langgraph_api-0.17.0.dev2 → langgraph_api-0.17.0.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langgraph-api
-Version: 0.17.0.dev2
+Version: 0.17.0.dev3
 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

langgraph_api-0.17.0.dev3/langgraph_api/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.17.0.dev3"

{langgraph_api-0.17.0.dev2 → langgraph_api-0.17.0.dev3}/langgraph_api/encryption/aes_json.py

@@ -8,6 +8,7 @@ from __future__ import annotations
 
 import base64
 import functools
+import hashlib
 from typing import TYPE_CHECKING, Any
 
 import orjson
@@ -24,17 +25,57 @@ if TYPE_CHECKING:
     from langgraph_api.encryption.custom import ModelType
 
 AES_ENCRYPTED_PREFIX = "encrypted.aes:"
+AES_ENVELOPE_MAGIC = b"LGAES-ENVELOPE\x00\x00"
+AES_ENVELOPE_VERSION = 1
+AES_KEY_ID_SIZE = 16
+AES_ENVELOPE_SIZE = len(AES_ENVELOPE_MAGIC) + 1 + AES_KEY_ID_SIZE
 
 # Marker key to identify AES encryption in __encryption_context__
 AES_ENCRYPTION_TYPE_KEY = "__langgraph_encryption_type__"
 AES_ENCRYPTION_CONTEXT = {AES_ENCRYPTION_TYPE_KEY: "aes"}
 
 
-def _get_aes_cipher(key: bytes) -> CipherProtocol:
-    """Get AES cipher using the SDK's implementation (same as checkpoint encryption)."""
-    # EncryptedSerializer.from_pycryptodome_aes creates a PycryptodomeAesCipher internally
-    # We extract it to reuse the exact same encryption format as checkpoints
-    return EncryptedSerializer.from_pycryptodome_aes(key=key).cipher
+class _EnvelopeAwareAesCipher:
+    """Read Go AES envelopes while preserving legacy Python writes."""
+
+    def __init__(self, key: bytes, legacy: CipherProtocol) -> None:
+        self._key = key
+        self._legacy = legacy
+
+    def encrypt(self, plaintext: bytes) -> tuple[str, bytes]:
+        return self._legacy.encrypt(plaintext)
+
+    def decrypt(self, ciphername: str, ciphertext: bytes) -> bytes:
+        if not ciphertext.startswith(AES_ENVELOPE_MAGIC):
+            return self._legacy.decrypt(ciphername, ciphertext)
+        if len(ciphertext) < AES_ENVELOPE_SIZE:
+            raise ValueError("invalid AES envelope: header is truncated")
+
+        header = ciphertext[:AES_ENVELOPE_SIZE]
+        if header[len(AES_ENVELOPE_MAGIC)] != AES_ENVELOPE_VERSION:
+            raise ValueError(
+                f"unsupported AES envelope version {header[len(AES_ENVELOPE_MAGIC)]}"
+            )
+        expected_key_id = hashlib.sha256(
+            b"langgraph-aes-key-id-v1\x00" + self._key
+        ).digest()[:AES_KEY_ID_SIZE]
+        if header[-AES_KEY_ID_SIZE:] != expected_key_id:
+            raise ValueError("AES envelope was encrypted with a different key")
+
+        from Crypto.Cipher import AES  # noqa: PLC0415
+
+        encrypted = ciphertext[AES_ENVELOPE_SIZE:]
+        nonce = encrypted[:16]
+        tag = encrypted[16:32]
+        cipher = AES.new(self._key, AES.MODE_EAX, nonce=nonce)
+        cipher.update(header)
+        return cipher.decrypt_and_verify(encrypted[32:], tag)
+
+
+def get_aes_cipher(key: bytes) -> CipherProtocol:
+    """Return cipher compatible with legacy Python and Go envelope formats."""
+    legacy = EncryptedSerializer.from_pycryptodome_aes(key=key).cipher
+    return _EnvelopeAwareAesCipher(key, legacy)
 
 
 def is_aes_encrypted(value: Any) -> bool:
@@ -72,7 +113,7 @@ class AesEncryptionInstance:
     """
 
     def __init__(self, key: bytes, allowlist: frozenset[str]) -> None:
-        self._cipher = _get_aes_cipher(key)
+        self._cipher = get_aes_cipher(key)
         self._allowlist = allowlist
 
     def encrypt_value(self, value: Any) -> str:

{langgraph_api-0.17.0.dev2 → langgraph_api-0.17.0.dev3}/langgraph_api/encryption/custom.py

@@ -271,6 +271,7 @@ class JsonEncryptionWrapper:
         )
 
         custom_decryptor = self._custom.get_json_decryptor(model_type)
+        custom_encryptor = self.get_json_encryptor(model_type)
 
         async def decryptor(ctx: Any, data: dict[str, Any]) -> dict[str, Any]:
             # No marker → plaintext passthrough
@@ -287,7 +288,18 @@ class JsonEncryptionWrapper:
                         f"for {model_type}"
                     )
                 aes_decryptor = self._aes.get_json_decryptor(model_type)
-                return await aes_decryptor(ctx, data)
+                plaintext = await aes_decryptor(ctx, data)
+                if with_replacement and custom_encryptor is not None:
+                    try:
+                        replacement = await custom_encryptor(ctx, plaintext)
+                    except Exception:
+                        await logger.aexception(
+                            "Failed to create AES-to-custom replacement",
+                            model=model_type,
+                        )
+                        replacement = None
+                    return DecryptResult(plaintext, replacement)
+                return plaintext
 
             # Custom marker → use custom decryptor
             if custom_decryptor is None:

{langgraph_api-0.17.0.dev2 → langgraph_api-0.17.0.dev3}/langgraph_api/store.py

@@ -18,6 +18,7 @@ from langgraph_api.encryption.middleware import (
     decrypt_response,
     encrypt_request,
 )
+from langgraph_api.encryption.shared import ENCRYPTION_CONTEXT_KEY
 from langgraph_api.timing import profiled_import
 from langgraph_api.utils.config import run_in_executor
 
@@ -49,6 +50,20 @@ def _bypass_store_encryption() -> bool:
     return config.USE_GRPC_STORE or CUSTOM_STORE is not None
 
 
+def _bypass_store_decryption(item: dict[str, Any]) -> bool:
+    if config.USE_GRPC_STORE or CUSTOM_STORE is None:
+        return config.USE_GRPC_STORE
+    value = item.get("value")
+    return not isinstance(value, dict) or ENCRYPTION_CONTEXT_KEY not in value
+
+
+async def _decrypt_store_item(item: Any) -> dict[str, Any]:
+    data = item.dict()
+    return await decrypt_response(
+        data, "store", plaintext_from_core=_bypass_store_decryption(data)
+    )
+
+
 async def put_item(
     namespace: tuple[str, ...],
     key: str,
@@ -71,9 +86,7 @@ async def get_item(
     item = await (await get_store()).aget(namespace, key, refresh_ttl=refresh_ttl)
     if item is None:
         return None
-    return await decrypt_response(
-        item.dict(), "store", plaintext_from_core=_bypass_store_encryption()
-    )
+    return await _decrypt_store_item(item)
 
 
 async def search_items(
@@ -93,14 +106,7 @@ async def search_items(
         query=query,
         refresh_ttl=refresh_ttl,
     )
-    return await asyncio.gather(
-        *(
-            decrypt_response(
-                item.dict(), "store", plaintext_from_core=_bypass_store_encryption()
-            )
-            for item in items
-        )
-    )
+    return await asyncio.gather(*(_decrypt_store_item(item) for item in items))
 
 
 async def exit_store():

{langgraph_api-0.17.0.dev2 → langgraph_api-0.17.0.dev3}/langgraph_grpc_common/checkpointer.py

@@ -77,8 +77,8 @@ class GrpcCheckpointer(BaseCheckpointSaver):
                 ``langgraph_grpc_common.conversion.*`` keep using the
                 process-wide default
             encryption_context_provider: Optional callable returning the
-                request-scoped encryption context, sent with writes so the
-                server can encrypt blobs with the caller's context. Injected
+                request-scoped encryption context, sent with reads and writes
+                so the server can encrypt blobs with the caller's context. Injected
                 rather than read directly because the context lives in a
                 ``ContextVar`` owned by ``langgraph_api``, which this package
                 does not depend on.
@@ -146,7 +146,8 @@ class GrpcCheckpointer(BaseCheckpointSaver):
     async def aget_tuple(self, config: RunnableConfig) -> CheckpointTuple | None:
         with self._scoped():
             request = checkpointer_pb2.GetTupleRequest(
-                config=ckpt_conv.checkpoint_config_to_proto(config)
+                config=ckpt_conv.checkpoint_config_to_proto(config),
+                encryption_context_json=self._encryption_context_json(),
             )
 
         async def _request() -> CheckpointTuple | None:
@@ -276,6 +277,7 @@ class GrpcCheckpointer(BaseCheckpointSaver):
                 config=ckpt_conv.checkpoint_config_to_proto(config),
                 filter_json=convert_dict_to_json_bytes(filter) or b"",
                 before=ckpt_conv.checkpoint_config_to_proto(before),
+                encryption_context_json=self._encryption_context_json(),
             )
         if limit is not None:
             request.limit = limit
@@ -393,6 +395,7 @@ class GrpcCheckpointer(BaseCheckpointSaver):
             # Empty checkpoint_id => server resolves the latest checkpoint.
             checkpoint_id=configurable.get("checkpoint_id", "") or "",
             channels=list(channels),
+            encryption_context_json=self._encryption_context_json(),
         )
 
         async def _request() -> checkpointer_pb2.GetDeltaChannelHistoryResponse:

{langgraph_api-0.17.0.dev2 → langgraph_api-0.17.0.dev3}/langgraph_grpc_common/conversion/store.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import math
 from datetime import datetime
 from typing import TYPE_CHECKING, Any, cast
 
@@ -61,11 +62,9 @@ def _ensure_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)
+    # The API accepts fractional minutes but the store keeps whole minutes;
+    # round up so items never expire earlier than requested.
+    return math.ceil(ttl)
 
 
 # Ordered comparisons compare the *text* form of the field (value->>key); $eq/$ne
@@ -178,6 +177,7 @@ def op_to_proto(
             "key": str(op.key),
             "value_json": orjson.dumps(op.value),
             "ttlMinutes": _ttl_to_proto_minutes(op.ttl),
+            "ttlMinutesExact": op.ttl or 0.0,
         }
         if vectors is not None:
             put_kwargs["vectors"] = list(vectors)
@@ -227,7 +227,9 @@ def op_from_proto(msg: store_pb2.Op) -> Op:
     if kind == "put":
         p = msg.put
         ttl: float | None = None
-        if p.ttlMinutes:
+        if p.ttlMinutesExact:
+            ttl = p.ttlMinutesExact
+        elif p.ttlMinutes:
             ttl = float(p.ttlMinutes)
         return PutOp(
             namespace=tuple(p.namespace),

langgraph_api-0.17.0.dev3/langgraph_grpc_common/proto/checkpointer_pb2.py

@@ -0,0 +1,99 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: checkpointer.proto
+# Protobuf Python Version: 6.33.5
+"""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,
+    33,
+    5,
+    '',
+    'checkpointer.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from . import engine_common_pb2 as engine__common__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x12\x63heckpointer.proto\x12\x0c\x63heckpointer\x1a\x1bgoogle/protobuf/empty.proto\x1a\x13\x65ngine-common.proto\"\xab\x03\n\nPutRequest\x12\x32\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\".engineCommon.EngineRunnableConfig\x12,\n\ncheckpoint\x18\x02 \x01(\x0b\x32\x18.engineCommon.Checkpoint\x12\x32\n\x08metadata\x18\x03 \x01(\x0b\x32 .engineCommon.CheckpointMetadata\x12?\n\x0cnew_versions\x18\x04 \x03(\x0b\x32).checkpointer.PutRequest.NewVersionsEntry\x12T\n\x17\x65ncryption_context_json\x18\x05 \x03(\x0b\x32\x33.checkpointer.PutRequest.EncryptionContextJsonEntry\x1a\x32\n\x10NewVersionsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a<\n\x1a\x45ncryptionContextJsonEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x0c:\x02\x38\x01\"\xa9\x02\n\x10PutWritesRequest\x12\x32\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\".engineCommon.EngineRunnableConfig\x12#\n\x06writes\x18\x02 \x03(\x0b\x32\x13.engineCommon.Write\x12\x0f\n\x07task_id\x18\x03 \x01(\t\x12\x11\n\ttask_path\x18\x04 \x01(\t\x12Z\n\x17\x65ncryption_context_json\x18\x05 \x03(\x0b\x32\x39.checkpointer.PutWritesRequest.EncryptionContextJsonEntry\x1a<\n\x1a\x45ncryptionContextJsonEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x0c:\x02\x38\x01\"\x86\x01\n\x0c\x43\x61pabilities\x12\x1e\n\x16supports_delete_thread\x18\x01 \x01(\x08\x12\x16\n\x0esupports_prune\x18\x02 \x01(\x08\x12 \n\x18supports_delete_for_runs\x18\x03 \x01(\x08\x12\x1c\n\x14supports_copy_thread\x18\x04 \x01(\x08\"\xbd\x02\n\x0bListRequest\x12\x32\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\".engineCommon.EngineRunnableConfig\x12\x13\n\x0b\x66ilter_json\x18\x02 \x01(\x0c\x12\x32\n\x06\x62\x65\x66ore\x18\x03 \x01(\x0b\x32\".engineCommon.EngineRunnableConfig\x12\x12\n\x05limit\x18\x04 \x01(\x03H\x00\x88\x01\x01\x12U\n\x17\x65ncryption_context_json\x18\x05 \x03(\x0b\x32\x34.checkpointer.ListRequest.EncryptionContextJsonEntry\x1a<\n\x1a\x45ncryptionContextJsonEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x0c:\x02\x38\x01\x42\x08\n\x06_limit\"(\n\x13\x44\x65leteThreadRequest\x12\x11\n\tthread_id\x18\x01 \x01(\t\"\'\n\x14\x44\x65leteForRunsRequest\x12\x0f\n\x07run_ids\x18\x01 \x03(\t\"A\n\x11\x43opyThreadRequest\x12\x16\n\x0e\x66rom_thread_id\x18\x01 \x01(\t\x12\x14\n\x0cto_thread_id\x18\x02 \x01(\t\"\xa1\x01\n\x0cPruneRequest\x12\x12\n\nthread_ids\x18\x01 \x03(\t\x12:\n\x08strategy\x18\x02 \x01(\x0e\x32(.checkpointer.PruneRequest.PruneStrategy\"A\n\rPruneStrategy\x12\x0f\n\x0bUNSPECIFIED\x10\x00\x12\x0f\n\x0bKEEP_LATEST\x10\x01\x12\x0e\n\nDELETE_ALL\x10\x02\"\xde\x01\n\x0fGetTupleRequest\x12\x32\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\".engineCommon.EngineRunnableConfig\x12Y\n\x17\x65ncryption_context_json\x18\x02 \x03(\x0b\x32\x38.checkpointer.GetTupleRequest.EncryptionContextJsonEntry\x1a<\n\x1a\x45ncryptionContextJsonEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x0c:\x02\x38\x01\"F\n\x0bPutResponse\x12\x37\n\x0bnext_config\x18\x01 \x01(\x0b\x32\".engineCommon.EngineRunnableConfig\"H\n\x0cListResponse\x12\x38\n\x11\x63heckpoint_tuples\x18\x01 \x03(\x0b\x32\x1d.engineCommon.CheckpointTuple\"e\n\x10GetTupleResponse\x12<\n\x10\x63heckpoint_tuple\x18\x01 \x01(\x0b\x32\x1d.engineCommon.CheckpointTupleH\x00\x88\x01\x01\x42\x13\n\x11_checkpoint_tuple\"~\n\x18\x44\x65ltaChannelHistoryEntry\x12-\n\x04seed\x18\x01 \x01(\x0b\x32\x1a.engineCommon.ChannelValueH\x00\x88\x01\x01\x12*\n\x06writes\x18\x02 \x03(\x0b\x32\x1a.engineCommon.PendingWriteB\x07\n\x05_seed\"\x99\x02\n\x1dGetDeltaChannelHistoryRequest\x12\x11\n\tthread_id\x18\x01 \x01(\t\x12\x15\n\rcheckpoint_ns\x18\x02 \x01(\t\x12\x15\n\rcheckpoint_id\x18\x03 \x01(\t\x12\x10\n\x08\x63hannels\x18\x04 \x03(\t\x12g\n\x17\x65ncryption_context_json\x18\x05 \x03(\x0b\x32\x46.checkpointer.GetDeltaChannelHistoryRequest.EncryptionContextJsonEntry\x1a<\n\x1a\x45ncryptionContextJsonEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x0c:\x02\x38\x01\"\xc4\x01\n\x1eGetDeltaChannelHistoryResponse\x12J\n\x07\x65ntries\x18\x01 \x03(\x0b\x32\x39.checkpointer.GetDeltaChannelHistoryResponse.EntriesEntry\x1aV\n\x0c\x45ntriesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x35\n\x05value\x18\x02 \x01(\x0b\x32&.checkpointer.DeltaChannelHistoryEntry:\x02\x38\x01\x32\xf1\x05\n\x0c\x43heckpointer\x12:\n\x03Put\x12\x18.checkpointer.PutRequest\x1a\x19.checkpointer.PutResponse\x12\x43\n\tPutWrites\x12\x1e.checkpointer.PutWritesRequest\x1a\x16.google.protobuf.Empty\x12\x45\n\x0fGetCapabilities\x12\x16.google.protobuf.Empty\x1a\x1a.checkpointer.Capabilities\x12=\n\x04List\x12\x19.checkpointer.ListRequest\x1a\x1a.checkpointer.ListResponse\x12I\n\x08GetTuple\x12\x1d.checkpointer.GetTupleRequest\x1a\x1e.checkpointer.GetTupleResponse\x12I\n\x0c\x44\x65leteThread\x12!.checkpointer.DeleteThreadRequest\x1a\x16.google.protobuf.Empty\x12K\n\rDeleteForRuns\x12\".checkpointer.DeleteForRunsRequest\x1a\x16.google.protobuf.Empty\x12\x45\n\nCopyThread\x12\x1f.checkpointer.CopyThreadRequest\x1a\x16.google.protobuf.Empty\x12;\n\x05Prune\x12\x1a.checkpointer.PruneRequest\x1a\x16.google.protobuf.Empty\x12s\n\x16GetDeltaChannelHistory\x12+.checkpointer.GetDeltaChannelHistoryRequest\x1a,.checkpointer.GetDeltaChannelHistoryResponseB?Z=github.com/langchain-ai/langgraph-api/core/internal/engine/pbb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'checkpointer_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['_PUTREQUEST_NEWVERSIONSENTRY']._loaded_options = None
+  _globals['_PUTREQUEST_NEWVERSIONSENTRY']._serialized_options = b'8\001'
+  _globals['_PUTREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._loaded_options = None
+  _globals['_PUTREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_options = b'8\001'
+  _globals['_PUTWRITESREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._loaded_options = None
+  _globals['_PUTWRITESREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_options = b'8\001'
+  _globals['_LISTREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._loaded_options = None
+  _globals['_LISTREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_options = b'8\001'
+  _globals['_GETTUPLEREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._loaded_options = None
+  _globals['_GETTUPLEREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_options = b'8\001'
+  _globals['_GETDELTACHANNELHISTORYREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._loaded_options = None
+  _globals['_GETDELTACHANNELHISTORYREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_options = b'8\001'
+  _globals['_GETDELTACHANNELHISTORYRESPONSE_ENTRIESENTRY']._loaded_options = None
+  _globals['_GETDELTACHANNELHISTORYRESPONSE_ENTRIESENTRY']._serialized_options = b'8\001'
+  _globals['_PUTREQUEST']._serialized_start=87
+  _globals['_PUTREQUEST']._serialized_end=514
+  _globals['_PUTREQUEST_NEWVERSIONSENTRY']._serialized_start=402
+  _globals['_PUTREQUEST_NEWVERSIONSENTRY']._serialized_end=452
+  _globals['_PUTREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_start=454
+  _globals['_PUTREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_end=514
+  _globals['_PUTWRITESREQUEST']._serialized_start=517
+  _globals['_PUTWRITESREQUEST']._serialized_end=814
+  _globals['_PUTWRITESREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_start=454
+  _globals['_PUTWRITESREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_end=514
+  _globals['_CAPABILITIES']._serialized_start=817
+  _globals['_CAPABILITIES']._serialized_end=951
+  _globals['_LISTREQUEST']._serialized_start=954
+  _globals['_LISTREQUEST']._serialized_end=1271
+  _globals['_LISTREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_start=454
+  _globals['_LISTREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_end=514
+  _globals['_DELETETHREADREQUEST']._serialized_start=1273
+  _globals['_DELETETHREADREQUEST']._serialized_end=1313
+  _globals['_DELETEFORRUNSREQUEST']._serialized_start=1315
+  _globals['_DELETEFORRUNSREQUEST']._serialized_end=1354
+  _globals['_COPYTHREADREQUEST']._serialized_start=1356
+  _globals['_COPYTHREADREQUEST']._serialized_end=1421
+  _globals['_PRUNEREQUEST']._serialized_start=1424
+  _globals['_PRUNEREQUEST']._serialized_end=1585
+  _globals['_PRUNEREQUEST_PRUNESTRATEGY']._serialized_start=1520
+  _globals['_PRUNEREQUEST_PRUNESTRATEGY']._serialized_end=1585
+  _globals['_GETTUPLEREQUEST']._serialized_start=1588
+  _globals['_GETTUPLEREQUEST']._serialized_end=1810
+  _globals['_GETTUPLEREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_start=454
+  _globals['_GETTUPLEREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_end=514
+  _globals['_PUTRESPONSE']._serialized_start=1812
+  _globals['_PUTRESPONSE']._serialized_end=1882
+  _globals['_LISTRESPONSE']._serialized_start=1884
+  _globals['_LISTRESPONSE']._serialized_end=1956
+  _globals['_GETTUPLERESPONSE']._serialized_start=1958
+  _globals['_GETTUPLERESPONSE']._serialized_end=2059
+  _globals['_DELTACHANNELHISTORYENTRY']._serialized_start=2061
+  _globals['_DELTACHANNELHISTORYENTRY']._serialized_end=2187
+  _globals['_GETDELTACHANNELHISTORYREQUEST']._serialized_start=2190
+  _globals['_GETDELTACHANNELHISTORYREQUEST']._serialized_end=2471
+  _globals['_GETDELTACHANNELHISTORYREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_start=454
+  _globals['_GETDELTACHANNELHISTORYREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_end=514
+  _globals['_GETDELTACHANNELHISTORYRESPONSE']._serialized_start=2474
+  _globals['_GETDELTACHANNELHISTORYRESPONSE']._serialized_end=2670
+  _globals['_GETDELTACHANNELHISTORYRESPONSE_ENTRIESENTRY']._serialized_start=2584
+  _globals['_GETDELTACHANNELHISTORYRESPONSE_ENTRIESENTRY']._serialized_end=2670
+  _globals['_CHECKPOINTER']._serialized_start=2673
+  _globals['_CHECKPOINTER']._serialized_end=3426
+# @@protoc_insertion_point(module_scope)

{langgraph_api-0.17.0.dev2 → langgraph_api-0.17.0.dev3}/langgraph_grpc_common/proto/checkpointer_pb2.pyi

@@ -24,8 +24,7 @@ DESCRIPTOR: _descriptor.FileDescriptor
 class PutRequest(_message.Message):
     """encryption_context_json: request-scoped encryption context, keyed by name
     with JSON-encoded values (e.g. {"tenant_id": "\\"acme\\""}). Writes must pass
-    it because it lives in a Python ContextVar the core server cannot observe;
-    reads recover it from the stored blob wrapper.
+    it because it lives in a Python ContextVar the core server cannot observe.
     """
 
     DESCRIPTOR: _descriptor.Descriptor
@@ -194,16 +193,39 @@ Global___Capabilities: _TypeAlias = Capabilities  # noqa: Y015
 class ListRequest(_message.Message):
     DESCRIPTOR: _descriptor.Descriptor
 
+    @_typing.final
+    class EncryptionContextJsonEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        value: _builtins.bytes
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: _builtins.bytes = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
     CONFIG_FIELD_NUMBER: _builtins.int
     FILTER_JSON_FIELD_NUMBER: _builtins.int
     BEFORE_FIELD_NUMBER: _builtins.int
     LIMIT_FIELD_NUMBER: _builtins.int
+    ENCRYPTION_CONTEXT_JSON_FIELD_NUMBER: _builtins.int
     filter_json: _builtins.bytes
     limit: _builtins.int
     @_builtins.property
     def config(self) -> _engine_common_pb2.EngineRunnableConfig: ...
     @_builtins.property
     def before(self) -> _engine_common_pb2.EngineRunnableConfig: ...
+    @_builtins.property
+    def encryption_context_json(self) -> _containers.ScalarMap[_builtins.str, _builtins.bytes]: ...
     def __init__(
         self,
         *,
@@ -211,10 +233,11 @@ class ListRequest(_message.Message):
         filter_json: _builtins.bytes = ...,
         before: _engine_common_pb2.EngineRunnableConfig | None = ...,
         limit: _builtins.int | None = ...,
+        encryption_context_json: _abc.Mapping[_builtins.str, _builtins.bytes] | None = ...,
     ) -> None: ...
     _HasFieldArgType: _TypeAlias = _typing.Literal["_limit", b"_limit", "before", b"before", "config", b"config", "limit", b"limit"]  # noqa: Y015
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
-    _ClearFieldArgType: _TypeAlias = _typing.Literal["_limit", b"_limit", "before", b"before", "config", b"config", "filter_json", b"filter_json", "limit", b"limit"]  # noqa: Y015
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_limit", b"_limit", "before", b"before", "config", b"config", "encryption_context_json", b"encryption_context_json", "filter_json", b"filter_json", "limit", b"limit"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
     _WhichOneofReturnType__limit: _TypeAlias = _typing.Literal["limit"]  # noqa: Y015
     _WhichOneofArgType__limit: _TypeAlias = _typing.Literal["_limit", b"_limit"]  # noqa: Y015
@@ -330,17 +353,41 @@ Global___PruneRequest: _TypeAlias = PruneRequest  # noqa: Y015
 class GetTupleRequest(_message.Message):
     DESCRIPTOR: _descriptor.Descriptor
 
+    @_typing.final
+    class EncryptionContextJsonEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        value: _builtins.bytes
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: _builtins.bytes = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
     CONFIG_FIELD_NUMBER: _builtins.int
+    ENCRYPTION_CONTEXT_JSON_FIELD_NUMBER: _builtins.int
     @_builtins.property
     def config(self) -> _engine_common_pb2.EngineRunnableConfig: ...
+    @_builtins.property
+    def encryption_context_json(self) -> _containers.ScalarMap[_builtins.str, _builtins.bytes]: ...
     def __init__(
         self,
         *,
         config: _engine_common_pb2.EngineRunnableConfig | None = ...,
+        encryption_context_json: _abc.Mapping[_builtins.str, _builtins.bytes] | None = ...,
     ) -> None: ...
     _HasFieldArgType: _TypeAlias = _typing.Literal["config", b"config"]  # noqa: Y015
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
-    _ClearFieldArgType: _TypeAlias = _typing.Literal["config", b"config"]  # noqa: Y015
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["config", b"config", "encryption_context_json", b"encryption_context_json"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
     def WhichOneof(self, oneof_group: _Never) -> None: ...
 
@@ -446,10 +493,31 @@ Global___DeltaChannelHistoryEntry: _TypeAlias = DeltaChannelHistoryEntry  # noqa
 class GetDeltaChannelHistoryRequest(_message.Message):
     DESCRIPTOR: _descriptor.Descriptor
 
+    @_typing.final
+    class EncryptionContextJsonEntry(_message.Message):
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        value: _builtins.bytes
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: _builtins.bytes = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
     THREAD_ID_FIELD_NUMBER: _builtins.int
     CHECKPOINT_NS_FIELD_NUMBER: _builtins.int
     CHECKPOINT_ID_FIELD_NUMBER: _builtins.int
     CHANNELS_FIELD_NUMBER: _builtins.int
+    ENCRYPTION_CONTEXT_JSON_FIELD_NUMBER: _builtins.int
     thread_id: _builtins.str
     """Thread whose delta-channel state to reconstruct."""
     checkpoint_ns: _builtins.str
@@ -462,6 +530,8 @@ class GetDeltaChannelHistoryRequest(_message.Message):
     def channels(self) -> _containers.RepeatedScalarFieldContainer[_builtins.str]:
         """Channels to reconstruct."""
 
+    @_builtins.property
+    def encryption_context_json(self) -> _containers.ScalarMap[_builtins.str, _builtins.bytes]: ...
     def __init__(
         self,
         *,
@@ -469,10 +539,11 @@ class GetDeltaChannelHistoryRequest(_message.Message):
         checkpoint_ns: _builtins.str = ...,
         checkpoint_id: _builtins.str = ...,
         channels: _abc.Iterable[_builtins.str] | None = ...,
+        encryption_context_json: _abc.Mapping[_builtins.str, _builtins.bytes] | None = ...,
     ) -> None: ...
     _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
     def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
-    _ClearFieldArgType: _TypeAlias = _typing.Literal["channels", b"channels", "checkpoint_id", b"checkpoint_id", "checkpoint_ns", b"checkpoint_ns", "thread_id", b"thread_id"]  # noqa: Y015
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["channels", b"channels", "checkpoint_id", b"checkpoint_id", "checkpoint_ns", b"checkpoint_ns", "encryption_context_json", b"encryption_context_json", "thread_id", b"thread_id"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
     def WhichOneof(self, oneof_group: _Never) -> None: ...
 

{langgraph_api-0.17.0.dev2 → langgraph_api-0.17.0.dev3}/langgraph_grpc_common/proto/store_pb2.py

@@ -25,7 +25,7 @@ _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\"\xb5\x01\n\x0c\x42\x61tchRequest\x12\x16\n\x03ops\x18\x01 \x03(\x0b\x32\t.store.Op\x12O\n\x17\x65ncryption_context_json\x18\x02 \x03(\x0b\x32..store.BatchRequest.EncryptionContextJsonEntry\x1a<\n\x1a\x45ncryptionContextJsonEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x0c:\x02\x38\x01\"1\n\rBatchResponse\x12 \n\x07results\x18\x01 \x03(\x0b\x32\x0f.store.OpResult\"\xbe\x01\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\x12!\n\x06\x64\x65lete\x18\x03 \x01(\x0b\x32\x0f.store.DeleteOpH\x00\x12!\n\x06search\x18\x04 \x01(\x0b\x32\x0f.store.SearchOpH\x00\x12\x32\n\x0flist_namespaces\x18\x05 \x01(\x0b\x32\x17.store.ListNamespacesOpH\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\"*\n\x08\x44\x65leteOp\x12\x11\n\tnamespace\x18\x01 \x03(\t\x12\x0b\n\x03key\x18\x02 \x01(\t\"L\n\x0f\x46ilterCondition\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x1b\n\x02op\x18\x02 \x01(\x0e\x32\x0f.store.FilterOp\x12\x0f\n\x07operand\x18\x03 \x01(\t\"\xa4\x01\n\x08SearchOp\x12\x18\n\x10namespace_prefix\x18\x01 \x03(\t\x12&\n\x06\x66ilter\x18\x02 \x03(\x0b\x32\x16.store.FilterCondition\x12\r\n\x05limit\x18\x03 \x01(\x05\x12\x0e\n\x06offset\x18\x04 \x01(\x05\x12\x12\n\nrefreshTTL\x18\x06 \x01(\x08\x12#\n\x06vector\x18\x07 \x01(\x0b\x32\x13.store.VectorSearch\"\x94\x01\n\x0cVectorSearch\x12\x17\n\x0fquery_embedding\x18\x01 \x03(\x02\x12*\n\rdistance_type\x18\x02 \x01(\x0e\x32\x13.store.DistanceType\x12\x17\n\x0fvectors_per_doc\x18\x03 \x01(\x05\x12&\n\x0bvector_type\x18\x04 \x01(\x0e\x32\x11.store.VectorType\"D\n\x0eMatchCondition\x12$\n\nmatch_type\x18\x01 \x01(\x0e\x32\x10.store.MatchType\x12\x0c\n\x04path\x18\x02 \x03(\t\"\x88\x01\n\x10ListNamespacesOp\x12/\n\x10match_conditions\x18\x01 \x03(\x0b\x32\x15.store.MatchCondition\x12\x16\n\tmax_depth\x18\x02 \x01(\x05H\x00\x88\x01\x01\x12\r\n\x05limit\x18\x03 \x01(\x05\x12\x0e\n\x06offset\x18\x04 \x01(\x05\x42\x0c\n\n_max_depth\"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\"\xb8\x01\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\x12%\n\x06search\x18\x03 \x01(\x0b\x32\x13.store.SearchResultH\x00\x12\x36\n\x0flist_namespaces\x18\x04 \x01(\x0b\x32\x1b.store.ListNamespacesResultH\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(\t\"\x86\x01\n\nSearchItem\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(\t\x12\x12\n\x05score\x18\x06 \x01(\x01H\x00\x88\x01\x01\x42\x08\n\x06_score\"0\n\x0cSearchResult\x12 \n\x05items\x18\x01 \x03(\x0b\x32\x11.store.SearchItem\"\x1a\n\tNamespace\x12\r\n\x05parts\x18\x01 \x03(\t\"<\n\x14ListNamespacesResult\x12$\n\nnamespaces\x18\x01 \x03(\x0b\x32\x10.store.Namespace*\x93\x01\n\x08\x46ilterOp\x12\x19\n\x15\x46ILTER_OP_UNSPECIFIED\x10\x00\x12\x10\n\x0c\x46ILTER_OP_EQ\x10\x01\x12\x10\n\x0c\x46ILTER_OP_NE\x10\x02\x12\x10\n\x0c\x46ILTER_OP_GT\x10\x03\x12\x11\n\rFILTER_OP_GTE\x10\x04\x12\x10\n\x0c\x46ILTER_OP_LT\x10\x05\x12\x11\n\rFILTER_OP_LTE\x10\x06*~\n\x0c\x44istanceType\x12\x1d\n\x19\x44ISTANCE_TYPE_UNSPECIFIED\x10\x00\x12\x18\n\x14\x44ISTANCE_TYPE_COSINE\x10\x01\x12\x14\n\x10\x44ISTANCE_TYPE_L2\x10\x02\x12\x1f\n\x1b\x44ISTANCE_TYPE_INNER_PRODUCT\x10\x03*Z\n\nVectorType\x12\x1b\n\x17VECTOR_TYPE_UNSPECIFIED\x10\x00\x12\x16\n\x12VECTOR_TYPE_VECTOR\x10\x01\x12\x17\n\x13VECTOR_TYPE_HALFVEC\x10\x02*U\n\tMatchType\x12\x1a\n\x16MATCH_TYPE_UNSPECIFIED\x10\x00\x12\x15\n\x11MATCH_TYPE_PREFIX\x10\x01\x12\x15\n\x11MATCH_TYPE_SUFFIX\x10\x02\x32;\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')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0bstore.proto\x12\x05store\x1a\x1bgoogle/protobuf/empty.proto\"\xb5\x01\n\x0c\x42\x61tchRequest\x12\x16\n\x03ops\x18\x01 \x03(\x0b\x32\t.store.Op\x12O\n\x17\x65ncryption_context_json\x18\x02 \x03(\x0b\x32..store.BatchRequest.EncryptionContextJsonEntry\x1a<\n\x1a\x45ncryptionContextJsonEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x0c:\x02\x38\x01\"1\n\rBatchResponse\x12 \n\x07results\x18\x01 \x03(\x0b\x32\x0f.store.OpResult\"\xbe\x01\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\x12!\n\x06\x64\x65lete\x18\x03 \x01(\x0b\x32\x0f.store.DeleteOpH\x00\x12!\n\x06search\x18\x04 \x01(\x0b\x32\x0f.store.SearchOpH\x00\x12\x32\n\x0flist_namespaces\x18\x05 \x01(\x0b\x32\x17.store.ListNamespacesOpH\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\"*\n\x08\x44\x65leteOp\x12\x11\n\tnamespace\x18\x01 \x03(\t\x12\x0b\n\x03key\x18\x02 \x01(\t\"L\n\x0f\x46ilterCondition\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x1b\n\x02op\x18\x02 \x01(\x0e\x32\x0f.store.FilterOp\x12\x0f\n\x07operand\x18\x03 \x01(\t\"\xa4\x01\n\x08SearchOp\x12\x18\n\x10namespace_prefix\x18\x01 \x03(\t\x12&\n\x06\x66ilter\x18\x02 \x03(\x0b\x32\x16.store.FilterCondition\x12\r\n\x05limit\x18\x03 \x01(\x05\x12\x0e\n\x06offset\x18\x04 \x01(\x05\x12\x12\n\nrefreshTTL\x18\x06 \x01(\x08\x12#\n\x06vector\x18\x07 \x01(\x0b\x32\x13.store.VectorSearch\"\x94\x01\n\x0cVectorSearch\x12\x17\n\x0fquery_embedding\x18\x01 \x03(\x02\x12*\n\rdistance_type\x18\x02 \x01(\x0e\x32\x13.store.DistanceType\x12\x17\n\x0fvectors_per_doc\x18\x03 \x01(\x05\x12&\n\x0bvector_type\x18\x04 \x01(\x0e\x32\x11.store.VectorType\"D\n\x0eMatchCondition\x12$\n\nmatch_type\x18\x01 \x01(\x0e\x32\x10.store.MatchType\x12\x0c\n\x04path\x18\x02 \x03(\t\"\x88\x01\n\x10ListNamespacesOp\x12/\n\x10match_conditions\x18\x01 \x03(\x0b\x32\x15.store.MatchCondition\x12\x16\n\tmax_depth\x18\x02 \x01(\x05H\x00\x88\x01\x01\x12\r\n\x05limit\x18\x03 \x01(\x05\x12\x0e\n\x06offset\x18\x04 \x01(\x05\x42\x0c\n\n_max_depth\"3\n\x0bVectorValue\x12\x11\n\tvaluePath\x18\x01 \x01(\t\x12\x11\n\tembedding\x18\x02 \x03(\x02\"\x8d\x01\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\x12\x17\n\x0fttlMinutesExact\x18\x06 \x01(\x01\"\xb8\x01\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\x12%\n\x06search\x18\x03 \x01(\x0b\x32\x13.store.SearchResultH\x00\x12\x36\n\x0flist_namespaces\x18\x04 \x01(\x0b\x32\x1b.store.ListNamespacesResultH\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(\t\"\x86\x01\n\nSearchItem\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(\t\x12\x12\n\x05score\x18\x06 \x01(\x01H\x00\x88\x01\x01\x42\x08\n\x06_score\"0\n\x0cSearchResult\x12 \n\x05items\x18\x01 \x03(\x0b\x32\x11.store.SearchItem\"\x1a\n\tNamespace\x12\r\n\x05parts\x18\x01 \x03(\t\"<\n\x14ListNamespacesResult\x12$\n\nnamespaces\x18\x01 \x03(\x0b\x32\x10.store.Namespace*\x93\x01\n\x08\x46ilterOp\x12\x19\n\x15\x46ILTER_OP_UNSPECIFIED\x10\x00\x12\x10\n\x0c\x46ILTER_OP_EQ\x10\x01\x12\x10\n\x0c\x46ILTER_OP_NE\x10\x02\x12\x10\n\x0c\x46ILTER_OP_GT\x10\x03\x12\x11\n\rFILTER_OP_GTE\x10\x04\x12\x10\n\x0c\x46ILTER_OP_LT\x10\x05\x12\x11\n\rFILTER_OP_LTE\x10\x06*~\n\x0c\x44istanceType\x12\x1d\n\x19\x44ISTANCE_TYPE_UNSPECIFIED\x10\x00\x12\x18\n\x14\x44ISTANCE_TYPE_COSINE\x10\x01\x12\x14\n\x10\x44ISTANCE_TYPE_L2\x10\x02\x12\x1f\n\x1b\x44ISTANCE_TYPE_INNER_PRODUCT\x10\x03*Z\n\nVectorType\x12\x1b\n\x17VECTOR_TYPE_UNSPECIFIED\x10\x00\x12\x16\n\x12VECTOR_TYPE_VECTOR\x10\x01\x12\x17\n\x13VECTOR_TYPE_HALFVEC\x10\x02*U\n\tMatchType\x12\x1a\n\x16MATCH_TYPE_UNSPECIFIED\x10\x00\x12\x15\n\x11MATCH_TYPE_PREFIX\x10\x01\x12\x15\n\x11MATCH_TYPE_SUFFIX\x10\x02\x32;\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)
@@ -35,14 +35,14 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._serialized_options = b'Z=github.com/langchain-ai/langgraph-api/core/internal/engine/pb'
   _globals['_BATCHREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._loaded_options = None
   _globals['_BATCHREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_options = b'8\001'
-  _globals['_FILTEROP']._serialized_start=1925
-  _globals['_FILTEROP']._serialized_end=2072
-  _globals['_DISTANCETYPE']._serialized_start=2074
-  _globals['_DISTANCETYPE']._serialized_end=2200
-  _globals['_VECTORTYPE']._serialized_start=2202
-  _globals['_VECTORTYPE']._serialized_end=2292
-  _globals['_MATCHTYPE']._serialized_start=2294
-  _globals['_MATCHTYPE']._serialized_end=2379
+  _globals['_FILTEROP']._serialized_start=1951
+  _globals['_FILTEROP']._serialized_end=2098
+  _globals['_DISTANCETYPE']._serialized_start=2100
+  _globals['_DISTANCETYPE']._serialized_end=2226
+  _globals['_VECTORTYPE']._serialized_start=2228
+  _globals['_VECTORTYPE']._serialized_end=2318
+  _globals['_MATCHTYPE']._serialized_start=2320
+  _globals['_MATCHTYPE']._serialized_end=2405
   _globals['_BATCHREQUEST']._serialized_start=52
   _globals['_BATCHREQUEST']._serialized_end=233
   _globals['_BATCHREQUEST_ENCRYPTIONCONTEXTJSONENTRY']._serialized_start=173
@@ -67,20 +67,20 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_LISTNAMESPACESOP']._serialized_end=1187
   _globals['_VECTORVALUE']._serialized_start=1189
   _globals['_VECTORVALUE']._serialized_end=1240
-  _globals['_PUTOP']._serialized_start=1242
-  _globals['_PUTOP']._serialized_end=1358
-  _globals['_OPRESULT']._serialized_start=1361
-  _globals['_OPRESULT']._serialized_end=1545
-  _globals['_ITEM']._serialized_start=1547
-  _globals['_ITEM']._serialized_end=1645
-  _globals['_SEARCHITEM']._serialized_start=1648
-  _globals['_SEARCHITEM']._serialized_end=1782
-  _globals['_SEARCHRESULT']._serialized_start=1784
-  _globals['_SEARCHRESULT']._serialized_end=1832
-  _globals['_NAMESPACE']._serialized_start=1834
-  _globals['_NAMESPACE']._serialized_end=1860
-  _globals['_LISTNAMESPACESRESULT']._serialized_start=1862
-  _globals['_LISTNAMESPACESRESULT']._serialized_end=1922
-  _globals['_STORE']._serialized_start=2381
-  _globals['_STORE']._serialized_end=2440
+  _globals['_PUTOP']._serialized_start=1243
+  _globals['_PUTOP']._serialized_end=1384
+  _globals['_OPRESULT']._serialized_start=1387
+  _globals['_OPRESULT']._serialized_end=1571
+  _globals['_ITEM']._serialized_start=1573
+  _globals['_ITEM']._serialized_end=1671
+  _globals['_SEARCHITEM']._serialized_start=1674
+  _globals['_SEARCHITEM']._serialized_end=1808
+  _globals['_SEARCHRESULT']._serialized_start=1810
+  _globals['_SEARCHRESULT']._serialized_end=1858
+  _globals['_NAMESPACE']._serialized_start=1860
+  _globals['_NAMESPACE']._serialized_end=1886
+  _globals['_LISTNAMESPACESRESULT']._serialized_start=1888
+  _globals['_LISTNAMESPACESRESULT']._serialized_end=1948
+  _globals['_STORE']._serialized_start=2407
+  _globals['_STORE']._serialized_end=2466
 # @@protoc_insertion_point(module_scope)

{langgraph_api-0.17.0.dev2 → langgraph_api-0.17.0.dev3}/langgraph_grpc_common/proto/store_pb2.pyi

@@ -472,10 +472,14 @@ class PutOp(_message.Message):
     VALUE_JSON_FIELD_NUMBER: _builtins.int
     TTLMINUTES_FIELD_NUMBER: _builtins.int
     VECTORS_FIELD_NUMBER: _builtins.int
+    TTLMINUTESEXACT_FIELD_NUMBER: _builtins.int
     key: _builtins.str
     value_json: _builtins.bytes
     """JSON-encoded value (orjson)."""
     ttlMinutes: _builtins.int
+    """Whole minutes, rounded up; stored as ttl_minutes and used for TTL refresh."""
+    ttlMinutesExact: _builtins.float
+    """Exact, possibly fractional TTL in minutes; sets the initial expires_at."""
     @_builtins.property
     def namespace(self) -> _containers.RepeatedScalarFieldContainer[_builtins.str]: ...
     @_builtins.property
@@ -490,10 +494,11 @@ class PutOp(_message.Message):
         value_json: _builtins.bytes = ...,
         ttlMinutes: _builtins.int = ...,
         vectors: _abc.Iterable[Global___VectorValue] | None = ...,
+        ttlMinutesExact: _builtins.float = ...,
     ) -> 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
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "namespace", b"namespace", "ttlMinutes", b"ttlMinutes", "ttlMinutesExact", b"ttlMinutesExact", "value_json", b"value_json", "vectors", b"vectors"]  # noqa: Y015
     def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
     def WhichOneof(self, oneof_group: _Never) -> None: ...
 

langgraph_api-0.17.0.dev2/langgraph_api/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.17.0.dev2"