Crate switchyard_runner 

Shared configured routing for Switchyard serving surfaces.

Structs

AlgorithmConfigError

Error returned when an algorithm description cannot be constructed.

AuxiliaryTarget

Exact upstream model and client used for an auxiliary provider operation.

CategoryModelConfig

Runtime model groups for a custom classifier, keyed by group name.

DecisionDescription

Fully resolved routing decision.

DecisionJudgeRouteConfig

Relative-advantage judgment using a decision model instead of an LLM prompt.

DecisionTarget

Non-secret configured target details returned by the decision endpoint.

LlmClassifierRouteConfig

Settings for an llm_classifier route. Which fields are required depends on the ClassifierMode; using a field from the wrong mode is an error.

ModelCapabilities

Capabilities declared for one route.

ModelInfo

Borrowed model metadata returned while listing routes.

ProviderKeyRedactor

Replaces configured provider keys without changing the credentials sent upstream.

Route

A configured algorithm and the per-target clients its calls resolve through.

RouteErrorSummary

Safe, structured terminal-failure data for routing telemetry.

RoutingOutcome

The terminal result of routing.

RunOutput

The selected model and untouched response produced by a route execution.

Runner

Immutable named route table.

RuntimeModels

The models one algorithm run may use, grouped by Category. Within a category they are ordered best-first.

StageClassifierConfig

The judge a stage_router route falls through to, and how it routes.

VgrRouteConfig

Enums

AdvisorTriggerConfig

What fires an advisor route’s review.

AlgorithmSpec

A routing algorithm described by configured target names.

CallerAuthKind

Caller credential family required by a forwarded-auth route.

ClassifierMode

Which of the three llm_classifier behaviors a route uses.

ClassifierPolicyConfig

How a custom classifier turns the judge’s JSON verdict into a target.

RouteErrorKind

Stable class of a terminal route-execution failure.

RouteErrorPhase

When a terminal failure occurred relative to response delivery.

RunnerError

Error returned while loading or executing configured routes.

SubagentRouteConfig

Routing policy applied only to delegated sub-agent work, nested inside a passthrough or stage_router route.

VgrModeConfig

Functions

api_key_variables

This function returns a deployment’s declared credential variable names without reading their values. It parses the deployment and checks its schema version before returning names from LLM and decision clients.

stream_error_summary

Returns a safe telemetry summary for an error yielded by an active response stream.