feat: migrate from openai to google adk multi-agent system

- Implemented hierarchical multi-agent architecture using Google ADK
- Created CoordinatorAgent, MathAgent, TextAgent, and InfoAgent
- Added specialized tools for each agent type
- Updated streaming response handling for ADK integration
- Added comprehensive documentation and migration guide

feat: migrate from openai to google adk multi-agent system

- Replace OpenAI integration with Google ADK multi-agent architecture
- Add specialized agents: MathAgent, TextAgent, InfoAgent, and CoordinatorAgent
- Implement custom tools for calculations, text processing, and information retrieval
- Add real-time status updates showing agent activity and tool usage
- Update streaming implementation to work with ADK event system
- Add comprehensive documentation including migration guide and status implementation guide

BREAKING CHANGE: Requires Google ADK authentication instead of OpenAI API key. Update environment variables to use GOOGLE_APPLICATION_CREDENTIALS or GOOGLE_API_KEY.

chore(git): ignore .vscode directory and update assistant status text

Updated .gitignore to exclude .vscode settings directory. Also refined the
assistant's loading status message from "is working..." to "is thinking..."
to better reflect the AI processing state and added clarifying comments
about the UI elements being updated.

Author: boffti

.gitignore

@@ -38,3 +38,4 @@ logs/
 *.db
 .pytype/
 .idea/
+.vscode/

.vscode/.gitignore

@@ -0,0 +1,14 @@
+{
+    "files.exclude": {
+        "**/.git": true,
+        "**/.svn": true,
+        "**/.hg": true,
+        "**/.DS_Store": true,
+        "**/Thumbs.db": true,
+        "**/.classpath": true,
+        "**/.project": true,
+        "**/.settings": true,
+        "**/.factorypath": true
+    },
+    "hide-files.files": []
+}

.vscode/settings.json

@@ -0,0 +1,137 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+This is a Slack AI Agent App built with Bolt for Python, implementing a multi-agent system using Google ADK (Agent Development Kit) with Gemini models. The app provides AI-powered assistance through Slack's Assistant interface with streaming responses.
+
+## Development Commands
+
+### Environment Setup
+
+```sh
+# Create and activate virtual environment
+python3 -m venv .venv
+source .venv/bin/activate  # Windows: .\.venv\Scripts\Activate
+
+# Install dependencies
+pip install -r requirements.txt
+```
+
+### Running the App
+
+```sh
+# Using Slack CLI (recommended)
+slack run
+
+# Or directly with Python
+python3 app.py
+```
+
+### Code Quality
+
+```sh
+# Lint code
+ruff check
+
+# Format code
+ruff format
+```
+
+### Testing
+
+```sh
+# Run all tests
+pytest
+
+# Run specific test file
+pytest tests/test_file.py
+
+# Run with verbose output
+pytest -v
+```
+
+## Architecture
+
+### Multi-Agent System
+
+The application uses Google ADK to implement a hierarchical multi-agent architecture:
+
+- **CoordinatorAgent** (`ai/agents.py:55-78`): Root agent that analyzes user requests and delegates to specialized agents
+- **MathAgent** (`ai/agents.py:20-28`): Handles mathematical calculations and numerical operations
+- **TextAgent** (`ai/agents.py:31-40`): Processes text formatting, word counting, and list creation
+- **InfoAgent** (`ai/agents.py:43-52`): Provides current time, help information, and general queries
+
+Each agent uses the `gemini-2.0-flash` model and has access to specific tools defined in `ai/tools.py`.
+
+### Request Flow
+
+1. **Entry Point** (`app.py`): Thin entry point that initializes the Bolt app and registers listeners
+2. **Listener Registration** (`listeners/__init__.py`): Routes incoming Slack events to appropriate handlers
+3. **Event Handlers**:
+   - `listeners/assistant/message.py`: Handles messages in assistant threads
+   - `listeners/events/app_mentioned.py`: Handles @mentions of the bot
+   - `listeners/assistant/assistant_thread_started.py`: Sets up suggested prompts when threads start
+4. **LLM Integration** (`ai/llm_caller.py`): Provides `call_llm()` async generator that streams responses from the ADK agent system
+5. **Response Streaming**: Uses Slack's `chat_stream` API to stream chunks back to the user in real-time
+
+### Key Design Patterns
+
+- **Async Streaming**: All LLM responses are streamed using async generators to provide real-time feedback
+- **Event Loop Management**: Creates new event loops in synchronous Bolt handlers to call async ADK functions
+- **Session Management**: Uses thread timestamps as session IDs to maintain conversation context
+- **Tool-Based Architecture**: Agents use Python functions as tools, automatically exposed to the LLM by ADK
+
+## Configuration
+
+### Required Environment Variables
+
+```sh
+SLACK_BOT_TOKEN=xoxb-...         # From OAuth & Permissions
+SLACK_APP_TOKEN=xapp-...         # App-level token with connections:write
+```
+
+### Google ADK Authentication (one of):
+
+```sh
+# Option 1: Service account (production)
+GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
+
+# Option 2: API key (development)
+GOOGLE_API_KEY=your-api-key
+
+# Option 3: Use `gcloud auth application-default login`
+```
+
+## Adding New Agents
+
+To add a new specialized agent:
+
+1. Create tools in `ai/tools.py` following the existing pattern (functions returning `Dict[str, Any]`)
+2. Define the agent in `ai/agents.py`:
+   ```python
+   new_agent = Agent(
+       name="AgentName",
+       model="gemini-2.0-flash",
+       description="When to use this agent",
+       instruction="Detailed instructions for the agent",
+       tools=[tool1, tool2],
+   )
+   ```
+3. Add the agent to `coordinator_agent.sub_agents` list
+4. Update the coordinator's instruction to explain when to delegate to the new agent
+
+## Slack-Specific Conventions
+
+- **Markdown Compatibility**: Agents are instructed to convert markdown to Slack-compatible format
+- **Slack Syntax Preservation**: User mentions (`<@USER_ID>`) and channel mentions (`<#CHANNEL_ID>`) must be preserved as-is in responses
+- **Status Messages**: Use playful loading messages during "thinking" state (see `listeners/assistant/message.py:40-46`)
+- **Feedback Blocks**: Responses include feedback blocks for user interaction (`listeners/views/feedback_block.py`)
+
+## Project Structure Notes
+
+- `/listeners`: Organized by Slack Platform feature (events, assistant, actions, views)
+- `/ai`: Contains all LLM and agent-related code, separated from Slack-specific logic
+- Socket Mode is used for local development (no public URL required)
+- For OAuth/distribution, use `app_oauth.py` instead of `app.py`

CLAUDE.md

@@ -0,0 +1,93 @@
+"""
+Multi-agent system using Google ADK.
+
+This module defines a multi-agent system with specialized agents for different tasks.
+"""
+
+from google.adk.agents import Agent
+from google.adk.models.lite_llm import LiteLlm
+
+from .tools import (
+    get_current_time,
+    calculate,
+    format_text,
+    count_words,
+    create_list,
+    get_help_info,
+)
+
+# Configure OpenAI model via LiteLLM
+# Requires OPENAI_API_KEY environment variable
+openai_model = LiteLlm(model="openai/gpt-4o")
+
+
+# Specialized agent for mathematical operations
+math_agent = Agent(
+    name="MathAgent",
+    model=openai_model,
+    description="Specializes in mathematical calculations and numerical operations. Use this agent for any math-related queries.",
+    instruction="""You are a mathematical expert. You can perform calculations, solve equations,
+    and help with numerical problems. Use the calculate tool to evaluate mathematical expressions.
+    Always explain your calculations clearly.""",
+    tools=[calculate],
+)
+
+# Specialized agent for text processing
+text_agent = Agent(
+    name="TextAgent",
+    model=openai_model,
+    description="Specializes in text processing, formatting, and analysis. Use this agent for text manipulation tasks.",
+    instruction="""You are a text processing expert. You can format text, count words,
+    create lists, and analyze text content. Use the available tools to help users with text-related tasks.
+    When you include markdown text, convert them to Slack compatible ones.
+    When a prompt has Slack's special syntax like <@USER_ID> or <#CHANNEL_ID>, you must keep them as-is in your response.""",
+    tools=[format_text, count_words, create_list],
+)
+
+# Specialized agent for information and utilities
+info_agent = Agent(
+    name="InfoAgent",
+    model=openai_model,
+    description="Provides general information, current time, and help about available capabilities.",
+    instruction="""You are an information assistant. You can provide the current time,
+    help users understand what tools are available, and answer general questions.
+    When you include markdown text, convert them to Slack compatible ones.
+    When a prompt has Slack's special syntax like <@USER_ID> or <#CHANNEL_ID>, you must keep them as-is in your response.""",
+    tools=[get_current_time, get_help_info],
+)
+
+# Coordinator agent that routes requests to specialized agents
+coordinator_agent = Agent(
+    name="CoordinatorAgent",
+    model=openai_model,
+    description="Main coordinator that routes user requests to specialized agents.",
+    instruction="""You are a helpful assistant coordinator in a Slack workspace.
+    Users in the workspace will ask you to help them with various tasks.
+
+    You have access to specialized agents:
+    - MathAgent: For mathematical calculations and numerical operations
+    - TextAgent: For text processing, formatting, and analysis
+    - InfoAgent: For general information, current time, and help
+
+    Analyze the user's request and delegate to the appropriate specialized agent:
+    - For math problems, calculations, or numerical queries -> use MathAgent
+    - For text formatting, word counting, or list creation -> use TextAgent
+    - For time queries, help requests, or general information -> use InfoAgent
+    - For general conversation or questions that don't fit the above -> answer directly
+
+    When you include markdown text, convert them to Slack compatible ones.
+    When a prompt has Slack's special syntax like <@USER_ID> or <#CHANNEL_ID>, you must keep them as-is in your response.
+
+    Always be professional, helpful, and friendly in your responses.""",
+    sub_agents=[math_agent, text_agent, info_agent],
+)
+
+
+def get_root_agent() -> Agent:
+    """
+    Get the root coordinator agent for the multi-agent system.
+
+    Returns:
+        Agent: The coordinator agent that routes requests to specialized agents.
+    """
+    return coordinator_agent