AI Router Documentation

AI Router provides capability-based routing for WordPress 7.0 AI requests — automatically directing each request to the most appropriate provider configuration.

Why AI Router?

WordPress 7.0 introduced the AI Client SDK, but different providers excel at different tasks:

• OpenAI GPT-4 — text generation and chat
• DALL-E / Stable Diffusion — image generation
• Anthropic Claude — reasoning and analysis
• Local Ollama models — privacy and cost benefits

AI Router lets you configure multiple providers and route each capability to the best one.

Documentation

Document	Description
Routing	How routing decisions are made (priority, fallbacks)
Data Model	Configuration, RequestContext, and Vocabulary DTOs
Provider Discovery	How AI providers are discovered and configured
WordPress Integration	Hooks, REST API, credential sync
Extensibility	Filters, actions, security considerations

Architecture Overview

sequenceDiagram
    participant App as Plugin/Theme
    participant Router as AI Router
    participant Map as CapabilityMap
    participant Repo as ConfigRepository
    participant Provider as AI Provider

    App->>Router: AI Request (e.g., text_generation)
    Router->>Map: Check explicit mapping
    alt Mapping exists
        Map-->>Router: Mapped config ID
        Router->>Repo: Get config
        Repo-->>Router: Configuration
    else No mapping
        Router->>Repo: Get default config
        alt Default supports capability
            Repo-->>Router: Default configuration
        else Default doesn't support
            Router->>Repo: Find any supporting config
            Repo-->>Router: Fallback (sorted by priority)
        end
    end
    Router->>Provider: Route request
    Note over Provider: OpenAI, Anthropic,<br/>Azure OpenAI, Ollama

Layers

Layer	Components
Admin UI	ConnectorsIntegration.php, connectors.js
REST API	ConfigurationsController.php
Domain	ConfigurationService.php, Vocabulary.php
Core Logic	Router.php, CapabilityMap.php, ConnectorSync.php, ProviderDiscovery.php
Data	ConfigurationRepository.php, Configuration.php, RequestContext.php
Storage	wp_options

Directory Structure

ai-router/
├── src/
│   ├── DTO/
│   │   ├── Configuration.php         # Immutable config data object
│   │   └── RequestContext.php        # Per-request routing state
│   ├── Repository/
│   │   └── ConfigurationRepository.php
│   ├── Service/
│   │   └── ConfigurationService.php  # Domain logic
│   ├── Admin/
│   │   └── ConnectorsIntegration.php
│   ├── Rest/
│   │   └── ConfigurationsController.php
│   ├── Vocabulary.php
│   ├── CapabilityMap.php
│   ├── ConnectorSync.php
│   ├── Router.php
│   └── ProviderDiscovery.php
├── src/js/
│   └── connectors.js
└── tests/
    ├── php/   # PHPUnit (126 tests)
    └── js/    # Vitest (6 tests)

Supported Capabilities

Capability	Description
text_generation	Generate text responses (GPT, Claude, etc.)
chat_history	Maintain conversation context
image_generation	Generate images (DALL-E, Stable Diffusion)
embedding_generation	Create vector embeddings
text_to_speech_conversion	Convert text to audio
speech_generation	Generate speech/audio
music_generation	Generate music
video_generation	Generate video content

📦 Source: soderlind/ai-router · Edit on GitHub