coordinode 3.0.0__tar.gz → 4.0.1__tar.gz

{coordinode-3.0.0 → coordinode-4.0.1}/.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.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: coordinode
-Version: 3.0.0
+Version: 4.0.1
 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
@@ -21,13 +21,13 @@ Classifier: Topic :: Database
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.11
 Requires-Dist: googleapis-common-protos>=1.74.0
-Requires-Dist: grpcio>=1.83.1
+Requires-Dist: grpcio>=1.84.0
 Requires-Dist: protobuf>=7.35.1
 Provides-Extra: dev
-Requires-Dist: grpcio-tools>=1.83.1; extra == 'dev'
+Requires-Dist: grpcio-tools>=1.84.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=1.4; extra == 'dev'
 Requires-Dist: pytest>=9; extra == 'dev'
-Requires-Dist: ruff>=0.16; extra == 'dev'
+Requires-Dist: ruff>=0.17.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # coordinode
@@ -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.1}/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.1}/coordinode/__init__.py

@@ -18,10 +18,11 @@ Async::
         result = await db.cypher("MATCH (n) RETURN count(n) AS total")
 """
 
-from coordinode._types import MultiVector, Path
+from coordinode._types import MultiVector, Path, Timestamp
 from coordinode.client import (
     AsyncCoordinodeClient,
     AsyncTransaction,
+    ConstraintInfo,
     CoordinodeClient,
     EdgeResult,
     EdgeTypeInfo,
@@ -49,10 +50,12 @@ __all__ = [
     "Transaction",
     "AsyncTransaction",
     # Values whose wire type only a tag can carry: a plain nested list encodes
-    # as a list and a plain dict as a map, so sending either of these types
-    # requires the constructor, not just the shape.
+    # as a list, a plain dict as a map and a plain int as an integer, so
+    # sending one of these types requires the constructor, not just the shape.
+    # An aware datetime encodes as a timestamp too.
     "MultiVector",
     "Path",
+    "Timestamp",
     # How a write is acknowledged: member count or majority, and how durably.
     "WriteConcern",
     "NodeResult",
@@ -62,6 +65,7 @@ __all__ = [
     "LabelInfo",
     "EdgeTypeInfo",
     "PropertyDefinitionInfo",
+    "ConstraintInfo",
     "TextIndexInfo",
     "TraverseResult",
 ]

coordinode-4.0.1/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.1/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.1/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.84.0'
+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-4.0.1/coordinode/_proto/coordinode/v1/admin/cluster_pb2.py

@@ -0,0 +1,77 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: coordinode/v1/admin/cluster.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/admin/cluster.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n!coordinode/v1/admin/cluster.proto\x12\x13\x63oordinode.v1.admin\x1a\x1cgoogle/api/annotations.proto\"\x19\n\x17GetClusterStatusRequest\"z\n\rClusterStatus\x12/\n\x05nodes\x18\x01 \x03(\x0b\x32 .coordinode.v1.admin.ClusterNode\x12\x11\n\tleader_id\x18\x02 \x01(\t\x12\x11\n\traft_term\x18\x03 \x01(\x04\x12\x12\n\ndeployment\x18\x04 \x01(\t\"\xb7\x01\n\x0b\x43lusterNode\x12\x0f\n\x07node_id\x18\x01 \x01(\t\x12\x0f\n\x07\x61\x64\x64ress\x18\x02 \x01(\t\x12+\n\x04role\x18\x03 \x01(\x0e\x32\x1d.coordinode.v1.admin.NodeRole\x12-\n\x05state\x18\x04 \x01(\x0e\x32\x1e.coordinode.v1.admin.NodeState\x12\x13\n\x0blag_entries\x18\x05 \x01(\x04\x12\x15\n\rnode_identity\x18\x06 \x01(\t\"^\n\x0fJoinNodeRequest\x12\x0f\n\x07node_id\x18\x01 \x01(\x04\x12\x0f\n\x07\x61\x64\x64ress\x18\x02 \x01(\t\x12\x12\n\npre_seeded\x18\x03 \x01(\x08\x12\x15\n\rnode_identity\x18\x04 \x01(\t\"3\n\x10JoinNodeResponse\x12\x0f\n\x07node_id\x18\x01 \x01(\x04\x12\x0e\n\x06status\x18\x02 \x01(\t\"&\n\x13JoinProgressRequest\x12\x0f\n\x07node_id\x18\x01 \x01(\x04\"\x83\x01\n\nJoinStatus\x12\x0f\n\x07node_id\x18\x01 \x01(\x04\x12-\n\x05phase\x18\x02 \x01(\x0e\x32\x1e.coordinode.v1.admin.JoinPhase\x12\x13\n\x0blag_entries\x18\x03 \x01(\x04\x12\x0f\n\x07percent\x18\x04 \x01(\r\x12\x0f\n\x07message\x18\x05 \x01(\t\"!\n\x0e\x41\x64\x64NodeRequest\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\"$\n\x11RemoveNodeRequest\x12\x0f\n\x07node_id\x18\x01 \x01(\t\"\x14\n\x12RemoveNodeResponse\"e\n\x17\x44\x65\x63ommissionNodeRequest\x12\x0f\n\x07node_id\x18\x01 \x01(\x04\x12\x0f\n\x07pruning\x18\x02 \x01(\x08\x12\r\n\x05\x66orce\x18\x03 \x01(\x08\x12\x19\n\x11skip_confirmation\x18\x04 \x01(\x08\"_\n\x18\x44\x65\x63ommissionNodeResponse\x12\x0f\n\x07node_id\x18\x01 \x01(\x04\x12\x0f\n\x07message\x18\x02 \x01(\t\x12!\n\x19operator_cleanup_required\x18\x03 \x01(\x08*j\n\x08NodeRole\x12\x19\n\x15NODE_ROLE_UNSPECIFIED\x10\x00\x12\x14\n\x10NODE_ROLE_LEADER\x10\x01\x12\x16\n\x12NODE_ROLE_FOLLOWER\x10\x02\x12\x15\n\x11NODE_ROLE_LEARNER\x10\x03*m\n\tNodeState\x12\x1a\n\x16NODE_STATE_UNSPECIFIED\x10\x00\x12\x16\n\x12NODE_STATE_HEALTHY\x10\x01\x12\x17\n\x13NODE_STATE_DEGRADED\x10\x02\x12\x13\n\x0fNODE_STATE_DOWN\x10\x03*\xa5\x01\n\tJoinPhase\x12\x1a\n\x16JOIN_PHASE_UNSPECIFIED\x10\x00\x12\x16\n\x12JOIN_PHASE_LEARNER\x10\x01\x12\x1a\n\x16JOIN_PHASE_READY_CHECK\x10\x02\x12\x18\n\x14JOIN_PHASE_PROMOTING\x10\x03\x12\x17\n\x13JOIN_PHASE_COMPLETE\x10\x04\x12\x15\n\x11JOIN_PHASE_FAILED\x10\x05\x32\x92\x06\n\x0e\x43lusterService\x12\x86\x01\n\x10GetClusterStatus\x12,.coordinode.v1.admin.GetClusterStatusRequest\x1a\".coordinode.v1.admin.ClusterStatus\" \x82\xd3\xe4\x93\x02\x1a\x12\x18/v1/admin/cluster/status\x12z\n\x08JoinNode\x12$.coordinode.v1.admin.JoinNodeRequest\x1a%.coordinode.v1.admin.JoinNodeResponse\"!\x82\xd3\xe4\x93\x02\x1b\"\x16/v1/admin/cluster/join:\x01*\x12]\n\x0cJoinProgress\x12(.coordinode.v1.admin.JoinProgressRequest\x1a\x1f.coordinode.v1.admin.JoinStatus\"\x00\x30\x01\x12t\n\x07\x41\x64\x64Node\x12#.coordinode.v1.admin.AddNodeRequest\x1a .coordinode.v1.admin.ClusterNode\"\"\x82\xd3\xe4\x93\x02\x1c\"\x17/v1/admin/cluster/nodes:\x01*\x12\x88\x01\n\nRemoveNode\x12&.coordinode.v1.admin.RemoveNodeRequest\x1a\'.coordinode.v1.admin.RemoveNodeResponse\")\x82\xd3\xe4\x93\x02#*!/v1/admin/cluster/nodes/{node_id}\x12\x9a\x01\n\x10\x44\x65\x63ommissionNode\x12,.coordinode.v1.admin.DecommissionNodeRequest\x1a-.coordinode.v1.admin.DecommissionNodeResponse\")\x82\xd3\xe4\x93\x02#\"\x1e/v1/admin/cluster/decommission:\x01*b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'coordinode.v1.admin.cluster_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_CLUSTERSERVICE'].methods_by_name['GetClusterStatus']._loaded_options = None
+  _globals['_CLUSTERSERVICE'].methods_by_name['GetClusterStatus']._serialized_options = b'\202\323\344\223\002\032\022\030/v1/admin/cluster/status'
+  _globals['_CLUSTERSERVICE'].methods_by_name['JoinNode']._loaded_options = None
+  _globals['_CLUSTERSERVICE'].methods_by_name['JoinNode']._serialized_options = b'\202\323\344\223\002\033\"\026/v1/admin/cluster/join:\001*'
+  _globals['_CLUSTERSERVICE'].methods_by_name['AddNode']._loaded_options = None
+  _globals['_CLUSTERSERVICE'].methods_by_name['AddNode']._serialized_options = b'\202\323\344\223\002\034\"\027/v1/admin/cluster/nodes:\001*'
+  _globals['_CLUSTERSERVICE'].methods_by_name['RemoveNode']._loaded_options = None
+  _globals['_CLUSTERSERVICE'].methods_by_name['RemoveNode']._serialized_options = b'\202\323\344\223\002#*!/v1/admin/cluster/nodes/{node_id}'
+  _globals['_CLUSTERSERVICE'].methods_by_name['DecommissionNode']._loaded_options = None
+  _globals['_CLUSTERSERVICE'].methods_by_name['DecommissionNode']._serialized_options = b'\202\323\344\223\002#\"\036/v1/admin/cluster/decommission:\001*'
+  _globals['_NODEROLE']._serialized_start=1043
+  _globals['_NODEROLE']._serialized_end=1149
+  _globals['_NODESTATE']._serialized_start=1151
+  _globals['_NODESTATE']._serialized_end=1260
+  _globals['_JOINPHASE']._serialized_start=1263
+  _globals['_JOINPHASE']._serialized_end=1428
+  _globals['_GETCLUSTERSTATUSREQUEST']._serialized_start=88
+  _globals['_GETCLUSTERSTATUSREQUEST']._serialized_end=113
+  _globals['_CLUSTERSTATUS']._serialized_start=115
+  _globals['_CLUSTERSTATUS']._serialized_end=237
+  _globals['_CLUSTERNODE']._serialized_start=240
+  _globals['_CLUSTERNODE']._serialized_end=423
+  _globals['_JOINNODEREQUEST']._serialized_start=425
+  _globals['_JOINNODEREQUEST']._serialized_end=519
+  _globals['_JOINNODERESPONSE']._serialized_start=521
+  _globals['_JOINNODERESPONSE']._serialized_end=572
+  _globals['_JOINPROGRESSREQUEST']._serialized_start=574
+  _globals['_JOINPROGRESSREQUEST']._serialized_end=612
+  _globals['_JOINSTATUS']._serialized_start=615
+  _globals['_JOINSTATUS']._serialized_end=746
+  _globals['_ADDNODEREQUEST']._serialized_start=748
+  _globals['_ADDNODEREQUEST']._serialized_end=781
+  _globals['_REMOVENODEREQUEST']._serialized_start=783
+  _globals['_REMOVENODEREQUEST']._serialized_end=819
+  _globals['_REMOVENODERESPONSE']._serialized_start=821
+  _globals['_REMOVENODERESPONSE']._serialized_end=841
+  _globals['_DECOMMISSIONNODEREQUEST']._serialized_start=843
+  _globals['_DECOMMISSIONNODEREQUEST']._serialized_end=944
+  _globals['_DECOMMISSIONNODERESPONSE']._serialized_start=946
+  _globals['_DECOMMISSIONNODERESPONSE']._serialized_end=1041
+  _globals['_CLUSTERSERVICE']._serialized_start=1431
+  _globals['_CLUSTERSERVICE']._serialized_end=2217
+# @@protoc_insertion_point(module_scope)

{coordinode-3.0.0 → coordinode-4.0.1}/coordinode/_proto/coordinode/v1/admin/cluster_pb2.pyi

@@ -50,38 +50,44 @@ class GetClusterStatusRequest(_message.Message):
     def __init__(self) -> None: ...
 
 class ClusterStatus(_message.Message):
-    __slots__ = ("nodes", "leader_id", "raft_term")
+    __slots__ = ("nodes", "leader_id", "raft_term", "deployment")
     NODES_FIELD_NUMBER: _ClassVar[int]
     LEADER_ID_FIELD_NUMBER: _ClassVar[int]
     RAFT_TERM_FIELD_NUMBER: _ClassVar[int]
+    DEPLOYMENT_FIELD_NUMBER: _ClassVar[int]
     nodes: _containers.RepeatedCompositeFieldContainer[ClusterNode]
     leader_id: str
     raft_term: int
-    def __init__(self, nodes: _Optional[_Iterable[_Union[ClusterNode, _Mapping]]] = ..., leader_id: _Optional[str] = ..., raft_term: _Optional[int] = ...) -> None: ...
+    deployment: str
+    def __init__(self, nodes: _Optional[_Iterable[_Union[ClusterNode, _Mapping]]] = ..., leader_id: _Optional[str] = ..., raft_term: _Optional[int] = ..., deployment: _Optional[str] = ...) -> None: ...
 
 class ClusterNode(_message.Message):
-    __slots__ = ("node_id", "address", "role", "state", "lag_entries")
+    __slots__ = ("node_id", "address", "role", "state", "lag_entries", "node_identity")
     NODE_ID_FIELD_NUMBER: _ClassVar[int]
     ADDRESS_FIELD_NUMBER: _ClassVar[int]
     ROLE_FIELD_NUMBER: _ClassVar[int]
     STATE_FIELD_NUMBER: _ClassVar[int]
     LAG_ENTRIES_FIELD_NUMBER: _ClassVar[int]
+    NODE_IDENTITY_FIELD_NUMBER: _ClassVar[int]
     node_id: str
     address: str
     role: NodeRole
     state: NodeState
     lag_entries: int
-    def __init__(self, node_id: _Optional[str] = ..., address: _Optional[str] = ..., role: _Optional[_Union[NodeRole, str]] = ..., state: _Optional[_Union[NodeState, str]] = ..., lag_entries: _Optional[int] = ...) -> None: ...
+    node_identity: str
+    def __init__(self, node_id: _Optional[str] = ..., address: _Optional[str] = ..., role: _Optional[_Union[NodeRole, str]] = ..., state: _Optional[_Union[NodeState, str]] = ..., lag_entries: _Optional[int] = ..., node_identity: _Optional[str] = ...) -> None: ...
 
 class JoinNodeRequest(_message.Message):
-    __slots__ = ("node_id", "address", "pre_seeded")
+    __slots__ = ("node_id", "address", "pre_seeded", "node_identity")
     NODE_ID_FIELD_NUMBER: _ClassVar[int]
     ADDRESS_FIELD_NUMBER: _ClassVar[int]
     PRE_SEEDED_FIELD_NUMBER: _ClassVar[int]
+    NODE_IDENTITY_FIELD_NUMBER: _ClassVar[int]
     node_id: int
     address: str
     pre_seeded: bool
-    def __init__(self, node_id: _Optional[int] = ..., address: _Optional[str] = ..., pre_seeded: _Optional[bool] = ...) -> None: ...
+    node_identity: str
+    def __init__(self, node_id: _Optional[int] = ..., address: _Optional[str] = ..., pre_seeded: _Optional[bool] = ..., node_identity: _Optional[str] = ...) -> None: ...
 
 class JoinNodeResponse(_message.Message):
     __slots__ = ("node_id", "status")

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

@@ -5,7 +5,7 @@ import warnings
 
 from coordinode._proto.coordinode.v1.admin import cluster_pb2 as coordinode_dot_v1_dot_admin_dot_cluster__pb2
 
-GRPC_GENERATED_VERSION = '1.83.1'
+GRPC_GENERATED_VERSION = '1.84.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 
@@ -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-3.0.0 → coordinode-4.0.1}/coordinode/_proto/coordinode/v1/common/pagination_pb2_grpc.py

@@ -4,7 +4,7 @@ import grpc
 import warnings
 
 
-GRPC_GENERATED_VERSION = '1.83.1'
+GRPC_GENERATED_VERSION = '1.84.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

coordinode-4.0.1/coordinode/_proto/coordinode/v1/common/types_pb2.py

@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: coordinode/v1/common/types.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/common/types.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n coordinode/v1/common/types.proto\x12\x14\x63oordinode.v1.common\"\x14\n\x06NodeId\x12\n\n\x02id\x18\x01 \x01(\x04\"\x14\n\x06\x45\x64geId\x12\n\n\x02id\x18\x01 \x01(\x04\" \n\tTimestamp\x12\x13\n\x0bunix_micros\x18\x01 \x01(\x03\"\xe0\x03\n\rPropertyValue\x12\x13\n\tint_value\x18\x01 \x01(\x03H\x00\x12\x15\n\x0b\x66loat_value\x18\x02 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x03 \x01(\tH\x00\x12\x14\n\nbool_value\x18\x04 \x01(\x08H\x00\x12\x15\n\x0b\x62ytes_value\x18\x05 \x01(\x0cH\x00\x12:\n\x0ftimestamp_value\x18\x06 \x01(\x0b\x32\x1f.coordinode.v1.common.TimestampH\x00\x12\x34\n\x0cvector_value\x18\x07 \x01(\x0b\x32\x1c.coordinode.v1.common.VectorH\x00\x12\x38\n\nlist_value\x18\x08 \x01(\x0b\x32\".coordinode.v1.common.PropertyListH\x00\x12\x36\n\tmap_value\x18\t \x01(\x0b\x32!.coordinode.v1.common.PropertyMapH\x00\x12?\n\x12multi_vector_value\x18\n \x01(\x0b\x32!.coordinode.v1.common.MultiVectorH\x00\x12\x30\n\npath_value\x18\x0b \x01(\x0b\x32\x1a.coordinode.v1.common.PathH\x00\x42\x07\n\x05value\"\x18\n\x06Vector\x12\x0e\n\x06values\x18\x01 \x03(\x02\"C\n\x0cPropertyList\x12\x33\n\x06values\x18\x01 \x03(\x0b\x32#.coordinode.v1.common.PropertyValue\"\xa3\x01\n\x0bPropertyMap\x12?\n\x07\x65ntries\x18\x01 \x03(\x0b\x32..coordinode.v1.common.PropertyMap.EntriesEntry\x1aS\n\x0c\x45ntriesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x32\n\x05value\x18\x02 \x01(\x0b\x32#.coordinode.v1.common.PropertyValue:\x02\x38\x01\"9\n\x0bMultiVector\x12*\n\x04rows\x18\x01 \x03(\x0b\x32\x1c.coordinode.v1.common.Vector\"B\n\x04Path\x12\r\n\x05nodes\x18\x01 \x03(\x04\x12+\n\x04rels\x18\x02 \x03(\x0b\x32\x1d.coordinode.v1.common.PathRel\"<\n\x07PathRel\x12\x11\n\tedge_type\x18\x01 \x01(\t\x12\x0e\n\x06source\x18\x02 \x01(\x04\x12\x0e\n\x06target\x18\x03 \x01(\x04\x62\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'coordinode.v1.common.types_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_PROPERTYMAP_ENTRIESENTRY']._loaded_options = None
+  _globals['_PROPERTYMAP_ENTRIESENTRY']._serialized_options = b'8\001'
+  _globals['_NODEID']._serialized_start=58
+  _globals['_NODEID']._serialized_end=78
+  _globals['_EDGEID']._serialized_start=80
+  _globals['_EDGEID']._serialized_end=100
+  _globals['_TIMESTAMP']._serialized_start=102
+  _globals['_TIMESTAMP']._serialized_end=134
+  _globals['_PROPERTYVALUE']._serialized_start=137
+  _globals['_PROPERTYVALUE']._serialized_end=617
+  _globals['_VECTOR']._serialized_start=619
+  _globals['_VECTOR']._serialized_end=643
+  _globals['_PROPERTYLIST']._serialized_start=645
+  _globals['_PROPERTYLIST']._serialized_end=712
+  _globals['_PROPERTYMAP']._serialized_start=715
+  _globals['_PROPERTYMAP']._serialized_end=878
+  _globals['_PROPERTYMAP_ENTRIESENTRY']._serialized_start=795
+  _globals['_PROPERTYMAP_ENTRIESENTRY']._serialized_end=878
+  _globals['_MULTIVECTOR']._serialized_start=880
+  _globals['_MULTIVECTOR']._serialized_end=937
+  _globals['_PATH']._serialized_start=939
+  _globals['_PATH']._serialized_end=1005
+  _globals['_PATHREL']._serialized_start=1007
+  _globals['_PATHREL']._serialized_end=1067
+# @@protoc_insertion_point(module_scope)

{coordinode-3.0.0 → coordinode-4.0.1}/coordinode/_proto/coordinode/v1/common/types_pb2.pyi

@@ -18,13 +18,11 @@ class EdgeId(_message.Message):
     id: int
     def __init__(self, id: _Optional[int] = ...) -> None: ...
 
-class HlcTimestamp(_message.Message):
-    __slots__ = ("wall_time", "logical")
-    WALL_TIME_FIELD_NUMBER: _ClassVar[int]
-    LOGICAL_FIELD_NUMBER: _ClassVar[int]
-    wall_time: int
-    logical: int
-    def __init__(self, wall_time: _Optional[int] = ..., logical: _Optional[int] = ...) -> None: ...
+class Timestamp(_message.Message):
+    __slots__ = ("unix_micros",)
+    UNIX_MICROS_FIELD_NUMBER: _ClassVar[int]
+    unix_micros: int
+    def __init__(self, unix_micros: _Optional[int] = ...) -> None: ...
 
 class PropertyValue(_message.Message):
     __slots__ = ("int_value", "float_value", "string_value", "bool_value", "bytes_value", "timestamp_value", "vector_value", "list_value", "map_value", "multi_vector_value", "path_value")
@@ -44,13 +42,13 @@ class PropertyValue(_message.Message):
     string_value: str
     bool_value: bool
     bytes_value: bytes
-    timestamp_value: HlcTimestamp
+    timestamp_value: Timestamp
     vector_value: Vector
     list_value: PropertyList
     map_value: PropertyMap
     multi_vector_value: MultiVector
     path_value: Path
-    def __init__(self, int_value: _Optional[int] = ..., float_value: _Optional[float] = ..., string_value: _Optional[str] = ..., bool_value: _Optional[bool] = ..., bytes_value: _Optional[bytes] = ..., timestamp_value: _Optional[_Union[HlcTimestamp, _Mapping]] = ..., vector_value: _Optional[_Union[Vector, _Mapping]] = ..., list_value: _Optional[_Union[PropertyList, _Mapping]] = ..., map_value: _Optional[_Union[PropertyMap, _Mapping]] = ..., multi_vector_value: _Optional[_Union[MultiVector, _Mapping]] = ..., path_value: _Optional[_Union[Path, _Mapping]] = ...) -> None: ...
+    def __init__(self, int_value: _Optional[int] = ..., float_value: _Optional[float] = ..., string_value: _Optional[str] = ..., bool_value: _Optional[bool] = ..., bytes_value: _Optional[bytes] = ..., timestamp_value: _Optional[_Union[Timestamp, _Mapping]] = ..., vector_value: _Optional[_Union[Vector, _Mapping]] = ..., list_value: _Optional[_Union[PropertyList, _Mapping]] = ..., map_value: _Optional[_Union[PropertyMap, _Mapping]] = ..., multi_vector_value: _Optional[_Union[MultiVector, _Mapping]] = ..., path_value: _Optional[_Union[Path, _Mapping]] = ...) -> None: ...
 
 class Vector(_message.Message):
     __slots__ = ("values",)

{coordinode-3.0.0 → coordinode-4.0.1}/coordinode/_proto/coordinode/v1/common/types_pb2_grpc.py

@@ -4,7 +4,7 @@ import grpc
 import warnings
 
 
-GRPC_GENERATED_VERSION = '1.83.1'
+GRPC_GENERATED_VERSION = '1.84.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

{coordinode-3.0.0 → coordinode-4.0.1}/coordinode/_proto/coordinode/v1/graph/blob_pb2_grpc.py

@@ -5,7 +5,7 @@ import warnings
 
 from coordinode._proto.coordinode.v1.graph import blob_pb2 as coordinode_dot_v1_dot_graph_dot_blob__pb2
 
-GRPC_GENERATED_VERSION = '1.83.1'
+GRPC_GENERATED_VERSION = '1.84.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

{coordinode-3.0.0 → coordinode-4.0.1}/coordinode/_proto/coordinode/v1/graph/graph_pb2_grpc.py

@@ -5,7 +5,7 @@ import warnings
 
 from coordinode._proto.coordinode.v1.graph import graph_pb2 as coordinode_dot_v1_dot_graph_dot_graph__pb2
 
-GRPC_GENERATED_VERSION = '1.83.1'
+GRPC_GENERATED_VERSION = '1.84.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

{coordinode-3.0.0 → coordinode-4.0.1}/coordinode/_proto/coordinode/v1/health/health_pb2_grpc.py

@@ -5,7 +5,7 @@ import warnings
 
 from coordinode._proto.coordinode.v1.health import health_pb2 as coordinode_dot_v1_dot_health_dot_health__pb2
 
-GRPC_GENERATED_VERSION = '1.83.1'
+GRPC_GENERATED_VERSION = '1.84.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False