Delivery Agent

interface DeliveryInput {
  userTickerId: number; // Required: Foreign key to the UserTicker table
  jobId?: string; // Optional: Job ID for tracking this run
}

{
  email: {
    provider: 'resend' | 'sendgrid',
    apiKey: string,
    fromAddress: string,
    fromName: string,
    replyTo: string,
    templates: {
      daily: 'templates/email-daily.html',
      weekly: 'templates/email-weekly.html'
    },
    retry: {
      maxAttempts: 3,
      backoff: 'exponential',
      delay: 1000
    },
    tracking: {
      openTracking: true,
      clickTracking: true,
      unsubscribeLink: true
    },
    feedback: {
      enabled: true,
      buttonTypes: ['like' | 'dislike' | 'useful' | 'irrelevant' | 'custom'],
      customButtons?: Array<{ label: string, value: string, icon?: string }>,
      placement: 'inline' | 'bottom' | 'both',
      style: 'buttons' | 'icons' | 'text-links'
    }
  },
  dashboard: {
    updateEndpoint: string,
    cacheStrategy: 'cache-first' | 'network-first',
    notificationEnabled: true
  },
  rateLimiting: {
    emailsPerMinute: 100,
    batchSize: 50
  }
}

{
  agentId: 'delivery',
  agentVersion: string,                 // Semantic version (e.g., "1.2.3") of the agent that generated this output
  userTickerId: number,
  jobId: string,
  timestamp: Date,
  executionTime: number,
  delivery: {
    email: {
      status: 'sent' | 'failed' | 'bounced' | 'pending',
      email: string,
      messageId?: string,
      error?: string,
      deliveredAt?: Date
    },
    dashboard: {
      updated: boolean,
      publishedAt: Date,
      url: string
    }
  },
  metadata: {
    deliveryTime: number,
    errors: Array<{ type: string, message: string }>
  }
}