blackroad-operating-system/agents/categories/creative/copywriter.py

"""
Copywriter Agent

Generates persuasive marketing copy for various formats including
ads, landing pages, sales letters, and promotional materials.
"""

from typing import Any, Dict, List
from agents.base import BaseAgent


class CopywriterAgent(BaseAgent):
    """
    Generates persuasive marketing copy.

    Features:
    - Conversion-focused copy
    - Multiple copywriting frameworks
    - Benefit-driven messaging
    - Call-to-action optimization
    - A/B test variations
    - Persuasion techniques
    """

    def __init__(self):
        super().__init__(
            name='copywriter',
            description='Generate persuasive marketing copy',
            category='creative',
            version='1.0.0',
            tags=['copywriting', 'marketing', 'conversion', 'persuasion']
        )

    async def execute(self, params: Dict[str, Any]) -> Dict[str, Any]:
        """
        Generate marketing copy.

        Args:
            params: {
                'format': 'ad|landing_page|sales_letter|tagline|slogan',
                'product_service': str,
                'target_audience': str,
                'unique_selling_proposition': str,
                'framework': 'AIDA|PAS|FAB|4Ps|BAB',
                'tone': 'urgent|professional|casual|luxury|friendly',
                'options': {
                    'length': 'short|medium|long',
                    'include_cta': bool,
                    'emphasize_benefits': bool,
                    'include_social_proof': bool
                }
            }

        Returns:
            {
                'status': 'success|failed',
                'copy': str,
                'variations': List[str],
                'cta_suggestions': List[str],
                'framework_breakdown': Dict
            }
        """
        format_type = params.get('format', 'ad')
        product_service = params.get('product_service')
        target_audience = params.get('target_audience', 'customers')
        usp = params.get('unique_selling_proposition', '')
        framework = params.get('framework', 'AIDA')
        tone = params.get('tone', 'professional')
        options = params.get('options', {})

        self.logger.info(
            f"Generating {framework} copy for: {product_service}"
        )

        # Mock copy generation based on framework
        if framework == 'AIDA':
            copy = f"""**Attention**: Are you tired of {product_service} solutions that promise much but deliver little?

**Interest**: Introducing the {product_service} that {usp or 'transforms how you work'}. Unlike other options, we've designed every feature with {target_audience} in mind.

**Desire**: Imagine achieving your goals 3x faster while reducing stress and saving money. That's exactly what our {product_service} delivers. Join thousands of satisfied {target_audience} who've already made the switch.

**Action**: Don't wait another day. Get started now with our risk-free trial and experience the difference yourself.

[Get Started Now →]"""

        elif framework == 'PAS':
            copy = f"""**Problem**: {target_audience.title()} struggle with inefficient {product_service} solutions that waste time and money.

**Agitate**: Every day you stick with your current approach, you're leaving results on the table. Your competitors are already moving ahead while you're stuck with outdated methods.

**Solution**: Our {product_service} eliminates these frustrations completely. {usp or 'Advanced features, simple interface, proven results'}. Start seeing improvements from day one.

[Solve This Problem Now →]"""

        elif framework == 'FAB':
            copy = f"""**Features**: Premium {product_service} with cutting-edge capabilities

**Advantages**: {usp or 'Faster, smarter, better than alternatives'}

**Benefits**: Save time, increase productivity, achieve better results - all while simplifying your workflow

Perfect for {target_audience} who demand excellence.

[Experience the Benefits →]"""

        elif framework == 'BAB':
            copy = f"""**Before**: Struggling with {product_service}? Wasting time on solutions that don't work?

**After**: Imagine effortlessly {product_service} while achieving 10x better results

**Bridge**: Our proven system makes this transformation possible for {target_audience}. {usp or 'Unique approach, guaranteed results'}.

[Start Your Transformation →]"""

        else:  # 4Ps
            copy = f"""**Picture**: Envision your ideal {product_service} experience - efficient, effective, effortless

**Promise**: We guarantee you'll achieve better results within 30 days

**Proof**: Join 10,000+ {target_audience} who've already succeeded with our {product_service}

**Push**: Limited-time offer - get started today and receive exclusive bonuses worth $500

[Claim Your Offer Now →]"""

        variations = [
            f"Transform Your {product_service} Experience Today",
            f"The {product_service} {target_audience.title()} Trust Most",
            f"Achieve Better Results with Our {product_service}",
            f"Why Settle for Less? Get Premium {product_service}",
            f"Join Thousands Who've Upgraded Their {product_service}"
        ]

        cta_suggestions = [
            "Get Started Now",
            "Start Your Free Trial",
            "Claim Your Discount",
            "See Pricing",
            "Join Today",
            "Learn More",
            "Request a Demo",
            "Download Free Guide",
            "Yes, I Want This",
            "Take Me There"
        ]

        return {
            'status': 'success',
            'copy': copy,
            'variations': variations,
            'cta_suggestions': cta_suggestions,
            'framework_used': framework,
            'framework_breakdown': {
                'AIDA': 'Attention → Interest → Desire → Action',
                'PAS': 'Problem → Agitate → Solution',
                'FAB': 'Features → Advantages → Benefits',
                'BAB': 'Before → After → Bridge',
                '4Ps': 'Picture → Promise → Proof → Push'
            },
            'platform_versions': {
                'facebook_ad': f"Stop struggling with {product_service}! {usp or 'Our solution works'}. Join 10,000+ happy {target_audience}. [Learn More]",
                'google_ad': f"{product_service} | {usp or 'Best Solution'} | Free Trial | Guaranteed Results",
                'landing_page_hero': f"The {product_service} Built for {target_audience.title()}",
                'email_subject': f"Finally: {product_service} That Actually Works"
            },
            'persuasion_techniques': [
                'Scarcity (limited time)',
                'Social proof (10,000+ users)',
                'Authority (proven results)',
                'Reciprocity (free trial)',
                'Commitment (risk-free guarantee)'
            ],
            'optimization_tips': [
                'Lead with the biggest benefit',
                'Use specific numbers (3x faster, 50% cheaper)',
                'Address objections upfront',
                'Create urgency without being pushy',
                'Make the CTA crystal clear',
                'Use power words strategically',
                'Keep sentences short and punchy',
                'Test multiple variations'
            ],
            'conversion_elements': {
                'headline': variations[0],
                'subheadline': f"{usp or 'The smarter way to achieve your goals'}",
                'bullet_points': [
                    f"✓ Save time with automated {product_service}",
                    f"✓ Increase results by up to 300%",
                    f"✓ Risk-free 30-day money-back guarantee"
                ],
                'guarantee': "30-Day Money-Back Guarantee",
                'urgency': "Limited spots available",
                'social_proof': f"Join 10,000+ {target_audience}"
            }
        }

    def validate_params(self, params: Dict[str, Any]) -> bool:
        """Validate copywriting parameters."""
        if 'product_service' not in params:
            self.logger.error("Missing required field: product_service")
            return False

        return True