User Request
    ↓
Claude (Natural Language Processing)
    ↓
┌─────────────────────────────────────┐
│  Creative Agent Decision Layer      │
│  ┌─────────────┐  ┌─────────────┐   │
│  │ Manifest    │  │ Code Mode   │   │
│  │ Mode        │  │             │   │
│  │ (Static)    │  │ (Dynamic)   │   │
│  └─────────────┘  └─────────────┘   │
└─────────────────────────────────────┘
    ↓                    ↓
Our Creative Tools    AdCP Publishers
    ↓                    ↓
Campaign Assignment   Real-time Inference

// Current implementation
creative/create {
  creativeName: string,
  assets: ManualAsset[],
  advertiserDomains: string[]
}

// Enhanced implementation
creative/create {
  creativeName: string,

  // Existing manual asset creation
  assets?: ManualAsset[],

  // NEW: Creative agent generation
  generateWithAgent?: {
    mode: 'manifest' | 'code',
    prompt: string,
    brandGuidelines?: BrandGuidelines,
    targetFormats?: CreativeFormat[],
    optimizationGoals?: OptimizationGoal[]
  },

  advertiserDomains: string[]
}

Parameters:
- buyerAgentId: string
- initialPrompt: string
- mode: 'manifest' | 'code'
- brandGuidelines?: object
- targetPlatforms?: string[]

Workflow:
1. User: "Build a creative for our coffee brand targeting morning commuters"
2. Agent: "I'll create a morning-focused coffee ad. What format do you prefer?"
3. User: "Banner ads for mobile and desktop"
4. Agent: "Great! Generating responsive banner set with morning imagery..."
5. Result: Manifest with optimized banner assets or dynamic code

Parameters:
- buyerAgentId: string
- action: 'analyze' | 'optimize' | 'recommend' | 'organize'
- filters?: CreativeFilter

Capabilities:
- Auto-tag creatives based on content analysis
- Identify performance patterns across creatives
- Recommend creative variants for A/B testing
- Suggest creative retirement based on performance
- Detect brand guideline violations

1. User Request:
   "Create display creatives for our holiday sale"

2. Creative Agent (Manifest Mode):
   - Analyzes brand guidelines
   - Generates asset manifest:
     * Hero image: Holiday-themed banner (1200x628)
     * Headline: "Holiday Sale - 50% Off"
     * CTA: "Shop Now"
     * Logo: Brand logo overlay
     * Colors: Brand color palette

3. Our System Integration:
   - Receives manifest from creative agent
   - Converts manifest to CreateCreativeInput
   - Calls existing creative/create
   - Returns creative with generated assets

4. Result:
   ✅ Creative "Holiday Sale 2024" created with 4 AI-generated assets
   📦 Assets optimized for display advertising
   🎯 Ready for campaign assignment

1. User Request:
   "Create a dynamic video creative that personalizes based on user location"

2. Creative Agent (Code Mode):
   - Generates executable creative code
   - Code handles real-time personalization:
     * Base video template
     * Location detection logic
     * Dynamic text overlay system
     * Weather-based content switching

3. Our System Integration:
   - Receives creative code from agent
   - Registers code with AdCP publishers
   - Creates creative record with code reference
   - Sets up real-time inference endpoints

4. Result:
   ✅ Dynamic creative deployed to AdCP network
   🌍 Personalizes for each viewer location
   📊 Real-time performance optimization
   🎯 Campaign-ready with dynamic capabilities

1. Initial Generation:
   User: "Build a creative for our fitness app"
   Agent: *Generates fitness-themed banner*

2. Iterative Refinement:
   User: "Make it more energetic and add a video element"
   Agent: *Updates with dynamic video background*

   User: "The text is too small for mobile"
   Agent: *Adjusts typography for mobile optimization*

   User: "Perfect! Deploy this to campaign camp_123"
   Agent: *Finalizes and assigns to campaign*

3. Result:
   ✅ Custom creative generated through conversation
   📱 Mobile-optimized design
   🎬 Video background for engagement
   🎯 Automatically assigned to campaign

class Scope3ApiClient {
  // NEW: Creative agent integration
  async generateCreativeWithAgent(
    apiKey: string,
    buyerAgentId: string,
    request: CreativeAgentRequest,
  ): Promise<CreativeAgentResponse>;

  async buildCreativeConversational(
    apiKey: string,
    sessionId: string,
    message: string,
  ): Promise<ConversationalResponse>;

  async deployDynamicCreative(
    apiKey: string,
    creativeCode: string,
    publisherEndpoints: string[],
  ): Promise<DeploymentResult>;
}

interface CreativeAgentRequest {
  mode: "manifest" | "code";
  prompt: string;
  brandGuidelines?: BrandGuidelines;
  targetFormats?: CreativeFormat[];
  optimizationGoals?: OptimizationGoal[];
}

interface CreativeAgentResponse {
  mode: "manifest" | "code";

  // Manifest mode response
  manifest?: {
    assets: GeneratedAsset[];
    metadata: CreativeMetadata;
  };

  // Code mode response
  code?: {
    executable: string;
    dependencies: string[];
    endpoints: string[];
  };

  // Common response data
  brandCompliance: ComplianceCheck;
  estimatedPerformance: PerformanceProjection;
}

interface BrandGuidelines {
  logoUsage: LogoGuidelines;
  colorPalette: ColorSpecs[];
  typography: TypographySpecs;
  messaging: MessagingGuidelines;
  restrictions: string[];
}