Print an error message.

Print a success message.

Print an info message.

Search using Brave Search API with comprehensive error handling and rate limiting. Args: query: Search query string api_

Print a formatted step with status.

Record a request timestamp.

Retry function with exponential backoff.

Validate and sanitize search query. Args: query: Raw search query Returns: Validated SearchQuery object

Check if a request can be made within rate limits.

Check if credentials file exists and is valid.

Analyze data and return structured report. Args: data_input: Raw data or description to analyze dependencies: Optional a

Ask the tool-enabled agent a question. Args: question: Question or request for the agent dependencies: Optional tool dep

Authenticate and return Gmail service instance.

Mock draft creation.

Extract key insights from search results. Args: results: List of SearchResult objects max_insights: Maximum number of in

Format search results for display or agent consumption. Args: results: List of SearchResult objects query: Original sear

Get LLM model configuration based on environment variables. Args: model_choice: Optional override for model choice Retu

Get configured LLM model based on environment settings.

Test Gmail API connection.

Wait if rate limit is exceeded.

Authenticate with Gmail API and return credentials.

Main function to chat with the agent. Args: message: User's message to the agent context: Optional conversation context

Check if credentials directory exists.

Check if credentials.json exists and is valid.

Create .env.example with Gmail configuration.

Demonstrate the basic chat agent with a simple conversation.

Demonstrate structured output validation.

Demonstrate the tool-enabled agent capabilities.

Display welcome message and setup instructions.

Get configured LLM model from environment settings.

Get configured LLM model from environment settings.

Get configured LLM model from environment settings.

Get LLM model configuration based on environment variables. Args: model_choice: Optional override for model choice Retu

Get global settings instance, creating it if needed.

Guide user through credentials download process.

Load settings with proper error handling and environment loading.

Main conversation loop.

Main setup function.

Main conversation loop.

Main validation function.

Main conversation loop.

Run OAuth2 authentication flow.

Pure function to search the web using Brave Search API. Args: api_key: Brave Search API key query: Search query

Pure function to search the web using Brave Search API. Args: api_key: Brave Search API key query: Search query

Stream agent interaction with real-time tool call display.

Stream agent interaction with real-time tool call display.

Stream agent response with real-time tool call visibility.

Test Gmail API access.

Validate required environment variables.

Validate that required setup is complete.

Synchronous version of analyze_data. Args: data_input: Raw data or description to analyze dependencies: Optional analysi

Analyze numerical data and provide statistical insights. Args: data_description: Description of what the numbers represent

Synchronous version of ask_agent. Args: question: Question or request for the agent Returns: String response fr

Handles OAuth2 authentication with Gmail API.

Perform mathematical calculations safely. Args: expression: Mathematical expression to evaluate description: Optional de

Synchronous version of chat_with_agent for simple use cases. Args: message: User's message to the agent context: Optiona

Compose email content based on context and research findings. Args: recipient_email: Email address of the recipient subj

Create an email draft based on research context using the Email Agent. Args: recipient_email: Email address of the recipient

Create an email draft based on research context using the Email Agent. Args: recipient_email: Email address of the recipient

Create email message structure for Gmail API. Args: to: List of recipient email addresses subject: Email subject

Create a Gmail draft email.

Creates a draft email in Gmail without sending.

Create a research agent with specified dependencies. Args: brave_api_key: Brave Search API key gmail_credentials_path: P

Custom function to generate specific responses.

Display welcome banner.

Dynamic system prompt that includes conversation context.

Create test dependencies for email agent.

Create an instance of the default event loop for the test session.

Create dependencies that will fail for testing error handling.

Format data into structured output. Args: data: Raw data to format format_type: Type of formatting (table, list, json)

Create dependencies from application settings.

Create fully configured mock dependencies.

Get the current date and time. Returns: Current timestamp in a readable format

Get information about current model configuration. Returns: Dictionary with model configuration info

Get information about current model configuration. Returns: Dictionary with model configuration info

Handle and format API errors for user-friendly messages. Args: error: The exception that occurred api_name: Name of the

Log API usage for monitoring and debugging. Args: api_name: Name of the API (e.g., "Brave Search", "Gmail") endpoint: AP

Mock API call tool for testing.

Mock database query tool for testing.

Create mock dependencies with configured responses.

Configure pytest with custom markers.

Create test dependencies for research agent.

Create sample search results for testing.

Search the web using Brave Search API. Args: query: Search query max_results: Maximum number of results to return (1-20)