{

"id": "xai",

"activation": {

"onStartup": false

},

"enabledByDefault": true,

"providers": ["xai"],

"providerCatalogEntry": "./provider-discovery.ts",

"modelIdNormalization": {

"providers": {

"xai": {

"aliases": {

"grok-4.20-experimental-beta-0304-reasoning": "grok-4.20-beta-latest-reasoning",

"grok-4.20-experimental-beta-0304-non-reasoning": "grok-4.20-beta-latest-non-reasoning",

"grok-4.20-reasoning": "grok-4.20-beta-latest-reasoning",

"grok-4.20-non-reasoning": "grok-4.20-beta-latest-non-reasoning"

}

}

}

},

"providerEndpoints": [

{

"endpointClass": "xai-native",

"hosts": ["api.x.ai"]

}

],

"providerRequest": {

"providers": {

"xai": {

"family": "xai"

}

}

},

"syntheticAuthRefs": ["xai"],

"setup": {

"providers": [

{

"id": "xai",

"envVars": ["XAI_API_KEY"]

}

]

},

"providerAuthChoices": [

{

"provider": "xai",

"method": "api-key",

"choiceId": "xai-api-key",

"choiceLabel": "xAI API key",

"groupId": "xai",

"groupLabel": "xAI (Grok)",

"groupHint": "API key or browser OAuth",

"onboardingFeatured": true,

"optionKey": "xaiApiKey",

"cliFlag": "--xai-api-key",

"cliOption": "--xai-api-key <key>",

"cliDescription": "xAI API key"

},

{

"provider": "xai",

"method": "oauth",

"choiceId": "xai-oauth",

"choiceLabel": "xAI OAuth",

"choiceHint": "Browser sign-in for eligible xAI accounts",

"groupId": "xai",

"groupLabel": "xAI (Grok)",

"groupHint": "API key or browser OAuth",

"onboardingFeatured": true

},

{

"provider": "xai",

"method": "device-code",

"choiceId": "xai-device-code",

"choiceLabel": "xAI device code",

"choiceHint": "Remote-friendly browser sign-in without a localhost callback",

"groupId": "xai",

"groupLabel": "xAI (Grok)",

"groupHint": "API key or browser OAuth",

"onboardingFeatured": true

}

],

"uiHints": {

"webSearch.apiKey": {

"label": "Grok Search API Key",

"help": "Optional xAI API key for Grok web search; xAI OAuth or XAI_API_KEY can satisfy it.",

"sensitive": true

},

"webSearch.model": {

"label": "Grok Search Model",

"help": "Grok model override for web search."

},

"webSearch.baseUrl": {

"label": "Grok Search Base URL",

"help": "Optional xAI Responses API base URL for Grok web_search and x_search fallbacks."

},

"webSearch.inlineCitations": {

"label": "Inline Citations",

"help": "Include inline markdown citations in Grok responses."

},

"codeExecution.enabled": {

"label": "Enable Code Execution",

"help": "Enable the code_execution tool for remote xAI sandbox analysis."

},

"xSearch.enabled": {

"label": "Enable X Search",

"help": "Enable the x_search tool for searching X posts with xAI."

},

"xSearch.model": {

"label": "X Search Model",

"help": "xAI model override for x_search."

},

"xSearch.baseUrl": {

"label": "X Search Base URL",

"help": "Optional xAI Responses API base URL for x_search requests."

},

"xSearch.inlineCitations": {

"label": "X Search Inline Citations",

"help": "Keep inline markdown citations from xAI in x_search responses when available."

},

"xSearch.maxTurns": {

"label": "X Search Max Turns",

"help": "Optional max internal tool turns xAI may use per x_search request."

},

"xSearch.timeoutSeconds": {

"label": "X Search Timeout",

"help": "Timeout in seconds for x_search requests."

},

"xSearch.cacheTtlMinutes": {

"label": "X Search Cache TTL",

"help": "Cache TTL in minutes for x_search results."

},

"codeExecution.model": {

"label": "Code Execution Model",

"help": "xAI model override for code_execution."

},

"codeExecution.maxTurns": {

"label": "Code Execution Max Turns",

"help": "Optional max internal tool turns xAI may use for code_execution."

},

"codeExecution.timeoutSeconds": {

"label": "Code Execution Timeout",

"help": "Timeout in seconds for code_execution requests."

}

},

"contracts": {

"webSearchProviders": ["grok"],

"videoGenerationProviders": ["xai"],

"mediaUnderstandingProviders": ["xai"],

"speechProviders": ["xai"],

"realtimeTranscriptionProviders": ["xai"],

"imageGenerationProviders": ["xai"],

"tools": ["code_execution", "x_search"]

},

"mediaUnderstandingProviderMetadata": {

"xai": {

"capabilities": ["audio"],

"defaultModels": {

"audio": "grok-stt"

},

"autoPriority": {

"audio": 25

}

}

},

"toolMetadata": {

"code_execution": {

"authSignals": [

{

"provider": "xai"

}

],

"configSignals": [

{

"rootPath": "plugins.entries.xai.config",

"overlayPath": "webSearch",

"required": ["apiKey"]

},

{

"rootPath": "tools.web.search.grok",

"required": ["apiKey"]

}

]

},

"x_search": {

"authSignals": [

{

"provider": "xai"

}

],

"configSignals": [

{

"rootPath": "plugins.entries.xai.config",

"overlayPath": "webSearch",

"required": ["apiKey"]

},

{

"rootPath": "tools.web.search.grok",

"required": ["apiKey"]

}

]

}

},

"configContracts": {

"compatibilityRuntimePaths": ["tools.web.search.apiKey"]

},

"configSchema": {

"type": "object",

"additionalProperties": false,

"properties": {

"webSearch": {

"type": "object",

"additionalProperties": false,

"properties": {

"apiKey": {

"type": ["string", "object"]

},

"model": {

"type": "string"

},

"baseUrl": {

"type": "string"

},

"inlineCitations": {

"type": "boolean"

}

}

},

"xSearch": {

"type": "object",

"additionalProperties": false,

"properties": {

"enabled": {

"type": "boolean"

},

"model": {

"type": "string"

},

"baseUrl": {

"type": "string"

},

"inlineCitations": {

"type": "boolean"

},

"maxTurns": {

"type": "number"

},

"timeoutSeconds": {

"type": "number"

},

"cacheTtlMinutes": {

"type": "number"

}

}

},

"codeExecution": {

"type": "object",

"additionalProperties": false,

"properties": {

"enabled": {

"type": "boolean"

},

"model": {

"type": "string"

},

"maxTurns": {

"type": "number"

},

"timeoutSeconds": {

"type": "number"

}

}

}

}

}

}