# Theo · Routing Studio

> The visual editor that decides which engine answers which prompt. Intent rules, confidence floors, per-mode overrides, and a live test bench. Routing is a first-class product surface, not a hidden implementation detail.

Source of truth: https://hitheo.ai/routing-studio. Last updated: 2026-05-24.

## At a glance
- 3-panel editor. Cascade + Rules + Test Bench.
- 13+ canonical modes. Plus a fast / reason / code / motion / search / image / video / vision / document / genui / analyze / extract / stealth family.
- Live test bench. Type a prompt, see the resolved mode, see why.
- Confidence floor. PROMOTION_CONFIDENCE_FLOOR = 0.85. The intent classifier must clear this before overriding an explicit caller mode.

## The routing cascade (first match wins)
1. Agentic lock. Agentic modes (insurance_*, data_extraction) never get promoted. No classifier call.
2. Attachments → vision. Image attachments on a non-media caller route to the vision engine. Stealth collapses to stealth_image.
3. Skill exclusive override. An intensity-100 skill with a modelPreference wins, still honoring media safety rails.
4. Intent promotion. The intent classifier runs for every promotable caller (text modes + stealth_fast). Promotion fires when the classifier returns a different mode with confidence ≥ 0.85.
5. Stealth family preservation. Any promotion from a stealth_* caller is remapped to the matching stealth engine.
6. Conversation modeHint. Auto fallback when the context resolver surfaced a prior-artifact hint.
7. Requested mode. Default.

## Intent classifier
Two-tier:
- Keyword fast-path (<1 ms). Regex patterns match high-confidence (0.82–0.95) modes.
- LLM fallback (~300 ms). A fast reasoning model classifies into one of 13+ modes.

Default: "fast" mode at 0.5 confidence. The routing engine enforces the 0.85 floor before overriding an explicit caller mode.

## Response telemetry
Every completion emits a routing block: { requested_mode, resolved_mode, promoted, reason, explanation, optional classification / skill_override / locked_family }. Available in v1 JSON, playground SSE meta + done, and the standard chat-completion envelope as theo_metadata.routing.

## Decisions are auditable
The audit ledger records the requested mode, resolved mode, promotion reason, and (if a skill override fired) the skill slug + intensity. Pairs with the Memory Console for memory and the Guardrails dashboard for policy.

## Routing rules in your dashboard
Three rule kinds:
- Pattern rules. Regex / contains / equals matchers on the prompt or metadata.
- Class rules. Pin a request class (vision, research, code, document) to a specific engine.
- Engine pins. Force a particular engine even when the classifier disagrees.

## Related machine-readable files
- https://hitheo.ai/llms.txt — full index of every Theo machine-readable file.
- https://hitheo.ai/llms-full.txt — long-form knowledge bundle (single fetch).
- https://hitheo.ai/humans.txt — team and open-source credits.
- https://hitheo.ai/lawyers.txt — trademark notice and legal contact.
- https://hitheo.ai/.well-known/security.txt — security disclosure contact.