Flagship use case: Context
Replayable context memory for AI agents and coding systems.
TemporalStore.AI focuses on the Context data model: session memory, tool-call history, retrieval evidence, summaries, safety counters, and decision replay. Other temporal workloads prove the same store can serve real online state.
Primary product story
Context is the flagship use case. Other workloads are bonus proof.
TemporalStore gives AI agents a real memory substrate: temporal writes, model-aware context, compact retrieval, safety counters, and replayable evidence. Risk, ads, and recommendation examples remain on the site as supporting examples of the same engine.
Start here
The pages people were missing are now first-class routes.
Why it exists
Modern AI and risk systems need more than latest-value KV.
Agents, fraud models, ad serving, recommendation systems, and real-time product policies all ask temporal questions: what happened recently, how often, in what sequence, under which filters, and with what replayable evidence?
Most teams approximate that with stream jobs, caches, feature tables, and application logic. TemporalStore moves those temporal primitives into the serving engine so open source users can build, inspect, benchmark, and improve the actual online state layer.
Architecture
Designed around event time, entity locality, and model-aware storage.
Clients
SDK writes stream consumers online reads replay jobsServing core
namespace + table router partition worker temporal model executor query plannerPersistence
WAL / oplog page store snapshot index recovery replayData models
Context first, with supporting temporal primitives for online state.
API shape
Small primitives, explicit semantics, testable behavior.
Ingest event
ts.put_event(
table="checkout_events",
entity="user_42",
ts_ms=event.ts_ms,
attrs={
"merchant": "m_812",
"amount_usd": 129.50,
"country": "US"
}
)
Read feature window
features = ts.window(
table="checkout_events",
entity="user_42",
range="15m",
metrics=[
"count",
"sum(amount_usd)",
"distinct(merchant)"
]
)
Build agent context
context = ts.context(
entity="workspace_7",
streams=["tool_calls", "decisions"],
since="24h",
summarize=True,
include_evidence=True
)
Contributor map
Good open-source work starts with narrow, inspectable problems.
Benchmark harness
Separate ingest throughput, read latency, sequence scans, distinct cardinality, and mixed workload tests.
Storage engine
WAL records, snapshots, page cache policy, object encoding, and replay correctness.
Query engine
Window planning, filter pushdown, distinct algorithms, sequence scans, and result explainability.
Agent memory
Context streams, tool-event schemas, memory summarization hooks, and retrieval evidence.