Returns a dictionary with:
- status: "ready", "browser_locked", or "error"
- error_message: Clear error message if there's an issue
- user_action_required: True if user needs to close browsers
- recommended_action: Specific instructions for the user
- available_browsers: List of detected browsers
- active_browsers: List of browsers that are currently running

IMPORTANT: If status is "browser_locked", you MUST tell the user to close the specified browser(s).

Args:
    time_period_in_days: Number of days of history to retrieve (default: 7)
    browser_type: Browser type ('firefox', 'chrome', 'safari', or None for auto-detect)
    all_browsers: If True, get history from all available browsers (default: True)

Returns:
    Either a list of history entries or a dictionary with partial results and browser status

This is the main analysis tool that consolidates all analysis options.

Args:
    time_period_in_days: Number of days of history to analyze (default: 7)
    analysis_type: Type of analysis to perform:
        - "quick_summary": Basic stats only (fastest)
        - "basic": Domain analysis and categorization (not yet implemented)
        - "comprehensive": Full analysis with sessions and insights (default)
    fast_mode: If True, limits analysis for faster processing (default: True)

Args:
    query: Search term to look for in URLs and titles