@spec cached_contents_path(keyword()) :: String.t()

Build the base cachedContents collection path for the active auth strategy.

@spec normalize_cache_model_name(
  String.t(),
  keyword()
) :: String.t()

Normalize a cache model name for the active auth strategy.

• Gemini: ensures models/ prefix.
• Vertex: expands to projects/{project}/locations/{location}/publishers/google/models/{model}.

@spec normalize_cached_content_name(
  String.t(),
  keyword()
) :: String.t()

Normalize cached content names for the active auth strategy.

• Gemini: ensures cachedContents/ prefix.
• Vertex: expands short names to projects/{project}/locations/{location}/cachedContents/{id}.