Bio Tools

from tools.bio_tools import BioTools

from tools.bio_tools import BioTools
import discord

# With Discord client (recommended)
bio_tools = BioTools(client=discord_client)

# Without client (will attempt to fetch from context)
bio_tools = BioTools()

details = await bio_tools.get_user_details(user_id=123456789)
print(details)

User Details for ID: 123456789
Username: JohnDoe
Display Name: John Doe
Bot: False
Created At: 2020-01-15 12:30:00
Avatar URL: https://cdn.discordapp.com/avatars/...
Joined Server: 2021-05-20 08:15:00
Server Nickname: Johnny
Roles: Admin, Developer, Community
Status: online
Desktop Status: Online
Activities:
  - Playing: Minecraft
  - Custom Status: Working on cool stuff 🚀
Banner URL: https://cdn.discordapp.com/banners/...
Accent Color: #5865F2
Bio: Full-stack developer and Discord enthusiast

result = await bio_tools.get_user_avatar(user_id=123456789)

if result.images:
    image = result.images[0]
    print(f"Avatar URL: {image.url}")
    print(f"Image ID: {image.id}")

def _get_discord_client(self, channel=None) -> Optional[discord.Client]:
    # Priority 1: Use injected client
    if self.client:
        return self.client
    
    # Priority 2: Get from channel state (works for DMs)
    if channel and hasattr(channel, '_state'):
        client = channel._state._get_client()
        if client:
            return client
    
    # Priority 3: Get from guild (guild channels only)
    if channel:
        guild = getattr(channel, 'guild', None)
        if guild and hasattr(guild, '_state'):
            client = guild._state._get_client()
            if client:
                return client
    
    return None

async def _fetch_user(self, user_id: int, channel=None):
    # For guild channels: Try to get Member (includes roles, status)
    if guild and not is_dm:
        member = guild.get_member(user_id)  # Cache first
        if not member:
            member = await guild.fetch_member(user_id)  # API fallback
        if member:
            return member
    
    # Fallback: Fetch User globally (works for both contexts)
    user = await client.fetch_user(user_id)
    return user

for activity in user.activities:
    if isinstance(activity, discord.CustomActivity):
        # Custom Status: Working on cool stuff 🚀
    elif isinstance(activity, discord.Spotify):
        # Listening to Spotify: Song Name by Artist
    elif isinstance(activity, discord.Game):
        # Playing: Minecraft
    elif isinstance(activity, discord.Streaming):
        # Streaming: Live Coding (https://twitch.tv/...)

from tools.history_tools import HistoryTools
from tools.bio_tools import BioTools

context_qna_agent = Agent(
    id="context-qna-agent",
    name="Chat Context Q&A",
    role="Answering questions about users, topics, and past conversations",
    model=OpenAILike(
        id=CONTEXT_AGENT_MODEL,
        max_tokens=8000,
        temperature=0.3,
        base_url=PROVIDER,
        api_key=CUSTOM_PROVIDER_API_KEY,
    ),
    tools=[HistoryTools(), BioTools(client=client)],
    add_datetime_to_context=True,
    timezone_identifier="Asia/Kolkata",
    instructions="""
    You specialize in answering questions about chat history, users, and topics.
    
    Use `get_user_details` to fetch user information.
    Use `read_chat_history` to get conversation context.
    
    Be precise with timestamps and attribute statements accurately.
    """
)

team = Team(
    name="Hero Team",
    model=model,
    db=db,
    members=agents,
    tools=[BioTools(client=client), CalculatorTools()],
    instructions=get_prompt(),
    num_history_runs=AGENT_HISTORY_RUNS,
    add_datetime_to_context=True,
    timezone_identifier="Asia/Kolkata",
    markdown=True,
    retries=AGENT_RETRIES,
    debug_mode=DEBUG_MODE,
)

from tools.bio_tools import BioTools

bio_tools = BioTools(client=discord_client)

# Get detailed user information
details = await bio_tools.get_user_details(user_id=123456789)
print(details)

from tools.bio_tools import BioTools

bio_tools = BioTools(client=discord_client)

# Fetch avatar as Image object
result = await bio_tools.get_user_avatar(user_id=123456789)

if result.images:
    avatar = result.images[0]
    print(f"Avatar: {avatar.url}")
    print(f"Prompt: {avatar.original_prompt}")

from tools.bio_tools import BioTools
from tools.history_tools import HistoryTools

# Create agent with both tools
agent = Agent(
    name="User Context Agent",
    model=my_model,
    tools=[BioTools(client=client), HistoryTools()],
    instructions="""
    Use get_user_details to learn about users.
    Use read_chat_history to understand conversation context.
    Combine both to provide comprehensive answers.
    """
)

# "Tell me about @JohnDoe"
# Agent calls get_user_details(user_id)
# Returns comprehensive profile information

# "What does Alice's avatar look like?"
# Agent calls get_user_avatar(user_id)
# Returns Image object for vision model analysis

# "What roles does Bob have?"
# Agent calls get_user_details(user_id)
# Extracts and returns role list

# "Is Charlie online?"
# Agent calls get_user_details(user_id)
# Returns status and platform presence

import logging

logger = logging.getLogger(__name__)

# Log levels used:
logger.debug(f"Could not get client from channel state: {e}")
logger.warning(f"Could not fetch full user profile: {e}")
logger.error(f"Error getting user details: {e}", exc_info=True)