Crate noema_router 

The initial text router for Noema.

Plain-text user requests are routed before any reasoning model runs. NeedleRouter uses Needle 2 to decide whether a request is a simple, deterministic application action — “open my flashcards”, “go to settings” — or whether it needs the full model:

User request
    ↓
NeedleRouter (Needle 2)
    ├── simple action → RoutedAction (model never runs)
    └── not recognised → Escalate → Gemma 4

The actions come from an ActionRegistry (defaulting to the six simple Agora actions from the plan); each action is exposed to Needle as a tool with a name and description, so the router needs no custom prompts to stay on-schema.

Usage

use noema_core::Noema;
use noema_router::NeedleRouter;

let router = NeedleRouter::from_default()?;
let noema = Noema::builder()
    .with_router(router)
    // .with_model(gemma)  // handles escalated requests
    .build()
    .await?;

Re-exports

pub use action::ActionRegistry;

pub use action::ActionSpec;

pub use formatter::NeedleToolFormatter;

pub use router::NeedleRouter;

Modules

action

The action registry: the simple application actions the router can emit.

formatter

The tool-specific Needle formatter.

router

The Needle-backed initial text router.