Adds internal/domain/image (Provider/Registry per the plugin engine family shape, but no Lifecycle -- a provider is call-scoped, not long-running) and config.ImageConfig with the same explicit enabled=true cost gate MinimaxConfig already uses, since a hosted provider spends real API credits and a local one can saturate the host GPU. Design doc at docs/prds/image-capability-contract.md per CLAUDE.md's rule for undesigned capabilities. No provider implementation lands here -- that's the epic's next child bead. Also re-links all 7 epic children that were unlinked from archie-core-1786748942120-1-6636e629 (same orphaning pattern found in the curator/memory epics earlier this session).
91 lines
2.2 KiB
Go
91 lines
2.2 KiB
Go
package image
|
|
|
|
import (
|
|
"errors"
|
|
"fmt"
|
|
"reflect"
|
|
"slices"
|
|
"sync"
|
|
)
|
|
|
|
// ErrDuplicate is returned when a provider name is already registered.
|
|
var ErrDuplicate = errors.New("duplicate image provider")
|
|
|
|
// Registry is the image family owner: registration and discovery only. A
|
|
// Provider is call-scoped (see package doc), so unlike curator's and
|
|
// memory's registries there is no Start/Health/Stop to orchestrate here.
|
|
type Registry struct {
|
|
mu sync.RWMutex
|
|
providers map[string]Provider
|
|
}
|
|
|
|
// NewRegistry builds an empty provider registry.
|
|
func NewRegistry() *Registry {
|
|
return &Registry{providers: make(map[string]Provider)}
|
|
}
|
|
|
|
// Register validates the provider's declared capability and adds it.
|
|
// Registration fails on a nil provider, an invalid Capability, or a
|
|
// duplicate name.
|
|
func (r *Registry) Register(p Provider) error {
|
|
if isNilProvider(p) {
|
|
return errors.New("image: nil provider")
|
|
}
|
|
if err := p.Capability().Validate(); err != nil {
|
|
return err
|
|
}
|
|
|
|
r.mu.Lock()
|
|
defer r.mu.Unlock()
|
|
if _, dup := r.providers[p.Name()]; dup {
|
|
return fmt.Errorf("%w: %s", ErrDuplicate, p.Name())
|
|
}
|
|
r.providers[p.Name()] = p
|
|
return nil
|
|
}
|
|
|
|
// Get returns the registered provider by name.
|
|
func (r *Registry) Get(name string) (Provider, bool) {
|
|
r.mu.RLock()
|
|
defer r.mu.RUnlock()
|
|
p, ok := r.providers[name]
|
|
return p, ok
|
|
}
|
|
|
|
// Names returns every registered provider name, sorted.
|
|
func (r *Registry) Names() []string {
|
|
r.mu.RLock()
|
|
defer r.mu.RUnlock()
|
|
names := make([]string, 0, len(r.providers))
|
|
for name := range r.providers {
|
|
names = append(names, name)
|
|
}
|
|
slices.Sort(names)
|
|
return names
|
|
}
|
|
|
|
// ByClass returns the sorted names of registered providers matching class.
|
|
func (r *Registry) ByClass(class ProviderClass) []string {
|
|
r.mu.RLock()
|
|
defer r.mu.RUnlock()
|
|
var names []string
|
|
for name, p := range r.providers {
|
|
if p.Class() == class {
|
|
names = append(names, name)
|
|
}
|
|
}
|
|
slices.Sort(names)
|
|
return names
|
|
}
|
|
|
|
func isNilProvider(p Provider) bool {
|
|
v := reflect.ValueOf(p)
|
|
switch v.Kind() {
|
|
case reflect.Invalid:
|
|
return true
|
|
case reflect.Chan, reflect.Func, reflect.Interface, reflect.Map, reflect.Pointer, reflect.Slice:
|
|
return v.IsNil()
|
|
}
|
|
return false
|
|
}
|