Configuration Models

Config

Root configuration object for the Reflexio system. Every nested type below is linked — click through to see the fields each accepts.

Enterprise Offline Tuner Configuration

Enterprise get_config responses include a separate offline-tuner overlay:

{
  "offline_tuner_config": {
    "enabled": false
  }
}

offline_tuner_config is a response overlay, not a persisted shared Config field. The Python client's set_config method strips response overlays from Config model instances, including objects returned by get_config; a dictionary containing an overlay is rejected by strict shared-Config validation. The current release returns { "enabled": false } as availability status. Attempts to set enabled: true are unavailable: managed deployments return replay_unsupported or config_reset_incomplete, and self-hosted deployments return deployment_unsupported. There is no launched or reachable offline-tuner generator, optimizer, automatic application, publication, or successor workflow.

StorageConfig

StorageConfig is a union type — pass whichever variant matches your deployment. None is also accepted (no storage configured yet).

StorageConfigSQLite

Local SQLite storage. The default for Local OSS.

StorageConfigSupabase

Supabase-backed storage for Hosted Enterprise configurations.

StorageConfigPostgres

Native PostgreSQL-backed storage for RDS or bring-your-own Postgres deployments.

StorageConfigManagedSupabase

Read-only representation returned when Hosted Enterprise manages storage credentials.

ToolUseConfig

Defines a tool that the agent can use.

ProfileExtractorConfig

Configuration for profile extraction from interactions.

UserPlaybookExtractorConfig

Configuration for user-playbook extraction. Also exposed as PlaybookConfig (deprecated alias).

PlaybookAggregatorConfig

Configuration for playbook aggregation (clustering similar user playbooks into agent playbooks).

DeduplicationConfig

Controls bounded candidate generation when looking for existing playbooks to dedup against. The LLM consolidation stage makes the final duplicate decision.

RetrievalExperimentConfig

The one retrieval experiment currently assigning agent search traffic.

RetrievalExperimentRecord

Historical lifecycle metadata for a retrieval experiment. It contains all RetrievalExperimentConfig fields plus:

RetrievalFloorConfig

Configuration for the read-path relevance floor applied on unified search (/api/search). Retrieved candidates are reranked by a cross-encoder, and any result whose relevance score falls below the per-arm floor is dropped. Because filtering happens after retrieval, a search arm can return fewer than top_k results — including zero — when nothing clears its floor.

Floors are raw, model-specific cross-encoder logits, not probabilities, so they are not bounded to [0, 1] and can be negative. Leave a floor null to use the calibrated default for the reranker discovered from the private inference service; a numeric value, including 0.0, is preserved exactly.

PlaybookOptimizerConfig

Opt-in (disabled by default) GEPA-backed optimizer for playbook content. Requires exactly one assistant backend — webhook_url or assistant_script_path, not both.

PendingToolCallConfig

Configuration for non-blocking pending tool calls (async information tools) during classic extraction.

LineageGCConfig

Controls reclamation of retired profile and playbook tombstones after the audit and rollback window.

ExpiryReclamationConfig

GovernanceRetentionConfig

Hosted Enterprise retention policy for audit events. These fields are accepted but do not perform audit-event reclamation in Local OSS.

AgentSuccessConfig

Configuration for agent success evaluation.

ExtractionPreset

Named presets that bundle window_size and stride_size. Accepts a string.

• quick_chat — short conversations (support bots, quick Q&A). window_size=5, stride_size=3.
• standard — general-purpose conversational agents. window_size=10, stride_size=5. (default)
• long_form — long conversations (coding assistants, research). window_size=25, stride_size=10.
• high_volume — high-traffic agents (1000+ daily interactions). window_size=15, stride_size=8.

APIKeyConfig

API key configuration for LLM providers. When custom_endpoint is configured, it takes priority over all other providers for LLM completion calls (but not embeddings).

CustomEndpointConfig

OpenAI-compatible custom endpoint. Validated against SSRF: cloud metadata endpoints are always blocked, and when REFLEXIO_BLOCK_PRIVATE_URLS=true, literal private IPs plus hostnames resolving to private, loopback, link-local, reserved, multicast, or unspecified IPs are blocked.

OpenAIConfig

OpenAI API configuration. At least one of api_key or azure_config must be provided.

AzureOpenAIConfig

AnthropicConfig

OpenRouterConfig

GeminiConfig

MiniMaxConfig

DeepSeekConfig

DashScopeConfig

ZAIConfig

MoonshotConfig

XAIConfig

LLMConfig

LLM model configuration overrides. If a field is None, the system default is used.