Function AvailableGalleryModelsCached

core/gallery/gallery.go:317–348

AvailableGalleryModelsCached returns gallery models from an in-memory cache. Local-only fields (installed status) are refreshed on every call. A background goroutine is triggered to re-fetch the full model list (including network calls) so subsequent requests pick up changes without blocking the cal

(galleries []config.Gallery, systemState *system.SystemState)

// calls) so subsequent requests pick up changes without blocking the caller.
// The first call with an empty cache blocks until the initial load completes.
func AvailableGalleryModelsCached(galleries []config.Gallery, systemState *system.SystemState) (GalleryElements[*GalleryModel], error) {
	availableModelsMu.RLock()
	cached := availableModelsCache
	availableModelsMu.RUnlock()

	if cached != nil {
		// Refresh installed status under write lock to avoid races with
		// concurrent readers and the background refresh goroutine.
		availableModelsMu.Lock()
		for _, m := range cached {
			_, err := os.Stat(filepath.Join(systemState.Model.ModelsPath, fmt.Sprintf("%s.yaml", m.GetName())))
			m.SetInstalled(err == nil)
		}
		availableModelsMu.Unlock()
		// Trigger a background refresh if one is not already running.
		triggerGalleryRefresh(galleries, systemState)
		return cached, nil
	}

	// No cache yet — must do a blocking load.
	models, err := AvailableGalleryModels(galleries, systemState)
	if err != nil {
		return nil, err
	}

	availableModelsMu.Lock()
	availableModelsCache = models
	galleryGeneration.Add(1)
	availableModelsMu.Unlock()

	return models, nil
}

// triggerGalleryRefresh starts a background goroutine that refreshes the
// gallery model cache. Only one refresh runs at a time; concurrent calls