LLMDB.History (LLM DB v2026.7.3)

Copy Markdown View Source

Read-only runtime access to generated model history artifacts.

History is loaded from priv/llm_db/history (or config :llm_db, :history_dir). NDJSON files are parsed into one immutable index published atomically through :persistent_term for fast timeline/recent lookups without a cache process.

The cache uses one bounded key. Reloading replaces that key and therefore has the normal :persistent_term global-GC update cost; reads remain lock-free.

Summary

Types

event()

Functions

available?()

Returns true when history artifacts are available and readable.

meta()

Returns parsed history metadata from meta.json.

recent(limit)

Returns most recent events globally, ordered by captured_at then event_id descending.

timeline(provider, model_id)

Returns all timeline events for a model, lineage-aware and ordered by captured_at then event_id ascending.

Types

event()

@type event() :: map()

Functions

available?()

@spec available?() :: boolean()

Returns true when history artifacts are available and readable.

meta()

@spec meta() :: {:ok, map()} | {:error, :history_unavailable | term()}

Returns parsed history metadata from meta.json.

recent(limit)

@spec recent(pos_integer()) :: {:ok, [event()]} | {:error, term()}

Returns most recent events globally, ordered by captured_at then event_id descending.

Limit is capped to 500.

timeline(provider, model_id)

@spec timeline(atom() | String.t(), String.t()) :: {:ok, [event()]} | {:error, term()}

Returns all timeline events for a model, lineage-aware and ordered by captured_at then event_id ascending.