research

import { research } from 'ai-functions'

research`topic`
research`topic`(options)

// Quick research
const findings = await research`${topic}`

// With depth control
const deep = await research`market size for AI developer tools`({
  depth: 'thorough',
})

// With context
const report = await research`competitor analysis for ${{ company, market }}`

interface Research {
  summary: string           // Key findings
  sources: Array<{
    url: string
    title: string
    relevance: number
  }>
  findings: string[]        // Individual findings
  confidence: number        // 0-1 confidence score
}

// Research → Content
const brand = await ai.storyBrand({ hero: 'developers', guide: 'our product' })
const marketResearch = await research`market validation for ${{ brand }}`
const pitch = await write`investor pitch based on ${{ brand, marketResearch }}`

// Research → Extract → Research
const initial = await research`competitors in ${market}`
for await (const competitor of extract`company names from ${initial}`) {
  const analysis = await research`${competitor} vs ${ourProduct}`
}