Files
CLIProxyAPI/internal/pluginhost/scheduler.go
Luis Pater 22d40703f2 feat(scheduler): support ExcludeCandidates in plugin scheduler fallback and delegation
- Add ExcludeCandidates with PascalCase and snake_case ojson decoding to pluginapi.SchedulerPickResponse and preserve normalized exclusions in pluginhost when unhandled or delegated.
- Filter excluded auth IDs per selection pass in Manager before priority tiering and built-in selector evaluation so healthy lower-priority credentials can promote without mutating caller tried state.
- Add unit tests covering JSON/RPC compatibility, host normalization, priority promotion, session affinity, and cooldown/empty-pool errors.

Closes: #7535
2026-11-14 19:12:07 +08:00

161 lines
4.5 KiB
Go

package pluginhost
import (
"context"
"strings"
"github.com/router-for-me/CLIProxyAPI/v8/sdk/pluginapi"
log "github.com/sirupsen/logrus"
)
func (h *Host) PickAuth(ctx context.Context, req pluginapi.SchedulerPickRequest) (pluginapi.SchedulerPickResponse, bool, error) {
record := h.schedulerRecord()
if record == nil {
return pluginapi.SchedulerPickResponse{}, false, nil
}
resp, handled, errPick := h.callScheduler(ctx, *record, req)
if errPick != nil || !handled {
return resp, handled, errPick
}
if !resp.Handled {
if excluded := normalizeExcludedCandidates(resp.ExcludeCandidates); len(excluded) > 0 {
return pluginapi.SchedulerPickResponse{ExcludeCandidates: excluded}, false, nil
}
return pluginapi.SchedulerPickResponse{}, false, nil
}
resp, valid, reason := normalizeSchedulerResponse(resp, req)
if !valid {
log.WithField("plugin_id", record.id).Warnf("pluginhost: scheduler returned invalid response: %s", reason)
return pluginapi.SchedulerPickResponse{}, false, nil
}
return resp, true, nil
}
func (h *Host) HasScheduler() bool {
return h.schedulerRecord() != nil
}
func (h *Host) SchedulerWantsAcrossPriorities() bool {
record := h.schedulerRecord()
if record == nil {
return false
}
return schedulerWantsAcrossPriorities(record.plugin.Capabilities)
}
func (h *Host) schedulerRecord() *capabilityRecord {
if h == nil {
return nil
}
for _, record := range h.activeRecords() {
if h.isPluginFused(record.id) || record.plugin.Capabilities.Scheduler == nil {
continue
}
copyRecord := record
return &copyRecord
}
return nil
}
func (h *Host) callScheduler(ctx context.Context, record capabilityRecord, req pluginapi.SchedulerPickRequest) (resp pluginapi.SchedulerPickResponse, handled bool, err error) {
scheduler := record.plugin.Capabilities.Scheduler
if h == nil || scheduler == nil || h.isPluginFused(record.id) || !h.recordCurrent(record) {
return pluginapi.SchedulerPickResponse{}, false, nil
}
defer func() {
if recovered := recover(); recovered != nil {
h.fusePlugin(record.id, "Scheduler.Pick", recovered)
resp = pluginapi.SchedulerPickResponse{}
handled = false
err = nil
}
}()
req.Plugin = record.meta
resp, errPick := scheduler.Pick(ctx, req)
if errPick != nil {
log.WithField("plugin_id", record.id).WithError(errPick).Warn("pluginhost: scheduler rejected auth pick")
return pluginapi.SchedulerPickResponse{}, true, errPick
}
return resp, true, nil
}
func normalizeSchedulerResponse(resp pluginapi.SchedulerPickResponse, req pluginapi.SchedulerPickRequest) (pluginapi.SchedulerPickResponse, bool, string) {
resp.AuthID = strings.TrimSpace(resp.AuthID)
resp.DelegateBuiltin = strings.TrimSpace(resp.DelegateBuiltin)
resp.RejectCode = strings.TrimSpace(resp.RejectCode)
resp.RejectReason = strings.TrimSpace(resp.RejectReason)
resp.ExcludeCandidates = normalizeExcludedCandidates(resp.ExcludeCandidates)
if resp.Reject {
if resp.RejectCode == "" {
resp.RejectCode = "auth_unavailable"
}
if resp.RejectReason == "" {
resp.RejectReason = "scheduler rejected candidate selection"
}
resp.ExcludeCandidates = nil
return resp, true, ""
}
hasAuthID := resp.AuthID != ""
hasDelegate := resp.DelegateBuiltin != ""
if !hasAuthID && !hasDelegate {
return pluginapi.SchedulerPickResponse{}, false, "missing auth id or delegate"
}
if hasAuthID {
if !schedulerCandidateExists(req.Candidates, resp.AuthID) {
return pluginapi.SchedulerPickResponse{}, false, "unknown auth id"
}
resp.ExcludeCandidates = nil
return resp, true, ""
}
if !validSchedulerBuiltin(resp.DelegateBuiltin) {
return pluginapi.SchedulerPickResponse{}, false, "unknown delegate"
}
return resp, true, ""
}
func normalizeExcludedCandidates(candidates []string) []string {
if len(candidates) == 0 {
return nil
}
out := make([]string, 0, len(candidates))
seen := make(map[string]struct{}, len(candidates))
for _, candidate := range candidates {
trimmed := strings.TrimSpace(candidate)
if trimmed == "" {
continue
}
if _, exists := seen[trimmed]; exists {
continue
}
seen[trimmed] = struct{}{}
out = append(out, trimmed)
}
if len(out) == 0 {
return nil
}
return out
}
func schedulerCandidateExists(candidates []pluginapi.SchedulerAuthCandidate, authID string) bool {
for _, candidate := range candidates {
if strings.TrimSpace(candidate.ID) == authID {
return true
}
}
return false
}
func validSchedulerBuiltin(delegate string) bool {
switch delegate {
case pluginapi.SchedulerBuiltinRoundRobin, pluginapi.SchedulerBuiltinFillFirst:
return true
default:
return false
}
}