host

type Host struct {
	Meta meta.Metadata `json:"metadata" yaml:"metadata"`
	Spec Spec          `json:"spec"     yaml:"spec"`

	// Status is runtime-observed health, overlaid by the control-API enrich
	// step from the host-health store. nil when no observation exists yet
	// (no traffic since boot, or the record TTL'd out) — the UI shows
	// "unknown". Never persisted and never loaded from YAML.
	Status *Status `json:"status,omitempty" yaml:"-"`
}

type HostHealth string

type Spec struct {
	// BaseURL is the upstream root. Required.
	BaseURL string `json:"baseURL" yaml:"baseURL" validate:"required,http_url"`

	// Backend is the free-form bag of backend-specific config (Bedrock region,
	// Azure deployment, Vertex project/location, etc.). Each provider client
	// reads the keys it needs and ignores the rest. Optional.
	Backend map[string]string `json:"backend,omitempty" yaml:"backend,omitempty"`

	// Policies is the host's menu of upstream tier Policy ids a HostKey can
	// mirror. Every entry must be a Policy with Meta.Owner = {kind:host, id:
	// <this host's id>}. The composition layer enforces the menu invariant.
	Policies []string `json:"policies,omitempty" yaml:"policies,omitempty"`

	// DefaultPolicy is the Policy id from Policies a HostKey inherits when
	// its Spec.PolicyID is empty. Must be one of Policies. Optional — if
	// empty, HostKey.Spec.PolicyID becomes required.
	DefaultPolicy string `json:"defaultPolicy,omitempty" yaml:"defaultPolicy,omitempty"`

	// PricingStrategies is the menu of billing modes this upstream offers:
	// "api" (per-token metered) and/or "sub" (flat-rate subscription). A
	// HostKey's Spec.PricingStrategy must be one of these. Empty defaults to
	// ["api"]. Anthropic offers both (an API key or a Max subscription reach
	// the same endpoint); Ollama Cloud is ["sub"] only; most hosts are
	// ["api"]. Catalog-declared; the operator picks one per HostKey.
	PricingStrategies []string `json:"pricingStrategies,omitempty" yaml:"pricingStrategies,omitempty" validate:"omitempty,dive,oneof=api sub"`

	// NoAuth marks an upstream that needs no API key (a self-hosted Ollama on
	// the operator's network). When set, routing injects a synthetic anonymous
	// key for this host instead of requiring a real HostKey, and the adapter
	// sends no Authorization header. Operator-managed (per-deployment), not a
	// catalog-fixed property — Ollama Cloud still needs a key.
	NoAuth bool `json:"noAuth,omitempty" yaml:"noAuth,omitempty"`

	// Enabled defaults to true when nil.
	Enabled *bool `json:"enabled,omitempty" yaml:"enabled,omitempty"`

	// Display metadata — operator-set, optional.
	HomepageURL   string     `json:"homepageURL,omitempty"   yaml:"homepageURL,omitempty"   validate:"omitempty,http_url"`
	DocsURL       string     `json:"docsURL,omitempty"       yaml:"docsURL,omitempty"       validate:"omitempty,http_url"`
	ConsoleURL    string     `json:"consoleURL,omitempty"    yaml:"consoleURL,omitempty"    validate:"omitempty,http_url"`
	StatusPageURL string     `json:"statusPageURL,omitempty" yaml:"statusPageURL,omitempty" validate:"omitempty,http_url"`
	Icon          *meta.Icon `json:"icon,omitempty"          yaml:"icon,omitempty"`
}

type Status struct {
	Health              HostHealth `json:"health" doc:"unknown | healthy | unreachable."`
	LastError           string     `json:"lastError,omitempty" doc:"Last dial-failure error excerpt; set while unreachable."`
	ConsecutiveFailures int        `json:"consecutiveFailures,omitempty" doc:"Consecutive dial failures; 0 when healthy."`
	LastTransition      time.Time  `json:"lastTransition,omitempty" doc:"When health was last recorded."`
	LastSuccess         time.Time  `json:"lastSuccess,omitempty" doc:"When the host was last reachable."`
}

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