castai-sdk-patterns

# CAST AI SDK Patterns ## Overview CAST AI uses a REST API with `X-API-Key` header authentication. There is no official SDK -- build typed wrappers around `fetch` or `requests`. These patterns cover singleton clients, typed responses, retry with backoff, and multi-cluster management. ## Prerequisites - Completed `castai-install-auth` setup - TypeScript 5+ or Python 3.10+ - Familiarity with async/await patterns ## Instructions ### Step 1: TypeScript API Client ```typescript // src/castai/client.ts interface CastAIConfig { apiKey: string; baseUrl?: string; timeoutMs?: number; } interface CastAICluster { id: string; name: string; status: string; providerType: "eks" | "gke" | "aks"; agentStatus: string; createdAt: string; } interface CastAISavings { monthlySavings: number; savingsPercentage: number; currentMonthlyCost: number; optimizedMonthlyCost: number; } interface CastAINode { name: string; instanceType: string; lifecycle: "on-demand" | "spot"; allocatableCpu: string; allocatableMemory: string; zone: string; } class CastAIClient { private apiKey: string; private baseUrl: string; private timeoutMs: number; constructor(config: CastAIConfig) { this.apiKey = config.apiKey; this.baseUrl = config.baseUrl ?? "https://api.cast.ai"; this.timeoutMs = config.timeoutMs ?? 30000; } private async request<T>(path: string, options?: RequestInit): Promise<T> { const controller = new AbortController(); const tim...