Market Research Team

# =========================
# Imports
# =========================

# --- Standard library ---
import base64
import json
import os
import re
from datetime import datetime
from io import BytesIO

# --- Third-party ---
import requests
import openai
from PIL import Image
from dotenv import load_dotenv
from IPython.display import Markdown, display
import aisuite

# --- Local / project ---
import tools
import utils


# =========================
# Environment & Client
# =========================
load_dotenv()
client = aisuite.Client()

tools.tavily_search_tool('trends in sunglasses fashion')

[{'title': 'Sunglasses from runways Fall 2025 Winter 2026 - YouTube',
  'content': "Sunglasses from runways Fall 2025 Winter 2026\nMM Design\n35700 subscribers\n275 likes\n8263 views\n20 Jul 2025\nYear-Round Sunglasses: Trends and Tips for Fall 2025 Winter 2026\n\nIn this episode of MM Design, Maria takes us through the must-have sunglasses trends spotted on the fall and winter 2025-2026 runways. From classic Aviator Glasses and retro-inspired oversized models to trendy tinted and sporty wraparound styles, you'll discover which frames best suit different face shapes and personal styles. Maria also shares practical advice on how to style these sunglasses to enhance any outfit, as well as insights into the versatility of prescription frames making a comeback. Tune in for expert tips on staying fashionable and well-protected all year round!\n\n00:00 Introduction to Year-Round Sunglasses\n01:22 Aviator Glasses\n02:53 Oversized Sunglasses: A Comeback\n04:43 Oval Shaped Sunglasses\n07:08 Narrow Frame Sunglasses\n08:52 Futuristic Shields and Wraparounds\n09:51 Tinted Lenses for Fall and Winter\n13:18 Prescription Glasses Trends\n\nInstagram @mm_go_design\n\nFall 2025 Winter 2026 Fashion trend videos:\nColor trends: https://youtu.be/uk104CDIoc8\nColor combinations: https://youtu.be/6_3Qsuh3fGk\nPrint trends: https://youtu.be/e9HXZlnDxr4\nShoe trends: https://youtu.be/3Z52SXMsKO4\nOuterwear I: https://youtu.be/Es-oXY7K9gc\nOuterwear II: https://youtu.be/VhJJ_oCKCSA\nHeadwear: https://youtu.be/M2uJoVEtXes\nSunglasses: https://youtu.be/HBCw2na2uUA\n\nRunway shows featured: \nAcne Studios, Alexander McQueen, Burberry, Chanel, Chloe, Coach, Diesel, Dolce Gabbana, Dsquared2, Etro, Versace, Fendi, Ferragamo, Ferrari, Givenchy, Gucci, Khaite, Louis Vuitton Max Mara, Michael Kors, Miu Miu.\n29 comments\n",
  'url': 'https://www.youtube.com/watch?v=HBCw2na2uUA'},
 {'title': "The Top Sunglasses Trends of 2025: Styles Everyone's Talking About",
  'content': '# The Top Sunglasses Trends of 2025: Styles Everyone’s Talking About From bold oversized frames to sleek sci-fi-inspired shields, and the understated elegance of transparent designs, we’ll unpack how each trend offers something unique for every style-savvy individual. ## Top Sunglasses Trends of 2025 The top sunglasses trends of 2025 represent the perfect blend of style, functionality, and personalization. From oversized frames and retro-inspired designs to futuristic shield sunglasses and sustainable collections, this year’s offerings have something for everyone. Explore our 2025 Sunglasses Collection to discover the latest trends in oversized sunglasses, colored lenses, and sustainable eyewear. The top trends in 2025 include oversized frames, futuristic shield sunglasses, transparent frames, retro-inspired designs, color-tinted lenses, hexagonal shapes, tailored eyewear, and tech-infused designs.',
  'url': 'https://topfoxx.com/en-au/blogs/news/the-top-sunglasses-trends-of-2025-styles-everyone-s-talking-about?srsltid=AfmBOorCpyGSshhY0PojTv_v525D6gpJQg8wa7He-3nHBOsPvk7MgNRi'},
 {'title': "2025's Top 10 Sunglasses Trends: Chrome Tints & '90s Style - Byrdie",
  'content': "+ Hair Styling # 2025's Top Sunglasses Trends to Try: Chrome Tints and '90s Silhouettes **Read on for 10 2025 sunglasses trends to try this spring and summer**, highlighting that there's plenty of ways to refresh your look, no matter your style. Sporty silhouettes are another standout sunglasses trend of the moment, with a major emphasis on designs that feel elevated and street style-ready. Colorful tinted lenses have gone through major stints of popularity over the decades, and 2025 is looking to be a new era for the recurrent sunglasses trend. The cat-eye sunglasses silhouette never goes out of style. * When Earlobes Aren’t Enough, Try Fall 2025’s Pierced Shoes Trend * This Wearable Shoe Trend Is What’s Missing From All of Your Fall ’Fits",
  'url': 'https://www.byrdie.com/2025-sunglasses-trends-11682002'},
 {'title': 'Tiny Sunglasses Style Trends For Small Faces in 2025 - Kraywoods',
  'content': "## Tiny Sunglasses Style Trends For Small Faces in 2025 # Tiny Sunglasses Style Trends The tiny sunglasses fashion trend came back from the 90's and has been going strong since a few years now! Small geometric frames are at the top of the tiny sunglasses trend. Embrace the trend of tiny sunglasses while making a bold fashion statement with the Scott sunglasses, a must-have accessory to elevate your everyday style. These sleek and fashion-forward slim aviator sunglasses are the epitome of sophistication and style for those who are looking to embrace the tiny frame trend. Join the tiny sunglasses fashion trend and make it your own! ### Tiny Sunglasses Style Trends For Small Faces in 2025",
  'url': 'https://www.kraywoods.com/blogs/our-stories/tiny-sunglasses-fashion-trend?srsltid=AfmBOoqpxiksWt1QRBKcAV4qBPhoKjTtGyMPV1EvJC-CKLqFhJRnY70P'},
 {'title': '2025 eyewear trends: The best sunglasses to shop now',
  'content': "# This summer's 7 sunglasses trends to shop now ## How do I choose the right sunglasses for my face shape? Characterised by full cheeks, a rounded chin, and equal width and length, round faces benefit from angular frames such as rectangular, square, or cat-eye sunglasses. Bottom-heavy frames, aviators, or round sunglasses soften the forehead and add width to the lower part of the face. Oversized sunglasses, wraparound styles, and rectangular frames are perfect choices. Photo: Lacoste spring/summer 2025 ## White frame sunglasses ## Cat eye sunglasses ##### Runway sunglasses ##### Metal frame sunglasses Photo: Chanel spring/summer 2025 ##### Square-frame acetate and gold-tone sunglasses ##### Wayfarer sunglasses ## Oversized sunglasses ##### Square sunglasses ##### Sunglasses square shape ## Aviator sunglasses",
  'url': 'https://www.voguescandinavia.com/articles/best-eyewear-sunglasses-trends-shop-2025'}]

tools.product_catalog_tool()

[{'name': 'Aviator',
  'item_id': 'SG001',
  'description': 'Originally designed for pilots, these teardrop-shaped lenses with thin metal frames offer timeless appeal. The large lenses provide excellent coverage while the lightweight construction ensures comfort during long wear.',
  'quantity_in_stock': 23,
  'price': 103},
 {'name': 'Wayfarer',
  'item_id': 'SG002',
  'description': 'Featuring thick, angular frames that make a statement, these sunglasses combine retro charm with modern edge. The rectangular lenses and sturdy acetate construction create a confident look.',
  'quantity_in_stock': 6,
  'price': 92},
 {'name': 'Mystique',
  'item_id': 'SG003',
  'description': 'Inspired by 1950s glamour, these frames sweep upward at the outer corners to create an elegant, feminine silhouette. The subtle curves and often embellished temples add sophistication to any outfit.',
  'quantity_in_stock': 3,
  'price': 88},
 {'name': 'Sport',
  'item_id': 'SG004',
  'description': 'Designed for active lifestyles, these wraparound sunglasses feature a single curved lens that provides maximum coverage and wind protection. The lightweight, flexible frames include rubber grips.',
  'quantity_in_stock': 11,
  'price': 144},
 {'name': 'Round',
  'item_id': 'SG005',
  'description': 'Circular lenses set in minimalist frames create a thoughtful, artistic appearance. These sunglasses evoke a scholarly or creative vibe while remaining effortlessly stylish.',
  'quantity_in_stock': 10,
  'price': 86}]

def market_research_agent(return_messages: bool = False):

    utils.log_agent_title_html("Market Research Agent", "🕵️‍♂️")

    prompt_ = f"""
You are a fashion market research agent tasked with preparing a trend analysis for a summer sunglasses campaign.

Your goal:
1. Explore current fashion trends related to sunglasses using web search.
2. Review the internal product catalog to identify items that align with those trends.
3. Recommend one or more products from the catalog that best match emerging trends.
4. If needed, today date is {datetime.now().strftime("%Y-%m-%d")}.

You can call the following tools:
- tavily_search_tool: to discover external web trends.
- product_catalog_tool: to inspect the internal sunglasses catalog.

Once your analysis is complete, summarize:
- The top 2–3 trends you found.
- The product(s) from the catalog that fit these trends.
- A justification of why they are a good fit for the summer campaign.
"""
    messages = [{"role": "user", "content": prompt_}]
    tools_ = tools.get_available_tools()

    while True:
        response = client.chat.completions.create(
            model="openai:o4-mini",
            messages=messages,
            tools=tools_,
            tool_choice="auto"
        )

        msg = response.choices[0].message

        if msg.content:
            utils.log_final_summary_html(msg.content)
            return (msg.content, messages) if return_messages else msg.content

        if msg.tool_calls:
            for tool_call in msg.tool_calls:
                utils.log_tool_call_html(tool_call.function.name, tool_call.function.arguments)
                result = tools.handle_tool_call(tool_call)
                utils.log_tool_result_html(result)

                messages.append(msg)
                messages.append(tools.create_tool_response_message(tool_call, result))
        else:
            utils.log_unexpected_html()
            return ("[⚠️ Unexpected: No tool_calls or content returned]", messages) if return_messages else "[⚠️ Unexpected: No tool_calls or content returned]"

market_research_result = market_research_agent()

def graphic_designer_agent(trend_insights: str, caption_style: str = "short punchy", size: str = "1024x1024") -> dict:

    """
    Uses aisuite to generate a marketing prompt/caption and OpenAI (directly) to generate the image.

    Args:
        trend_insights (str): Trend summary from the researcher agent.
        caption_style (str): Optional style hint for caption.
        size (str): Image resolution (e.g., '1024x1024').

    Returns:
        dict: A dictionary with image_url, prompt, and caption.
    """

    utils.log_agent_title_html("Graphic Designer Agent", "🎨")

    # Step 1: Generate prompt and caption using aisuite
    system_message = (
        "You are a visual marketing assistant. Based on the input trend insights, "
        "write a creative and visual prompt for an AI image generation model, and also a short caption."
    )

    user_prompt = f"""
Trend insights:
{trend_insights}

Please output:
1. A vivid, descriptive prompt to guide image generation.
2. A marketing caption in style: {caption_style}.

Respond in this format:
{{"prompt": "...", "caption": "..."}}
"""

    chat_response = client.chat.completions.create(
        model="openai:o4-mini",
        messages=[
            {"role": "system", "content": system_message},
            {"role": "user", "content": user_prompt}
        ]
    )

    content = chat_response.choices[0].message.content.strip()
    match = re.search(r'\{.*\}', content, re.DOTALL)
    parsed = json.loads(match.group(0)) if match else {"error": "No JSON returned", "raw": content}

    prompt = parsed["prompt"]
    caption = parsed["caption"]

    # Step 2: Generate image directly using openai-python
    openai_client = openai.OpenAI()

    image_response = openai_client.images.generate(
        model="dall-e-3",
        prompt=prompt,
        size=size,
        quality="standard",
        n=1,
        response_format="url"
    )

    image_url = image_response.data[0].url

    # Save image locally
    img_bytes = requests.get(image_url).content
    img = Image.open(BytesIO(img_bytes))

    filename = os.path.basename(image_url.split("?")[0])
    image_path = filename
    img.save(image_path)


    # Log summary with local image
    utils.log_final_summary_html(f"""
        <h3>Generated Image and Caption</h3>

        <p><strong>Image Path:</strong> <code>{image_path}</code></p>

        <p><strong>Generated Image:</strong></p>
        <img src="{image_path}" alt="Generated Image" style="max-width: 100%; height: auto; border: 1px solid #ccc; border-radius: 8px; margin-top: 10px; margin-bottom: 10px;">

        <p><strong>Prompt:</strong> {prompt}</p>
    """)


    return {
        "image_url": image_url,
        "prompt": prompt,
        "caption": caption,
        "image_path": image_path  
    }

graphic_designer_agent_result = graphic_designer_agent(
    trend_insights=market_research_result,
)

def copywriter_agent(image_path: str, trend_summary: str, model: str = "openai:o4-mini") -> dict:

    """
    Uses aisuite (OpenAI only) to send an image and a trend summary and return a campaign quote.

    Args:
        image_path (str): URL of the image to be analyzed.
        trend_summary (str): Text from the researcher agent.
        model (str): OpenAI model (e.g., openai:o4-mini, openai:gpt-4o)

    Returns:
        dict: {
            "quote": "...",
            "justification": "...",
            "image_path": "..."
        }
    """

    utils.log_agent_title_html("Copywriter Agent", "✍️")

    # Step 1: Load local image and encode as base64
    with open(image_path, "rb") as f:
        img_bytes = f.read()

    b64_img = base64.b64encode(img_bytes).decode("utf-8")

    # Step 2: Build OpenAI-compliant multimodal message
    messages = [
        {
            "role": "system",
            "content": "You are a copywriter that creates elegant campaign quotes based on an image and a marketing trend summary."
        },
        {
            "role": "user",
            "content": [
                {
                    "type": "image_url",
                    "image_url": {
                        "url": f"data:image/png;base64,{b64_img}",
                        "detail": "auto"
                    }
                },
                {
                    "type": "text",
                    "text": f"""
Here is a visual marketing image and a trend analysis:

Trend summary:
\"\"\"{trend_summary}\"\"\"

Please return a JSON object like:
{{
  "quote": "A short, elegant campaign phrase (max 12 words)",
  "justification": "Why this quote matches the image and trend"
}}"""
                }
            ]
        }
    ]

    # Step 3: Send request via aisuite
    response = client.chat.completions.create(
        model=model,
        messages=messages,
    )

    # Step 4: Parse JSON response
    content = response.choices[0].message.content.strip()

    utils.log_final_summary_html(content)

    try:
        match = re.search(r'\{.*\}', content, re.DOTALL)
        parsed = json.loads(match.group(0)) if match else {"error": "No valid JSON returned"}
    except Exception as e:
        parsed = {"error": f"Failed to parse: {e}", "raw": content}


    parsed["image_path"] = image_path
    return parsed

copywriter_agent_result = copywriter_agent(
    image_path=graphic_designer_agent_result["image_path"],
    trend_summary=market_research_result,
)

def packaging_agent(trend_summary: str, image_url: str, quote: str, justification: str, output_path: str = "campaign_summary.md") -> str:

    """
    Packages the campaign assets into a beautifully formatted markdown report for executive review.

    Args:
        trend_summary (str): Summary of the market trends.
        image_url (str): URL of the campaign image.
        quote (str): Marketing quote to overlay.
        justification (str): Explanation for the quote.
        output_path (str): Path to save the markdown report.

    Returns:
        str: Path to the saved markdown file.
    """

    utils.log_agent_title_html("Packaging Agent", "📦")

    # We use this path in the src of the <img>
    styled_image_html = f"""
![Open the generated file to see]({image_url})
    """

    beautified_summary = client.chat.completions.create(
        model="openai:o4-mini",
        messages=[
            {"role": "system", "content": "You are a marketing communication expert writing elegant campaign summaries for executives."},
            {"role": "user", "content": f"""
Please rewrite the following trend summary to be clear, professional, and engaging for a CEO audience:

\"\"\"{trend_summary.strip()}\"\"\"
"""}
        ]
    ).choices[0].message.content.strip()

    utils.log_tool_result_html(beautified_summary)

    # Combine all parts into markdown
    markdown_content = f"""# 🕶️ Summer Sunglasses Campaign – Executive Summary

## 📊 Refined Trend Insights
{beautified_summary}

## 🎯 Campaign Visual
{styled_image_html}

## ✍️ Campaign Quote
{quote.strip()}

## ✅ Why This Works
{justification.strip()}

---

*Report generated on {datetime.now().strftime('%Y-%m-%d')}*
"""

    with open(output_path, "w", encoding="utf-8") as f:
        f.write(markdown_content)

    return output_path

packaging_agent_result = packaging_agent(
    trend_summary=market_research_result,
    image_url=graphic_designer_agent_result["image_path"],
    quote=copywriter_agent_result["quote"],
    justification=copywriter_agent_result["justification"],
    output_path=f"campaign_summary_{datetime.now().strftime('%Y-%m-%d_%H-%M-%S')}.md"
)

# Load and render the markdown content
with open(packaging_agent_result, "r", encoding="utf-8") as f:
    md_content = f.read()

display(Markdown(md_content))

def run_sunglasses_campaign_pipeline(output_path: str = "campaign_summary.md") -> dict:
    """
    Runs the full summer sunglasses campaign pipeline:
    1. Market research (search trends + match products)
    2. Generate visual + caption
    3. Generate quote based on image + trend
    4. Create executive markdown report

    Returns:
        dict: Dictionary containing all intermediate results + path to final report
    """
    # 1. Run market research agent
    trend_summary = market_research_agent()
    print("✅ Market research completed")

    # 2. Generate image + caption
    visual_result = graphic_designer_agent(trend_insights=trend_summary)
    image_path = visual_result["image_path"]
    print("🖼️ Image generated")

    # 3. Generate quote based on image + trends
    quote_result = copywriter_agent(image_path=image_path, trend_summary=trend_summary)
    quote = quote_result.get("quote", "")
    justification = quote_result.get("justification", "")
    print("💬 Quote created")

    # 4. Generate markdown report
    md_path = packaging_agent(
        trend_summary=trend_summary,
        image_url=image_path,  
        quote=quote,
        justification=justification,
        output_path=f"campaign_summary_{datetime.now().strftime('%Y-%m-%d_%H-%M-%S')}.md"
    )

    print(f"📦 Report generated: {md_path}")

    return {
        "trend_summary": trend_summary,
        "visual": visual_result,
        "quote": quote_result,
        "markdown_path": md_path
    }

results = run_sunglasses_campaign_pipeline()

✅ Market research completed

🖼️ Image generated

💬 Quote created

📦 Report generated: campaign_summary_2025-11-03_08-48-31.md

with open(results["markdown_path"], "r", encoding="utf-8") as f:
    md_content = f.read()
display(Markdown(md_content))