Skip to main content

load_api_catalog

ralph_workflow::agents::opencode_api

Function load_api_catalog 

Source 
pub fn load_api_catalog(
    fetcher: &dyn CatalogHttpClient,
) -> Result<(ApiCatalog, Vec<CacheWarning>), CacheError>
Expand description

Load the API catalog from cache or fetch if expired.

This function:

  1. Checks if a cached catalog exists
  2. If cached and not expired, returns the cached version
  3. If expired or missing, fetches a fresh catalog from the API
  4. Saves the fetched catalog to disk for future use

Gracefully degrades on network errors: if fetching fails but a stale cache exists (< 7 days old), it will be used with a warning.

ยงReturns

Returns the catalog along with any warnings encountered during loading. Warnings should be emitted by the caller at the I/O boundary.