Skip to content

Store backend model

What it is: the persistence model behind memory, sqlite, jsonl, mongodb, and postgres backends.

When it matters: whenever the run must survive process boundaries or integrate with a larger environment.

What you provide: the backend choice and backend-specific parameters.

What Themis provides: a common RunStore contract so planning, execution, reporting, and inspection can remain backend-agnostic.

Use this capability table when you need to match a backend to the workflow it must support.

Backend Best fit Cross-process reopen Resume/report ergonomics
memory tutorials, smoke tests, in-process debugging no lowest
sqlite most local persisted work yes highest for single-machine workflows
jsonl file-based operational handoff yes workflow-specific
mongodb service-backed persistence yes environment-specific
postgres shared relational persistence yes environment-specific

The main difference is not API shape but how durable and operationally reusable the stored run becomes.

What to inspect when it goes wrong: confirm the store backend supports the workflow you expect, then inspect whether the snapshot and events were persisted where that workflow reads them back.