@spec default_inline_image_bytes() :: pos_integer()

@spec maybe_store_image(
  Vibe.Image.t(),
  keyword()
) :: {:ok, Vibe.Image.t() | Vibe.Files.ImageRef.t()} | {:error, term()}

@spec prune_orphans([String.t()] | nil) :: [Path.t()]

@spec public_path(Vibe.Files.ImageRef.t()) :: String.t() | nil

@spec resolve_session_artifact(String.t(), Path.t()) ::
  {:ok, Path.t()} | {:error, term()}

@spec session_artifact_dir(String.t()) :: Path.t()

@spec session_artifact_summary(String.t()) :: %{
  count: non_neg_integer(),
  bytes: non_neg_integer()
}

@spec store_image(
  Vibe.Image.t(),
  keyword()
) :: {:ok, Vibe.Files.ImageRef.t()} | {:error, term()}