Struct RoutingTextModel 

pub struct RoutingTextModel { /* private fields */ }

Dispatches by Prompt::tier to the adapter a venture configured for that tier, so venture code holds one Arc<dyn TextModel> and never matches on the tier or the vendor itself (ADR 0002). The router lives above the adapters, in core — the same place RoutingPush does, and for the same reason (ADR 0015).

This is the seam that lets a venture put drafting on one vendor and an independent judge on another without either module knowing.

A tier with no adapter is TextModelError::NotConfigured — deliberately not TextModelError::Rejected: nothing is wrong with the prompt, the venture simply did not wire that tier.

The router also enforces capability agreement (issue #665): a prompt that carries Prompt::tools is refused with TextModelError::Unsupported before a tier that does not report Capability::Tools for that tier is called, so a venture can assert once at compose time — router.supports(ModelTier::Strong, Capability::Tools) — that the tier it routed tools to can carry them. RoutingTextModel::supports answers for the single routed tier: the adapter wired for tier, or false when that tier is unwired. It is deliberately not an aggregate over every wired tier: a prompt goes to exactly one tier, so what matters is that tier’s answer, and a strong-tier judge that cannot carry tools must not make a fast-tier drafting model look incapable.

The same agreement covers images (issue #628): a prompt carrying a Part::Image is refused with TextModelError::Unsupported before a tier that does not report Capability::Images is called, and an over-limit prompt by Prompt::check_images before the tier is looked up at all.

Implementations

impl RoutingTextModel

pub fn new() -> Self

A router with no adapters: every tier is NotConfigured.

pub fn fast(self, model: Arc<dyn TextModel>) -> Self

The adapter for ModelTier::Fast.

pub fn strong(self, model: Arc<dyn TextModel>) -> Self

The adapter for ModelTier::Strong.

pub fn route_for(&self, tier: ModelTier) -> Option<&Arc<dyn TextModel>>

The adapter that serves tier, if one is configured.

Trait Implementations

impl Clone for RoutingTextModel

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RoutingTextModel

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RoutingTextModel

fn default() -> Self

Returns the “default value” for a type.

impl TextModel for RoutingTextModel

fn stream<'a>( &'a self, prompt: &'a Prompt, ) -> BoxStream<'a, Result<TextDelta, TextModelError>>

Forwards to the routed tier’s own stream — a native stream is not flattened through a buffered complete, or the router would turn every native stream into one round trip. The pre-flight refusals are the router’s own (routed), so an unwired tier, an over-limit prompt or a capability the tier lacks fails with the same error complete gives, as the stream’s first item.

fn complete<'life0, 'life1, 'async_trait>( &'life0 self, prompt: &'life1 Prompt, ) -> Pin<Box<dyn Future<Output = Result<Completion, TextModelError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Completes prompt.

fn supports(&self, tier: ModelTier, capability: Capability) -> bool

Whether this adapter can do capability for a prompt routed to tier. Defaults to false: a model that has not opted in is refused a tools-bearing prompt by RoutingTextModel and run_tool_loop before it is ever called, rather than sent a request it would silently drop the tools from. An adapter that carries Capability::Tools or Capability::Images overrides this to answer true for it.