Metadata-Version: 2.4
Name: lumis-sdk-postgres-memory
Version: 0.1.1
Summary: Optional PostgreSQL MemoryStore plugin for Lumis SDK.
License-Expression: Apache-2.0
Requires-Python: >=3.11
Requires-Dist: lumis-sdk<0.1.0,>=0.0.8
Requires-Dist: psycopg[binary]<4,>=3.2
Description-Content-Type: text/markdown

# Lumis SDK PostgreSQL memory

This independently installable package implements the public asynchronous `MemoryStore`
contract with PostgreSQL. It is optional: installing `lumis-sdk` does not install a PostgreSQL
driver.

Install the independently versioned plugin alongside the released core:

```bash
pip install "lumis-sdk==0.0.8" "lumis-sdk-postgres-memory==0.1.1"
```

Project YAML references an environment variable rather than containing credentials:

```yaml
spec:
  memory:
    provider: postgres
    connectionUrlEnv: LUMIS_MEMORY_DATABASE_URL
    schema: lumis_memory
```

The plugin requests `network` and `secrets` authority. Discovery grants neither authority;
applications must explicitly load the plugin and supply the referenced environment.

The store creates only its validated schema and tables, serializes migrations with a PostgreSQL
advisory transaction lock, treats `incident_id` as an idempotency key, bounds search candidates,
and never exposes arbitrary SQL or action execution.
