Route

One routing request for a named model-selection router.

Either messages (OpenAI-shape chat turns) or prompt (a single user string) identifies the request text; messages wins when both are set. Exactly one of the two must be non-empty. Every routing knob is optional and falls back to the router's deployed default.

Attributes: router_type: Registry id of the router to score with (e.g. general). messages: OpenAI-shape chat messages to route. prompt: Single user prompt, used when messages is absent. threshold: Minimum calibrated success probability for a candidate (code/auto router family only; ignored where unused). max_regret: Allowed probability gap below the top candidate (code/auto router family only; ignored where unused). alpha: LinUCB exploration weight (router-specific; ignored where unused). lambda_cost: Cost weight in the general router's q - cost*lambda policy (general router only; ignored where unused). allowed_models: Optional catalog-id subset the router may select between. actual_model: Catalog model the caller would otherwise use, for regret.

A router's decision for one request.

Every model id is a standard Pioneer catalog id (the router normalizes its internal slugs before responding).

Attributes: model: Chosen catalog model id, or None when the router declined. confidence: Calibrated success probability of the chosen candidate. expected_cost_usd: Router's expected cost for the chosen candidate. rule: Decision-rule label that fired. reason_codes: Diagnostic reason codes the router attached. policy_version: Deployed policy version that produced the decision. candidates: Per-candidate score rows the router considered.