cortexdb-client 0.2.0__tar.gz → 0.4.0__tar.gz

cortexdb_client-0.4.0/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.5
+Name: cortexdb-client
+Version: 0.4.0
+Summary: Typed gRPC client for CortexDB (AI memory + knowledge graph sidecar)
+Project-URL: Homepage, https://github.com/liliang-cn/cortexdb
+Project-URL: Repository, https://github.com/liliang-cn/cortexdb
+Author: Liang Li
+License: MIT
+Keywords: agent-memory,ai,cortexdb,grpc,knowledge-graph,rag
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Requires-Dist: grpcio>=1.60
+Requires-Dist: protobuf>=4.25
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: grpcio-tools>=1.60; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Provides-Extra: pandas
+Requires-Dist: pandas>=1.5; extra == 'pandas'
+Description-Content-Type: text/markdown
+
+# cortexdb-client (Python)
+
+Typed gRPC client for [CortexDB](https://github.com/liliang-cn/cortexdb) — a
+pure-Go, single-file AI memory and knowledge graph database, served as a
+sidecar (`cortexdb-grpc`). Give your Python agent (e.g. **Hermes**) durable
+memory **and** a queryable knowledge graph.
+
+## Install
+
+```bash
+pip install cortexdb-client          # or: uv add cortexdb-client
+```
+
+Start the sidecar (one binary, one SQLite file):
+
+```bash
+go install github.com/liliang-cn/cortexdb/v2/cmd/cortexdb-grpc@latest
+CORTEXDB_PATH=agent.db CORTEXDB_GRPC_TOKEN=s3cret cortexdb-grpc
+# listening on 127.0.0.1:47821
+```
+
+## Quick start
+
+```python
+from cortexdb_client import CortexClient, proto
+
+with CortexClient.connect("127.0.0.1:47821", token="s3cret") as client:
+    client.knowledge.SaveKnowledge(proto.SaveKnowledgeRequest(
+        knowledge_id="note-1",
+        content="The user is building an autonomous research agent in Python.",
+    ))
+    hits = client.knowledge.SearchKnowledge(proto.SearchKnowledgeRequest(
+        query="what is the user building?", top_k=3,
+    ))
+    for h in hits.results:
+        print(h.knowledge_id, h.score, h.snippet)
+```
+
+Sub-clients mirror the Rust crate: `client.knowledge`, `client.memory`,
+`client.graph` (SPARQL/RDF/SHACL/inference/ontology), `client.graphrag`,
+`client.tools` (generic tool dispatch, same surface as MCP), `client.admin`.
+
+## Results as DataFrames or CSV
+
+`client.tools.CallTool` answers with JSON. `cortexdb_client.tabular` turns the
+row-shaped part of it into flat records, a pandas DataFrame or a CSV file:
+
+```python
+import json
+from cortexdb_client import CortexClient, proto, tabular
+
+with CortexClient.connect("127.0.0.1:47821", token="s3cret") as client:
+    res = client.tools.CallTool(proto.CallToolRequest(
+        name="graph_cypher_query",
+        args_json=json.dumps({"query": "MATCH (a)-[r]->(b) RETURN a, r, b LIMIT 100"}),
+    ))
+
+rows = tabular.records(res)       # list of flat dicts: {"a.id": ..., "r.type": ..., "b.id": ...}
+df = tabular.to_pandas(res)       # needs the extra: pip install "cortexdb-client[pandas]"
+tabular.to_csv(res, "edges.csv")  # standard library only; to_csv(res) returns the text
+```
+
+pandas is optional and imported only inside `to_pandas()`; the base install
+stays `grpcio` + `protobuf`.
+
+| Tool | Table(s) |
+| --- | --- |
+| `graph_cypher_query` | `rows` (default) — `columns` zipped with each row |
+| `aggregate_metadata` | `results` (default) — one row per group |
+| `memory_search`, `knowledge_search` | `results` (default); `knowledge_search` may also carry `chunks` |
+| `knowledge_memory_recall` | `memories`, `knowledge`, `chunks`, `graph_facts` — pass `table=` |
+| `memory_list_all` | `memories` (default) |
+| `graph_list_all` | `nodes`, `edges` — pass `table=` |
+| `search_text`, `recall_log_list`, `graph_property_values`, … | the one top-level list of objects (`chunks`, `recalls`, `values`) |
+
+`tabular.tables(res)` names the tables a result has. A result with more than one
+and no `rows` / `results` raises `ValueError` until you pick:
+`tabular.records(res, "edges")`.
+
+How a row becomes columns:
+
+- a scalar is a column under its key;
+- a nested object becomes one column per leaf, keys joined with `.`
+  (`metadata.project`, `n.properties.city`); `sep="__"` changes the separator;
+- a list becomes its JSON text, or stays a list with `lists="keep"`
+  (for `DataFrame.explode`);
+- the `keys` of an aggregate group and the `memory` of a memory hit are lifted,
+  so their fields lead the row unprefixed (`team`, `year`, `value`, `count`;
+  `id`, `content`, …, `score`). A lifted name that collides keeps its prefix
+  (`keys.count`). Every other key of a group is a column whatever it is called,
+  so new measures need no client change;
+- rows need not share columns: CSV leaves the cell empty, pandas gives `NaN`.
+
+Listings page with a cursor; collect the pages, then tabulate:
+
+```python
+memories, cursor = [], ""
+while True:
+    page = json.loads(client.tools.CallTool(proto.CallToolRequest(
+        name="memory_list_all", args_json=json.dumps({"cursor": cursor}))).result_json)
+    memories += tabular.records(page)
+    cursor = page.get("next_cursor", "")
+    if not cursor:
+        break
+```
+
+To analyse the SQLite file itself with DuckDB, pandas or `sqlite3`, see
+"Data analysis" in the [guide](https://github.com/liliang-cn/cortexdb/blob/main/docs/GUIDE.md).
+
+## Why a knowledge graph, not just vectors
+
+Beyond semantic recall, the `graph` service lets an agent store and traverse
+**entities and relations** — multi-hop questions like "who, among the people
+Alice knows, works on X" — with SPARQL, RDFS-lite inference, and SHACL-lite
+validation. That is the capability most agent-memory layers lack.
+
+## Embeddings
+
+Lexical mode needs no keys. Point the sidecar at any OpenAI-compatible
+embeddings endpoint (e.g. Ollama) to enable vector retrieval:
+
+```bash
+OPENAI_BASE_URL=http://localhost:11434/v1 \
+CORTEXDB_EMBED_MODEL=embeddinggemma CORTEXDB_EMBED_DIM=768 \
+cortexdb-grpc
+```
+
+## Regenerating the protobuf code
+
+Generated code is committed under `cortexdb_client/_pb`. To regenerate after a
+proto change: `uv run --extra dev ./gen.sh`.

cortexdb_client-0.4.0/README.md

@@ -0,0 +1,131 @@
+# cortexdb-client (Python)
+
+Typed gRPC client for [CortexDB](https://github.com/liliang-cn/cortexdb) — a
+pure-Go, single-file AI memory and knowledge graph database, served as a
+sidecar (`cortexdb-grpc`). Give your Python agent (e.g. **Hermes**) durable
+memory **and** a queryable knowledge graph.
+
+## Install
+
+```bash
+pip install cortexdb-client          # or: uv add cortexdb-client
+```
+
+Start the sidecar (one binary, one SQLite file):
+
+```bash
+go install github.com/liliang-cn/cortexdb/v2/cmd/cortexdb-grpc@latest
+CORTEXDB_PATH=agent.db CORTEXDB_GRPC_TOKEN=s3cret cortexdb-grpc
+# listening on 127.0.0.1:47821
+```
+
+## Quick start
+
+```python
+from cortexdb_client import CortexClient, proto
+
+with CortexClient.connect("127.0.0.1:47821", token="s3cret") as client:
+    client.knowledge.SaveKnowledge(proto.SaveKnowledgeRequest(
+        knowledge_id="note-1",
+        content="The user is building an autonomous research agent in Python.",
+    ))
+    hits = client.knowledge.SearchKnowledge(proto.SearchKnowledgeRequest(
+        query="what is the user building?", top_k=3,
+    ))
+    for h in hits.results:
+        print(h.knowledge_id, h.score, h.snippet)
+```
+
+Sub-clients mirror the Rust crate: `client.knowledge`, `client.memory`,
+`client.graph` (SPARQL/RDF/SHACL/inference/ontology), `client.graphrag`,
+`client.tools` (generic tool dispatch, same surface as MCP), `client.admin`.
+
+## Results as DataFrames or CSV
+
+`client.tools.CallTool` answers with JSON. `cortexdb_client.tabular` turns the
+row-shaped part of it into flat records, a pandas DataFrame or a CSV file:
+
+```python
+import json
+from cortexdb_client import CortexClient, proto, tabular
+
+with CortexClient.connect("127.0.0.1:47821", token="s3cret") as client:
+    res = client.tools.CallTool(proto.CallToolRequest(
+        name="graph_cypher_query",
+        args_json=json.dumps({"query": "MATCH (a)-[r]->(b) RETURN a, r, b LIMIT 100"}),
+    ))
+
+rows = tabular.records(res)       # list of flat dicts: {"a.id": ..., "r.type": ..., "b.id": ...}
+df = tabular.to_pandas(res)       # needs the extra: pip install "cortexdb-client[pandas]"
+tabular.to_csv(res, "edges.csv")  # standard library only; to_csv(res) returns the text
+```
+
+pandas is optional and imported only inside `to_pandas()`; the base install
+stays `grpcio` + `protobuf`.
+
+| Tool | Table(s) |
+| --- | --- |
+| `graph_cypher_query` | `rows` (default) — `columns` zipped with each row |
+| `aggregate_metadata` | `results` (default) — one row per group |
+| `memory_search`, `knowledge_search` | `results` (default); `knowledge_search` may also carry `chunks` |
+| `knowledge_memory_recall` | `memories`, `knowledge`, `chunks`, `graph_facts` — pass `table=` |
+| `memory_list_all` | `memories` (default) |
+| `graph_list_all` | `nodes`, `edges` — pass `table=` |
+| `search_text`, `recall_log_list`, `graph_property_values`, … | the one top-level list of objects (`chunks`, `recalls`, `values`) |
+
+`tabular.tables(res)` names the tables a result has. A result with more than one
+and no `rows` / `results` raises `ValueError` until you pick:
+`tabular.records(res, "edges")`.
+
+How a row becomes columns:
+
+- a scalar is a column under its key;
+- a nested object becomes one column per leaf, keys joined with `.`
+  (`metadata.project`, `n.properties.city`); `sep="__"` changes the separator;
+- a list becomes its JSON text, or stays a list with `lists="keep"`
+  (for `DataFrame.explode`);
+- the `keys` of an aggregate group and the `memory` of a memory hit are lifted,
+  so their fields lead the row unprefixed (`team`, `year`, `value`, `count`;
+  `id`, `content`, …, `score`). A lifted name that collides keeps its prefix
+  (`keys.count`). Every other key of a group is a column whatever it is called,
+  so new measures need no client change;
+- rows need not share columns: CSV leaves the cell empty, pandas gives `NaN`.
+
+Listings page with a cursor; collect the pages, then tabulate:
+
+```python
+memories, cursor = [], ""
+while True:
+    page = json.loads(client.tools.CallTool(proto.CallToolRequest(
+        name="memory_list_all", args_json=json.dumps({"cursor": cursor}))).result_json)
+    memories += tabular.records(page)
+    cursor = page.get("next_cursor", "")
+    if not cursor:
+        break
+```
+
+To analyse the SQLite file itself with DuckDB, pandas or `sqlite3`, see
+"Data analysis" in the [guide](https://github.com/liliang-cn/cortexdb/blob/main/docs/GUIDE.md).
+
+## Why a knowledge graph, not just vectors
+
+Beyond semantic recall, the `graph` service lets an agent store and traverse
+**entities and relations** — multi-hop questions like "who, among the people
+Alice knows, works on X" — with SPARQL, RDFS-lite inference, and SHACL-lite
+validation. That is the capability most agent-memory layers lack.
+
+## Embeddings
+
+Lexical mode needs no keys. Point the sidecar at any OpenAI-compatible
+embeddings endpoint (e.g. Ollama) to enable vector retrieval:
+
+```bash
+OPENAI_BASE_URL=http://localhost:11434/v1 \
+CORTEXDB_EMBED_MODEL=embeddinggemma CORTEXDB_EMBED_DIM=768 \
+cortexdb-grpc
+```
+
+## Regenerating the protobuf code
+
+Generated code is committed under `cortexdb_client/_pb`. To regenerate after a
+proto change: `uv run --extra dev ./gen.sh`.

{cortexdb_client-0.2.0 → cortexdb_client-0.4.0}/cortexdb_client/__init__.py

@@ -16,10 +16,14 @@ Example::
 The sub-client accessors mirror the Rust crate: ``client.knowledge``,
 ``client.memory``, ``client.graph``, ``client.graphrag``, ``client.tools``,
 ``client.admin``.
+
+``cortexdb_client.tabular`` turns a tool result into flat records, a pandas
+DataFrame or CSV.
 """
 
 from .client import CortexClient
 from . import proto
+from . import tabular
 
-__all__ = ["CortexClient", "proto"]
+__all__ = ["CortexClient", "proto", "tabular"]
 __version__ = "0.1.0"

{cortexdb_client-0.2.0 → cortexdb_client-0.4.0}/cortexdb_client/_pb/cortexdb/v1/admin_pb2.py

@@ -24,7 +24,7 @@ _sym_db = _symbol_database.Default()
 
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x17\x63ortexdb/v1/admin.proto\x12\x0b\x63ortexdb.v1\"\x0f\n\rHealthRequest\"\x1c\n\x0eHealthResponse\x12\n\n\x02ok\x18\x01 \x01(\x08\"\r\n\x0bInfoRequest\"F\n\x0cInfoResponse\x12\x0f\n\x07version\x18\x01 \x01(\t\x12\x0f\n\x07\x64\x62_path\x18\x02 \x01(\t\x12\x14\n\x0chas_embedder\x18\x03 \x01(\x08\x32\x8e\x01\n\x0c\x41\x64minService\x12\x41\n\x06Health\x12\x1a.cortexdb.v1.HealthRequest\x1a\x1b.cortexdb.v1.HealthResponse\x12;\n\x04Info\x12\x18.cortexdb.v1.InfoRequest\x1a\x19.cortexdb.v1.InfoResponseB4Z2github.com/liliang-cn/cortexdb/v2/pkg/rpc/v1;rpcv1b\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x17\x63ortexdb/v1/admin.proto\x12\x0b\x63ortexdb.v1\"\x0f\n\rHealthRequest\"\x1c\n\x0eHealthResponse\x12\n\n\x02ok\x18\x01 \x01(\x08\"\r\n\x0bInfoRequest\"\x99\x01\n\x0cInfoResponse\x12\x0f\n\x07version\x18\x01 \x01(\t\x12\x0f\n\x07\x64\x62_path\x18\x02 \x01(\t\x12\x14\n\x0chas_embedder\x18\x03 \x01(\x08\x12\x18\n\x10\x65mbedder_healthy\x18\x04 \x01(\x08\x12\x16\n\x0e\x65mbedder_error\x18\x05 \x01(\t\x12\x1f\n\x17memories_without_vector\x18\x06 \x01(\x03\"\x1d\n\rBackupRequest\x12\x0c\n\x04path\x18\x01 \x01(\t\"2\n\x0e\x42\x61\x63kupResponse\x12\x0c\n\x04path\x18\x01 \x01(\t\x12\x12\n\nsize_bytes\x18\x02 \x01(\x03\x32\xd1\x01\n\x0c\x41\x64minService\x12\x41\n\x06Health\x12\x1a.cortexdb.v1.HealthRequest\x1a\x1b.cortexdb.v1.HealthResponse\x12;\n\x04Info\x12\x18.cortexdb.v1.InfoRequest\x1a\x19.cortexdb.v1.InfoResponse\x12\x41\n\x06\x42\x61\x63kup\x12\x1a.cortexdb.v1.BackupRequest\x1a\x1b.cortexdb.v1.BackupResponseB4Z2github.com/liliang-cn/cortexdb/v2/pkg/rpc/v1;rpcv1b\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -38,8 +38,12 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_HEALTHRESPONSE']._serialized_end=85
   _globals['_INFOREQUEST']._serialized_start=87
   _globals['_INFOREQUEST']._serialized_end=100
-  _globals['_INFORESPONSE']._serialized_start=102
-  _globals['_INFORESPONSE']._serialized_end=172
-  _globals['_ADMINSERVICE']._serialized_start=175
-  _globals['_ADMINSERVICE']._serialized_end=317
+  _globals['_INFORESPONSE']._serialized_start=103
+  _globals['_INFORESPONSE']._serialized_end=256
+  _globals['_BACKUPREQUEST']._serialized_start=258
+  _globals['_BACKUPREQUEST']._serialized_end=287
+  _globals['_BACKUPRESPONSE']._serialized_start=289
+  _globals['_BACKUPRESPONSE']._serialized_end=339
+  _globals['_ADMINSERVICE']._serialized_start=342
+  _globals['_ADMINSERVICE']._serialized_end=551
 # @@protoc_insertion_point(module_scope)

{cortexdb_client-0.2.0 → cortexdb_client-0.4.0}/cortexdb_client/_pb/cortexdb/v1/admin_pb2_grpc.py

@@ -44,6 +44,11 @@ class AdminServiceStub:
                 request_serializer=cortexdb_dot_v1_dot_admin__pb2.InfoRequest.SerializeToString,
                 response_deserializer=cortexdb_dot_v1_dot_admin__pb2.InfoResponse.FromString,
                 _registered_method=True)
+        self.Backup = channel.unary_unary(
+                '/cortexdb.v1.AdminService/Backup',
+                request_serializer=cortexdb_dot_v1_dot_admin__pb2.BackupRequest.SerializeToString,
+                response_deserializer=cortexdb_dot_v1_dot_admin__pb2.BackupResponse.FromString,
+                _registered_method=True)
 
 
 class AdminServiceServicer:
@@ -61,6 +66,14 @@ class AdminServiceServicer:
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def Backup(self, request, context):
+        """Backup snapshots the whole brain without stopping the server. Backends that
+        are backed up by their own tooling (PostgreSQL) fail it with UNIMPLEMENTED.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
 
 def add_AdminServiceServicer_to_server(servicer, server):
     rpc_method_handlers = {
@@ -74,6 +87,11 @@ def add_AdminServiceServicer_to_server(servicer, server):
                     request_deserializer=cortexdb_dot_v1_dot_admin__pb2.InfoRequest.FromString,
                     response_serializer=cortexdb_dot_v1_dot_admin__pb2.InfoResponse.SerializeToString,
             ),
+            'Backup': grpc.unary_unary_rpc_method_handler(
+                    servicer.Backup,
+                    request_deserializer=cortexdb_dot_v1_dot_admin__pb2.BackupRequest.FromString,
+                    response_serializer=cortexdb_dot_v1_dot_admin__pb2.BackupResponse.SerializeToString,
+            ),
     }
     generic_handler = grpc.method_handlers_generic_handler(
             'cortexdb.v1.AdminService', rpc_method_handlers)
@@ -138,3 +156,30 @@ class AdminService:
             timeout,
             metadata,
             _registered_method=True)
+
+    @staticmethod
+    def Backup(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,
+            '/cortexdb.v1.AdminService/Backup',
+            cortexdb_dot_v1_dot_admin__pb2.BackupRequest.SerializeToString,
+            cortexdb_dot_v1_dot_admin__pb2.BackupResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

cortexdb_client-0.4.0/cortexdb_client/_pb/cortexdb/v1/contract_pb2.py

@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: cortexdb/v1/contract.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,
+    '',
+    'cortexdb/v1/contract.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1a\x63ortexdb/v1/contract.proto\x12\x0b\x63ortexdb.v1\"*\n\nGradeCount\x12\r\n\x05nodes\x18\x01 \x01(\x03\x12\r\n\x05\x65\x64ges\x18\x02 \x01(\x03\"\x16\n\x14\x43ontractTallyRequest\"\xa6\x03\n\x15\x43ontractTallyResponse\x12)\n\x08verified\x18\x01 \x01(\x0b\x32\x17.cortexdb.v1.GradeCount\x12\x30\n\x0fself_consistent\x18\x02 \x01(\x0b\x32\x17.cortexdb.v1.GradeCount\x12)\n\x08\x61sserted\x18\x03 \x01(\x0b\x32\x17.cortexdb.v1.GradeCount\x12%\n\x04held\x18\x04 \x01(\x0b\x32\x17.cortexdb.v1.GradeCount\x12(\n\x07refused\x18\x05 \x01(\x0b\x32\x17.cortexdb.v1.GradeCount\x12)\n\x08untagged\x18\x06 \x01(\x0b\x32\x17.cortexdb.v1.GradeCount\x12@\n\x07unknown\x18\x07 \x03(\x0b\x32/.cortexdb.v1.ContractTallyResponse.UnknownEntry\x1aG\n\x0cUnknownEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.cortexdb.v1.GradeCount:\x02\x38\x01\"\xc6\x01\n\x0cGradedRecord\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0c\n\x04\x65\x64ge\x18\x02 \x01(\x08\x12\x0c\n\x04type\x18\x03 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x04 \x01(\t\x12\x0c\n\x04\x66rom\x18\x05 \x01(\t\x12\n\n\x02to\x18\x06 \x01(\t\x12\r\n\x05grade\x18\x07 \x01(\t\x12\r\n\x05state\x18\x08 \x01(\t\x12\x0b\n\x03why\x18\t \x01(\t\x12\x0e\n\x06source\x18\n \x01(\t\x12\x10\n\x08producer\x18\x0b \x01(\t\x12\n\n\x02\x61t\x18\x0c \x01(\t\x12\n\n\x02\x62y\x18\r \x01(\t\"&\n\x15NeedsAttentionRequest\x12\r\n\x05limit\x18\x01 \x01(\x05\"f\n\x16NeedsAttentionResponse\x12*\n\x07records\x18\x01 \x03(\x0b\x32\x19.cortexdb.v1.GradedRecord\x12\x11\n\ttruncated\x18\x02 \x01(\x08\x12\r\n\x05total\x18\x03 \x01(\x03\x32\xc4\x01\n\x0f\x43ontractService\x12V\n\rContractTally\x12!.cortexdb.v1.ContractTallyRequest\x1a\".cortexdb.v1.ContractTallyResponse\x12Y\n\x0eNeedsAttention\x12\".cortexdb.v1.NeedsAttentionRequest\x1a#.cortexdb.v1.NeedsAttentionResponseB4Z2github.com/liliang-cn/cortexdb/v2/pkg/rpc/v1;rpcv1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'cortexdb.v1.contract_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z2github.com/liliang-cn/cortexdb/v2/pkg/rpc/v1;rpcv1'
+  _globals['_CONTRACTTALLYRESPONSE_UNKNOWNENTRY']._loaded_options = None
+  _globals['_CONTRACTTALLYRESPONSE_UNKNOWNENTRY']._serialized_options = b'8\001'
+  _globals['_GRADECOUNT']._serialized_start=43
+  _globals['_GRADECOUNT']._serialized_end=85
+  _globals['_CONTRACTTALLYREQUEST']._serialized_start=87
+  _globals['_CONTRACTTALLYREQUEST']._serialized_end=109
+  _globals['_CONTRACTTALLYRESPONSE']._serialized_start=112
+  _globals['_CONTRACTTALLYRESPONSE']._serialized_end=534
+  _globals['_CONTRACTTALLYRESPONSE_UNKNOWNENTRY']._serialized_start=463
+  _globals['_CONTRACTTALLYRESPONSE_UNKNOWNENTRY']._serialized_end=534
+  _globals['_GRADEDRECORD']._serialized_start=537
+  _globals['_GRADEDRECORD']._serialized_end=735
+  _globals['_NEEDSATTENTIONREQUEST']._serialized_start=737
+  _globals['_NEEDSATTENTIONREQUEST']._serialized_end=775
+  _globals['_NEEDSATTENTIONRESPONSE']._serialized_start=777
+  _globals['_NEEDSATTENTIONRESPONSE']._serialized_end=879
+  _globals['_CONTRACTSERVICE']._serialized_start=882
+  _globals['_CONTRACTSERVICE']._serialized_end=1078
+# @@protoc_insertion_point(module_scope)

cortexdb_client-0.4.0/cortexdb_client/_pb/cortexdb/v1/contract_pb2_grpc.py

@@ -0,0 +1,157 @@
+# 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 cortexdb_client._pb.cortexdb.v1 import contract_pb2 as cortexdb_dot_v1_dot_contract__pb2
+
+GRPC_GENERATED_VERSION = '1.81.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 cortexdb/v1/contract_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 ContractServiceStub:
+    """ContractService reads the knowledge contract. Read-only by construction:
+    what goes on the shelf is written through the stores' own RPCs, and a
+    producer that could stamp a grade without writing the record would be a way
+    to make the tally disagree with the shelf.
+    """
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.ContractTally = channel.unary_unary(
+                '/cortexdb.v1.ContractService/ContractTally',
+                request_serializer=cortexdb_dot_v1_dot_contract__pb2.ContractTallyRequest.SerializeToString,
+                response_deserializer=cortexdb_dot_v1_dot_contract__pb2.ContractTallyResponse.FromString,
+                _registered_method=True)
+        self.NeedsAttention = channel.unary_unary(
+                '/cortexdb.v1.ContractService/NeedsAttention',
+                request_serializer=cortexdb_dot_v1_dot_contract__pb2.NeedsAttentionRequest.SerializeToString,
+                response_deserializer=cortexdb_dot_v1_dot_contract__pb2.NeedsAttentionResponse.FromString,
+                _registered_method=True)
+
+
+class ContractServiceServicer:
+    """ContractService reads the knowledge contract. Read-only by construction:
+    what goes on the shelf is written through the stores' own RPCs, and a
+    producer that could stamp a grade without writing the record would be a way
+    to make the tally disagree with the shelf.
+    """
+
+    def ContractTally(self, request, context):
+        """ContractTally counts every node and edge by its grade.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def NeedsAttention(self, request, context):
+        """NeedsAttention lists what a person has to deal with. It is a named call
+        rather than a filter language because it is the one question the contract
+        exists to make answerable, and because held and refused belong in one list
+        — split into two calls, it is likely only one gets rendered.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_ContractServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'ContractTally': grpc.unary_unary_rpc_method_handler(
+                    servicer.ContractTally,
+                    request_deserializer=cortexdb_dot_v1_dot_contract__pb2.ContractTallyRequest.FromString,
+                    response_serializer=cortexdb_dot_v1_dot_contract__pb2.ContractTallyResponse.SerializeToString,
+            ),
+            'NeedsAttention': grpc.unary_unary_rpc_method_handler(
+                    servicer.NeedsAttention,
+                    request_deserializer=cortexdb_dot_v1_dot_contract__pb2.NeedsAttentionRequest.FromString,
+                    response_serializer=cortexdb_dot_v1_dot_contract__pb2.NeedsAttentionResponse.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'cortexdb.v1.ContractService', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers('cortexdb.v1.ContractService', rpc_method_handlers)
+
+
+ # This class is part of an EXPERIMENTAL API.
+class ContractService:
+    """ContractService reads the knowledge contract. Read-only by construction:
+    what goes on the shelf is written through the stores' own RPCs, and a
+    producer that could stamp a grade without writing the record would be a way
+    to make the tally disagree with the shelf.
+    """
+
+    @staticmethod
+    def ContractTally(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,
+            '/cortexdb.v1.ContractService/ContractTally',
+            cortexdb_dot_v1_dot_contract__pb2.ContractTallyRequest.SerializeToString,
+            cortexdb_dot_v1_dot_contract__pb2.ContractTallyResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def NeedsAttention(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,
+            '/cortexdb.v1.ContractService/NeedsAttention',
+            cortexdb_dot_v1_dot_contract__pb2.NeedsAttentionRequest.SerializeToString,
+            cortexdb_dot_v1_dot_contract__pb2.NeedsAttentionResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

cortexdb_client-0.4.0/cortexdb_client/_pb/cortexdb/v1/decision_pb2.py

@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: cortexdb/v1/decision.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,
+    '',
+    'cortexdb/v1/decision.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1a\x63ortexdb/v1/decision.proto\x12\x0b\x63ortexdb.v1\"\xa6\x01\n\x0f\x44\x65\x63isionPremise\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0c\n\x04\x65\x64ge\x18\x02 \x01(\x08\x12\x0c\n\x04type\x18\x03 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x04 \x01(\t\x12\x0c\n\x04\x66rom\x18\x05 \x01(\t\x12\n\n\x02to\x18\x06 \x01(\t\x12\x10\n\x08\x64\x65\x63ision\x18\x07 \x01(\x08\x12\r\n\x05grade\x18\x08 \x01(\t\x12\x0e\n\x06source\x18\t \x01(\t\x12\x0f\n\x07missing\x18\n \x01(\x08\"\x80\x02\n\x08\x44\x65\x63ision\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0c\n\x04kind\x18\x02 \x01(\t\x12\r\n\x05\x61\x63tor\x18\x03 \x01(\t\x12\n\n\x02\x61t\x18\x04 \x01(\t\x12\x0f\n\x07verdict\x18\x05 \x01(\t\x12\x0f\n\x07subject\x18\x06 \x01(\t\x12\x0c\n\x04note\x18\x07 \x01(\t\x12\r\n\x05grade\x18\x08 \x01(\t\x12\x0e\n\x06source\x18\t \x01(\t\x12\x10\n\x08producer\x18\n \x01(\t\x12\r\n\x05state\x18\x0b \x01(\t\x12\x0b\n\x03why\x18\x0c \x01(\t\x12.\n\x08premises\x18\r \x03(\x0b\x32\x1c.cortexdb.v1.DecisionPremise\x12\x12\n\nsupersedes\x18\x0e \x03(\t\"\xef\x01\n\x15RecordDecisionRequest\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0c\n\x04kind\x18\x02 \x01(\t\x12\r\n\x05\x61\x63tor\x18\x03 \x01(\t\x12\x0c\n\x04note\x18\x04 \x01(\t\x12\x0f\n\x07verdict\x18\x05 \x01(\t\x12\x0f\n\x07subject\x18\x06 \x01(\t\x12\x10\n\x08premises\x18\x07 \x03(\t\x12\x12\n\nsupersedes\x18\x08 \x01(\t\x12\n\n\x02\x61t\x18\t \x01(\t\x12\x0e\n\x06source\x18\n \x01(\t\x12\x10\n\x08producer\x18\x0b \x01(\t\x12\r\n\x05grade\x18\x0c \x01(\t\x12\r\n\x05state\x18\r \x01(\t\x12\x0b\n\x03why\x18\x0e \x01(\t\"A\n\x16RecordDecisionResponse\x12\'\n\x08\x64\x65\x63ision\x18\x01 \x01(\x0b\x32\x15.cortexdb.v1.Decision\"5\n\x14\x44\x65\x63isionChainRequest\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tmax_depth\x18\x02 \x01(\x05\"q\n\x15\x44\x65\x63isionChainResponse\x12\x0c\n\x04root\x18\x01 \x01(\t\x12(\n\tdecisions\x18\x02 \x03(\x0b\x32\x15.cortexdb.v1.Decision\x12\r\n\x05\x64\x65pth\x18\x03 \x01(\x05\x12\x11\n\ttruncated\x18\x04 \x01(\x08\"R\n\x11PrecedentsRequest\x12\x0c\n\x04kind\x18\x01 \x01(\t\x12\x0f\n\x07subject\x18\x02 \x01(\t\x12\x0f\n\x07\x65xclude\x18\x03 \x01(\t\x12\r\n\x05limit\x18\x04 \x01(\x05\"`\n\x12PrecedentsResponse\x12(\n\tdecisions\x18\x01 \x03(\x0b\x32\x15.cortexdb.v1.Decision\x12\r\n\x05\x63ount\x18\x02 \x01(\x05\x12\x11\n\ttruncated\x18\x03 \x01(\x08\x32\x93\x02\n\x0f\x44\x65\x63isionService\x12Y\n\x0eRecordDecision\x12\".cortexdb.v1.RecordDecisionRequest\x1a#.cortexdb.v1.RecordDecisionResponse\x12V\n\rDecisionChain\x12!.cortexdb.v1.DecisionChainRequest\x1a\".cortexdb.v1.DecisionChainResponse\x12M\n\nPrecedents\x12\x1e.cortexdb.v1.PrecedentsRequest\x1a\x1f.cortexdb.v1.PrecedentsResponseB4Z2github.com/liliang-cn/cortexdb/v2/pkg/rpc/v1;rpcv1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'cortexdb.v1.decision_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z2github.com/liliang-cn/cortexdb/v2/pkg/rpc/v1;rpcv1'
+  _globals['_DECISIONPREMISE']._serialized_start=44
+  _globals['_DECISIONPREMISE']._serialized_end=210
+  _globals['_DECISION']._serialized_start=213
+  _globals['_DECISION']._serialized_end=469
+  _globals['_RECORDDECISIONREQUEST']._serialized_start=472
+  _globals['_RECORDDECISIONREQUEST']._serialized_end=711
+  _globals['_RECORDDECISIONRESPONSE']._serialized_start=713
+  _globals['_RECORDDECISIONRESPONSE']._serialized_end=778
+  _globals['_DECISIONCHAINREQUEST']._serialized_start=780
+  _globals['_DECISIONCHAINREQUEST']._serialized_end=833
+  _globals['_DECISIONCHAINRESPONSE']._serialized_start=835
+  _globals['_DECISIONCHAINRESPONSE']._serialized_end=948
+  _globals['_PRECEDENTSREQUEST']._serialized_start=950
+  _globals['_PRECEDENTSREQUEST']._serialized_end=1032
+  _globals['_PRECEDENTSRESPONSE']._serialized_start=1034
+  _globals['_PRECEDENTSRESPONSE']._serialized_end=1130
+  _globals['_DECISIONSERVICE']._serialized_start=1133
+  _globals['_DECISIONSERVICE']._serialized_end=1408
+# @@protoc_insertion_point(module_scope)