function generatePRF(transcript: string): Promise<string>

string // PRF document in Markdown format

import { generatePRF } from '@/services/ai'

const transcript = `385-Chris Pacifico\nGuest: Chris Pacifico\n...`

try {
  const prf = await generatePRF(transcript)
  console.log('PRF generated:', prf.length, 'characters')
  
  // Save to episode
  await updateEpisode(episodeId, { prf })
} catch (error) {
  console.error('PRF generation failed:', error.message)
}

function generateHooks(
  transcript: string,
  prf: string,
  episodeNumber: string,
  guestName: string
): Promise<string>

string // HTML content with TipTap-compatible structure

import { generateHooks } from '@/services/ai'

const hooks = await generateHooks(
  transcript,
  prf,
  '385',
  'Chris Pacifico'
)

// hooks is HTML:
// "<h2>Hook 1: The Hidden Cost</h2>\n<p>Most IT leaders don't realize...</p>"

await updateEpisode(episodeId, { viralHooks: hooks })

function generateEpisodeMetadata(
  episodeId: string,
  episodeNumber: string,
  guestName: string,
  transcript: string,
  prf?: string,
  onProgress?: (step: string, detail: string, progress: number) => void
): Promise<EpisodeMetadataResult>

interface EpisodeMetadataResult {
  title: string                    // "EP 385: The Hidden Cost of Vendor Lock-In"
  shortDescription: string         // 1-2 sentence summary
  longDescription: string          // Full "On this episode" content
  keyTakeaways: [string, string, string]  // Exactly 3 takeaways
  showNotes: ShowNote[]            // Timestamped segments
}

interface ShowNote {
  timestamp: string  // "00:15:30"
  description: string
}

import { generateEpisodeMetadata } from '@/services/ai'

const metadata = await generateEpisodeMetadata(
  episodeId,
  '385',
  'Chris Pacifico',
  transcript,
  prf,
  (step, detail, progress) => {
    console.log(`[${Math.round(progress * 100)}%] ${step}: ${detail}`)
  }
)

// Save to Sanity
await updateEpisode(episodeId, {
  sanityPageMetadata: metadata
})

function generateTitleVariations(
  episodeId: string,
  episodeNumber: string,
  guestName: string,
  transcript: string,
  prf?: string,
  existingTitles?: string[]
): Promise<TitleVariation[]>

interface TitleVariation {
  title: string
  angle: 'contrarian' | 'confession' | 'specific'
  wordCount: number
}

import { generateTitleVariations } from '@/services/ai'

const variations = await generateTitleVariations(
  episodeId,
  '385',
  'Chris Pacifico',
  transcript,
  prf,
  ['The IT Leadership Crisis']  // Avoid similar titles
)

// variations:
// [
//   { title: "Why Most CIOs Fail...", angle: "contrarian", wordCount: 8 },
//   { title: "I Wasted 3 Years...", angle: "confession", wordCount: 6 },
//   { title: "387 IT Leaders Reveal...", angle: "specific", wordCount: 7 }
// ]

function generateLinkedInPosts(
  transcript: string,
  prf: string,
  hooks: string,
  episodeNumber: string,
  guestName: string
): Promise<LinkedInPostsResult>

interface LinkedInPostsResult {
  verifiedFactsBank: {
    directQuotes: string[]      // Verbatim quotes from transcript
    specificNumbers: string[]   // Stats mentioned in episode
    events: string[]            // Specific events or examples
    frameworks: string[]        // Named frameworks or methodologies
    insights: string[]          // Key insights
  }
  releaseDay: string           // Release day post copy
  followUp: string             // Follow-up post copy
}

import { generateLinkedInPosts } from '@/services/ai'

const posts = await generateLinkedInPosts(
  transcript,
  prf,
  hooks,
  '385',
  'Chris Pacifico'
)

await updateEpisode(episodeId, {
  socialPosts: {
    linkedin: [posts.releaseDay, posts.followUp]
  }
})

function generateInfographicSpec(
  selectedText: string,
  transcript: string,
  prf: string,
  episodeNumber: string,
  guestName: string,
  history: string[],
  designType?: 'infographic' | 'quote' | 'thumbnail'
): Promise<InfographicSpec>

interface InfographicSpec {
  layout: string              // "Pyramid (Bottom-Up)"
  template: string            // "Strategic Framework"
  title: string               // "The Three Pillars of IT Leadership"
  colorSystem: string         // "Corporate Professional"
  iconStyle: 'isometric' | 'flat2d'
  aspectRatio: string         // "16:9"
  contentBreakdown?: {
    mainMessage: string
    sections: string[]
    dataPoints: string[]
  }
  prompt: string              // Complete Kie.ai prompt
}

import { generateInfographicSpec } from '@/services/ai'

const spec = await generateInfographicSpec(
  'The three pillars of IT leadership: technical expertise, business acumen, and people skills.',
  transcript,
  prf,
  '385',
  'Chris Pacifico',
  ['Doom Loop', 'Timeline'],  // Avoid these layouts
  'infographic'
)

// Use spec to generate image
import { createTask } from '@/services/kieai'
const { taskId } = await createTask({
  prompt: spec.prompt,
  aspectRatio: spec.aspectRatio,
  resolution: '2K'
})

function generateVisualSuggestionsV2(
  episodeId: string,
  episodeNumber: string,
  guestName: string,
  transcript: string,
  prf: string,
  hooks: string,
  history?: string[],
  onProgress?: (step: string, detail: string, progress: number) => void,
  customPrompts?: {
    dataviz?: string
    cinematic?: string
    quoteCards?: string
  }
): Promise<VisualSuggestionsResponse>

interface VisualSuggestionsResponse {
  suggestions: VisualSuggestionResult[]
  counts: {
    dataviz: number      // 4
    cinematic: number    // 4
    quoteCard: number    // 2
  }
  errors: {
    dataviz: string | null
    cinematic: string | null
    quoteCard: string | null
  }
}

interface VisualSuggestionResult {
  visualType: 'dataviz' | 'cinematic' | 'quoteCard'
  type: 'infographic' | 'quoteCard'
  sourceText: string
  sourceSection: string  // "Core Message", "Key Insight #2", etc.
  spec: InfographicSpec
}

import { generateVisualSuggestionsV2 } from '@/services/ai'

const { suggestions, counts } = await generateVisualSuggestionsV2(
  episodeId,
  '385',
  'Chris Pacifico',
  transcript,
  prf,
  hooks,
  [],  // No history
  (step, detail, progress) => {
    console.log(`${Math.round(progress * 100)}%: ${step}`)
  }
)

console.log(`Generated ${counts.dataviz} data viz + ${counts.cinematic} cinematic + ${counts.quoteCard} quote cards`)

// Save to episode
await updateEpisode(episodeId, {
  visualSuggestions: suggestions
})

function factCheckContent(
  transcript: string,
  prf: string,
  guestName: string,
  items: FactCheckItem[],
  coHostName?: string,
  onProgress?: (step: string, detail: string, progress: number) => void
): Promise<FactCheckResponse>

interface FactCheckResponse {
  overallScore: number           // 0-100
  passedValidation: boolean      // true if score >= 80
  results: ValidationResult[]
  summary: string
  criticalIssues: string[]       // Blocking errors
}

interface ValidationResult {
  item: FactCheckItem
  status: 'verified' | 'unverified' | 'misattributed' | 'fabricated'
  confidence: number             // 0-1
  issue?: string                 // Error description
  suggestion?: string            // How to fix
  transcriptEvidence?: string    // Supporting quote from transcript
}

import { factCheckContent, extractFactCheckItems } from '@/services/ai'

// Extract items from infographic spec
const items = extractFactCheckItems(spec, guestName)

// Verify against transcript
const result = await factCheckContent(
  transcript,
  prf,
  'Chris Pacifico',
  items,
  'Doug'
)

if (!result.passedValidation) {
  console.error('Fact-check failed:', result.summary)
  console.error('Issues:', result.criticalIssues)
  
  // Show validation errors in UI
  for (const r of result.results) {
    if (r.status === 'fabricated') {
      console.error(`❌ ${r.item.content}`)
      console.error(`   Issue: ${r.issue}`)
      console.error(`   Fix: ${r.suggestion}`)
    }
  }
}

function extractFactCheckItems(
  spec: Record<string, unknown>,
  guestName: string
): FactCheckItem[]

import { extractFactCheckItems } from '@/services/ai'

const spec = {
  title: "Mark Baker's Tech Debt Doom Loop",  // NOT extracted (editorial title)
  dataPoints: [
    "70% of IT budgets go to maintenance",    // EXTRACTED (statistic)
    "Average lifespan: 3-5 years"             // EXTRACTED (data)
  ],
  pullQuote: {
    text: "We were spending more time firefighting than innovating",  // EXTRACTED (quote)
    attribution: "Chris Pacifico"
  },
  sections: [
    {
      name: "The Cycle",
      textContent: "1. Legacy systems age\n2. Technical debt grows\n3. Innovation stalls"  // EXTRACTED (list)
    }
  ]
}

const items = extractFactCheckItems(spec, 'Chris Pacifico')
// Returns 4 items (2 statistics, 1 quote, 1 list)

function checkSpelling(text: string): Promise<SpellCheckResult>

interface SpellCheckResult {
  correctedText: string
  changes: SpellCheckChange[]
  hasChanges: boolean
}

interface SpellCheckChange {
  original: string
  corrected: string
  type: 'spelling' | 'grammar' | 'punctuation'
}

import { checkSpelling } from '@/services/ai'

const result = await checkSpelling(
  'Most IT leaders dont realize the impact of techincal debt.'
)

if (result.hasChanges) {
  console.log('Corrected:', result.correctedText)
  // "Most IT leaders don't realize the impact of technical debt."
  
  console.log('Changes:', result.changes)
  // [
  //   { original: "dont", corrected: "don't", type: "spelling" },
  //   { original: "techincal", corrected: "technical", type: "spelling" }
  // ]
}

// Settings are fetched from store
const settings = useSettingsStore.getState().settings

// Used for:
// - Model selection (e.g., "claude-sonnet-4-20250514")
// - Agent prompts (PRF, hooks, infographic, etc.)
// - Preset fields (brand name, co-host name, etc.)

try {
  const prf = await generatePRF(transcript)
} catch (error) {
  if (error.message.includes('API error: 401')) {
    // Authentication expired
    redirectToLogin()
  } else if (error.message.includes('rate limit')) {
    // Rate limit hit
    showToast('Too many requests, please wait')
  } else {
    // Generation failed
    showToast('Generation failed: ' + error.message)
  }
}