models

type AllowedModel ¶

type AllowedModel struct {
	ProviderID uuid.UUID
	Model      string
}

AllowedModel is one (provider row, model id) pair a caller may assign.

type ModelCatalog ¶

type ModelCatalog interface {
	ListModels(ctx context.Context, p authz.Principal, opts catalog.ListModelsOptions) ([]catalog.Model, error)
}

ModelCatalog is the slice of the catalog service used to verify, server-side, that a model assigned to a capability slot actually has that capability (defense-in-depth behind the UI's capability-filtered pickers). *catalog.Service satisfies it.

type Pair ¶

type Pair struct {
	ProviderID string // empty or a parseable UUID string
	Model      string
}

Pair is a (provider FK, bare model name) tuple. An empty ProviderID means "inherit the system default for this capability"; an empty Model has the same meaning. Both halves must be set together or both unset — except `search`, where a provider may stand alone (empty Model = the search backend's default model; a set Model overrides it).

type RefreshAgentFunc ¶

type RefreshAgentFunc func(ctx context.Context, agentID uuid.UUID) error

RefreshAgentFunc pushes a /refresh into a running agent container so it re-syncs its cached PromptData after a model-slot change. A model change alters the agent's Capabilities/SupportedModalities, which the prompt and the attach-modality guard render from — without a refresh those stay stale until the next restart. A dispatch-time hash check self-heals as a backstop (see trigger.AgentConfigHash), but this makes the correction immediate.

type Service ¶

type Service struct {
	// contains filtered or unexported fields
}

func New(d *db.DB, cat ModelCatalog, refresh RefreshAgentFunc, logger *zap.Logger) *Service

func (s *Service) AllowedModels(ctx context.Context, p authz.Principal) (unrestricted bool, models []AllowedModel, err error)

func (s *Service) Get(ctx context.Context, p authz.Principal, agentID uuid.UUID) (State, error)

func (s *Service) Update(ctx context.Context, p authz.Principal, agentID uuid.UUID, req UpdateRequest) (State, error)

type SlotAssignment ¶

type SlotAssignment struct {
	Slug       string
	ProviderID string
	Model      string
}

SlotAssignment is one declared model-slot assignment. Slug must match an already-declared slot (via sync). Same model/provider pairing rule as Pair.

type State ¶

type State struct {
	Agent dbq.Agent
	Slots []dbq.AgentModelSlot
	// Settings carries the tenant model defaults so callers can resolve the
	// effective model for an unset override / unbound slot (modelresolve).
	Settings dbq.SystemSetting
}

State is the authoritative read-side view returned by Get / Update.

type UpdateRequest ¶

type UpdateRequest struct {
	Build     Pair
	Exec      Pair
	STT       Pair
	Vision    Pair
	TTS       Pair
	ImageGen  Pair
	Embedding Pair
	Search    Pair
	Slots     []SlotAssignment
}

UpdateRequest is the input to Update: all eight pairs plus any slot assignments the operator submitted. Slots not present in the agent's declared slot list are silently ignored.