coordinode 3.0.0__tar.gz → 4.0.0__tar.gz

{coordinode-3.0.0 → coordinode-4.0.0}/.gitignore

@@ -22,10 +22,4 @@ coordinode/coordinode/_version.py
 langchain-coordinode/langchain_coordinode/_version.py
 llama-index-coordinode/llama_index/graph_stores/coordinode/_version.py
 
-# Local dev / arch docs — not part of the SDK
-GAPS.md
-CLAUDE.md
-DEVLOG*.md
-
 **/.ipynb_checkpoints/
-.claude/

{coordinode-3.0.0 → coordinode-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: coordinode
-Version: 3.0.0
+Version: 4.0.0
 Summary: Python client for CoordiNode — graph + vector + full-text database
 Project-URL: Homepage, https://github.com/structured-world/coordinode
 Project-URL: Repository, https://github.com/structured-world/coordinode-python
@@ -231,6 +231,17 @@ Accepted values:
 - ``read_concern``: ``local`` (default) · ``majority`` · ``linearizable`` · ``snapshot``. Causal reads (``after_index`` > 0) require ``majority`` here.
 - ``write_concern``: ``"majority"`` (default) · a member count (``1`` leader only, ``0`` fire-and-forget) · ``WriteConcern(w, journal, timeout_ms)`` with ``journal`` one of ``journal`` (default) · ``cache`` · ``memory``. The volatile ``cache`` and ``memory`` states are accepted only with ``w`` of 0 or 1.
 - ``read_preference``: ``primary`` (default) · ``primary_preferred`` · ``secondary`` · ``secondary_preferred`` · ``nearest``
+- ``vector_consistency``: ``current`` (the index as it is: fastest, may include writes newer than the read) · ``snapshot`` (index candidates filtered at the read's snapshot) · ``exact`` (every vector of the label, without the index). Omitted, the mode the read concern implies. A ``vector_consistency`` hint in the query wins.
+- ``vector_build_wait_ms``: how long a vector search waits for an index still being built; ``0`` refuses a building index at once. Omitted, the server's default.
+
+```python
+db.cypher(
+    "MATCH (d:Doc) RETURN d.title AS title ORDER BY vector_distance(d.embedding, $q) LIMIT 5",
+    params={"q": query_vector},
+    vector_consistency="exact",
+    vector_build_wait_ms=0,
+)
+```
 
 ## Related Packages
 

{coordinode-3.0.0 → coordinode-4.0.0}/README.md

@@ -199,6 +199,17 @@ Accepted values:
 - ``read_concern``: ``local`` (default) · ``majority`` · ``linearizable`` · ``snapshot``. Causal reads (``after_index`` > 0) require ``majority`` here.
 - ``write_concern``: ``"majority"`` (default) · a member count (``1`` leader only, ``0`` fire-and-forget) · ``WriteConcern(w, journal, timeout_ms)`` with ``journal`` one of ``journal`` (default) · ``cache`` · ``memory``. The volatile ``cache`` and ``memory`` states are accepted only with ``w`` of 0 or 1.
 - ``read_preference``: ``primary`` (default) · ``primary_preferred`` · ``secondary`` · ``secondary_preferred`` · ``nearest``
+- ``vector_consistency``: ``current`` (the index as it is: fastest, may include writes newer than the read) · ``snapshot`` (index candidates filtered at the read's snapshot) · ``exact`` (every vector of the label, without the index). Omitted, the mode the read concern implies. A ``vector_consistency`` hint in the query wins.
+- ``vector_build_wait_ms``: how long a vector search waits for an index still being built; ``0`` refuses a building index at once. Omitted, the server's default.
+
+```python
+db.cypher(
+    "MATCH (d:Doc) RETURN d.title AS title ORDER BY vector_distance(d.embedding, $q) LIMIT 5",
+    params={"q": query_vector},
+    vector_consistency="exact",
+    vector_build_wait_ms=0,
+)
+```
 
 ## Related Packages
 

{coordinode-3.0.0 → coordinode-4.0.0}/coordinode/__init__.py

@@ -22,6 +22,7 @@ from coordinode._types import MultiVector, Path
 from coordinode.client import (
     AsyncCoordinodeClient,
     AsyncTransaction,
+    ConstraintInfo,
     CoordinodeClient,
     EdgeResult,
     EdgeTypeInfo,
@@ -62,6 +63,7 @@ __all__ = [
     "LabelInfo",
     "EdgeTypeInfo",
     "PropertyDefinitionInfo",
+    "ConstraintInfo",
     "TextIndexInfo",
     "TraverseResult",
 ]

coordinode-4.0.0/coordinode/_proto/coordinode/internode/handshake_pb2.py

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: coordinode/internode/handshake.proto
+# Protobuf Python Version: 7.35.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,
+    7,
+    35,
+    1,
+    '',
+    'coordinode/internode/handshake.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n$coordinode/internode/handshake.proto\x12\x14\x63oordinode.internode\"!\n\x0fHandshakeRecord\x12\x0e\n\x06record\x18\x01 \x01(\x0c\x32l\n\x10VersionHandshake\x12X\n\x08\x45xchange\x12%.coordinode.internode.HandshakeRecord\x1a%.coordinode.internode.HandshakeRecordb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'coordinode.internode.handshake_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_HANDSHAKERECORD']._serialized_start=62
+  _globals['_HANDSHAKERECORD']._serialized_end=95
+  _globals['_VERSIONHANDSHAKE']._serialized_start=97
+  _globals['_VERSIONHANDSHAKE']._serialized_end=205
+# @@protoc_insertion_point(module_scope)

coordinode-4.0.0/coordinode/_proto/coordinode/internode/handshake_pb2.pyi

@@ -0,0 +1,11 @@
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Optional as _Optional
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class HandshakeRecord(_message.Message):
+    __slots__ = ("record",)
+    RECORD_FIELD_NUMBER: _ClassVar[int]
+    record: bytes
+    def __init__(self, record: _Optional[bytes] = ...) -> None: ...

coordinode-4.0.0/coordinode/_proto/coordinode/internode/handshake_pb2_grpc.py

@@ -0,0 +1,132 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+from coordinode.internode import handshake_pb2 as coordinode_dot_internode_dot_handshake__pb2
+
+GRPC_GENERATED_VERSION = '1.83.1'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + ' but the generated code in coordinode/internode/handshake_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )
+
+
+class VersionHandshakeStub:
+    """The version handshake between two members of a consensus group.
+
+    This file is frozen for the life of the product: its package, service,
+    method and messages never change, so that members of any two releases can
+    tell each other which version they run. Members whose versions differ
+    exchange nothing but this.
+
+    The same record also travels in the `cn-version-handshake-bin` request
+    and response metadata of every other inter-node call; a call whose record
+    does not match the receiver's version is refused before its payload is
+    read.
+    """
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.Exchange = channel.unary_unary(
+                '/coordinode.internode.VersionHandshake/Exchange',
+                request_serializer=coordinode_dot_internode_dot_handshake__pb2.HandshakeRecord.SerializeToString,
+                response_deserializer=coordinode_dot_internode_dot_handshake__pb2.HandshakeRecord.FromString,
+                _registered_method=True)
+
+
+class VersionHandshakeServicer:
+    """The version handshake between two members of a consensus group.
+
+    This file is frozen for the life of the product: its package, service,
+    method and messages never change, so that members of any two releases can
+    tell each other which version they run. Members whose versions differ
+    exchange nothing but this.
+
+    The same record also travels in the `cn-version-handshake-bin` request
+    and response metadata of every other inter-node call; a call whose record
+    does not match the receiver's version is refused before its payload is
+    read.
+    """
+
+    def Exchange(self, request, context):
+        """Exchange version records. Answered whether or not the two members
+        match; the caller compares the records itself.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_VersionHandshakeServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'Exchange': grpc.unary_unary_rpc_method_handler(
+                    servicer.Exchange,
+                    request_deserializer=coordinode_dot_internode_dot_handshake__pb2.HandshakeRecord.FromString,
+                    response_serializer=coordinode_dot_internode_dot_handshake__pb2.HandshakeRecord.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'coordinode.internode.VersionHandshake', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers('coordinode.internode.VersionHandshake', rpc_method_handlers)
+
+
+ # This class is part of an EXPERIMENTAL API.
+class VersionHandshake:
+    """The version handshake between two members of a consensus group.
+
+    This file is frozen for the life of the product: its package, service,
+    method and messages never change, so that members of any two releases can
+    tell each other which version they run. Members whose versions differ
+    exchange nothing but this.
+
+    The same record also travels in the `cn-version-handshake-bin` request
+    and response metadata of every other inter-node call; a call whose record
+    does not match the receiver's version is refused before its payload is
+    read.
+    """
+
+    @staticmethod
+    def Exchange(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/coordinode.internode.VersionHandshake/Exchange',
+            coordinode_dot_internode_dot_handshake__pb2.HandshakeRecord.SerializeToString,
+            coordinode_dot_internode_dot_handshake__pb2.HandshakeRecord.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

{coordinode-3.0.0 → coordinode-4.0.0}/coordinode/_proto/coordinode/v1/admin/cluster_pb2_grpc.py

@@ -126,18 +126,19 @@ class ClusterServiceServicer:
     def DecommissionNode(self, request, context):
         """Gracefully decommission a node from the cluster.
 
-        Implements the Phase 0-2 decommission protocol:
-        Phase 0: Quorum gate — verify removing node_id still leaves ≥ 2 voters.
-        Aborts with FAILED_PRECONDITION if quorum would be lost.
-        Phase 1: Leadership transfer — if node_id is the current Raft leader,
-        leadership is transferred to a peer before removal.
-        For self-decommission (leader removing itself), the request is
-        internally forwarded to the new leader after transfer.
-        Phase 2: Membership remove — change_membership(remove: node_id).
-        Node stops receiving log replication and is removed from quorum.
-
-        CE behaviour: single Raft group, all nodes hold full data. Pruning (Phase 3)
-        is advisory — operator must delete data on the decommissioned node manually.
+        First the quorum gate: removing node_id must still leave at least 2
+        voters, otherwise the call aborts with FAILED_PRECONDITION.
+
+        Then the leadership transfer: if node_id is the current Raft leader,
+        leadership moves to a peer before removal. For self-decommission (the
+        leader removing itself) the request is forwarded to the new leader after
+        the transfer.
+
+        Last the membership remove, change_membership(remove: node_id): the node
+        stops receiving log replication and leaves the quorum.
+
+        CE behaviour: single Raft group, all nodes hold full data. Pruning is
+        advisory: the operator deletes data on the decommissioned node manually.
 
         Must be called on the current Raft leader, or on the node being decommissioned
         when that node is the leader (self-decommission path).

coordinode-4.0.0/coordinode/_proto/coordinode/v1/query/cypher_pb2.py

@@ -0,0 +1,89 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: coordinode/v1/query/cypher.proto
+# Protobuf Python Version: 7.35.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,
+    7,
+    35,
+    1,
+    '',
+    'coordinode/v1/query/cypher.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from coordinode._proto.coordinode.v1.common import types_pb2 as coordinode_dot_v1_dot_common_dot_types__pb2
+from coordinode._proto.coordinode.v1.replication import consistency_pb2 as coordinode_dot_v1_dot_replication_dot_consistency__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n coordinode/v1/query/cypher.proto\x12\x13\x63oordinode.v1.query\x1a coordinode/v1/common/types.proto\x1a+coordinode/v1/replication/consistency.proto\x1a\x1cgoogle/api/annotations.proto\"\xac\x04\n\x14\x45xecuteCypherRequest\x12\r\n\x05query\x18\x01 \x01(\t\x12M\n\nparameters\x18\x02 \x03(\x0b\x32\x39.coordinode.v1.query.ExecuteCypherRequest.ParametersEntry\x12\x42\n\x0fread_preference\x18\x03 \x01(\x0e\x32).coordinode.v1.replication.ReadPreference\x12<\n\x0cread_concern\x18\x04 \x01(\x0b\x32&.coordinode.v1.replication.ReadConcern\x12>\n\rwrite_concern\x18\x05 \x01(\x0b\x32\'.coordinode.v1.replication.WriteConcern\x12\x16\n\x0etransaction_id\x18\x06 \x01(\x04\x12H\n\x12vector_consistency\x18\x07 \x01(\x0e\x32,.coordinode.v1.replication.VectorConsistency\x12!\n\x14vector_build_wait_ms\x18\x08 \x01(\rH\x00\x88\x01\x01\x1aV\n\x0fParametersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x32\n\x05value\x18\x02 \x01(\x0b\x32#.coordinode.v1.common.PropertyValue:\x02\x38\x01\x42\x17\n\x15_vector_build_wait_ms\"\x80\x01\n\x15\x45xecuteCypherResponse\x12\x0f\n\x07\x63olumns\x18\x01 \x03(\t\x12&\n\x04rows\x18\x02 \x03(\x0b\x32\x18.coordinode.v1.query.Row\x12.\n\x05stats\x18\x03 \x01(\x0b\x32\x1f.coordinode.v1.query.QueryStats\":\n\x03Row\x12\x33\n\x06values\x18\x01 \x03(\x0b\x32#.coordinode.v1.common.PropertyValue\"\xf6\x01\n\nQueryStats\x12\x15\n\rnodes_created\x18\x01 \x01(\x03\x12\x15\n\rnodes_deleted\x18\x02 \x01(\x03\x12\x15\n\redges_created\x18\x03 \x01(\x03\x12\x15\n\redges_deleted\x18\x04 \x01(\x03\x12\x16\n\x0eproperties_set\x18\x05 \x01(\x03\x12\x19\n\x11\x65xecution_time_ms\x18\x06 \x01(\x03\x12\x15\n\rapplied_index\x18\x07 \x01(\x04\x12\x18\n\x10served_by_leader\x18\x08 \x01(\x08\x12\x11\n\tcommit_ts\x18\t \x01(\x04\x12\x15\n\rread_as_of_ts\x18\n \x01(\x04\"\xcc\x01\n\x14\x45xplainCypherRequest\x12\r\n\x05query\x18\x01 \x01(\t\x12M\n\nparameters\x18\x02 \x03(\x0b\x32\x39.coordinode.v1.query.ExplainCypherRequest.ParametersEntry\x1aV\n\x0fParametersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x32\n\x05value\x18\x02 \x01(\x0b\x32#.coordinode.v1.common.PropertyValue:\x02\x38\x01\"E\n\x15\x45xplainCypherResponse\x12,\n\x04plan\x18\x01 \x01(\x0b\x32\x1e.coordinode.v1.query.QueryPlan\"\xd5\x01\n\tQueryPlan\x12\x10\n\x08operator\x18\x01 \x01(\t\x12<\n\x07\x64\x65tails\x18\x02 \x03(\x0b\x32+.coordinode.v1.query.QueryPlan.DetailsEntry\x12\x30\n\x08\x63hildren\x18\x03 \x03(\x0b\x32\x1e.coordinode.v1.query.QueryPlan\x12\x16\n\x0e\x65stimated_rows\x18\x04 \x01(\x01\x1a.\n\x0c\x44\x65tailsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x19\n\x17\x42\x65ginTransactionRequest\"2\n\x18\x42\x65ginTransactionResponse\x12\x16\n\x0etransaction_id\x18\x01 \x01(\x04\"l\n\x18\x43ommitTransactionRequest\x12\x16\n\x0etransaction_id\x18\x01 \x01(\x04\x12\x38\n\x06\x65xpect\x18\x02 \x03(\x0b\x32(.coordinode.v1.query.ExpectedNodeVersion\"H\n\x13\x45xpectedNodeVersion\x12\x0f\n\x07node_id\x18\x01 \x01(\x04\x12\x14\n\x07version\x18\x02 \x01(\x04H\x00\x88\x01\x01\x42\n\n\x08_version\"E\n\x19\x43ommitTransactionResponse\x12\x15\n\rapplied_index\x18\x01 \x01(\x04\x12\x11\n\tcommit_ts\x18\x02 \x01(\x04\"4\n\x1aRollbackTransactionRequest\x12\x16\n\x0etransaction_id\x18\x01 \x01(\x04\"\x1d\n\x1bRollbackTransactionResponse2\x81\x06\n\rCypherService\x12\x83\x01\n\rExecuteCypher\x12).coordinode.v1.query.ExecuteCypherRequest\x1a*.coordinode.v1.query.ExecuteCypherResponse\"\x1b\x82\xd3\xe4\x93\x02\x15\"\x10/v1/query/cypher:\x01*\x12\x8b\x01\n\rExplainCypher\x12).coordinode.v1.query.ExplainCypherRequest\x1a*.coordinode.v1.query.ExplainCypherResponse\"#\x82\xd3\xe4\x93\x02\x1d\"\x18/v1/query/cypher/explain:\x01*\x12\x97\x01\n\x10\x42\x65ginTransaction\x12,.coordinode.v1.query.BeginTransactionRequest\x1a-.coordinode.v1.query.BeginTransactionResponse\"&\x82\xd3\xe4\x93\x02 \"\x1b/v1/query/transaction/begin:\x01*\x12\x9b\x01\n\x11\x43ommitTransaction\x12-.coordinode.v1.query.CommitTransactionRequest\x1a..coordinode.v1.query.CommitTransactionResponse\"\'\x82\xd3\xe4\x93\x02!\"\x1c/v1/query/transaction/commit:\x01*\x12\xa3\x01\n\x13RollbackTransaction\x12/.coordinode.v1.query.RollbackTransactionRequest\x1a\x30.coordinode.v1.query.RollbackTransactionResponse\")\x82\xd3\xe4\x93\x02#\"\x1e/v1/query/transaction/rollback:\x01*b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'coordinode.v1.query.cypher_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_EXECUTECYPHERREQUEST_PARAMETERSENTRY']._loaded_options = None
+  _globals['_EXECUTECYPHERREQUEST_PARAMETERSENTRY']._serialized_options = b'8\001'
+  _globals['_EXPLAINCYPHERREQUEST_PARAMETERSENTRY']._loaded_options = None
+  _globals['_EXPLAINCYPHERREQUEST_PARAMETERSENTRY']._serialized_options = b'8\001'
+  _globals['_QUERYPLAN_DETAILSENTRY']._loaded_options = None
+  _globals['_QUERYPLAN_DETAILSENTRY']._serialized_options = b'8\001'
+  _globals['_CYPHERSERVICE'].methods_by_name['ExecuteCypher']._loaded_options = None
+  _globals['_CYPHERSERVICE'].methods_by_name['ExecuteCypher']._serialized_options = b'\202\323\344\223\002\025\"\020/v1/query/cypher:\001*'
+  _globals['_CYPHERSERVICE'].methods_by_name['ExplainCypher']._loaded_options = None
+  _globals['_CYPHERSERVICE'].methods_by_name['ExplainCypher']._serialized_options = b'\202\323\344\223\002\035\"\030/v1/query/cypher/explain:\001*'
+  _globals['_CYPHERSERVICE'].methods_by_name['BeginTransaction']._loaded_options = None
+  _globals['_CYPHERSERVICE'].methods_by_name['BeginTransaction']._serialized_options = b'\202\323\344\223\002 \"\033/v1/query/transaction/begin:\001*'
+  _globals['_CYPHERSERVICE'].methods_by_name['CommitTransaction']._loaded_options = None
+  _globals['_CYPHERSERVICE'].methods_by_name['CommitTransaction']._serialized_options = b'\202\323\344\223\002!\"\034/v1/query/transaction/commit:\001*'
+  _globals['_CYPHERSERVICE'].methods_by_name['RollbackTransaction']._loaded_options = None
+  _globals['_CYPHERSERVICE'].methods_by_name['RollbackTransaction']._serialized_options = b'\202\323\344\223\002#\"\036/v1/query/transaction/rollback:\001*'
+  _globals['_EXECUTECYPHERREQUEST']._serialized_start=167
+  _globals['_EXECUTECYPHERREQUEST']._serialized_end=723
+  _globals['_EXECUTECYPHERREQUEST_PARAMETERSENTRY']._serialized_start=612
+  _globals['_EXECUTECYPHERREQUEST_PARAMETERSENTRY']._serialized_end=698
+  _globals['_EXECUTECYPHERRESPONSE']._serialized_start=726
+  _globals['_EXECUTECYPHERRESPONSE']._serialized_end=854
+  _globals['_ROW']._serialized_start=856
+  _globals['_ROW']._serialized_end=914
+  _globals['_QUERYSTATS']._serialized_start=917
+  _globals['_QUERYSTATS']._serialized_end=1163
+  _globals['_EXPLAINCYPHERREQUEST']._serialized_start=1166
+  _globals['_EXPLAINCYPHERREQUEST']._serialized_end=1370
+  _globals['_EXPLAINCYPHERREQUEST_PARAMETERSENTRY']._serialized_start=612
+  _globals['_EXPLAINCYPHERREQUEST_PARAMETERSENTRY']._serialized_end=698
+  _globals['_EXPLAINCYPHERRESPONSE']._serialized_start=1372
+  _globals['_EXPLAINCYPHERRESPONSE']._serialized_end=1441
+  _globals['_QUERYPLAN']._serialized_start=1444
+  _globals['_QUERYPLAN']._serialized_end=1657
+  _globals['_QUERYPLAN_DETAILSENTRY']._serialized_start=1611
+  _globals['_QUERYPLAN_DETAILSENTRY']._serialized_end=1657
+  _globals['_BEGINTRANSACTIONREQUEST']._serialized_start=1659
+  _globals['_BEGINTRANSACTIONREQUEST']._serialized_end=1684
+  _globals['_BEGINTRANSACTIONRESPONSE']._serialized_start=1686
+  _globals['_BEGINTRANSACTIONRESPONSE']._serialized_end=1736
+  _globals['_COMMITTRANSACTIONREQUEST']._serialized_start=1738
+  _globals['_COMMITTRANSACTIONREQUEST']._serialized_end=1846
+  _globals['_EXPECTEDNODEVERSION']._serialized_start=1848
+  _globals['_EXPECTEDNODEVERSION']._serialized_end=1920
+  _globals['_COMMITTRANSACTIONRESPONSE']._serialized_start=1922
+  _globals['_COMMITTRANSACTIONRESPONSE']._serialized_end=1991
+  _globals['_ROLLBACKTRANSACTIONREQUEST']._serialized_start=1993
+  _globals['_ROLLBACKTRANSACTIONREQUEST']._serialized_end=2045
+  _globals['_ROLLBACKTRANSACTIONRESPONSE']._serialized_start=2047
+  _globals['_ROLLBACKTRANSACTIONRESPONSE']._serialized_end=2076
+  _globals['_CYPHERSERVICE']._serialized_start=2079
+  _globals['_CYPHERSERVICE']._serialized_end=2848
+# @@protoc_insertion_point(module_scope)

{coordinode-3.0.0 → coordinode-4.0.0}/coordinode/_proto/coordinode/v1/query/cypher_pb2.pyi

@@ -10,7 +10,7 @@ from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
 DESCRIPTOR: _descriptor.FileDescriptor
 
 class ExecuteCypherRequest(_message.Message):
-    __slots__ = ("query", "parameters", "read_preference", "read_concern", "write_concern", "transaction_id")
+    __slots__ = ("query", "parameters", "read_preference", "read_concern", "write_concern", "transaction_id", "vector_consistency", "vector_build_wait_ms")
     class ParametersEntry(_message.Message):
         __slots__ = ("key", "value")
         KEY_FIELD_NUMBER: _ClassVar[int]
@@ -24,13 +24,17 @@ class ExecuteCypherRequest(_message.Message):
     READ_CONCERN_FIELD_NUMBER: _ClassVar[int]
     WRITE_CONCERN_FIELD_NUMBER: _ClassVar[int]
     TRANSACTION_ID_FIELD_NUMBER: _ClassVar[int]
+    VECTOR_CONSISTENCY_FIELD_NUMBER: _ClassVar[int]
+    VECTOR_BUILD_WAIT_MS_FIELD_NUMBER: _ClassVar[int]
     query: str
     parameters: _containers.MessageMap[str, _types_pb2.PropertyValue]
     read_preference: _consistency_pb2.ReadPreference
     read_concern: _consistency_pb2.ReadConcern
     write_concern: _consistency_pb2.WriteConcern
     transaction_id: int
-    def __init__(self, query: _Optional[str] = ..., parameters: _Optional[_Mapping[str, _types_pb2.PropertyValue]] = ..., read_preference: _Optional[_Union[_consistency_pb2.ReadPreference, str]] = ..., read_concern: _Optional[_Union[_consistency_pb2.ReadConcern, _Mapping]] = ..., write_concern: _Optional[_Union[_consistency_pb2.WriteConcern, _Mapping]] = ..., transaction_id: _Optional[int] = ...) -> None: ...
+    vector_consistency: _consistency_pb2.VectorConsistency
+    vector_build_wait_ms: int
+    def __init__(self, query: _Optional[str] = ..., parameters: _Optional[_Mapping[str, _types_pb2.PropertyValue]] = ..., read_preference: _Optional[_Union[_consistency_pb2.ReadPreference, str]] = ..., read_concern: _Optional[_Union[_consistency_pb2.ReadConcern, _Mapping]] = ..., write_concern: _Optional[_Union[_consistency_pb2.WriteConcern, _Mapping]] = ..., transaction_id: _Optional[int] = ..., vector_consistency: _Optional[_Union[_consistency_pb2.VectorConsistency, str]] = ..., vector_build_wait_ms: _Optional[int] = ...) -> None: ...
 
 class ExecuteCypherResponse(_message.Message):
     __slots__ = ("columns", "rows", "stats")
@@ -49,7 +53,7 @@ class Row(_message.Message):
     def __init__(self, values: _Optional[_Iterable[_Union[_types_pb2.PropertyValue, _Mapping]]] = ...) -> None: ...
 
 class QueryStats(_message.Message):
-    __slots__ = ("nodes_created", "nodes_deleted", "edges_created", "edges_deleted", "properties_set", "execution_time_ms", "applied_index", "served_by_leader", "commit_ts")
+    __slots__ = ("nodes_created", "nodes_deleted", "edges_created", "edges_deleted", "properties_set", "execution_time_ms", "applied_index", "served_by_leader", "commit_ts", "read_as_of_ts")
     NODES_CREATED_FIELD_NUMBER: _ClassVar[int]
     NODES_DELETED_FIELD_NUMBER: _ClassVar[int]
     EDGES_CREATED_FIELD_NUMBER: _ClassVar[int]
@@ -59,6 +63,7 @@ class QueryStats(_message.Message):
     APPLIED_INDEX_FIELD_NUMBER: _ClassVar[int]
     SERVED_BY_LEADER_FIELD_NUMBER: _ClassVar[int]
     COMMIT_TS_FIELD_NUMBER: _ClassVar[int]
+    READ_AS_OF_TS_FIELD_NUMBER: _ClassVar[int]
     nodes_created: int
     nodes_deleted: int
     edges_created: int
@@ -68,7 +73,8 @@ class QueryStats(_message.Message):
     applied_index: int
     served_by_leader: bool
     commit_ts: int
-    def __init__(self, nodes_created: _Optional[int] = ..., nodes_deleted: _Optional[int] = ..., edges_created: _Optional[int] = ..., edges_deleted: _Optional[int] = ..., properties_set: _Optional[int] = ..., execution_time_ms: _Optional[int] = ..., applied_index: _Optional[int] = ..., served_by_leader: _Optional[bool] = ..., commit_ts: _Optional[int] = ...) -> None: ...
+    read_as_of_ts: int
+    def __init__(self, nodes_created: _Optional[int] = ..., nodes_deleted: _Optional[int] = ..., edges_created: _Optional[int] = ..., edges_deleted: _Optional[int] = ..., properties_set: _Optional[int] = ..., execution_time_ms: _Optional[int] = ..., applied_index: _Optional[int] = ..., served_by_leader: _Optional[bool] = ..., commit_ts: _Optional[int] = ..., read_as_of_ts: _Optional[int] = ...) -> None: ...
 
 class ExplainCypherRequest(_message.Message):
     __slots__ = ("query", "parameters")

coordinode-4.0.0/coordinode/_proto/coordinode/v1/replication/cdc_pb2.py

@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: coordinode/v1/replication/cdc.proto
+# Protobuf Python Version: 7.35.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,
+    7,
+    35,
+    1,
+    '',
+    'coordinode/v1/replication/cdc.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n#coordinode/v1/replication/cdc.proto\x12\x19\x63oordinode.v1.replication\"\x9b\x01\n\x11\x43onsumerRetention\x12<\n\x06strict\x18\x01 \x01(\x0b\x32*.coordinode.v1.replication.StrictRetentionH\x00\x12>\n\x07\x62ounded\x18\x02 \x01(\x0b\x32+.coordinode.v1.replication.BoundedRetentionH\x00\x42\x08\n\x06policy\"\x11\n\x0fStrictRetention\"\x85\x01\n\x10\x42oundedRetention\x12\x1b\n\x13max_progress_lag_ms\x18\x01 \x01(\x04\x12\x1a\n\x12max_retained_bytes\x18\x02 \x01(\x04\x12 \n\x13liveness_timeout_ms\x18\x03 \x01(\x04H\x00\x88\x01\x01\x42\x16\n\x14_liveness_timeout_ms\"E\n\x19\x43\x61ncelSubscriptionRequest\x12\x13\n\x0b\x63onsumer_id\x18\x01 \x01(\t\x12\x13\n\x0bincarnation\x18\x02 \x01(\x04\"\x1c\n\x1a\x43\x61ncelSubscriptionResponse\"\x84\x01\n\x1e\x41\x63knowledgeSubscriptionRequest\x12\x13\n\x0b\x63onsumer_id\x18\x01 \x01(\t\x12\x13\n\x0bincarnation\x18\x02 \x01(\x04\x12\x38\n\x08position\x18\x03 \x01(\x0b\x32&.coordinode.v1.replication.ResumeToken\"!\n\x1f\x41\x63knowledgeSubscriptionResponse\"I\n\x0bResumeToken\x12\x10\n\x08shard_id\x18\x01 \x01(\r\x12\x12\n\nsegment_id\x18\x02 \x01(\x04\x12\x14\n\x0c\x65ntry_offset\x18\x03 \x01(\x04\"L\n\nCdcFilters\x12\x12\n\nedge_types\x18\x01 \x03(\t\x12\x19\n\x0cis_migration\x18\x02 \x01(\x08H\x00\x88\x01\x01\x42\x0f\n\r_is_migration\"\xf3\x01\n\x10SubscribeRequest\x12<\n\x0cresume_token\x18\x01 \x01(\x0b\x32&.coordinode.v1.replication.ResumeToken\x12\x36\n\x07\x66ilters\x18\x02 \x01(\x0b\x32%.coordinode.v1.replication.CdcFilters\x12\x13\n\x0b\x63onsumer_id\x18\x03 \x01(\t\x12\x13\n\x0bincarnation\x18\x04 \x01(\x04\x12?\n\tretention\x18\x05 \x01(\x0b\x32,.coordinode.v1.replication.ConsumerRetention\"\xce\x01\n\x0b\x43hangeEvent\x12\n\n\x02ts\x18\x01 \x01(\x04\x12\x0c\n\x04term\x18\x02 \x01(\x04\x12\x11\n\tlog_index\x18\x03 \x01(\x04\x12\x10\n\x08shard_id\x18\x04 \x01(\r\x12\x14\n\x0cis_migration\x18\x05 \x01(\x08\x12\x30\n\x03ops\x18\x06 \x03(\x0b\x32#.coordinode.v1.replication.ChangeOp\x12\x38\n\x08position\x18\x07 \x01(\x0b\x32&.coordinode.v1.replication.ResumeToken\"p\n\x08\x43hangeOp\x12\x35\n\x04type\x18\x01 \x01(\x0e\x32\'.coordinode.v1.replication.ChangeOpType\x12\x11\n\tpartition\x18\x02 \x01(\r\x12\x0b\n\x03key\x18\x03 \x01(\x0c\x12\r\n\x05value\x18\x04 \x01(\x0c*\x92\x01\n\x0c\x43hangeOpType\x12\x1e\n\x1a\x43HANGE_OP_TYPE_UNSPECIFIED\x10\x00\x12\n\n\x06INSERT\x10\x01\x12\n\n\x06\x44\x45LETE\x10\x02\x12\t\n\x05MERGE\x10\x03\x12\x08\n\x04NOOP\x10\x04\x12\x0e\n\nRAFT_ENTRY\x10\x05\x12\x13\n\x0fRAFT_TRUNCATION\x10\x06\x12\x10\n\x0cREMOVE_RANGE\x10\x07\x32\x90\x03\n\x13\x43hangeStreamService\x12\x62\n\tSubscribe\x12+.coordinode.v1.replication.SubscribeRequest\x1a&.coordinode.v1.replication.ChangeEvent0\x01\x12\x90\x01\n\x17\x41\x63knowledgeSubscription\x12\x39.coordinode.v1.replication.AcknowledgeSubscriptionRequest\x1a:.coordinode.v1.replication.AcknowledgeSubscriptionResponse\x12\x81\x01\n\x12\x43\x61ncelSubscription\x12\x34.coordinode.v1.replication.CancelSubscriptionRequest\x1a\x35.coordinode.v1.replication.CancelSubscriptionResponseb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'coordinode.v1.replication.cdc_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_CHANGEOPTYPE']._serialized_start=1373
+  _globals['_CHANGEOPTYPE']._serialized_end=1519
+  _globals['_CONSUMERRETENTION']._serialized_start=67
+  _globals['_CONSUMERRETENTION']._serialized_end=222
+  _globals['_STRICTRETENTION']._serialized_start=224
+  _globals['_STRICTRETENTION']._serialized_end=241
+  _globals['_BOUNDEDRETENTION']._serialized_start=244
+  _globals['_BOUNDEDRETENTION']._serialized_end=377
+  _globals['_CANCELSUBSCRIPTIONREQUEST']._serialized_start=379
+  _globals['_CANCELSUBSCRIPTIONREQUEST']._serialized_end=448
+  _globals['_CANCELSUBSCRIPTIONRESPONSE']._serialized_start=450
+  _globals['_CANCELSUBSCRIPTIONRESPONSE']._serialized_end=478
+  _globals['_ACKNOWLEDGESUBSCRIPTIONREQUEST']._serialized_start=481
+  _globals['_ACKNOWLEDGESUBSCRIPTIONREQUEST']._serialized_end=613
+  _globals['_ACKNOWLEDGESUBSCRIPTIONRESPONSE']._serialized_start=615
+  _globals['_ACKNOWLEDGESUBSCRIPTIONRESPONSE']._serialized_end=648
+  _globals['_RESUMETOKEN']._serialized_start=650
+  _globals['_RESUMETOKEN']._serialized_end=723
+  _globals['_CDCFILTERS']._serialized_start=725
+  _globals['_CDCFILTERS']._serialized_end=801
+  _globals['_SUBSCRIBEREQUEST']._serialized_start=804
+  _globals['_SUBSCRIBEREQUEST']._serialized_end=1047
+  _globals['_CHANGEEVENT']._serialized_start=1050
+  _globals['_CHANGEEVENT']._serialized_end=1256
+  _globals['_CHANGEOP']._serialized_start=1258
+  _globals['_CHANGEOP']._serialized_end=1370
+  _globals['_CHANGESTREAMSERVICE']._serialized_start=1522
+  _globals['_CHANGESTREAMSERVICE']._serialized_end=1922
+# @@protoc_insertion_point(module_scope)

{coordinode-3.0.0 → coordinode-4.0.0}/coordinode/_proto/coordinode/v1/replication/cdc_pb2.pyi

@@ -26,6 +26,54 @@ RAFT_ENTRY: ChangeOpType
 RAFT_TRUNCATION: ChangeOpType
 REMOVE_RANGE: ChangeOpType
 
+class ConsumerRetention(_message.Message):
+    __slots__ = ("strict", "bounded")
+    STRICT_FIELD_NUMBER: _ClassVar[int]
+    BOUNDED_FIELD_NUMBER: _ClassVar[int]
+    strict: StrictRetention
+    bounded: BoundedRetention
+    def __init__(self, strict: _Optional[_Union[StrictRetention, _Mapping]] = ..., bounded: _Optional[_Union[BoundedRetention, _Mapping]] = ...) -> None: ...
+
+class StrictRetention(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...
+
+class BoundedRetention(_message.Message):
+    __slots__ = ("max_progress_lag_ms", "max_retained_bytes", "liveness_timeout_ms")
+    MAX_PROGRESS_LAG_MS_FIELD_NUMBER: _ClassVar[int]
+    MAX_RETAINED_BYTES_FIELD_NUMBER: _ClassVar[int]
+    LIVENESS_TIMEOUT_MS_FIELD_NUMBER: _ClassVar[int]
+    max_progress_lag_ms: int
+    max_retained_bytes: int
+    liveness_timeout_ms: int
+    def __init__(self, max_progress_lag_ms: _Optional[int] = ..., max_retained_bytes: _Optional[int] = ..., liveness_timeout_ms: _Optional[int] = ...) -> None: ...
+
+class CancelSubscriptionRequest(_message.Message):
+    __slots__ = ("consumer_id", "incarnation")
+    CONSUMER_ID_FIELD_NUMBER: _ClassVar[int]
+    INCARNATION_FIELD_NUMBER: _ClassVar[int]
+    consumer_id: str
+    incarnation: int
+    def __init__(self, consumer_id: _Optional[str] = ..., incarnation: _Optional[int] = ...) -> None: ...
+
+class CancelSubscriptionResponse(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...
+
+class AcknowledgeSubscriptionRequest(_message.Message):
+    __slots__ = ("consumer_id", "incarnation", "position")
+    CONSUMER_ID_FIELD_NUMBER: _ClassVar[int]
+    INCARNATION_FIELD_NUMBER: _ClassVar[int]
+    POSITION_FIELD_NUMBER: _ClassVar[int]
+    consumer_id: str
+    incarnation: int
+    position: ResumeToken
+    def __init__(self, consumer_id: _Optional[str] = ..., incarnation: _Optional[int] = ..., position: _Optional[_Union[ResumeToken, _Mapping]] = ...) -> None: ...
+
+class AcknowledgeSubscriptionResponse(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...
+
 class ResumeToken(_message.Message):
     __slots__ = ("shard_id", "segment_id", "entry_offset")
     SHARD_ID_FIELD_NUMBER: _ClassVar[int]
@@ -45,12 +93,18 @@ class CdcFilters(_message.Message):
     def __init__(self, edge_types: _Optional[_Iterable[str]] = ..., is_migration: _Optional[bool] = ...) -> None: ...
 
 class SubscribeRequest(_message.Message):
-    __slots__ = ("resume_token", "filters")
+    __slots__ = ("resume_token", "filters", "consumer_id", "incarnation", "retention")
     RESUME_TOKEN_FIELD_NUMBER: _ClassVar[int]
     FILTERS_FIELD_NUMBER: _ClassVar[int]
+    CONSUMER_ID_FIELD_NUMBER: _ClassVar[int]
+    INCARNATION_FIELD_NUMBER: _ClassVar[int]
+    RETENTION_FIELD_NUMBER: _ClassVar[int]
     resume_token: ResumeToken
     filters: CdcFilters
-    def __init__(self, resume_token: _Optional[_Union[ResumeToken, _Mapping]] = ..., filters: _Optional[_Union[CdcFilters, _Mapping]] = ...) -> None: ...
+    consumer_id: str
+    incarnation: int
+    retention: ConsumerRetention
+    def __init__(self, resume_token: _Optional[_Union[ResumeToken, _Mapping]] = ..., filters: _Optional[_Union[CdcFilters, _Mapping]] = ..., consumer_id: _Optional[str] = ..., incarnation: _Optional[int] = ..., retention: _Optional[_Union[ConsumerRetention, _Mapping]] = ...) -> None: ...
 
 class ChangeEvent(_message.Message):
     __slots__ = ("ts", "term", "log_index", "shard_id", "is_migration", "ops", "position")