Scheduler Plugin

This plugin demonstrates the CLIProxyAPI C ABI scheduler capability from Go.

It implements:

The plugin can select a configured auth ID, delegate routing to a built-in scheduler, or reject scheduler picks.

Configuration

Add the plugin under plugins.configs:

yaml

plugins:
  configs:
    scheduler:
      enabled: true
      priority: 1
      auth_id: ""
      delegate: ""
      deny: false

Fields:

auth_id: selects this auth ID when it appears in the scheduler candidates.
delegate: delegates selection to a built-in scheduler. Supported values are "", fill-first, and round-robin.
deny: returns a scheduler error when set to true.

Behavior:

When deny is true, the plugin returns an error envelope with code scheduler_denied.
When delegate is fill-first or round-robin, the plugin returns DelegateBuiltin and marks the pick as handled.
When delegate is any other non-empty value, the plugin leaves the pick unhandled.
When delegate is empty and auth_id exists in the candidates, the plugin returns that auth ID and marks the pick as handled.
When no rule matches, the plugin leaves the pick unhandled.

From this directory:

bash

cd go
go build -buildmode=c-shared -o /tmp/cliproxy-scheduler-plugin.so .
rm -f /tmp/cliproxy-scheduler-plugin.so /tmp/cliproxy-scheduler-plugin.h