cohere-sdk-patterns

# Cohere SDK Patterns ## Overview Production-ready patterns for the `cohere-ai` TypeScript SDK (CohereClientV2) and Python `cohere` package. Real model names, real API shapes, real error types. ## Prerequisites - `cohere-ai` v7+ installed (TypeScript) or `cohere` v5+ (Python) - Familiarity with async/await patterns - Understanding of Cohere API v2 endpoints ## Instructions ### Pattern 1: Singleton Client with Retry ```typescript // src/cohere/client.ts import { CohereClientV2, CohereError, CohereTimeoutError } from 'cohere-ai'; let instance: CohereClientV2 | null = null; export function getCohere(): CohereClientV2 { if (!instance) { if (!process.env.CO_API_KEY) { throw new Error('CO_API_KEY environment variable is required'); } instance = new CohereClientV2({ token: process.env.CO_API_KEY, }); } return instance; } export async function withRetry<T>( operation: () => Promise<T>, maxRetries = 3, baseDelayMs = 1000 ): Promise<T> { for (let attempt = 1; attempt <= maxRetries; attempt++) { try { return await operation(); } catch (err) { if (attempt === maxRetries) throw err; // Only retry on rate limits (429) and server errors (5xx) if (err instanceof CohereError) { const status = err.statusCode; if (status && status !== 429 && status < 500) throw err; } else if (!(err instanceof CohereTimeoutError)) { throw err; } const delay = baseDelayMs * Math.pow(2, at...