@altsafe/aidirector 1.0.1 → 1.2.0

package/README.md

@@ -1,27 +1,12 @@
-# @altsafe/aidirector
+# @altsafe/aidirector - Client SDK
 
-Official TypeScript SDK for **AI Director** — the intelligent AI API gateway with automatic failover, response caching, and JSON extraction.
-
-[![npm version](https://img.shields.io/npm/v/@altsafe/aidirector.svg)](https://www.npmjs.com/package/@altsafe/aidirector)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-## Features
-
-- 🔐 **HMAC Authentication** — Secure request signing (Node.js & browser)
-- ⚡ **10-minute Timeout** — Handles long-running AI requests
-- 🔄 **Automatic Retries** — Exponential backoff with configurable limits
-- 📦 **Structured Errors** — Type-safe error handling
-- 🌊 **Streaming Support** — Real-time response streaming
-- 🎯 **Full TypeScript** — Complete type definitions
+Production-grade TypeScript SDK for the AI Director API gateway.
 
 ## Installation
 
 ```bash
 npm install @altsafe/aidirector
 # or
-bun add @altsafe/aidirector
-# or
 pnpm add @altsafe/aidirector
 ```
 
@@ -32,330 +17,125 @@ import { AIDirector } from '@altsafe/aidirector';
 
 const client = new AIDirector({
   secretKey: process.env.AIDIRECTOR_SECRET_KEY!,
-  baseUrl: 'https://your-api.example.com',
+  baseUrl: 'https://your-instance.vercel.app',
 });
 
+// Generate content
 const result = await client.generate({
-  chainId: 'your-chain-id',
-  prompt: 'Generate 5 user profiles with name and email',
-  schema: { name: 'string', email: 'string' },
+  chainId: 'my-chain',
+  prompt: 'Generate 5 user profiles',
 });
 
 if (result.success) {
-  console.log('Users:', result.data.valid);
-  console.log('Model:', result.meta.modelUsed);
-  console.log('Cached:', result.meta.cached);
+  console.log(result.data.valid);
 }
 ```
 
-## Usage Examples
-
-### Next.js Server Actions
-
-```typescript
-'use server';
-
-import { AIDirector } from '@altsafe/aidirector';
-
-const client = new AIDirector({
-  secretKey: process.env.AIDIRECTOR_SECRET_KEY!,
-});
+## Features
 
-export async function generateContent(prompt: string) {
-  return client.generate({
-    chainId: process.env.DEFAULT_CHAIN_ID!,
-    prompt,
-  });
-}
-```
+- 🔐 **HMAC Authentication** - Secure request signing
+- ⚡ **3-Step Architecture** - Token → Worker → Complete (minimizes costs)
+- 📎 **File Attachments** - Upload and process documents
+- 🔄 **Automatic Retries** - Exponential backoff on failures
+- 💾 **Smart Caching** - Hybrid Redis caching with 7-day TTL
+- 🎯 **TypeScript** - Full type safety
 
-### API Routes
-
-```typescript
-// app/api/generate/route.ts
-import { NextResponse } from 'next/server';
-import { AIDirector } from '@altsafe/aidirector';
-
-const client = new AIDirector({
-  secretKey: process.env.AIDIRECTOR_SECRET_KEY!,
-});
-
-export async function POST(request: Request) {
-  const { prompt, chainId } = await request.json();
-  const result = await client.generate({ chainId, prompt });
-  return NextResponse.json(result);
-}
-```
-
-### Streaming
+## Streaming (Recommended for Large Responses)
 
 ```typescript
 await client.generateStream(
   {
     chainId: 'my-chain',
-    prompt: 'Write a long story...',
+    prompt: 'Generate 100 product descriptions',
   },
   {
-    onChunk: (chunk) => process.stdout.write(chunk),
-    onComplete: (result) => console.log('\nDone!', result.meta),
-    onError: (error) => console.error('Error:', error),
+    onObject: (obj, index) => {
+      console.log(`Object ${index}:`, obj);
+      renderToUI(obj); // Render immediately!
+    },
+    onComplete: (result) => {
+      console.log(`Done! ${result.objectCount} objects`);
+    },
+    onError: (error) => {
+      console.error('Stream failed:', error);
+    },
   }
 );
 ```
 
-### Error Handling
+## File Attachments
 
 ```typescript
-import { 
-  AIDirector, 
-  TimeoutError, 
-  RateLimitError,
-  ValidationError,
-  isAIDirectorError,
-  isRetryableError,
-} from '@altsafe/aidirector';
+import fs from 'fs';
 
-try {
-  const result = await client.generate({ chainId, prompt });
-} catch (error) {
-  if (error instanceof TimeoutError) {
-    console.log('Request timed out after', error.timeoutMs, 'ms');
-  } else if (error instanceof RateLimitError) {
-    console.log('Rate limited, retry after', error.retryAfterMs, 'ms');
-  } else if (error instanceof ValidationError) {
-    console.log('Validation failed:', error.validationErrors);
-  } else if (isAIDirectorError(error)) {
-    console.log('AI Director error:', error.code, error.message);
-    
-    // Check if we should retry
-    if (isRetryableError(error)) {
-      console.log('This error is retryable');
-    }
-  }
-}
-```
+const fileBuffer = fs.readFileSync('report.pdf');
 
-## API Reference
+const result = await client.generate({
+  chainId: 'document-analysis',
+  prompt: 'Summarize this document',
+  files: [{
+    data: fileBuffer.toString('base64'),
+    filename: 'report.pdf',
+    mimeType: 'application/pdf',
+  }],
+});
+```
 
-### `new AIDirector(config)`
+## Configuration
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `secretKey` | `string` | — | **Required.** Your API secret key |
-| `baseUrl` | `string` | `localhost:3000` | API base URL |
-| `timeout` | `number` | `600000` | Request timeout (ms) |
+| `secretKey` | `string` | **required** | Your API key (`aid_sk_...`) |
+| `baseUrl` | `string` | `http://localhost:3000` | API base URL |
+| `timeout` | `number` | `600000` | Request timeout (10 min) |
 | `maxRetries` | `number` | `3` | Max retry attempts |
-| `debug` | `boolean` | `false` | Enable console logging |
-
-### `client.generate(options)`
+| `debug` | `boolean` | `false` | Enable debug logging |
+| `useOptimized` | `boolean` | `true` | Use 3-step Worker flow |
 
-Generate content using your fallback chain.
+## API Methods
 
-| Option | Type | Required | Description |
-|--------|------|----------|-------------|
-| `chainId` | `string` | Yes | Fallback chain ID |
-| `prompt` | `string` | Yes | Prompt to send |
-| `schema` | `object` | No | JSON schema for validation |
-| `timeout` | `number` | No | Override timeout for this request |
-| `options.temperature` | `number` | No | Randomness (0-2) |
-| `options.maxTokens` | `number` | No | Max output tokens |
-| `options.topP` | `number` | No | Nucleus sampling (0-1) |
-| `options.topK` | `number` | No | Top-K sampling |
-| `options.systemPrompt` | `string` | No | System prompt to prepend |
+| Method | Description |
+|--------|-------------|
+| `generate(options)` | Generate content with fallback chain |
+| `generateStream(options, callbacks)` | Stream JSON objects in real-time |
+| `listModels()` | List available AI models |
+| `listChains()` | List your fallback chains |
+| `getUsageStats(options)` | Get usage statistics |
+| `healthCheck()` | Check API health |
 
-**Returns:** `Promise<GenerateResult>`
-
-```typescript
-interface GenerateResult {
-  success: boolean;
-  data: {
-    valid: unknown[];      // Schema-compliant objects
-    invalid: unknown[];    // Failed validation but parsed
-    rawContent?: string;   // Raw AI response
-  };
-  meta: {
-    cached: boolean;
-    modelUsed: string;
-    tokensUsed: { input: number; output: number };
-    latencyMs: number;
-    attemptedModels: string[];
-    finishReason?: string;
-  };
-  error?: {
-    code: string;
-    message: string;
-    retryable?: boolean;
-  };
-}
-```
-
-### `client.generateStream(options, callbacks)`
-
-Stream responses in real-time.
-
-```typescript
-interface StreamCallbacks {
-  onChunk?: (chunk: string) => void;
-  onComplete?: (result: GenerateResult) => void;
-  onError?: (error: Error) => void;
-  onProgress?: (progress: StreamProgress) => void;
-}
-```
-
-### `client.listModels()`
-
-List all available AI models.
-
-```typescript
-const models = await client.listModels();
-// Returns: ModelInfo[]
-```
-
-### `client.listChains()`
-
-Get your fallback chains (requires session auth).
-
-```typescript
-const chains = await client.listChains();
-// Returns: ChainInfo[]
-```
-
-### `client.getUsage(options?)`
-
-Get usage statistics for your account.
-
-```typescript
-const usage = await client.getUsage({ 
-  startDate: new Date('2024-01-01'),
-  endDate: new Date(),
-});
-// Returns: UsageStats
-```
-
-### `client.health()`
-
-Health check to verify API connection.
-
-```typescript
-const { ok, latencyMs, version } = await client.health();
-```
-
-### `client.withConfig(overrides)`
-
-Create a new client with different configuration.
-
-```typescript
-const debugClient = client.withConfig({ debug: true });
-const fastClient = client.withConfig({ timeout: 30000 });
-```
-
-## Error Classes
-
-| Error | Code | Retryable | Properties | Description |
-|-------|------|-----------|------------|-------------|
-| `ConfigurationError` | `CONFIGURATION_ERROR` | No | — | Invalid client setup |
-| `AuthenticationError` | `AUTH_ERROR` | No | `statusCode` | Invalid credentials |
-| `RateLimitError` | `RATE_LIMITED` | Yes | `retryAfterMs` | Too many requests |
-| `TimeoutError` | `TIMEOUT` | Yes | `timeoutMs` | Request timed out |
-| `NetworkError` | `NETWORK_ERROR` | Yes | `originalError` | Connection failed |
-| `ChainExecutionError` | `CHAIN_FAILED` | No | `attemptedModels` | All models failed |
-| `ValidationError` | `VALIDATION_ERROR` | No | `validationErrors` | Schema validation failed |
-| `ServerError` | `SERVER_ERROR` | Yes | `statusCode` | Internal server error |
-
-### Error Helpers
-
-```typescript
-import { isAIDirectorError, isRetryableError } from '@altsafe/aidirector';
-
-// Check if error is from AI Director
-if (isAIDirectorError(error)) {
-  console.log(error.code, error.message);
-}
-
-// Check if error should be retried
-if (isRetryableError(error)) {
-  // Implement retry logic
-}
-```
-
-## Advanced: HMAC Utilities
-
-For custom integrations, you can use the HMAC utilities directly:
+## Error Handling
 
 ```typescript
 import { 
-  generateSignature, 
-  getKeyPrefix, 
-  isValidSecretKey 
+  RateLimitError,
+  TimeoutError,
+  AuthenticationError,
 } from '@altsafe/aidirector';
 
-// Validate a secret key format
-if (isValidSecretKey(key)) {
-  console.log('Valid key');
+try {
+  const result = await client.generate({ ... });
+} catch (error) {
+  if (error instanceof RateLimitError) {
+    console.log(`Retry after ${error.retryAfterMs}ms`);
+  } else if (error instanceof TimeoutError) {
+    console.log('Request timed out');
+  } else if (error instanceof AuthenticationError) {
+    console.log('Invalid API key');
+  }
 }
-
-// Get key prefix for headers
-const prefix = getKeyPrefix(secretKey); // "aid_sk_xxxx"
-
-// Generate signature for custom requests
-const signature = await generateSignature(
-  secretKey,
-  'POST',
-  '/api/v1/generate',
-  JSON.stringify(body),
-  Date.now()
-);
 ```
 
-## TypeScript Types
-
-All types are exported for your convenience:
+## Pricing
 
-```typescript
-import type {
-  // Configuration
-  AIDirectorConfig,
-  
-  // Generation
-  GenerateOptions,
-  GenerateResult,
-  GenerateData,
-  GenerateMeta,
-  GenerateError,
-  GenerationParameters,
-  TokenUsage,
-  
-  // Streaming
-  StreamCallbacks,
-  StreamProgress,
-  
-  // Chains & Models
-  ChainInfo,
-  ChainStep,
-  ModelInfo,
-  
-  // Usage & Health
-  UsageStats,
-  HealthResult,
-} from '@altsafe/aidirector';
-```
+BYOK (Bring Your Own Key) - You pay for AI costs directly to providers.
 
-## Security
-
-⚠️ **Server-side only!** Never expose your secret key to browsers.
-
-- ✅ Next.js API routes / Server Actions
-- ✅ Express.js / Fastify
-- ✅ Angular Universal (SSR)
-- ✅ Edge Functions (Vercel, Cloudflare)
-- ❌ Client-side JavaScript
-
-Store your secret key in environment variables:
-
-```bash
-AIDIRECTOR_SECRET_KEY=aid_sk_your_secret_key_here
-```
+| Tier | Price | Requests | Overage |
+|------|-------|----------|---------|
+| Free | $0 | 1K | Blocked |
+| Starter | $9 | 25K | $0.50/1K |
+| Pro | $29 | 100K | $0.40/1K |
+| Scale | $79 | 500K | $0.30/1K |
 
 ## License
 
-MIT © altsafe
+MIT

package/dist/index.d.mts

@@ -58,11 +58,64 @@ interface GenerateOptions {
      * Override the client timeout for this request
      */
     timeout?: number;
+    /**
+     * Skip the cache for this request.
+     * Useful for prompts that should always generate fresh responses.
+     * @default false
+     */
+    noCache?: boolean;
+    /**
+     * File attachments to include with the request.
+     * The server automatically handles:
+     * - File type detection (magic bytes)
+     * - Model compatibility checking
+     * - Automatic conversion (e.g., DOCX → PDF)
+     *
+     * @example
+     * ```typescript
+     * await client.generate({
+     *   chainId: 'my-chain',
+     *   prompt: 'Summarize this document',
+     *   files: [{
+     *     data: documentBuffer.toString('base64'),
+     *     filename: 'report.pdf',
+     *     mimeType: 'application/pdf',
+     *   }],
+     * });
+     * ```
+     */
+    files?: FileAttachment[];
+    /**
+     * Use the optimized 3-step generation flow.
+     * This minimizes Vercel compute costs by calling the Cloudflare Worker directly.
+     * Set to false to force legacy single-call mode.
+     * @default true
+     */
+    useOptimized?: boolean;
     /**
      * Generation parameters
      */
     options?: GenerationParameters;
 }
+/**
+ * File attachment for generate requests.
+ * Pass files and the server handles detection/conversion automatically.
+ */
+interface FileAttachment {
+    /**
+     * File content as base64-encoded string
+     */
+    data: string;
+    /**
+     * Original filename (optional, helps with type detection)
+     */
+    filename?: string;
+    /**
+     * Claimed MIME type (optional, will be verified by server)
+     * If omitted, server will auto-detect from magic bytes
+     */
+    mimeType?: string;
+}
 /**
  * AI generation parameters
  */
@@ -195,13 +248,22 @@ interface GenerateError {
  */
 interface StreamCallbacks {
     /**
-     * Called for each text chunk received
+     * Called for each text chunk received (legacy/backwards compatible)
      */
     onChunk?: (chunk: string) => void;
     /**
-     * Called when streaming is complete
+     * Called for each VALID JSON object parsed from stream
+     * This is the preferred callback for JSON streaming - each object is complete and parseable
      */
-    onComplete?: (result: GenerateResult) => void;
+    onObject?: (object: unknown, index: number) => void;
+    /**
+     * Called when a JSON array starts in the stream
+     */
+    onArrayStart?: () => void;
+    /**
+     * Called when streaming is complete with full result
+     */
+    onComplete?: (result: StreamCompleteResult) => void;
     /**
      * Called if an error occurs
      */
@@ -211,6 +273,30 @@ interface StreamCallbacks {
      */
     onProgress?: (progress: StreamProgress) => void;
 }
+/**
+ * Result passed to onComplete callback during streaming
+ */
+interface StreamCompleteResult {
+    /**
+     * All collected objects from the stream
+     */
+    objects: unknown[];
+    /**
+     * Total number of objects parsed
+     */
+    objectCount: number;
+    /**
+     * Token usage for the request
+     */
+    tokensUsed?: {
+        input: number;
+        output: number;
+    };
+    /**
+     * Whether the response was cached at stream end
+     */
+    cached?: boolean;
+}
 /**
  * Streaming progress information
  */
@@ -408,6 +494,89 @@ interface HealthResult {
      */
     timestamp?: string;
 }
+/**
+ * Detailed health check result with component status
+ */
+interface DetailedHealthResult {
+    /**
+     * Overall status
+     */
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    /**
+     * Server timestamp
+     */
+    timestamp: string;
+    /**
+     * Server uptime in seconds
+     */
+    uptime: number;
+    /**
+     * Component status
+     */
+    components: {
+        database: {
+            status: string;
+            latencyMs: number;
+            message?: string;
+        };
+        redis: {
+            status: string;
+            latencyMs: number;
+            message?: string;
+        };
+        gemini: {
+            status: string;
+            errorRate: number;
+            recentErrors: number;
+        };
+        openrouter: {
+            status: string;
+            errorRate: number;
+            recentErrors: number;
+        };
+    };
+    /**
+     * 24h metrics
+     */
+    metrics: {
+        last24h: {
+            totalRequests: number;
+            successRate: number;
+            cacheHitRate: number;
+            avgLatencyMs: number;
+        };
+        errorsByCode: Record<string, number>;
+    };
+    /**
+     * Cache status
+     */
+    cache: {
+        totalEntries: number;
+        redisAvailable: boolean;
+    };
+}
+/**
+ * Webhook configuration for async notifications
+ */
+interface WebhookConfig {
+    /**
+     * Request ID to receive notifications for
+     */
+    requestId: string;
+    /**
+     * URL to call when request completes
+     */
+    url: string;
+    /**
+     * Optional secret for HMAC signing
+     */
+    secret?: string;
+    /**
+     * Number of retry attempts on failure
+     * @default 3
+     */
+    retryCount?: number;
+}
 
 /**
  * AI Director Client SDK
@@ -467,6 +636,24 @@ declare class AIDirector {
      * ```
      */
     generate(options: GenerateOptions): Promise<GenerateResult>;
+    /**
+     * Optimized 3-step generation (minimizes Vercel compute costs)
+     *
+     * Step 1: Get token from Vercel (~50ms)
+     * Step 2: Call CF Worker directly (FREE)
+     * Step 3: Cache result in Vercel (~50ms)
+     *
+     * Total Vercel time: ~100ms vs 30-120s in legacy mode
+     */
+    private generateOptimized;
+    /**
+     * Cache completion from worker (Step 3 - async, non-blocking)
+     */
+    private cacheCompletionAsync;
+    /**
+     * Legacy single-call generation (higher Vercel compute cost)
+     */
+    private generateLegacy;
     /**
      * Generate content with streaming (for long responses)
      *
@@ -527,6 +714,67 @@ declare class AIDirector {
      * @returns New AIDirector instance
      */
     withConfig(overrides: Partial<AIDirectorConfig>): AIDirector;
+    /**
+     * Register a webhook for async notifications
+     *
+     * @param config - Webhook configuration
+     * @returns Registration result
+     */
+    registerWebhook(config: {
+        requestId: string;
+        url: string;
+        secret?: string;
+        retryCount?: number;
+    }): Promise<{
+        registered: boolean;
+        message: string;
+    }>;
+    /**
+     * Get detailed health information including component status
+     *
+     * @returns Detailed health status
+     */
+    healthDetailed(): Promise<{
+        status: 'healthy' | 'degraded' | 'unhealthy';
+        timestamp: string;
+        uptime: number;
+        components: Record<string, unknown>;
+        metrics: Record<string, unknown>;
+    }>;
+    /**
+     * Generate content for multiple prompts in a single request
+     *
+     * @param chainId - Chain to use for all items
+     * @param items - Array of prompts with IDs
+     * @param options - Batch options
+     * @returns Batch generation results
+     */
+    generateBatch(chainId: string, items: Array<{
+        id: string;
+        prompt: string;
+        systemPrompt?: string;
+        temperature?: number;
+        maxTokens?: number;
+    }>, options?: {
+        continueOnError?: boolean;
+    }): Promise<{
+        results: Array<{
+            id: string;
+            success: boolean;
+            data?: unknown[];
+            error?: string;
+        }>;
+        summary: {
+            total: number;
+            succeeded: number;
+            failed: number;
+            tokensUsed: {
+                input: number;
+                output: number;
+                total: number;
+            };
+        };
+    }>;
     /**
      * Make authenticated API request
      */
@@ -656,4 +904,4 @@ declare function getKeyPrefix(secretKey: string): string;
  */
 declare function isValidSecretKey(secretKey: string): boolean;
 
-export { AIDirector, type AIDirectorConfig, AIDirectorError, AuthenticationError, ChainExecutionError, type ChainInfo, type ChainStep, ConfigurationError, type GenerateData, type GenerateError, type GenerateMeta, type GenerateOptions, type GenerateResult, type GenerationParameters, type HealthResult, type ModelInfo, NetworkError, RateLimitError, ServerError, type StreamCallbacks, type StreamProgress, TimeoutError, type TokenUsage, type UsageStats, ValidationError, generateSignature, getKeyPrefix, isAIDirectorError, isRetryableError, isValidSecretKey };
+export { AIDirector, type AIDirectorConfig, AIDirectorError, AuthenticationError, ChainExecutionError, type ChainInfo, type ChainStep, ConfigurationError, type DetailedHealthResult, type FileAttachment, type GenerateData, type GenerateError, type GenerateMeta, type GenerateOptions, type GenerateResult, type GenerationParameters, type HealthResult, type ModelInfo, NetworkError, RateLimitError, ServerError, type StreamCallbacks, type StreamCompleteResult, type StreamProgress, TimeoutError, type TokenUsage, type UsageStats, ValidationError, type WebhookConfig, generateSignature, getKeyPrefix, isAIDirectorError, isRetryableError, isValidSecretKey };

package/dist/index.d.ts

@@ -58,11 +58,64 @@ interface GenerateOptions {
      * Override the client timeout for this request
      */
     timeout?: number;
+    /**
+     * Skip the cache for this request.
+     * Useful for prompts that should always generate fresh responses.
+     * @default false
+     */
+    noCache?: boolean;
+    /**
+     * File attachments to include with the request.
+     * The server automatically handles:
+     * - File type detection (magic bytes)
+     * - Model compatibility checking
+     * - Automatic conversion (e.g., DOCX → PDF)
+     *
+     * @example
+     * ```typescript
+     * await client.generate({
+     *   chainId: 'my-chain',
+     *   prompt: 'Summarize this document',
+     *   files: [{
+     *     data: documentBuffer.toString('base64'),
+     *     filename: 'report.pdf',
+     *     mimeType: 'application/pdf',
+     *   }],
+     * });
+     * ```
+     */
+    files?: FileAttachment[];
+    /**
+     * Use the optimized 3-step generation flow.
+     * This minimizes Vercel compute costs by calling the Cloudflare Worker directly.
+     * Set to false to force legacy single-call mode.
+     * @default true
+     */
+    useOptimized?: boolean;
     /**
      * Generation parameters
      */
     options?: GenerationParameters;
 }
+/**
+ * File attachment for generate requests.
+ * Pass files and the server handles detection/conversion automatically.
+ */
+interface FileAttachment {
+    /**
+     * File content as base64-encoded string
+     */
+    data: string;
+    /**
+     * Original filename (optional, helps with type detection)
+     */
+    filename?: string;
+    /**
+     * Claimed MIME type (optional, will be verified by server)
+     * If omitted, server will auto-detect from magic bytes
+     */
+    mimeType?: string;
+}
 /**
  * AI generation parameters
  */
@@ -195,13 +248,22 @@ interface GenerateError {
  */
 interface StreamCallbacks {
     /**
-     * Called for each text chunk received
+     * Called for each text chunk received (legacy/backwards compatible)
      */
     onChunk?: (chunk: string) => void;
     /**
-     * Called when streaming is complete
+     * Called for each VALID JSON object parsed from stream
+     * This is the preferred callback for JSON streaming - each object is complete and parseable
      */
-    onComplete?: (result: GenerateResult) => void;
+    onObject?: (object: unknown, index: number) => void;
+    /**
+     * Called when a JSON array starts in the stream
+     */
+    onArrayStart?: () => void;
+    /**
+     * Called when streaming is complete with full result
+     */
+    onComplete?: (result: StreamCompleteResult) => void;
     /**
      * Called if an error occurs
      */
@@ -211,6 +273,30 @@ interface StreamCallbacks {
      */
     onProgress?: (progress: StreamProgress) => void;
 }
+/**
+ * Result passed to onComplete callback during streaming
+ */
+interface StreamCompleteResult {
+    /**
+     * All collected objects from the stream
+     */
+    objects: unknown[];
+    /**
+     * Total number of objects parsed
+     */
+    objectCount: number;
+    /**
+     * Token usage for the request
+     */
+    tokensUsed?: {
+        input: number;
+        output: number;
+    };
+    /**
+     * Whether the response was cached at stream end
+     */
+    cached?: boolean;
+}
 /**
  * Streaming progress information
  */
@@ -408,6 +494,89 @@ interface HealthResult {
      */
     timestamp?: string;
 }
+/**
+ * Detailed health check result with component status
+ */
+interface DetailedHealthResult {
+    /**
+     * Overall status
+     */
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    /**
+     * Server timestamp
+     */
+    timestamp: string;
+    /**
+     * Server uptime in seconds
+     */
+    uptime: number;
+    /**
+     * Component status
+     */
+    components: {
+        database: {
+            status: string;
+            latencyMs: number;
+            message?: string;
+        };
+        redis: {
+            status: string;
+            latencyMs: number;
+            message?: string;
+        };
+        gemini: {
+            status: string;
+            errorRate: number;
+            recentErrors: number;
+        };
+        openrouter: {
+            status: string;
+            errorRate: number;
+            recentErrors: number;
+        };
+    };
+    /**
+     * 24h metrics
+     */
+    metrics: {
+        last24h: {
+            totalRequests: number;
+            successRate: number;
+            cacheHitRate: number;
+            avgLatencyMs: number;
+        };
+        errorsByCode: Record<string, number>;
+    };
+    /**
+     * Cache status
+     */
+    cache: {
+        totalEntries: number;
+        redisAvailable: boolean;
+    };
+}
+/**
+ * Webhook configuration for async notifications
+ */
+interface WebhookConfig {
+    /**
+     * Request ID to receive notifications for
+     */
+    requestId: string;
+    /**
+     * URL to call when request completes
+     */
+    url: string;
+    /**
+     * Optional secret for HMAC signing
+     */
+    secret?: string;
+    /**
+     * Number of retry attempts on failure
+     * @default 3
+     */
+    retryCount?: number;
+}
 
 /**
  * AI Director Client SDK
@@ -467,6 +636,24 @@ declare class AIDirector {
      * ```
      */
     generate(options: GenerateOptions): Promise<GenerateResult>;
+    /**
+     * Optimized 3-step generation (minimizes Vercel compute costs)
+     *
+     * Step 1: Get token from Vercel (~50ms)
+     * Step 2: Call CF Worker directly (FREE)
+     * Step 3: Cache result in Vercel (~50ms)
+     *
+     * Total Vercel time: ~100ms vs 30-120s in legacy mode
+     */
+    private generateOptimized;
+    /**
+     * Cache completion from worker (Step 3 - async, non-blocking)
+     */
+    private cacheCompletionAsync;
+    /**
+     * Legacy single-call generation (higher Vercel compute cost)
+     */
+    private generateLegacy;
     /**
      * Generate content with streaming (for long responses)
      *
@@ -527,6 +714,67 @@ declare class AIDirector {
      * @returns New AIDirector instance
      */
     withConfig(overrides: Partial<AIDirectorConfig>): AIDirector;
+    /**
+     * Register a webhook for async notifications
+     *
+     * @param config - Webhook configuration
+     * @returns Registration result
+     */
+    registerWebhook(config: {
+        requestId: string;
+        url: string;
+        secret?: string;
+        retryCount?: number;
+    }): Promise<{
+        registered: boolean;
+        message: string;
+    }>;
+    /**
+     * Get detailed health information including component status
+     *
+     * @returns Detailed health status
+     */
+    healthDetailed(): Promise<{
+        status: 'healthy' | 'degraded' | 'unhealthy';
+        timestamp: string;
+        uptime: number;
+        components: Record<string, unknown>;
+        metrics: Record<string, unknown>;
+    }>;
+    /**
+     * Generate content for multiple prompts in a single request
+     *
+     * @param chainId - Chain to use for all items
+     * @param items - Array of prompts with IDs
+     * @param options - Batch options
+     * @returns Batch generation results
+     */
+    generateBatch(chainId: string, items: Array<{
+        id: string;
+        prompt: string;
+        systemPrompt?: string;
+        temperature?: number;
+        maxTokens?: number;
+    }>, options?: {
+        continueOnError?: boolean;
+    }): Promise<{
+        results: Array<{
+            id: string;
+            success: boolean;
+            data?: unknown[];
+            error?: string;
+        }>;
+        summary: {
+            total: number;
+            succeeded: number;
+            failed: number;
+            tokensUsed: {
+                input: number;
+                output: number;
+                total: number;
+            };
+        };
+    }>;
     /**
      * Make authenticated API request
      */
@@ -656,4 +904,4 @@ declare function getKeyPrefix(secretKey: string): string;
  */
 declare function isValidSecretKey(secretKey: string): boolean;
 
-export { AIDirector, type AIDirectorConfig, AIDirectorError, AuthenticationError, ChainExecutionError, type ChainInfo, type ChainStep, ConfigurationError, type GenerateData, type GenerateError, type GenerateMeta, type GenerateOptions, type GenerateResult, type GenerationParameters, type HealthResult, type ModelInfo, NetworkError, RateLimitError, ServerError, type StreamCallbacks, type StreamProgress, TimeoutError, type TokenUsage, type UsageStats, ValidationError, generateSignature, getKeyPrefix, isAIDirectorError, isRetryableError, isValidSecretKey };
+export { AIDirector, type AIDirectorConfig, AIDirectorError, AuthenticationError, ChainExecutionError, type ChainInfo, type ChainStep, ConfigurationError, type DetailedHealthResult, type FileAttachment, type GenerateData, type GenerateError, type GenerateMeta, type GenerateOptions, type GenerateResult, type GenerationParameters, type HealthResult, type ModelInfo, NetworkError, RateLimitError, ServerError, type StreamCallbacks, type StreamCompleteResult, type StreamProgress, TimeoutError, type TokenUsage, type UsageStats, ValidationError, type WebhookConfig, generateSignature, getKeyPrefix, isAIDirectorError, isRetryableError, isValidSecretKey };

package/dist/index.js

@@ -1,4 +1,4 @@
-'use strict';var M=typeof process<"u"&&process.versions?.node;async function P(s){let{createHash:e}=await import('crypto');return e("sha256").update(s).digest("hex")}async function O(s,e,t,r,a){let{createHmac:n}=await import('crypto'),o=[e.toUpperCase(),t,a.toString(),r].join(`
-`),u=await P(s);return n("sha256",u).update(o).digest("hex")}async function K(s){let t=new TextEncoder().encode(s),r=await crypto.subtle.digest("SHA-256",t);return Array.from(new Uint8Array(r)).map(n=>n.toString(16).padStart(2,"0")).join("")}async function N(s,e,t,r,a){let n=new TextEncoder,o=[e.toUpperCase(),t,a.toString(),r].join(`
-`),u=await K(s),l=n.encode(u),i=await crypto.subtle.importKey("raw",l,{name:"HMAC",hash:"SHA-256"},false,["sign"]),d=await crypto.subtle.sign("HMAC",i,n.encode(o));return Array.from(new Uint8Array(d)).map(A=>A.toString(16).padStart(2,"0")).join("")}async function x(s,e,t,r,a){return M?O(s,e,t,r,a):N(s,e,t,r,a)}function S(s){return s.slice(0,12)}function R(s){return typeof s=="string"&&s.startsWith("aid_sk_")&&s.length>=20}var c=class extends Error{constructor(e,t,r){super(e),this.name="AIDirectorError",this.code=t,this.retryable=r?.retryable??false,this.statusCode=r?.statusCode,this.originalError=r?.cause;}},g=class extends c{constructor(e){super(e,"CONFIGURATION_ERROR",{retryable:false}),this.name="ConfigurationError";}},f=class extends c{constructor(e,t){super(e,"AUTH_ERROR",{retryable:false,statusCode:t}),this.name="AuthenticationError";}},p=class extends c{constructor(e,t=6e4){super(e,"RATE_LIMITED",{retryable:true,statusCode:429}),this.name="RateLimitError",this.retryAfterMs=t;}},y=class extends c{constructor(e){super(`Request timed out after ${e}ms`,"TIMEOUT",{retryable:true}),this.name="TimeoutError",this.timeoutMs=e;}},m=class extends c{constructor(e,t){super(e,"NETWORK_ERROR",{retryable:true,cause:t}),this.name="NetworkError";}},w=class extends c{constructor(e,t=[]){super(e,"CHAIN_FAILED",{retryable:false}),this.name="ChainExecutionError",this.attemptedModels=t;}},T=class extends c{constructor(e,t=[]){super(e,"VALIDATION_ERROR",{retryable:false}),this.name="ValidationError",this.validationErrors=t;}},h=class extends c{constructor(e,t=500){super(e,"SERVER_ERROR",{retryable:true,statusCode:t}),this.name="ServerError";}};function v(s){return s instanceof c}function _(s){return v(s)?s.retryable:false}var j="http://localhost:3000",G=6e5,L=3,k=[1e3,2e3,5e3],I=class s{constructor(e){if(!e.secretKey)throw new g("secretKey is required");if(!R(e.secretKey))throw new g("Invalid secret key format. Expected format: aid_sk_<key>");this.secretKey=e.secretKey,this.baseUrl=(e.baseUrl||j).replace(/\/$/,""),this.timeout=e.timeout??G,this.maxRetries=e.maxRetries??L,this.keyPrefix=S(e.secretKey),this.debug=e.debug??false,this.debug&&this.log("Initialized",{baseUrl:this.baseUrl,timeout:this.timeout});}async generate(e){let t=Date.now(),r="/api/v1/generate",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,options:{...e.options,timeout:e.timeout??this.timeout}}),n=null;for(let l=0;l<=this.maxRetries;l++)try{let i=await this.makeAuthenticatedRequest(r,"POST",a,e.timeout),d=Date.now()-t;return this.debug&&this.log("generate success",{latencyMs:d,attempt:l+1}),i.meta&&(i.meta.latencyMs=d),i}catch(i){if(n=i instanceof Error?i:new Error(String(i)),this.debug&&this.log(`generate attempt ${l+1} failed`,{error:n.message}),!this.isRetryable(i)||l>=this.maxRetries)break;let d=k[Math.min(l,k.length-1)];i instanceof p&&i.retryAfterMs>d?await this.sleep(i.retryAfterMs):await this.sleep(d);}let o=Date.now()-t,u=n instanceof y;return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:"",tokensUsed:{input:0,output:0},latencyMs:o,attemptedModels:[]},error:{code:u?"TIMEOUT":"REQUEST_FAILED",message:n?.message||"Request failed after all retries",retryable:false}}}async generateStream(e,t){let r="/api/v1/generate/stream",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,options:e.options});try{let n=Date.now(),o=await x(this.secretKey,"POST",r,a,n),u=await this.fetchWithTimeout(`${this.baseUrl}${r}`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"text/event-stream","x-aidirector-signature":o,"x-aidirector-timestamp":n.toString(),"x-aidirector-key":this.keyPrefix},body:a},e.timeout??this.timeout);if(!u.ok){let E=await u.json();throw this.parseError(u.status,E)}let l=u.body?.getReader();if(!l)throw new m("Response body is not readable");let i=new TextDecoder,d="";for(;;){let{done:E,value:A}=await l.read();if(E)break;d+=i.decode(A,{stream:!0});let D=d.split(`
-`);d=D.pop()||"";for(let C of D)if(C.startsWith("data: ")){let U=C.slice(6);if(U==="[DONE]")break;try{let b=JSON.parse(U);b.chunk&&t.onChunk?.(b.chunk),b.complete&&t.onComplete&&t.onComplete(b.result);}catch{}}}}catch(n){if(t.onError)t.onError(n instanceof Error?n:new Error(String(n)));else throw n}}async listModels(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/models`,{method:"GET",headers:{Accept:"application/json"}})).json();if(!t.success)throw new h(t.error?.message||"Failed to list models");return t.data}async listChains(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/chains`,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!t.success)throw new h(t.error?.message||"Failed to list chains");return t.data}async getUsage(e){let t=new URLSearchParams;e?.startDate&&t.set("startDate",e.startDate.toISOString()),e?.endDate&&t.set("endDate",e.endDate.toISOString());let r=`${this.baseUrl}/api/v1/usage${t.toString()?"?"+t:""}`,n=await(await this.fetchWithTimeout(r,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!n.success)throw new h(n.error?.message||"Failed to get usage");return n.data}async health(){let e=Date.now();try{let t=await this.fetchWithTimeout(`${this.baseUrl}/api/health`,{method:"GET"},5e3),r=Date.now()-e,a=await t.json().catch(()=>({}));return {ok:t.ok,latencyMs:r,version:a.version}}catch{return {ok:false,latencyMs:Date.now()-e}}}withConfig(e){return new s({secretKey:this.secretKey,baseUrl:this.baseUrl,timeout:this.timeout,maxRetries:this.maxRetries,debug:this.debug,...e})}async makeAuthenticatedRequest(e,t,r,a){let n=Date.now(),o=await x(this.secretKey,t,e,r,n),u=await this.fetchWithTimeout(`${this.baseUrl}${e}`,{method:t,headers:{"Content-Type":"application/json",Accept:"application/json","x-aidirector-signature":o,"x-aidirector-timestamp":n.toString(),"x-aidirector-key":this.keyPrefix},body:r},a??this.timeout),l=await u.json();if(!u.ok)throw this.parseError(u.status,l);return l}async fetchWithTimeout(e,t,r=this.timeout){let a=new AbortController,n=setTimeout(()=>a.abort(),r);try{return await fetch(e,{...t,signal:a.signal})}catch(o){throw o instanceof Error&&o.name==="AbortError"?new y(r):o instanceof Error?new m(o.message,o):new m(String(o))}finally{clearTimeout(n);}}parseError(e,t){let r=t?.error?.message||`HTTP ${e}`,a=t?.error?.code||"UNKNOWN";switch(e){case 401:return new f(r,e);case 429:let n=t?.retryAfterMs||6e4;return new p(r,n);case 500:case 502:case 503:case 504:return new h(r,e);default:return a==="CHAIN_FAILED"?new w(r,t?.error?.attemptedModels||[]):new c(r,a,{statusCode:e,retryable:e>=500})}}isRetryable(e){if(e instanceof c)return e.retryable;if(e instanceof Error){let t=e.message.toLowerCase();return t.includes("network")||t.includes("timeout")||e.name==="AbortError"}return  false}sleep(e){return new Promise(t=>setTimeout(t,e))}log(e,t){let r="[AIDirector]";t?console.log(r,e,t):console.log(r,e);}};exports.AIDirector=I;exports.AIDirectorError=c;exports.AuthenticationError=f;exports.ChainExecutionError=w;exports.ConfigurationError=g;exports.NetworkError=m;exports.RateLimitError=p;exports.ServerError=h;exports.TimeoutError=y;exports.ValidationError=T;exports.generateSignature=x;exports.getKeyPrefix=S;exports.isAIDirectorError=v;exports.isRetryableError=_;exports.isValidSecretKey=R;
+'use strict';var M=typeof process<"u"&&process.versions?.node;async function j(o){let{createHash:e}=await import('crypto');return e("sha256").update(o).digest("hex")}async function K(o,e,t,r,a){let{createHmac:s}=await import('crypto'),c=[e.toUpperCase(),t,a.toString(),r].join(`
+`),u=await j(o);return s("sha256",u).update(c).digest("hex")}async function N(o){let t=new TextEncoder().encode(o),r=await crypto.subtle.digest("SHA-256",t);return Array.from(new Uint8Array(r)).map(s=>s.toString(16).padStart(2,"0")).join("")}async function G(o,e,t,r,a){let s=new TextEncoder,c=[e.toUpperCase(),t,a.toString(),r].join(`
+`),u=await N(o),n=s.encode(u),i=await crypto.subtle.importKey("raw",n,{name:"HMAC",hash:"SHA-256"},false,["sign"]),m=await crypto.subtle.sign("HMAC",i,s.encode(c));return Array.from(new Uint8Array(m)).map(h=>h.toString(16).padStart(2,"0")).join("")}async function A(o,e,t,r,a){return M?K(o,e,t,r,a):G(o,e,t,r,a)}function T(o){return o.slice(0,12)}function x(o){return typeof o=="string"&&o.startsWith("aid_sk_")&&o.length>=20}var d=class extends Error{constructor(e,t,r){super(e),this.name="AIDirectorError",this.code=t,this.retryable=r?.retryable??false,this.statusCode=r?.statusCode,this.originalError=r?.cause;}},b=class extends d{constructor(e){super(e,"CONFIGURATION_ERROR",{retryable:false}),this.name="ConfigurationError";}},E=class extends d{constructor(e,t){super(e,"AUTH_ERROR",{retryable:false,statusCode:t}),this.name="AuthenticationError";}},w=class extends d{constructor(e,t=6e4){super(e,"RATE_LIMITED",{retryable:true,statusCode:429}),this.name="RateLimitError",this.retryAfterMs=t;}},k=class extends d{constructor(e){super(`Request timed out after ${e}ms`,"TIMEOUT",{retryable:true}),this.name="TimeoutError",this.timeoutMs=e;}},y=class extends d{constructor(e,t){super(e,"NETWORK_ERROR",{retryable:true,cause:t}),this.name="NetworkError";}},g=class extends d{constructor(e,t=[]){super(e,"CHAIN_FAILED",{retryable:false}),this.name="ChainExecutionError",this.attemptedModels=t;}},U=class extends d{constructor(e,t=[]){super(e,"VALIDATION_ERROR",{retryable:false}),this.name="ValidationError",this.validationErrors=t;}},p=class extends d{constructor(e,t=500){super(e,"SERVER_ERROR",{retryable:true,statusCode:t}),this.name="ServerError";}};function v(o){return o instanceof d}function _(o){return v(o)?o.retryable:false}var L="http://localhost:3000",W=6e5,H=3,O=[1e3,2e3,5e3],I=class o{constructor(e){if(!e.secretKey)throw new b("secretKey is required");if(!x(e.secretKey))throw new b("Invalid secret key format. Expected format: aid_sk_<key>");this.secretKey=e.secretKey,this.baseUrl=(e.baseUrl||L).replace(/\/$/,""),this.timeout=e.timeout??W,this.maxRetries=e.maxRetries??H,this.keyPrefix=T(e.secretKey),this.debug=e.debug??false,this.debug&&this.log("Initialized",{baseUrl:this.baseUrl,timeout:this.timeout});}async generate(e){if(e.useOptimized!==false)try{return await this.generateOptimized(e)}catch(r){this.debug&&this.log("3-step generation failed, falling back to legacy",{error:r instanceof Error?r.message:String(r)});}return this.generateLegacy(e)}async generateOptimized(e){let t=Date.now(),r="/api/v1/generate/token",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,temperature:e.options?.temperature,maxTokens:e.options?.maxTokens,topP:e.options?.topP,topK:e.options?.topK,files:e.files}),s=await this.makeAuthenticatedRequest(r,"POST",a);if(s.cached&&s.data)return this.debug&&this.log("generate cache hit (optimized)",{latencyMs:Date.now()-t}),{success:true,data:s.data,meta:{cached:true,modelUsed:s.meta?.modelUsed||"",tokensUsed:{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[]}};if(!s.token||!s.workerUrl)throw new g("Token generation failed - no token or worker URL returned",[]);let c=JSON.stringify({token:s.token,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,timeout:e.timeout??this.timeout}),n=await(await this.fetchWithTimeout(s.workerUrl,{method:"POST",headers:{"Content-Type":"application/json"},body:c},e.timeout??this.timeout)).json();if(!n.success||!n.content)return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:n.modelId||"",tokensUsed:n.tokensUsed||{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[n.modelId||""]},error:{code:n.errorCode||"GENERATION_FAILED",message:n.errorMessage||"Generation failed",retryable:false}};let i=[],m=[];try{let h=JSON.parse(n.content);Array.isArray(h)?i=h:i=[h];}catch{i=[n.content];}n.completionToken&&this.cacheCompletionAsync({completionToken:n.completionToken,content:n.content,tokensUsed:n.tokensUsed||{input:0,output:0},finishReason:n.finishReason||"stop",chainId:e.chainId,modelUsed:n.modelId,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,temperature:e.options?.temperature,maxTokens:e.options?.maxTokens,topP:e.options?.topP,topK:e.options?.topK}).catch(h=>{this.debug&&this.log("cacheCompletion failed (non-blocking)",{error:h});});let f=Date.now()-t;return this.debug&&this.log("generate success (optimized 3-step)",{latencyMs:f,modelUsed:n.modelId,tokensUsed:n.tokensUsed}),{success:true,data:{valid:i,invalid:m},meta:{cached:false,modelUsed:n.modelId,tokensUsed:n.tokensUsed||{input:0,output:0},latencyMs:f,attemptedModels:[n.modelId]}}}async cacheCompletionAsync(e){let t="/api/v1/generate/complete",r=JSON.stringify(e);await this.makeAuthenticatedRequest(t,"POST",r);}async generateLegacy(e){let t=Date.now(),r="/api/v1/generate",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,noCache:e.noCache,files:e.files,options:{...e.options,timeout:e.timeout??this.timeout}}),s=null;for(let n=0;n<=this.maxRetries;n++)try{let i=await this.makeAuthenticatedRequest(r,"POST",a,e.timeout),m=Date.now()-t;return this.debug&&this.log("generate success (legacy)",{latencyMs:m,attempt:n+1}),i.meta&&(i.meta.latencyMs=m),i}catch(i){if(s=i instanceof Error?i:new Error(String(i)),this.debug&&this.log(`generate attempt ${n+1} failed`,{error:s.message}),!this.isRetryable(i)||n>=this.maxRetries)break;let m=O[Math.min(n,O.length-1)];i instanceof w&&i.retryAfterMs>m?await this.sleep(i.retryAfterMs):await this.sleep(m);}let c=Date.now()-t,u=s instanceof k;return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:"",tokensUsed:{input:0,output:0},latencyMs:c,attemptedModels:[]},error:{code:u?"TIMEOUT":"REQUEST_FAILED",message:s?.message||"Request failed after all retries",retryable:false}}}async generateStream(e,t){let r="/api/v1/generate/stream",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,options:e.options});try{let s=Date.now(),c=await A(this.secretKey,"POST",r,a,s),u=await this.fetchWithTimeout(`${this.baseUrl}${r}`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"text/event-stream","x-aidirector-signature":c,"x-aidirector-timestamp":s.toString(),"x-aidirector-key":this.keyPrefix},body:a},e.timeout??this.timeout);if(!u.ok){let h=await u.json();throw this.parseError(u.status,h)}let n=u.body?.getReader();if(!n)throw new y("Response body is not readable");let i=new TextDecoder,m="",f=[];for(;;){let{done:h,value:D}=await n.read();if(h)break;m+=i.decode(D,{stream:!0});let P=m.split(`
+`);m=P.pop()||"";let S="";for(let R of P){if(R.startsWith("event: ")){S=R.slice(7).trim();continue}if(R.startsWith("data: ")){let C=R.slice(6);if(C==="[DONE]")break;try{let l=JSON.parse(C);switch(S){case "start":this.debug&&this.log("Stream started",l);break;case "object":l.object!==void 0&&(f.push(l.object),t.onObject?.(l.object,l.index)),t.onChunk&&l.object&&t.onChunk(JSON.stringify(l.object));break;case "array_start":t.onArrayStart?.();break;case "complete":t.onComplete&&t.onComplete({objects:f,objectCount:l.objectCount,tokensUsed:l.tokensUsed,cached:l.cached});break;case "error":t.onError&&t.onError(new g(l.error||"Stream error",["STREAM_ERROR"]));break;default:l.chunk&&t.onChunk?.(l.chunk);}}catch{}S="";}}}}catch(s){if(t.onError)t.onError(s instanceof Error?s:new Error(String(s)));else throw s}}async listModels(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/models`,{method:"GET",headers:{Accept:"application/json"}})).json();if(!t.success)throw new p(t.error?.message||"Failed to list models");return t.data}async listChains(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/chains`,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!t.success)throw new p(t.error?.message||"Failed to list chains");return t.data}async getUsage(e){let t=new URLSearchParams;e?.startDate&&t.set("startDate",e.startDate.toISOString()),e?.endDate&&t.set("endDate",e.endDate.toISOString());let r=`${this.baseUrl}/api/v1/usage${t.toString()?"?"+t:""}`,s=await(await this.fetchWithTimeout(r,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!s.success)throw new p(s.error?.message||"Failed to get usage");return s.data}async health(){let e=Date.now();try{let t=await this.fetchWithTimeout(`${this.baseUrl}/api/health`,{method:"GET"},5e3),r=Date.now()-e,a=await t.json().catch(()=>({}));return {ok:t.ok,latencyMs:r,version:a.version}}catch{return {ok:false,latencyMs:Date.now()-e}}}withConfig(e){return new o({secretKey:this.secretKey,baseUrl:this.baseUrl,timeout:this.timeout,maxRetries:this.maxRetries,debug:this.debug,...e})}async registerWebhook(e){let t=await this.makeAuthenticatedRequest("/api/v1/webhooks","POST",JSON.stringify(e));if(!t.success||!t.data)throw new p(t.error?.message||"Failed to register webhook");return t.data}async healthDetailed(){return (await fetch(`${this.baseUrl}/api/v1/health/detailed`,{headers:{Accept:"application/json"}})).json()}async generateBatch(e,t,r={}){let a=await this.makeAuthenticatedRequest("/api/v1/generate/batch","POST",JSON.stringify({chainId:e,items:t,continueOnError:r.continueOnError??true}));if(!a.success||!a.data)throw new g(a.error?.message||"Batch generation failed",[]);return a.data}async makeAuthenticatedRequest(e,t,r,a){let s=Date.now(),c=await A(this.secretKey,t,e,r,s),u=await this.fetchWithTimeout(`${this.baseUrl}${e}`,{method:t,headers:{"Content-Type":"application/json",Accept:"application/json","x-aidirector-signature":c,"x-aidirector-timestamp":s.toString(),"x-aidirector-key":this.keyPrefix},body:r},a??this.timeout),n=await u.json();if(!u.ok)throw this.parseError(u.status,n);return n}async fetchWithTimeout(e,t,r=this.timeout){let a=new AbortController,s=setTimeout(()=>a.abort(),r);try{return await fetch(e,{...t,signal:a.signal})}catch(c){throw c instanceof Error&&c.name==="AbortError"?new k(r):c instanceof Error?new y(c.message,c):new y(String(c))}finally{clearTimeout(s);}}parseError(e,t){let r=t?.error?.message||`HTTP ${e}`,a=t?.error?.code||"UNKNOWN";switch(e){case 401:return new E(r,e);case 429:let s=t?.retryAfterMs||6e4;return new w(r,s);case 500:case 502:case 503:case 504:return new p(r,e);default:return a==="CHAIN_FAILED"?new g(r,t?.error?.attemptedModels||[]):new d(r,a,{statusCode:e,retryable:e>=500})}}isRetryable(e){if(e instanceof d)return e.retryable;if(e instanceof Error){let t=e.message.toLowerCase();return t.includes("network")||t.includes("timeout")||e.name==="AbortError"}return  false}sleep(e){return new Promise(t=>setTimeout(t,e))}log(e,t){let r="[AIDirector]";t?console.log(r,e,t):console.log(r,e);}};exports.AIDirector=I;exports.AIDirectorError=d;exports.AuthenticationError=E;exports.ChainExecutionError=g;exports.ConfigurationError=b;exports.NetworkError=y;exports.RateLimitError=w;exports.ServerError=p;exports.TimeoutError=k;exports.ValidationError=U;exports.generateSignature=A;exports.getKeyPrefix=T;exports.isAIDirectorError=v;exports.isRetryableError=_;exports.isValidSecretKey=x;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-var M=typeof process<"u"&&process.versions?.node;async function P(s){let{createHash:e}=await import('crypto');return e("sha256").update(s).digest("hex")}async function O(s,e,t,r,a){let{createHmac:n}=await import('crypto'),o=[e.toUpperCase(),t,a.toString(),r].join(`
-`),u=await P(s);return n("sha256",u).update(o).digest("hex")}async function K(s){let t=new TextEncoder().encode(s),r=await crypto.subtle.digest("SHA-256",t);return Array.from(new Uint8Array(r)).map(n=>n.toString(16).padStart(2,"0")).join("")}async function N(s,e,t,r,a){let n=new TextEncoder,o=[e.toUpperCase(),t,a.toString(),r].join(`
-`),u=await K(s),l=n.encode(u),i=await crypto.subtle.importKey("raw",l,{name:"HMAC",hash:"SHA-256"},false,["sign"]),d=await crypto.subtle.sign("HMAC",i,n.encode(o));return Array.from(new Uint8Array(d)).map(A=>A.toString(16).padStart(2,"0")).join("")}async function x(s,e,t,r,a){return M?O(s,e,t,r,a):N(s,e,t,r,a)}function S(s){return s.slice(0,12)}function R(s){return typeof s=="string"&&s.startsWith("aid_sk_")&&s.length>=20}var c=class extends Error{constructor(e,t,r){super(e),this.name="AIDirectorError",this.code=t,this.retryable=r?.retryable??false,this.statusCode=r?.statusCode,this.originalError=r?.cause;}},g=class extends c{constructor(e){super(e,"CONFIGURATION_ERROR",{retryable:false}),this.name="ConfigurationError";}},f=class extends c{constructor(e,t){super(e,"AUTH_ERROR",{retryable:false,statusCode:t}),this.name="AuthenticationError";}},p=class extends c{constructor(e,t=6e4){super(e,"RATE_LIMITED",{retryable:true,statusCode:429}),this.name="RateLimitError",this.retryAfterMs=t;}},y=class extends c{constructor(e){super(`Request timed out after ${e}ms`,"TIMEOUT",{retryable:true}),this.name="TimeoutError",this.timeoutMs=e;}},m=class extends c{constructor(e,t){super(e,"NETWORK_ERROR",{retryable:true,cause:t}),this.name="NetworkError";}},w=class extends c{constructor(e,t=[]){super(e,"CHAIN_FAILED",{retryable:false}),this.name="ChainExecutionError",this.attemptedModels=t;}},T=class extends c{constructor(e,t=[]){super(e,"VALIDATION_ERROR",{retryable:false}),this.name="ValidationError",this.validationErrors=t;}},h=class extends c{constructor(e,t=500){super(e,"SERVER_ERROR",{retryable:true,statusCode:t}),this.name="ServerError";}};function v(s){return s instanceof c}function _(s){return v(s)?s.retryable:false}var j="http://localhost:3000",G=6e5,L=3,k=[1e3,2e3,5e3],I=class s{constructor(e){if(!e.secretKey)throw new g("secretKey is required");if(!R(e.secretKey))throw new g("Invalid secret key format. Expected format: aid_sk_<key>");this.secretKey=e.secretKey,this.baseUrl=(e.baseUrl||j).replace(/\/$/,""),this.timeout=e.timeout??G,this.maxRetries=e.maxRetries??L,this.keyPrefix=S(e.secretKey),this.debug=e.debug??false,this.debug&&this.log("Initialized",{baseUrl:this.baseUrl,timeout:this.timeout});}async generate(e){let t=Date.now(),r="/api/v1/generate",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,options:{...e.options,timeout:e.timeout??this.timeout}}),n=null;for(let l=0;l<=this.maxRetries;l++)try{let i=await this.makeAuthenticatedRequest(r,"POST",a,e.timeout),d=Date.now()-t;return this.debug&&this.log("generate success",{latencyMs:d,attempt:l+1}),i.meta&&(i.meta.latencyMs=d),i}catch(i){if(n=i instanceof Error?i:new Error(String(i)),this.debug&&this.log(`generate attempt ${l+1} failed`,{error:n.message}),!this.isRetryable(i)||l>=this.maxRetries)break;let d=k[Math.min(l,k.length-1)];i instanceof p&&i.retryAfterMs>d?await this.sleep(i.retryAfterMs):await this.sleep(d);}let o=Date.now()-t,u=n instanceof y;return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:"",tokensUsed:{input:0,output:0},latencyMs:o,attemptedModels:[]},error:{code:u?"TIMEOUT":"REQUEST_FAILED",message:n?.message||"Request failed after all retries",retryable:false}}}async generateStream(e,t){let r="/api/v1/generate/stream",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,options:e.options});try{let n=Date.now(),o=await x(this.secretKey,"POST",r,a,n),u=await this.fetchWithTimeout(`${this.baseUrl}${r}`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"text/event-stream","x-aidirector-signature":o,"x-aidirector-timestamp":n.toString(),"x-aidirector-key":this.keyPrefix},body:a},e.timeout??this.timeout);if(!u.ok){let E=await u.json();throw this.parseError(u.status,E)}let l=u.body?.getReader();if(!l)throw new m("Response body is not readable");let i=new TextDecoder,d="";for(;;){let{done:E,value:A}=await l.read();if(E)break;d+=i.decode(A,{stream:!0});let D=d.split(`
-`);d=D.pop()||"";for(let C of D)if(C.startsWith("data: ")){let U=C.slice(6);if(U==="[DONE]")break;try{let b=JSON.parse(U);b.chunk&&t.onChunk?.(b.chunk),b.complete&&t.onComplete&&t.onComplete(b.result);}catch{}}}}catch(n){if(t.onError)t.onError(n instanceof Error?n:new Error(String(n)));else throw n}}async listModels(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/models`,{method:"GET",headers:{Accept:"application/json"}})).json();if(!t.success)throw new h(t.error?.message||"Failed to list models");return t.data}async listChains(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/chains`,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!t.success)throw new h(t.error?.message||"Failed to list chains");return t.data}async getUsage(e){let t=new URLSearchParams;e?.startDate&&t.set("startDate",e.startDate.toISOString()),e?.endDate&&t.set("endDate",e.endDate.toISOString());let r=`${this.baseUrl}/api/v1/usage${t.toString()?"?"+t:""}`,n=await(await this.fetchWithTimeout(r,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!n.success)throw new h(n.error?.message||"Failed to get usage");return n.data}async health(){let e=Date.now();try{let t=await this.fetchWithTimeout(`${this.baseUrl}/api/health`,{method:"GET"},5e3),r=Date.now()-e,a=await t.json().catch(()=>({}));return {ok:t.ok,latencyMs:r,version:a.version}}catch{return {ok:false,latencyMs:Date.now()-e}}}withConfig(e){return new s({secretKey:this.secretKey,baseUrl:this.baseUrl,timeout:this.timeout,maxRetries:this.maxRetries,debug:this.debug,...e})}async makeAuthenticatedRequest(e,t,r,a){let n=Date.now(),o=await x(this.secretKey,t,e,r,n),u=await this.fetchWithTimeout(`${this.baseUrl}${e}`,{method:t,headers:{"Content-Type":"application/json",Accept:"application/json","x-aidirector-signature":o,"x-aidirector-timestamp":n.toString(),"x-aidirector-key":this.keyPrefix},body:r},a??this.timeout),l=await u.json();if(!u.ok)throw this.parseError(u.status,l);return l}async fetchWithTimeout(e,t,r=this.timeout){let a=new AbortController,n=setTimeout(()=>a.abort(),r);try{return await fetch(e,{...t,signal:a.signal})}catch(o){throw o instanceof Error&&o.name==="AbortError"?new y(r):o instanceof Error?new m(o.message,o):new m(String(o))}finally{clearTimeout(n);}}parseError(e,t){let r=t?.error?.message||`HTTP ${e}`,a=t?.error?.code||"UNKNOWN";switch(e){case 401:return new f(r,e);case 429:let n=t?.retryAfterMs||6e4;return new p(r,n);case 500:case 502:case 503:case 504:return new h(r,e);default:return a==="CHAIN_FAILED"?new w(r,t?.error?.attemptedModels||[]):new c(r,a,{statusCode:e,retryable:e>=500})}}isRetryable(e){if(e instanceof c)return e.retryable;if(e instanceof Error){let t=e.message.toLowerCase();return t.includes("network")||t.includes("timeout")||e.name==="AbortError"}return  false}sleep(e){return new Promise(t=>setTimeout(t,e))}log(e,t){let r="[AIDirector]";t?console.log(r,e,t):console.log(r,e);}};export{I as AIDirector,c as AIDirectorError,f as AuthenticationError,w as ChainExecutionError,g as ConfigurationError,m as NetworkError,p as RateLimitError,h as ServerError,y as TimeoutError,T as ValidationError,x as generateSignature,S as getKeyPrefix,v as isAIDirectorError,_ as isRetryableError,R as isValidSecretKey};
+var M=typeof process<"u"&&process.versions?.node;async function j(o){let{createHash:e}=await import('crypto');return e("sha256").update(o).digest("hex")}async function K(o,e,t,r,a){let{createHmac:s}=await import('crypto'),c=[e.toUpperCase(),t,a.toString(),r].join(`
+`),u=await j(o);return s("sha256",u).update(c).digest("hex")}async function N(o){let t=new TextEncoder().encode(o),r=await crypto.subtle.digest("SHA-256",t);return Array.from(new Uint8Array(r)).map(s=>s.toString(16).padStart(2,"0")).join("")}async function G(o,e,t,r,a){let s=new TextEncoder,c=[e.toUpperCase(),t,a.toString(),r].join(`
+`),u=await N(o),n=s.encode(u),i=await crypto.subtle.importKey("raw",n,{name:"HMAC",hash:"SHA-256"},false,["sign"]),m=await crypto.subtle.sign("HMAC",i,s.encode(c));return Array.from(new Uint8Array(m)).map(h=>h.toString(16).padStart(2,"0")).join("")}async function A(o,e,t,r,a){return M?K(o,e,t,r,a):G(o,e,t,r,a)}function T(o){return o.slice(0,12)}function x(o){return typeof o=="string"&&o.startsWith("aid_sk_")&&o.length>=20}var d=class extends Error{constructor(e,t,r){super(e),this.name="AIDirectorError",this.code=t,this.retryable=r?.retryable??false,this.statusCode=r?.statusCode,this.originalError=r?.cause;}},b=class extends d{constructor(e){super(e,"CONFIGURATION_ERROR",{retryable:false}),this.name="ConfigurationError";}},E=class extends d{constructor(e,t){super(e,"AUTH_ERROR",{retryable:false,statusCode:t}),this.name="AuthenticationError";}},w=class extends d{constructor(e,t=6e4){super(e,"RATE_LIMITED",{retryable:true,statusCode:429}),this.name="RateLimitError",this.retryAfterMs=t;}},k=class extends d{constructor(e){super(`Request timed out after ${e}ms`,"TIMEOUT",{retryable:true}),this.name="TimeoutError",this.timeoutMs=e;}},y=class extends d{constructor(e,t){super(e,"NETWORK_ERROR",{retryable:true,cause:t}),this.name="NetworkError";}},g=class extends d{constructor(e,t=[]){super(e,"CHAIN_FAILED",{retryable:false}),this.name="ChainExecutionError",this.attemptedModels=t;}},U=class extends d{constructor(e,t=[]){super(e,"VALIDATION_ERROR",{retryable:false}),this.name="ValidationError",this.validationErrors=t;}},p=class extends d{constructor(e,t=500){super(e,"SERVER_ERROR",{retryable:true,statusCode:t}),this.name="ServerError";}};function v(o){return o instanceof d}function _(o){return v(o)?o.retryable:false}var L="http://localhost:3000",W=6e5,H=3,O=[1e3,2e3,5e3],I=class o{constructor(e){if(!e.secretKey)throw new b("secretKey is required");if(!x(e.secretKey))throw new b("Invalid secret key format. Expected format: aid_sk_<key>");this.secretKey=e.secretKey,this.baseUrl=(e.baseUrl||L).replace(/\/$/,""),this.timeout=e.timeout??W,this.maxRetries=e.maxRetries??H,this.keyPrefix=T(e.secretKey),this.debug=e.debug??false,this.debug&&this.log("Initialized",{baseUrl:this.baseUrl,timeout:this.timeout});}async generate(e){if(e.useOptimized!==false)try{return await this.generateOptimized(e)}catch(r){this.debug&&this.log("3-step generation failed, falling back to legacy",{error:r instanceof Error?r.message:String(r)});}return this.generateLegacy(e)}async generateOptimized(e){let t=Date.now(),r="/api/v1/generate/token",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,temperature:e.options?.temperature,maxTokens:e.options?.maxTokens,topP:e.options?.topP,topK:e.options?.topK,files:e.files}),s=await this.makeAuthenticatedRequest(r,"POST",a);if(s.cached&&s.data)return this.debug&&this.log("generate cache hit (optimized)",{latencyMs:Date.now()-t}),{success:true,data:s.data,meta:{cached:true,modelUsed:s.meta?.modelUsed||"",tokensUsed:{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[]}};if(!s.token||!s.workerUrl)throw new g("Token generation failed - no token or worker URL returned",[]);let c=JSON.stringify({token:s.token,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,timeout:e.timeout??this.timeout}),n=await(await this.fetchWithTimeout(s.workerUrl,{method:"POST",headers:{"Content-Type":"application/json"},body:c},e.timeout??this.timeout)).json();if(!n.success||!n.content)return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:n.modelId||"",tokensUsed:n.tokensUsed||{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[n.modelId||""]},error:{code:n.errorCode||"GENERATION_FAILED",message:n.errorMessage||"Generation failed",retryable:false}};let i=[],m=[];try{let h=JSON.parse(n.content);Array.isArray(h)?i=h:i=[h];}catch{i=[n.content];}n.completionToken&&this.cacheCompletionAsync({completionToken:n.completionToken,content:n.content,tokensUsed:n.tokensUsed||{input:0,output:0},finishReason:n.finishReason||"stop",chainId:e.chainId,modelUsed:n.modelId,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,temperature:e.options?.temperature,maxTokens:e.options?.maxTokens,topP:e.options?.topP,topK:e.options?.topK}).catch(h=>{this.debug&&this.log("cacheCompletion failed (non-blocking)",{error:h});});let f=Date.now()-t;return this.debug&&this.log("generate success (optimized 3-step)",{latencyMs:f,modelUsed:n.modelId,tokensUsed:n.tokensUsed}),{success:true,data:{valid:i,invalid:m},meta:{cached:false,modelUsed:n.modelId,tokensUsed:n.tokensUsed||{input:0,output:0},latencyMs:f,attemptedModels:[n.modelId]}}}async cacheCompletionAsync(e){let t="/api/v1/generate/complete",r=JSON.stringify(e);await this.makeAuthenticatedRequest(t,"POST",r);}async generateLegacy(e){let t=Date.now(),r="/api/v1/generate",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,noCache:e.noCache,files:e.files,options:{...e.options,timeout:e.timeout??this.timeout}}),s=null;for(let n=0;n<=this.maxRetries;n++)try{let i=await this.makeAuthenticatedRequest(r,"POST",a,e.timeout),m=Date.now()-t;return this.debug&&this.log("generate success (legacy)",{latencyMs:m,attempt:n+1}),i.meta&&(i.meta.latencyMs=m),i}catch(i){if(s=i instanceof Error?i:new Error(String(i)),this.debug&&this.log(`generate attempt ${n+1} failed`,{error:s.message}),!this.isRetryable(i)||n>=this.maxRetries)break;let m=O[Math.min(n,O.length-1)];i instanceof w&&i.retryAfterMs>m?await this.sleep(i.retryAfterMs):await this.sleep(m);}let c=Date.now()-t,u=s instanceof k;return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:"",tokensUsed:{input:0,output:0},latencyMs:c,attemptedModels:[]},error:{code:u?"TIMEOUT":"REQUEST_FAILED",message:s?.message||"Request failed after all retries",retryable:false}}}async generateStream(e,t){let r="/api/v1/generate/stream",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,options:e.options});try{let s=Date.now(),c=await A(this.secretKey,"POST",r,a,s),u=await this.fetchWithTimeout(`${this.baseUrl}${r}`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"text/event-stream","x-aidirector-signature":c,"x-aidirector-timestamp":s.toString(),"x-aidirector-key":this.keyPrefix},body:a},e.timeout??this.timeout);if(!u.ok){let h=await u.json();throw this.parseError(u.status,h)}let n=u.body?.getReader();if(!n)throw new y("Response body is not readable");let i=new TextDecoder,m="",f=[];for(;;){let{done:h,value:D}=await n.read();if(h)break;m+=i.decode(D,{stream:!0});let P=m.split(`
+`);m=P.pop()||"";let S="";for(let R of P){if(R.startsWith("event: ")){S=R.slice(7).trim();continue}if(R.startsWith("data: ")){let C=R.slice(6);if(C==="[DONE]")break;try{let l=JSON.parse(C);switch(S){case "start":this.debug&&this.log("Stream started",l);break;case "object":l.object!==void 0&&(f.push(l.object),t.onObject?.(l.object,l.index)),t.onChunk&&l.object&&t.onChunk(JSON.stringify(l.object));break;case "array_start":t.onArrayStart?.();break;case "complete":t.onComplete&&t.onComplete({objects:f,objectCount:l.objectCount,tokensUsed:l.tokensUsed,cached:l.cached});break;case "error":t.onError&&t.onError(new g(l.error||"Stream error",["STREAM_ERROR"]));break;default:l.chunk&&t.onChunk?.(l.chunk);}}catch{}S="";}}}}catch(s){if(t.onError)t.onError(s instanceof Error?s:new Error(String(s)));else throw s}}async listModels(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/models`,{method:"GET",headers:{Accept:"application/json"}})).json();if(!t.success)throw new p(t.error?.message||"Failed to list models");return t.data}async listChains(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/chains`,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!t.success)throw new p(t.error?.message||"Failed to list chains");return t.data}async getUsage(e){let t=new URLSearchParams;e?.startDate&&t.set("startDate",e.startDate.toISOString()),e?.endDate&&t.set("endDate",e.endDate.toISOString());let r=`${this.baseUrl}/api/v1/usage${t.toString()?"?"+t:""}`,s=await(await this.fetchWithTimeout(r,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!s.success)throw new p(s.error?.message||"Failed to get usage");return s.data}async health(){let e=Date.now();try{let t=await this.fetchWithTimeout(`${this.baseUrl}/api/health`,{method:"GET"},5e3),r=Date.now()-e,a=await t.json().catch(()=>({}));return {ok:t.ok,latencyMs:r,version:a.version}}catch{return {ok:false,latencyMs:Date.now()-e}}}withConfig(e){return new o({secretKey:this.secretKey,baseUrl:this.baseUrl,timeout:this.timeout,maxRetries:this.maxRetries,debug:this.debug,...e})}async registerWebhook(e){let t=await this.makeAuthenticatedRequest("/api/v1/webhooks","POST",JSON.stringify(e));if(!t.success||!t.data)throw new p(t.error?.message||"Failed to register webhook");return t.data}async healthDetailed(){return (await fetch(`${this.baseUrl}/api/v1/health/detailed`,{headers:{Accept:"application/json"}})).json()}async generateBatch(e,t,r={}){let a=await this.makeAuthenticatedRequest("/api/v1/generate/batch","POST",JSON.stringify({chainId:e,items:t,continueOnError:r.continueOnError??true}));if(!a.success||!a.data)throw new g(a.error?.message||"Batch generation failed",[]);return a.data}async makeAuthenticatedRequest(e,t,r,a){let s=Date.now(),c=await A(this.secretKey,t,e,r,s),u=await this.fetchWithTimeout(`${this.baseUrl}${e}`,{method:t,headers:{"Content-Type":"application/json",Accept:"application/json","x-aidirector-signature":c,"x-aidirector-timestamp":s.toString(),"x-aidirector-key":this.keyPrefix},body:r},a??this.timeout),n=await u.json();if(!u.ok)throw this.parseError(u.status,n);return n}async fetchWithTimeout(e,t,r=this.timeout){let a=new AbortController,s=setTimeout(()=>a.abort(),r);try{return await fetch(e,{...t,signal:a.signal})}catch(c){throw c instanceof Error&&c.name==="AbortError"?new k(r):c instanceof Error?new y(c.message,c):new y(String(c))}finally{clearTimeout(s);}}parseError(e,t){let r=t?.error?.message||`HTTP ${e}`,a=t?.error?.code||"UNKNOWN";switch(e){case 401:return new E(r,e);case 429:let s=t?.retryAfterMs||6e4;return new w(r,s);case 500:case 502:case 503:case 504:return new p(r,e);default:return a==="CHAIN_FAILED"?new g(r,t?.error?.attemptedModels||[]):new d(r,a,{statusCode:e,retryable:e>=500})}}isRetryable(e){if(e instanceof d)return e.retryable;if(e instanceof Error){let t=e.message.toLowerCase();return t.includes("network")||t.includes("timeout")||e.name==="AbortError"}return  false}sleep(e){return new Promise(t=>setTimeout(t,e))}log(e,t){let r="[AIDirector]";t?console.log(r,e,t):console.log(r,e);}};export{I as AIDirector,d as AIDirectorError,E as AuthenticationError,g as ChainExecutionError,b as ConfigurationError,y as NetworkError,w as RateLimitError,p as ServerError,k as TimeoutError,U as ValidationError,A as generateSignature,T as getKeyPrefix,v as isAIDirectorError,_ as isRetryableError,x as isValidSecretKey};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@altsafe/aidirector",
-    "version": "1.0.1",
+    "version": "1.2.0",
     "description": "Official TypeScript SDK for AI Director - Intelligent AI API Gateway with automatic failover, caching, and JSON extraction",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",