🤖 Zai Bridge - Professional AI-to-AI Extension

Enhanced Professional Bridge for Intelligent AI-to-AI Communication between Zrald MCP Server and VSCode AI Assistant

🚀 What This Extension Does

This VSCode extension serves as an enhanced professional bridge that enables seamless AI-to-AI communication between:

1. Zrald MCP Server (generates AI prompts via OpenRouter with multiple API keys)
2. VSCode AI Assistant (processes prompts and provides responses)
3. Back to Zrald MCP Server (receives responses for next iteration with acknowledgment)

🔄 How It Works

User: actloop improve code
    ↓
Zrald MCP Server: Generates improvement prompts via OpenRouter
    ↓
Zai Bridge Extension: Gets prompts from MCP server
    ↓
VSCode AI Assistant: Processes prompts automatically
    ↓
Zai Bridge Extension: Captures AI responses with acknowledgment
    ↓
Zrald MCP Server: Receives responses for next iteration
    ↓
🔄 Loop continues automatically with sequential processing!

⚙️ Enhanced Features

• 🔄 Ultra-Fast Polling: 500ms polling for instant response (configurable)
• 🤖 Professional AI Integration: Advanced VSCode AI assistant integration
• 📡 Acknowledgment System: Automatic response capture with completion acknowledgment
• 📊 Real-Time Monitoring: Live status in VSCode status bar with detailed info
• ⚙️ Advanced Configuration: Multiple server URLs, retry logic, error recovery
• 🛡️ Enhanced Error Handling: Multi-layer fallback with automatic recovery
• 🔄 Sequential Processing: Ensures AI agent completes before next iteration
• 🚀 Auto-Recovery: Automatic restart on errors or disconnections

🛠️ Installation

Method 1: From VSIX (Recommended)

1. Download the .vsix file
2. Open VSCode
3. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
4. Type "Extensions: Install from VSIX"
5. Select the downloaded .vsix file

Method 2: From Source

1. Clone this repository
2. Run npm install
3. Run npm run compile
4. Press F5 to launch extension development host

🚀 Usage

1. Start the Zai Bridge

• Open Command Palette (Ctrl+Shift+P)
• Run "🤖 Start Zai Bridge"
• Or click the Zai robot icon in status bar

2. Configure Settings

• Open Settings (Ctrl+,)
• Search for "Zai Bridge"
• Configure:
  • MCP Server URL: Default http://localhost:7878
  • Poll Interval: Default 500ms (ultra-fast)
  • Auto Start: Default true

3. Use with Zrald MCP Server

# Start Zrald MCP server
npx -y zai-mcp-server@latest

# In MCP client, activate AI-to-AI loop
actloop improve mobile app performance

# Zai Bridge will automatically:
# 1. Get prompts from Zrald MCP server
# 2. Send to VSCode AI assistant
# 3. Capture responses with acknowledgment
# 4. Send back to Zrald MCP server
# 5. Continue the infinite loop with sequential processing!

📊 Status Indicators

• 🤖 $(sync~spin) Zai Bridge: Running and polling
• 🤖 $(circle-slash) Zai Bridge: Stopped
• 🤖 $(error) Zai Bridge: Error occurred
• 🤖 $(check) Zai Bridge: Successfully processed iteration

⚙️ Configuration Options

🔧 Commands

• 🤖 Start Zai Bridge: Start the bridge service
• ⏹️ Stop Zai Bridge: Stop the bridge service
• 📊 Bridge Status: Show current status
• ⚙️ Configure Bridge: Open settings

🛡️ Enhanced Error Handling

The Zai Bridge includes multiple professional fallback mechanisms:

1. Primary: VSCode AI Assistant API with acknowledgment
2. Secondary: Chat Participant API with retry logic
3. Tertiary: User input dialog with timeout
4. Fallback: Notification with manual response
5. Auto-Recovery: Automatic restart on connection loss

🔍 Troubleshooting

Bridge Not Starting

• Check Zrald MCP server is running at http://localhost:7878
• Verify network connectivity
• Check VSCode output panel for errors
• Ensure port 7878 is not blocked

No Prompts Received

• Ensure Zrald MCP server has active AI loops (actloop command)
• Check polling interval settings (default 500ms)
• Verify MCP server is generating prompts via OpenRouter
• Check if multiple OpenRouter API keys are configured

AI Assistant Not Responding

• Check VSCode AI assistant is available and enabled
• Try manual response via input dialog
• Check extension permissions
• Verify acknowledgment system is working

📝 Development

Building

npm install
npm run compile

Testing

npm run test

Packaging

npm run package

🤝 Contributing

1. Fork the repository
2. Create feature branch
3. Make changes
4. Test thoroughly
5. Submit pull request

📄 License

MIT License - see LICENSE file for details

🔗 Related Projects

• Zrald MCP Server
• MCP Protocol
• OpenRouter API

🤖 Zai Bridge by Zrald - Enabling Professional AI-to-AI Communication!