Capabilities Overview

// You call this:
const results = await saturn.search({ query: 'AI news' });

// Saturn routes to Serper, Brave, or the next best option
// You get results in a consistent format

interface CapabilityResponse<T> {
  data: T;              // Capability-specific result
  metadata: {
    chargedSats: number;      // Actual cost (sats)
    chargedUsdCents: number;  // Actual cost (USD)
    quotedSats: number;       // Pre-quoted estimate
    balanceAfter: number;     // Remaining credits
    auditId: string;          // Unique receipt ID
    provider: string;         // Which provider handled it
    latencyMs: number;        // Request duration
  };
}

// Get all available capabilities
const capabilities = await saturn.capabilities.list();

// Get details for a specific capability
const reason = await saturn.capabilities.get('reason');
console.log(reason.providers); // ['openai', 'anthropic', ...]
console.log(reason.pricing);   // Pricing tiers

// Call any registered service directly
const result = await saturn.call<MyResponseType>('openai', {
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello' }],
});