Add SuperOptiX integration for AG-UI

[Shashikant86]

🚀 Add SuperOptiX Integration for AG-UI

📋 Overview

This PR adds SuperOptiX as a new AG-UI integration, enabling seamless integration between SuperOptiX agents and the AG-UI ecosystem. SuperOptiX is a DSPy-powered agent framework for agent development and optimization.

✨ What's Added

Complete Integration Package

• TypeScript SDK: @ag-ui/superoptix package for client-side integration
• Python Server: ag-ui-superoptix package with FastAPI endpoint
• Dojo Integration: Full integration into the AG-UI demo application
• Self-contained Setup: Users create their own SuperOptiX projects. See example_server.py

Core Features

• Agentic Chat: Real-time streaming chat with SuperOptiX agents
• Tool Integration: Full support for AG-UI tool calls
• State Management: Proper state handling and synchronization
• Event Streaming: Server-Sent Events (SSE) for real-time communication

AG-UI Standards Compliance

✅ Protocol Compliance

• Implements all required AG-UI event types (RUN_STARTED, RUN_FINISHED, RUN_ERROR, TEXT_MESSAGE_CHUNK, TOOL_CALL_CHUNK, etc.)
• Proper AG-UI message structure and tool call support
• Complete state synchronization and lifecycle management

✅ Integration Patterns

• Follows established patterns (mirrors CrewAI, LangGraph integrations)
• Standard package structure (TypeScript + Python packages)
• Complete dojo integration with menu and agent configuration

Testing Instructions

Quick Start

# 1. Build AG-UI packages
cd typescript-sdk && pnpm build

# 2. Install SuperOptiX integration
cd integrations/superoptix/python && pip install -e .

# 3. Create your SuperOptiX project
super init swe && cd swe
super agent pull developer && super agent compile developer

# 4. Configure server (edit example_server.py PROJECT_ROOT)

# 5. Start servers
python example_server.py  # SuperOptiX server on :8000
cd ../../apps/dojo && pnpm dev  # AG-UI dojo on :3000

# 6. Test: http://localhost:3000/superoptix/feature/agentic_chat

Available Features

• Agentic Chat: /superoptix/feature/agentic_chat
• Human in the Loop: /superoptix/feature/human_in_the_loop
• Tool-based Generative UI: /superoptix/feature/tool_based_generative_ui
• Agentic Generative UI: /superoptix/feature/agentic_generative_ui
• Shared State: /superoptix/feature/shared_state
• Predictive State Updates: /superoptix/feature/predictive_state_updates

Architecture

AG-UI Client ←→ FastAPI Server ←→ SuperOptiX DSPyRunner ←→ Compiled Agent Pipeline

Benefits

For SuperOptiX Users

• Access to AG-UI ecosystem tools and components
• Rich UI with CopilotKit and other AG-UI frontends
• AG-UI tool ecosystem integration

For AG-UI Community

• New DSPy-powered agent framework
• SuperOptiX's agent optimization capabilities
• Advanced agent development patterns

---

🎉 Ready for Review! This integration brings SuperOptiX's powerful agent capabilities to the AG-UI ecosystem while maintaining full protocol compliance and following established patterns. Users create their own SuperOptiX projects, making the integration lightweight and flexible.

[vercel]

@Shashikant86 is attempting to deploy a commit to the CopilotKit Team on Vercel.

A member of the Team first needs to authorize it.