define

import { define } from 'ai-functions'

define(name: string, schema: Schema)
define(name: string, options: DefineOptions)

const planTrip = define('planTrip', {
  destination: 'Travel destination',
  budget: 'Budget in USD (number)',
})

await planTrip({ destination: 'Tokyo', budget: 5000 })

const planTrip = define('planTrip', {
  args: {
    destination: 'Travel destination',
    budget: 'Budget in USD (number)',
  },
  returns: {
    itinerary: [{
      day: 'Day number (number)',
      activities: ['List of activities'],
      estimatedCost: 'Cost for the day (number)',
    }],
    totalCost: 'Total trip cost (number)',
    tips: ['Travel tips'],
  },
})

const analyze = define('analyzeCompetitors', {
  args: { company: 'Company name', market: 'Market segment' },
  returns: { strengths: ['...'], weaknesses: ['...'] },
  model: 'claude-opus-4-5',
  temperature: 0.7,
  system: 'You are a business analyst.',
})

// Conceptually:
is = define('is', { returns: 'boolean' })
list = define('list', { returns: ['items'] })
code = define('code', { returns: 'code string' })