feat(beta): add xAI provider

[vvlrff]

Summary

Adds xAI Grok as a model provider.

import asyncio

from autogen.beta import Agent
from autogen.beta.config import XAIConfig
from autogen.beta.tools import WebSearchTool, XSearchTool


agent = Agent(
    "researcher",
    prompt="You are a research assistant.",
    config=XAIConfig(
        model="grok-4",
        api_key="xai-...",
        streaming=True,
        reasoning_effort="high",
    ),
    tools=[
        WebSearchTool(),
        XSearchTool(allowed_x_handles=["xai"]),
    ],
)


async def main() -> None:
    reply = await agent.ask("What did @xai announce about Grok this week?")
    print(reply.body)


asyncio.run(main())

Supported built-in tools

Tool	Status
WebSearchTool	✓
XSearchTool (new, xAI-only)	✓
CodeExecutionTool	✓
MCPServerTool	✓
ShellTool / MemoryTool / ImageGenerationTool / SkillsTool / WebFetchTool	unsupported → UnsupportedToolError

[marklysze]

Thanks so much @vvlrff!

[codecov]

Codecov Report

❌ Patch coverage is 85.77878% with 63 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
autogen/beta/config/xai/xai_client.py	77.77%	17 Missing and 13 partials ⚠️
autogen/beta/config/xai/mappers.py	84.21%	11 Missing and 16 partials ⚠️
autogen/beta/tools/builtin/x_search.py	93.18%	3 Missing ⚠️
autogen/beta/config/__init__.py	50.00%	2 Missing ⚠️
autogen/beta/config/xai/events.py	93.33%	0 Missing and 1 partial ⚠️

Files with missing lines	Coverage Δ
autogen/beta/config/xai/__init__.py	100.00% <100.00%> (ø)
autogen/beta/config/xai/config.py	100.00% <100.00%> (ø)
autogen/beta/tools/__init__.py	100.00% <ø> (ø)
autogen/beta/tools/builtin/__init__.py	100.00% <100.00%> (ø)
autogen/beta/config/xai/events.py	93.33% <93.33%> (ø)
autogen/beta/config/__init__.py	48.48% <50.00%> (-30.83%)	⬇️
autogen/beta/tools/builtin/x_search.py	93.18% <93.18%> (ø)
autogen/beta/config/xai/mappers.py	84.21% <84.21%> (ø)
autogen/beta/config/xai/xai_client.py	77.77% <77.77%> (ø)

... and 62 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.