Error Handling

import { Cognest, CognestError, RateLimitError, IntegrationError } from '@cognest/sdk'

const cognest = new Cognest()

try {
  const reply = await cognest.think('Hello!')
  await cognest.integration('whatsapp').send(userId, reply)
} catch (error) {
  if (error instanceof RateLimitError) {
    console.log(`Rate limited. Retry after ${error.retryAfter}ms`)
    // Automatic retry is built-in, but you can handle manually
  } else if (error instanceof IntegrationError) {
    console.log(`Integration ${error.integration} failed: ${error.message}`)
    console.log(`Error code: ${error.code}`)
  } else if (error instanceof CognestError) {
    console.log(`Cognest error [${error.code}]: ${error.message}`)
  } else {
    throw error
  }
}

// Catch all unhandled errors
cognest.on('error', (error) => {
  console.error(`[Global] ${error.code}: ${error.message}`)

  // Send to your error tracking service
  Sentry.captureException(error, {
    tags: {
      cognest_code: error.code,
      integration: error.integration ?? 'none',
    },
  })
})

// Catch per-integration errors
cognest.integration('whatsapp').on('error', (error) => {
  console.error(`[WhatsApp] ${error.message}`)
})

# cognest.config.yaml
server:
  retry:
    max_attempts: 3           # Maximum retry attempts
    initial_delay: 1000       # First retry delay (ms)
    max_delay: 30000          # Maximum delay between retries
    backoff_multiplier: 2     # Exponential backoff factor
    retryable_codes:          # Only retry these error types
      - RATE_LIMITED
      - INTEGRATION_TIMEOUT
      - ENGINE_OVERLOADED