opencontext-memory

SQLite + FTS5 memory store and 19 MCP-style tools for OpenContext Runtime.

This package is the concrete memory backend the conductor (opencontext-sdd) and the CLI (opencontext memory v2 …) read and write through. It is local only — no network, no cloud sync, no third-party drivers — and rides the Python 3.12 stdlib sqlite3 (FTS5 is built-in on the supported versions).

Public exports

from opencontext_memory import MemoryStore, WriteQueue

Storage shape

The canonical schema lives in opencontext_memory/store/schema.sql and is the single source of truth for tables, indices, and the FTS5 virtual table. MemoryStore loads it on first open.

Cross-process safety

Concurrent writers in the same process serialise through a per-connection lock; concurrent writers across processes serialise through WriteQueue, which uses fcntl.flock on POSIX and a msvcrt-compatible lockfile on Windows.

Mock LLM

The package never makes network calls. The tests/conftest.py autouse fixture asserts no real LLM env vars are set during test execution so future tool surface inherits the same guarantee.