scheduler

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

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

type Placement struct {
	Pool       RuntimePool      `json:"pool"`
	Score      float64          `json:"score"`
	Components []ScoreComponent `json:"components"`
}

type PoolSource interface {
	ListRuntimePools(context.Context, string) ([]RuntimePool, error)
}

type Rejection struct {
	PoolID  string   `json:"poolId"`
	Reasons []string `json:"reasons"`
}

type Result struct {
	Placement Placement `json:"placement"`
	// Candidates is the full score-ranked placement list. Placement is the
	// first entry; the scheduler walks the remaining entries in order when
	// a higher-ranked pool loses the transactional capacity reservation.
	Candidates []Placement `json:"candidates"`
	Rejected   []Rejection `json:"rejected"`
}

type RuntimePool struct {
	ID                string   `json:"id"`
	TenantIDs         []string `json:"tenantIds"`
	RuntimeClass      string   `json:"runtimeClass"`
	RuntimeInstanceID string   `json:"runtimeInstanceId"`
	Region            string   `json:"region"`
	DataResidency     string   `json:"dataResidency"`
	Ready             bool     `json:"ready"`
	// Status separates health from operator intent. Empty/ACTIVE accepts new
	// work; CORDONED and DRAINING preserve existing leases but reject placement.
	Status            string `json:"status,omitempty"`
	FailureDomain     string `json:"failureDomain,omitempty"`
	AvailableCPU      int64  `json:"availableCpuMillis"`
	AvailableMemory   int64  `json:"availableMemoryMiB"`
	AvailableLLMSlots int    `json:"availableLlmSlots"`
	// CapacityLedgerMissing marks a pool whose durable capacity ledger was
	// never registered by the operator. Such pools fail placement closed
	// instead of being treated as fully idle. Zero (the default) keeps
	// statically configured pools schedulable.
	CapacityLedgerMissing bool     `json:"capacityLedgerMissing,omitempty"`
	ArtifactRegions       []string `json:"artifactRegions"`
	CostWeight            float64  `json:"costWeight"`
	// Operators lists the operator subjects granted cordon/drain/activate
	// authority on this pool. Usage visibility comes from TenantIDs; the
	// two authorities are deliberately independent so a tenant of a shared
	// pool cannot operate it.
	Operators []string `json:"operators,omitempty"`
}

type ScoreComponent struct {
	Name   string  `json:"name"`
	Value  float64 `json:"value"`
	Reason string  `json:"reason"`
}

type StaticPoolSource []RuntimePool