reason

const result = await saturn.reason({
  prompt: 'Explain quantum computing in simple terms',
});

console.log(result.data.content);
// → "Quantum computing is a type of computation that..."

interface ReasonResponse {
  data: {
    content: string;        // Generated text
    finishReason: string;   // 'stop', 'length', etc.
    usage: {
      promptTokens: number;
      completionTokens: number;
      totalTokens: number;
    };
  };
  metadata: {
    chargedUsdCents: number;
    provider: string;
    model: string;
    latencyMs: number;
    auditId: string;
  };
}

// Use Anthropic specifically
const result = await saturn.reason({
  prompt: 'Analyze this code for bugs...',
  provider: 'anthropic',
  model: 'claude-sonnet-4-20250514',
});

const result = await saturn.reason({
  systemPrompt: 'You are a helpful coding assistant.',
  prompt: 'How do I reverse a string in Python?',
});

const result = await saturn.reason({
  prompt: 'Write a haiku about programming',
  maxTokens: 50,
  temperature: 0.7,
});

import { SaturnPolicyDeniedError, SaturnProviderError } from '@saturn-pay/sdk';

try {
  await saturn.reason({ prompt: 'Very long prompt...' });
} catch (err) {
  if (err instanceof SaturnPolicyDeniedError) {
    // Budget exceeded or capability not allowed
    console.log('Policy error:', err.message);
  } else if (err instanceof SaturnProviderError) {
    // Upstream provider error
    console.log('Provider error:', err.message);
  }
}