Rich integration

# Use in place of the ordinary handler; bot, dp and sk are initialized.
from dataclasses import replace
from aiogram import F, types
from sidekick_ads.router import sidekick_router

dp.include_router(sidekick_router(sk))

@dp.message(F.text, F.chat.type == "private")
async def handle_rich(message: types.Message):
    if message.from_user is None:
        return
    reply = await get_llm_response(message.text)  # Return plain text.
    result = await sk.inject(
        user_id=message.from_user.id,
        message=reply,
        language_code=message.from_user.language_code or "en",
        accept_formats=["text", "response", "card", "consent", "quiz"],
        capabilities={
            "rich_messages": True,
            "callbacks": True,
            "custom_emoji": False,
        },
    )
    if result.send:
        # A rich scene contains only the ad. Send the reply first.
        await message.answer(reply, parse_mode=None)
        ad = result.ad or {}
        # Keep the text fallback ad-only to avoid repeating the reply.
        ad_only = replace(
            result,
            message="Ad\n" + ad.get("text", ""),
        )
        delivered = await sk.send(bot, message.chat.id, ad_only)
        if delivered is None:
            # Record a delivery failure; do not request another ad.
            pass
    else:
        await message.answer(
            result.message, reply_markup=result.keyboard, parse_mode=None
        )