Auto Router Feature History
Every stable release links to its GitHub release and full release notes. Newest first. A feature listed under a version is available from that version onward.
Coming in Next Release​
Merged after the v1.100.0 release candidate was cut. Available in v1.101.0-dev builds now; the stable link will be added when it ships.
- Heuristic v2 classifier.
classifier_type: trained_heuristic, pretrained, no LLM call on the request path. 27% more Terminal-Bench tasks solved at 45% lower cost per task than v1. #39276, #39423. Post. - Context-window escalation. Oversized prompts move to the cheapest tier that fits before dispatch. On by default,
context_window_escalation_buffer: 0.95. #38844, UI #39054. - Modality routing. Opt-in
modality_routing: truesends image requests to a tier that can see them. #39032, UI #39059. - User-turn classification.
classification_mode: user_turnclassifies new user asks only and carries the decision through continuation turns. #38861. - Shadow evals on teams and users. Target a
key,team, oruser, so JWT-authenticated traffic can be evaluated. #39015. - Shadow evals across several routers. Compare multiple router configs on one job's sampled traffic, paired. #39028.
- 1M context preset. #39490.
Posts: Route on Context Size and Modality.
v1.100.0 (release candidate)​
GitHub pre-release, Release notes
- Custom tier sets. Define your own tiers for the LLM classifier, preview the exact classifier prompt, keyword rules follow renames. #38602, #38603, #38605.
- Heuristic-first chaining.
classifier_type: heuristic_firstscores locally and calls the LLM classifier only when needed. #38428. - Classifier context budget. A character budget across turns replaces the per-turn 200-character clip. #38141, #38145.
- Housekeeping prompts skip the classifier. Client housekeeping messages go to the cheapest tier with no classifier call. #38598.
- Gemini Family preset; per-tier reasoning effort in the Lite and Anthropic presets. #38138, #38482, #38490.
- Dry-run validation before save. The UI validates a config against
/auto_router/validate_complexity_router_config;/auto_router/test_routingaccepts a real request body. #38595. - Tier-pinned reasoning effort wins. A tier's
reasoning_effortsupersedes client carriers; unsupported tier params are dropped instead of failing the tier. #38622, #38698. - Classifier cost counted. Savings figures, benchmarks, and shadow evals net out the router's own classifier charge. #38835, #38631.
- Router health from its models. A router is flagged when a tier, default, or classifier model cannot serve. #37966, #38174.
model_group_aliasworks for auto-routers. #38272, #38382.- Breaking. Settings placed outside
complexity_router_configare rejected (#38570).router_model_nameis gone, usereturn_raw_model_name(#38429).autorouter_savings_baseline_modelis deleted; each router derives its baseline from its hardest tier (#38700).
v1.99.0​
- Operator-defined tier sets for the LLM classifier. #37226.
- Custom classifier plugins.
classifier_type: customwith a dotted path to your ownclassify(). #37249. - Plan-mode tier floor for coding-agent clients. #37230.
- Per-tier
litellm_paramsand per-model reasoning effort in the tier editor. #37064, #37673. - Business classification rubric preset. #37534.
- Lite preset (mixed provider) and heuristic scorer settings in the UI. #37068, #37216.
- Shadow evals: several keys per job, budget in dollars.
api_key_idsreplacesapi_key_id,max_budgetreplacesmax_turns(breaking). #37251, #37555. - Responses API input routed through the auto-router. #37333.
- Savings to callbacks and per key. Per-request savings reach logging callbacks; a Savings tab on the key page. #37894, #37693.
v1.98.0​
- Shadow evaluations. Sample one key's live traffic, replay it through the router without serving the response, blind LLM judge, reverse mode,
/v1/messagesand/v1/responses. #36587, #36830, #36865. UI #36588, #36994. Post. - Calibrated classifier rubric with worked examples, selectable per router; system prompt text no longer scored. #36578, #36721.
- Deployment affinity toggle in the UI; models shown under each tier in the benchmark chart. #36302, #36291.
- Tag routing gates. Required-AND tag prefix,
allow_fail_open, untagged requests bypass a tagged pre-routing strategy. #36193, #36627, #36628.
v1.97.0​
- Deployment affinity on by default (breaking). A session returning to a model group lands on the deployment it used before, so the provider cache stays warm.
deployment_affinity: falserestores the old behavior. #36146. - Session affinity off by default, exposed in the UI. #35714.
- Savings and usage tab. Net auto-router savings on Cost Optimization, baseline derived from the hardest tier, per-session rollup, turns per tier. #35522, #35995, #35521, #35907, #35910, #36209. Post.
- Classifier cost per request in
routing_decisionand thex-litellm-classifier-costheader. #36015. - 1-click presets and Test Routing. Add Auto Router is name plus template; Test Routing shows the pick before saving; presets match deployments by underlying model ID. #35746, #35859, #35972, #36111. Post.
- Replaceable classifier prompt and tier names. #35855, #35893.
v1.96.0​
- Classifier context window. The LLM classifier sees prior turns (
classifier_context_window_size, default 3). #35185. Post. - Assistant turns optionally included (
classifier_context_include_assistant_turns). #35471. - Routing decision recorded. Tier, cause, and classifier request body in spend logs and the log drawer; the router's own classifier calls are marked. #35016, #35164, #35300, #35304.
- Auto-routers get their own tab in Models + Endpoints, with the context window fields. #35009, #35315, #35500.
v1.95.0​
return_raw_model_name. Put the picked model in the response bodymodelfield instead of the alias. #33875.- Logs show the router. The log drawer and session sidebar mark requests an auto-router served. #34434.
v1.94.0​
- Auto Router v2. Complexity, semantic, and adaptive routing in one
auto_router/complexity_router. Post. - Router plugins.
Router(plugins=[...]), resolvable from proxy config. #32972, #33251, #33644. Post. - Tier pools. Soft-floor adaptive mode and random-pick multi-model tiers. #32947, #32967.
- Session affinity. Pin a session to its first-turn model. #33126, #33500, #33723.
- Escalation keywords and per-tier semantic keyword prompts. #33656, #33508.
- Cost Optimization page (beta) with an Autorouter tab. #33899.
- Test Connection for the auto router. #32950, #33146.