fix(llama-index): escape node label in upsert_nodes with _cypher_ident

fix(llama-index): align delete() to use n.id (string) not id(n) (int graph ID)

fix(client): add debug logging on gRPC health check failure

docs(release): document single shared version intent in release-please-config.json

Author: polaz

coordinode/client.py

@@ -5,6 +5,7 @@
 from __future__ import annotations
 
 import asyncio
+import logging
 from collections.abc import Sequence
 from typing import Any
 
@@ -19,6 +20,8 @@
     props_to_dict,
 )
 
+logger = logging.getLogger(__name__)
+
 # ── Low-level helpers ────────────────────────────────────────────────────────
 
 
@@ -295,7 +298,12 @@ async def health(self) -> bool:
         try:
             resp = await self._health_stub.Check(HealthCheckRequest(), timeout=5.0)
             return resp.status == ServingStatus.SERVING_STATUS_SERVING
-        except grpc.RpcError:
+        except grpc.RpcError as e:
+            logger.debug(
+                "health check failed: %s %s",
+                e.code(),  # type: ignore[union-attr]
+                e.details(),  # type: ignore[union-attr]
+            )
             return False
 
 

llama-index-coordinode/llama_index/graph_stores/coordinode/base.py

@@ -183,7 +183,7 @@ def upsert_nodes(self, nodes: list[LabelledNode]) -> None:
         """Upsert nodes into the graph."""
         for node in nodes:
             props = _labelled_to_props(node)
-            label = _node_label(node)
+            label = _cypher_ident(_node_label(node))
             cypher = f"MERGE (n:{label} {{id: $id}}) SET n += $props"
             self._client.cypher(cypher, params={"id": node.id, "props": props})
 
@@ -215,7 +215,8 @@ def delete(
         if relation_names or properties:
             raise NotImplementedError("delete() does not yet support filtering by relation_names or properties")
         if ids:
-            cypher = "MATCH (n) WHERE id(n) IN $ids DETACH DELETE n"
+            # Use n.id (string adapter ID) for consistency with get()
+            cypher = "MATCH (n) WHERE n.id IN $ids DETACH DELETE n"
             self._client.cypher(cypher, params={"ids": ids})
         elif entity_names:
             cypher = "MATCH (n) WHERE n.name IN $names DETACH DELETE n"

release-please-config.json

@@ -5,6 +5,7 @@
   "include-component-in-tag": false,
   "packages": {
     ".": {
+      "_comment": "Single shared version for all three workspace packages (coordinode, langchain-coordinode, llama-index-graph-stores-coordinode). release.yml builds and publishes all three from one tag.",
       "component": "sdk",
       "changelog-path": "CHANGELOG.md"
     }