# AI Workforce Model Routing (Internal)

This document defines internal route keys for AI Workforce. UI surfaces must
show capability tiers only and must not expose raw provider/model names.

## Route File

`configs/workforce_model_routes.json`

## Active Route Keys

- `main_orchestrator`
  - provider: `deepinfra`
  - model: `minimax-2.5`

- `heartbeat_fast`
  - provider: `deepinfra`
  - model: `deepseek-ai/DeepSeek-V4-Flash`
  - usage: automation heartbeat wake and quick anomaly checks

- `health_score_fast`
  - provider: `deepinfra`
  - model: `deepseek-ai/DeepSeek-V4-Flash`
  - usage: health score reasoning tier

- `default_subagent`
  - provider: `deepinfra`
  - model: `Qwen/Qwen3-235B-A22B-Instruct-2507`
  - usage: default MCP sub-agent, mini app, HTML5, project, workflow, knowledge

- `long_context`
  - provider: `deepinfra`
  - model: `meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8`
  - usage: long browser, document, and library context

- `vision_ui`
  - provider: `deepinfra`
  - model: `Qwen/Qwen3-VL-30B-A3B-Instruct`
  - usage: screenshots, visual inspection, UI-to-JSON, image understanding

- `user_openrouter_brainstorm`
  - provider: `user_openrouter`
  - model: `user_supplied`
  - usage: five-model Intelligence Brain Storm panel

- `user_fal_media`
  - provider: `user_fal_ai`
  - model: `user_supplied`
  - usage: STT, TTS, image, image-to-image, text-to-video, image-to-video

- `managed_together_image`
  - provider: `together_ai`
  - model: `user_selectable`
  - default model: `Qwen Image`
  - usage: AI Workforce managed text-to-image and image-to-image

- `managed_together_video`
  - provider: `together_ai`
  - model: `user_selectable`
  - default model: `ByteDance Seedance 1.0 Lite`
  - usage: AI Workforce managed text-to-video and image-to-video

- `user_media_api`
  - provider: `user_supplied`
  - model: `user_selectable`
  - usage: user-owned Fal.ai, Together, OpenRouter, or other media API

## Policy Integration

- `configs/model_policy.json` includes:
  - `heartbeat_monitor.model_tier = heartbeat_fast`
  - `health_score.model_tier = health_score_fast`
  - `miniapp.model_tier = default_subagent`
  - `html5.model_tier = default_subagent`
  - `vision.model_tier = vision_ui`
  - `media.model_tier = user_fal_media`
  - `intelligence_brainstorm.model_tier = user_openrouter_brainstorm`

- Bridge runtime writes route keys to events for audit:
  - `automation.heartbeat.wake` payload includes `route_key=heartbeat_fast`
  - `health.checked` payload includes `route_key=health_score_fast`

## UI Constraint

Cockpit, app.99pages.uk, and Telegram should present user-facing labels such as:

- `Fast diagnostic tier`
- `Heartbeat mode`

No raw provider/model names should appear in user-facing text.
