LLMDB.Snapshot.ReleaseStore (LLM DB v2026.9.0)

Copy Markdown View Source

GitHub Releases-backed snapshot artifact store.

Runtime fetching resolves immutable snapshots through the latest complete catalog generation release. It resolves history through the latest complete checkpoint generation release. Fixed-tag assets and a release scan support migration when these releases do not exist. Publishing creates one immutable release for each complete asset pair. It uses the gh CLI for maintainer workflows and GitHub Actions.

This shared transport is internal. Runtime consumers configure snapshot sources through LLMDB.load/1; maintainers use the supported mix llm_db.snapshot.* and mix llm_db.history.* tasks. Direct publishing calls are documentation-deprecated through the current major release.

Summary

Types

config()

Functions

asset_url(tag, filename, overrides \\ %{})
config(overrides \\ [])
download_history_archive(destination, overrides \\ %{})
ensure_snapshot_release(snapshot_path, meta_path, snapshot_id, overrides \\ %{})
fetch_history_meta(overrides \\ %{})
fetch_latest(overrides \\ %{})
fetch_snapshot(ref, overrides \\ %{})
fetch_snapshot_index(overrides \\ %{})
history_archive_asset_url(snapshot_id, overrides \\ %{})
history_meta_asset_url(snapshot_id, overrides \\ %{})
history_tag(snapshot_id)
publish_history_release(asset_paths, snapshot_id, overrides \\ %{})
publish_snapshot_index(asset_paths, overrides \\ %{})
snapshot_asset_url(snapshot_id, overrides \\ %{})
snapshot_meta_asset_url(snapshot_id, overrides \\ %{})
snapshot_tag(snapshot_id)

Types

config()

@type config() :: %{
  repo: String.t(),
  index_tag: String.t(),
  history_tag: String.t(),
  cache_dir: String.t()
}

Functions

asset_url(tag, filename, overrides \\ %{})

@spec asset_url(String.t(), String.t(), keyword() | map()) :: String.t()

config(overrides \\ [])

@spec config(keyword() | map()) :: config()

download_history_archive(destination, overrides \\ %{})

@spec download_history_archive(String.t(), keyword() | map()) ::
  :ok | {:error, term()}

ensure_snapshot_release(snapshot_path, meta_path, snapshot_id, overrides \\ %{})

@spec ensure_snapshot_release(String.t(), String.t(), String.t(), keyword() | map()) ::
  {:ok, String.t()} | {:error, term()}

fetch_history_meta(overrides \\ %{})

@spec fetch_history_meta(keyword() | map()) :: {:ok, map()} | {:error, term()}

fetch_latest(overrides \\ %{})

@spec fetch_latest(keyword() | map()) :: {:ok, map()} | {:error, term()}

fetch_snapshot(ref, overrides \\ %{})

@spec fetch_snapshot(:latest | String.t(), keyword() | map()) ::
  {:ok, %{snapshot: map(), snapshot_id: String.t(), path: String.t()}}
  | {:error, term()}

fetch_snapshot_index(overrides \\ %{})

@spec fetch_snapshot_index(keyword() | map()) :: {:ok, [map()]} | {:error, term()}

history_archive_asset_url(snapshot_id, overrides \\ %{})

@spec history_archive_asset_url(String.t(), keyword() | map()) :: String.t() | nil

history_meta_asset_url(snapshot_id, overrides \\ %{})

@spec history_meta_asset_url(String.t(), keyword() | map()) :: String.t() | nil

history_tag(snapshot_id)

@spec history_tag(String.t()) :: String.t()

publish_history_release(asset_paths, snapshot_id, overrides \\ %{})

@spec publish_history_release([String.t()], String.t(), keyword() | map()) ::
  {:ok, String.t()} | {:error, term()}

publish_snapshot_index(asset_paths, overrides \\ %{})

@spec publish_snapshot_index([String.t()], keyword() | map()) ::
  {:ok, String.t()} | {:error, term()}

snapshot_asset_url(snapshot_id, overrides \\ %{})

@spec snapshot_asset_url(String.t(), keyword() | map()) :: String.t() | nil

snapshot_meta_asset_url(snapshot_id, overrides \\ %{})

@spec snapshot_meta_asset_url(String.t(), keyword() | map()) :: String.t() | nil

snapshot_tag(snapshot_id)

@spec snapshot_tag(String.t()) :: String.t()