cryptomem 2026.6.1__tar.gz

cryptomem-2026.6.1/.gitignore

@@ -0,0 +1,44 @@
+# ---- Python ----
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+env/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.hypothesis/
+.coverage
+htmlcov/
+*.so
+
+# ---- Rust ----
+/rust/target/
+target/
+**/*.rs.bk
+Cargo.lock        # library crate: keep unlocked (binaries may commit it)
+
+# ---- cryptomem local data / models ----
+*.sqlite
+*.sqlite3
+*.db
+models/
+.cache/
+*.onnx
+# Never commit private keys
+*.key
+*.pem
+secrets/
+.env
+.env.*
+
+# ---- Editors / OS ----
+.idea/
+.vscode/
+*.swp
+.DS_Store
+Thumbs.db

cryptomem-2026.6.1/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: cryptomem
+Version: 2026.6.1
+Summary: Cryptographically verified, relational, persistent memory for AI agents.
+Author: cryptomem contributors
+License: MIT OR Apache-2.0
+Keywords: agents,ai,cryptography,graphrag,memory,ollama
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic-settings>=2.2
+Requires-Dist: pydantic>=2.6
+Requires-Dist: pynacl>=1.5
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Provides-Extra: local
+Requires-Dist: onnxruntime>=1.17; extra == 'local'
+Requires-Dist: sentence-transformers>=3.0; extra == 'local'
+Provides-Extra: neo4j
+Requires-Dist: neo4j>=5.14; extra == 'neo4j'
+Provides-Extra: serve
+Requires-Dist: fastapi>=0.110; extra == 'serve'
+Requires-Dist: tiktoken>=0.7; extra == 'serve'
+Requires-Dist: uvicorn>=0.29; extra == 'serve'
+Description-Content-Type: text/markdown
+
+# cryptomem
+
+Cryptographically verified, relational, persistent memory for AI agents.
+
+This package is the Python engine. Every fact is SHA-256 hashed and Ed25519
+signed at write time; at read time each node is re-verified, and tampered or
+unsigned facts are dropped so the agent abstains rather than guessing.
+
+```python
+from cryptomem import MemoryClient
+
+mem = MemoryClient()
+mem.archive("Project Phoenix", "Budget approved at $4.2M for FY26.")
+
+for hit in mem.query("What budget did Project Phoenix get?"):
+    print(hit.node.content, hit.confidence)
+
+print(mem.answer("What budget did Project Phoenix get?"))
+```
+
+Runs on CPU-only hardware with zero model downloads via the default stub
+embedder and in-memory SQLite store. See the repository `docs/` for the full
+architecture and roadmap.
+
+## Beyond retrieval
+
+- `mem.respond(...)` — answer plus a provenance block (injected node ids,
+  verification status, Merkle root).
+- `mem.proof(node_id)` — a verifiable Merkle **inclusion proof** against the
+  current ledger root.
+- `mem.confidence(...)` — semantic-entropy confidence over sampled answers.
+- `mem.verify_answer(draft)` — Chain-of-Verification re-check of a draft.
+- `mem.contradictions()` — same-entity nodes whose content diverges.
+- `mem.suggest(...)`, `mem.triggers()`, `mem.stage_facts(...)`,
+  `mem.pending()`, `mem.confirm(node_id)` — proactive planner, triggers, and
+  write-back of staged (pending) facts that you later confirm.
+
+## Store backends
+
+Selected via `CRYPTOMEM_MODE` (or `Settings(mode=...)`):
+
+- **`sqlite`** (default) — zero-config local store; Python-side vector search.
+- **`neo4j`** — graph-native store over the Bolt driver
+  (`pip install "cryptomem[neo4j]"`, `CRYPTOMEM_NEO4J_URI=...`).
+- **`remote`** — signs locally and POSTs verbatim to a `/cmem/v1/*` backend
+  (`CRYPTOMEM_BACKEND_URL=...`); falls back to SQLite if the backend is down.
+
+## Optional extras
+
+`pip install "cryptomem[local]"` (MiniLM embeddings), `[serve]` (FastAPI
+Ollama-compatible sidecar + CLI), `[neo4j]` (graph store), `[dev]` (tooling).

cryptomem-2026.6.1/README.md

@@ -0,0 +1,51 @@
+# cryptomem
+
+Cryptographically verified, relational, persistent memory for AI agents.
+
+This package is the Python engine. Every fact is SHA-256 hashed and Ed25519
+signed at write time; at read time each node is re-verified, and tampered or
+unsigned facts are dropped so the agent abstains rather than guessing.
+
+```python
+from cryptomem import MemoryClient
+
+mem = MemoryClient()
+mem.archive("Project Phoenix", "Budget approved at $4.2M for FY26.")
+
+for hit in mem.query("What budget did Project Phoenix get?"):
+    print(hit.node.content, hit.confidence)
+
+print(mem.answer("What budget did Project Phoenix get?"))
+```
+
+Runs on CPU-only hardware with zero model downloads via the default stub
+embedder and in-memory SQLite store. See the repository `docs/` for the full
+architecture and roadmap.
+
+## Beyond retrieval
+
+- `mem.respond(...)` — answer plus a provenance block (injected node ids,
+  verification status, Merkle root).
+- `mem.proof(node_id)` — a verifiable Merkle **inclusion proof** against the
+  current ledger root.
+- `mem.confidence(...)` — semantic-entropy confidence over sampled answers.
+- `mem.verify_answer(draft)` — Chain-of-Verification re-check of a draft.
+- `mem.contradictions()` — same-entity nodes whose content diverges.
+- `mem.suggest(...)`, `mem.triggers()`, `mem.stage_facts(...)`,
+  `mem.pending()`, `mem.confirm(node_id)` — proactive planner, triggers, and
+  write-back of staged (pending) facts that you later confirm.
+
+## Store backends
+
+Selected via `CRYPTOMEM_MODE` (or `Settings(mode=...)`):
+
+- **`sqlite`** (default) — zero-config local store; Python-side vector search.
+- **`neo4j`** — graph-native store over the Bolt driver
+  (`pip install "cryptomem[neo4j]"`, `CRYPTOMEM_NEO4J_URI=...`).
+- **`remote`** — signs locally and POSTs verbatim to a `/cmem/v1/*` backend
+  (`CRYPTOMEM_BACKEND_URL=...`); falls back to SQLite if the backend is down.
+
+## Optional extras
+
+`pip install "cryptomem[local]"` (MiniLM embeddings), `[serve]` (FastAPI
+Ollama-compatible sidecar + CLI), `[neo4j]` (graph store), `[dev]` (tooling).

cryptomem-2026.6.1/cryptomem/__init__.py

@@ -0,0 +1,51 @@
+from cryptomem.adapters.mock_adapter import MockAdapter
+from cryptomem.adapters.ollama_adapter import OllamaAdapter
+from cryptomem.client import ABSTAIN, MemoryClient
+from cryptomem.config import Settings
+from cryptomem.embeddings.minilm import MiniLMEmbedder
+from cryptomem.embeddings.stub import StubEmbedder
+from cryptomem.models import (
+    Contradiction,
+    CryptoEnvelope,
+    MemoryNode,
+    Relationship,
+    ScoredNode,
+)
+from cryptomem.proactive import Planner, TriggerEngine, WriteBack
+from cryptomem.store.remote_store import RemoteStore
+from cryptomem.store.sqlite_store import SqliteStore
+from cryptomem.verification import (
+    ChainOfVerification,
+    Citer,
+    FaithfulnessChecker,
+    GroundingGate,
+    SemanticEntropy,
+)
+
+__version__ = "2026.06.1"
+
+__all__ = [
+    "ABSTAIN",
+    "MemoryClient",
+    "Settings",
+    "MemoryNode",
+    "Relationship",
+    "CryptoEnvelope",
+    "ScoredNode",
+    "Contradiction",
+    "StubEmbedder",
+    "MiniLMEmbedder",
+    "MockAdapter",
+    "OllamaAdapter",
+    "GroundingGate",
+    "FaithfulnessChecker",
+    "Citer",
+    "SemanticEntropy",
+    "ChainOfVerification",
+    "Planner",
+    "TriggerEngine",
+    "WriteBack",
+    "SqliteStore",
+    "RemoteStore",
+    "__version__",
+]

cryptomem-2026.6.1/cryptomem/adapters/__init__.py

@@ -0,0 +1,5 @@
+from cryptomem.adapters.base import LLMAdapter
+from cryptomem.adapters.mock_adapter import MockAdapter
+from cryptomem.adapters.ollama_adapter import OllamaAdapter
+
+__all__ = ["LLMAdapter", "MockAdapter", "OllamaAdapter"]

cryptomem-2026.6.1/cryptomem/adapters/base.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+
+
+class LLMAdapter(ABC):
+    """Uniform completion interface across model backends."""
+
+    @abstractmethod
+    def complete(self, prompt: str) -> str:
+        """Return the model completion for ``prompt``."""

cryptomem-2026.6.1/cryptomem/adapters/mock_adapter.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from cryptomem.adapters.base import LLMAdapter
+
+
+class MockAdapter(LLMAdapter):
+    """Model-free adapter for deterministic, offline development and tests.
+
+    Echoes the verified context it was handed so grounding and abstention can
+    be asserted without downloading or running any model.
+    """
+
+    def complete(self, prompt: str) -> str:
+        return f"[mock] grounded answer based on:\n{prompt.strip()}"

cryptomem-2026.6.1/cryptomem/adapters/ollama_adapter.py

@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+import httpx
+
+from cryptomem.adapters.base import LLMAdapter
+
+
+class OllamaAdapter(LLMAdapter):
+    """Completion adapter that forwards prompts to a local Ollama server.
+
+    Speaks Ollama's native ``/api/generate`` wire protocol with streaming
+    disabled, so it works against any stock Ollama install with zero config.
+    """
+
+    def __init__(
+        self,
+        base_url: str = "http://localhost:11434",
+        model: str = "qwen2.5:0.5b",
+        timeout: float = 60.0,
+    ):
+        self.base_url = base_url.rstrip("/")
+        self.model = model
+        self._client = httpx.Client(base_url=self.base_url, timeout=timeout)
+
+    def complete(self, prompt: str) -> str:
+        resp = self._client.post(
+            "/api/generate",
+            json={"model": self.model, "prompt": prompt, "stream": False},
+        )
+        resp.raise_for_status()
+        return str(resp.json().get("response", ""))
+
+    def is_alive(self) -> bool:
+        """Return ``True`` if the Ollama server answers ``GET /api/tags``."""
+        try:
+            return self._client.get("/api/tags").status_code == 200
+        except httpx.HTTPError:
+            return False
+
+    def close(self) -> None:
+        self._client.close()

cryptomem-2026.6.1/cryptomem/cli.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+import argparse
+
+from cryptomem import __version__
+
+
+def main(argv: list[str] | None = None) -> int:
+    """Entry point for the ``cryptomem`` command."""
+    parser = argparse.ArgumentParser(prog="cryptomem", description="cryptomem CLI")
+    parser.add_argument("--version", action="version", version=f"cryptomem {__version__}")
+    sub = parser.add_subparsers(dest="command")
+
+    serve = sub.add_parser("serve", help="run the Ollama-compatible sidecar")
+    serve.add_argument("--host", default="127.0.0.1")
+    serve.add_argument("--port", type=int, default=8088)
+    serve.add_argument("--ollama-url", default="http://localhost:11434")
+
+    args = parser.parse_args(argv)
+
+    if args.command == "serve":
+        try:
+            import uvicorn
+
+            from cryptomem.server.app import create_app
+        except ImportError:
+            print("The sidecar needs the 'serve' extra: pip install 'cryptomem[serve]'")
+            return 1
+        app = create_app(ollama_url=args.ollama_url)
+        uvicorn.run(app, host=args.host, port=args.port)
+        return 0
+
+    parser.print_help()
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())