tinker_cookbook.stores.RunRegistry

class tinker_cookbook.stores.RunRegistry()

Discovers training runs and provides stores for each.

Supports multiple storage backends. Each run is tracked with its source storage so stores route to the correct backend.

property storage_count

Number of storage backends registered.

Returns: int

property primary_storage

The first (default) storage backend.

Returns: Storage

storage_for(run_id)

Return the storage backend that owns a run (falls back to primary).

Parameters:

• run_id (str)

Returns: Storage

refresh()

Re-scan all storages. Clears cached stores.

Returns: list[RunInfo]

get_runs()

Return all discovered runs (lazy — calls refresh on first access).

Returns: list[RunInfo]

get_run(run_id)

Look up a single run by ID, or None if not found.

Parameters:

• run_id (str)

Returns: RunInfo | None

get_training_store(run_id)

Get a TrainingRunStore for a specific run.

Parameters:

• run_id (str)

Returns: TrainingRunStore

get_eval_store()

Get the EvalStore if eval data exists (cached after first call).

Returns None if no eval data found. Import is deferred to avoid circular deps with eval/init.py. Probes eval_prefixes (configurable via constructor) for a runs.jsonl file.

Returns: Any | None