Content Generation Agent

interface ContentGenerationInput {
  tickerId: number; // Required: Foreign key to the Ticker table
  jobId?: string; // Optional: Job ID for tracking this run
}

{
  ai: {
    model: 'gpt-4',
    temperature: 0.7,
    maxTokens: 4000,
    systemPrompt: string // Base prompt template
  },
  tone: {
    style: 'executive' | 'analytical' | 'concise',
    formality: 'professional',
    length: 'brief' | 'moderate' | 'detailed'
  },
  structure: {
    sections: Array<{
      id: string,                                    // Unique section identifier
      type: 'executiveSummary' | 'keyInsights' | 'analysisSection' | 'actionItems',
      analysisType?: string,                         // Maps to analysis type for dynamic sections (e.g., 'sentiment', 'competitive')
      enabled: boolean,                              // Whether to include this section
      maxLength: number,                             // Maximum length for this section
      template?: string,                             // Optional custom template
      title?: string                                 // Optional custom title
    }>,
    sectionMapping: {                                // Maps analysis types to section IDs
      [analysisType: string]: string                 // e.g., { 'sentiment': 'sentimentSection', 'competitive': 'competitiveLandscape' }
    },
    defaultSections: {                               // Default section configuration
      executiveSummary: { maxLength: 200, enabled: true },
      keyInsights: { maxLength: 500, enabled: true },
      actionItems: { maxLength: 300, enabled: true }
    }
  },
  personalization: {
    includeCharts: true,
    detailLevel: 'high' | 'medium' | 'low',
    focusAreas: string[] // User's areas of interest
  },
  templates: {
    email: 'templates/email-newsletter.html',
    dashboard: 'templates/dashboard-newsletter.html'
  }
}

{
  agentId: 'content-generation',
  agentVersion: string,                 // Semantic version (e.g., "1.2.3") of the agent that generated this output
  tickerId: number,
  jobId: string,
  timestamp: Date,
  executionTime: number,
  newsletter: {
    id: string,
    title: string,
    date: Date,
    sections: {
      // Always present sections
      executiveSummary: {
        content: string,
        keyPoints: string[]
      },
      keyInsights: Array<{
        title: string,
        description: string,
        priority: 'high' | 'medium' | 'low',
        source: string,
        analysisType: string                    // Which analysis type generated this insight
      }>,
      // Dynamic sections based on available analyses
      [sectionId: string]: {                   // Dynamic: sections generated from analysis results
        analysisType: string,                   // Which analysis type this section represents
        content: string,                        // Generated content
        data: any                               // Type-safe data from analysis results
      },
      // Optional sections
      actionItems?: Array<{
        action: string,
        rationale: string,
        priority: 'high' | 'medium' | 'low'
      }>
    },
    metadata: {
      wordCount: number,
      readingTime: number,
      personalizationScore: number,
      abTestVariant?: string,
      includedAnalysisTypes: string[]           // Which analysis types were included
    }
  },
  rawContent: string, // Full markdown/HTML
  emailHtml: string,
  dashboardHtml: string
}