Documentation Index
Fetch the complete documentation index at: https://docs.docex.dev/llms.txt
Use this file to discover all available pages before exploring further.
Providers
Providers are adapters around external APIs. The catalog describes capabilities, costs, and auth requirements. The planner resolves candidates per step. The executor runs strategies with automatic fallback.
Supported providers
| Provider | Capability | Best for |
|---|---|---|
| Anthropic | Multimodal vision (Claude) | Complex images requiring reasoning |
| OpenRouter | Gateway for multimodal vision models | Flexibility, model switching |
| Mistral OCR | OCR engine for image and PDF text extraction | High-accuracy text extraction from documents |
| Mock | Deterministic local responses | CI testing, offline development |
Provider catalog
The catalog (catalog.js) defines each provider’s:
- Capabilities — supported input types, output formats, max file size
- Cost model — per-request or per-token pricing
- Auth requirements — API key, OAuth, or none
- Reliability score — historical success rate for routing decisions
Automatic fallback
If a provider fails (network error, rate limit, invalid response), the executor automatically retries with the next candidate in the plan. This happens transparently to the caller.Mock provider
The mock provider is enabled by default in development and testing. It returns deterministic fixture responses based on file name patterns without calling external APIs or deducting wallet balance.In
NODE_ENV=production or when DOCEX_PROVIDER_MODE=managed, the mock provider is disabled unless DOCEX_ALLOW_MOCK_PROVIDER=1 is explicitly set.Provider mode
| Mode | Behavior |
|---|---|
default | Mock provider available, real providers used if configured |
managed | Mock provider disabled, only authenticated real providers are routed |
DOCEX_PROVIDER_MODE environment variable.