@altsafe/aidirector 1.2.0 → 1.4.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 AI Director
+Copyright (c) 2026 Hydra
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,27 +1,35 @@
-# @altsafe/aidirector - Client SDK
+# hydra-aidirector - Client SDK
+# hydra-aidirector
 
-Production-grade TypeScript SDK for the AI Director API gateway.
+The official Node.js/TypeScript client for [Hydra](https://hydrai.dev).
+
+Hydra is a high-performance AI API gateway that provides:
+- 🔄 **Automatic Failover**: Never let an LLM outage break your app
+- ⚡ **God-Tier Caching**: Reduce costs and latency with smart response caching
+- 🛡️ **Self-Healing AI**: Auto-extract JSON, strip markdown, and repair malformed responses with `healingReport`
+- 🧠 **Thinking Mode**: Support for reasoning models like Gemini 2.0 Flash Thinking
+- 📊 **Detailed Usage**: Track token usage, latency, and costs per model
 
 ## Installation
 
 ```bash
-npm install @altsafe/aidirector
+npm install hydra-aidirector
 # or
-pnpm add @altsafe/aidirector
+pnpm add hydra-aidirector
 ```
 
 ## Quick Start
 
 ```typescript
-import { AIDirector } from '@altsafe/aidirector';
+import { Hydra } from 'hydra-aidirector';
 
-const client = new AIDirector({
-  secretKey: process.env.AIDIRECTOR_SECRET_KEY!,
+const ai = new Hydra({
+  secretKey: process.env.HYDRA_SECRET_KEY!,
   baseUrl: 'https://your-instance.vercel.app',
 });
 
 // Generate content
-const result = await client.generate({
+const result = await ai.generate({
   chainId: 'my-chain',
   prompt: 'Generate 5 user profiles',
 });
@@ -37,8 +45,10 @@ if (result.success) {
 - ⚡ **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
+- 💾 **Smart Caching** - Two-tier (user/global) cache with AI-directed scoping
+- 🎯 **TypeScript** - Full type safety with comprehensive types
+- 🛑 **Request Cancellation** - Support for AbortSignal
+- 🪝 **Webhooks** - Async notification callbacks
 
 ## Streaming (Recommended for Large Responses)
 
@@ -63,6 +73,64 @@ await client.generateStream(
 );
 ```
 
+## Batch Generation
+
+```typescript
+const result = await client.generateBatch('my-chain', [
+  { id: 'item1', prompt: 'Describe product A' },
+  { id: 'item2', prompt: 'Describe product B' },
+  { id: 'item3', prompt: 'Describe product C' },
+]);
+
+console.log(`Processed ${result.summary.succeeded}/${result.summary.total}`);
+```
+
+## Request Cancellation
+
+```typescript
+const controller = new AbortController();
+
+// Cancel after 5 seconds
+setTimeout(() => controller.abort(), 5000);
+
+try {
+  const result = await client.generate({
+    chainId: 'my-chain',
+    prompt: 'Long running prompt',
+    signal: controller.signal,
+  });
+} catch (error) {
+  if (error instanceof TimeoutError) {
+    console.log('Request was cancelled');
+  }
+}
+```
+
+## Cache Control
+
+```typescript
+// Global cache (shared across users - default)
+const result = await client.generate({
+  chainId: 'my-chain',
+  prompt: 'Static content',
+  cacheScope: 'global',
+});
+
+// User-scoped cache (private to user)
+const userResult = await client.generate({
+  chainId: 'my-chain',
+  prompt: 'Personalized content',
+  cacheScope: 'user',
+});
+
+// Skip cache entirely
+const freshResult = await client.generate({
+  chainId: 'my-chain',
+  prompt: 'Always fresh',
+  cacheScope: 'skip',
+});
+```
+
 ## File Attachments
 
 ```typescript
@@ -81,16 +149,62 @@ const result = await client.generate({
 });
 ```
 
+## Webhooks
+
+```typescript
+// Register a webhook
+await client.registerWebhook({
+  requestId: 'req_123',
+  url: 'https://your-domain.com/webhooks/hydra',
+  secret: 'your-webhook-secret',
+  retryCount: 3,
+});
+
+// List webhooks
+const webhooks = await client.listWebhooks();
+
+// Update webhook
+await client.updateWebhook('webhook_id', { retryCount: 5 });
+
+// Unregister webhook
+await client.unregisterWebhook('webhook_id');
+```
+
+## Thinking Mode (Reasoning Models)
+
+```typescript
+const result = await client.generate({
+  chainId: 'reasoning-chain',
+  prompt: 'Solve this complex problem step by step',
+  options: {
+    thinkingMode: true, // Shows model reasoning process
+  },
+});
+```
+
 ## Configuration
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `secretKey` | `string` | **required** | Your API key (`aid_sk_...`) |
+| `secretKey` | `string` | **required** | Your API key (`hyd_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 debug logging |
-| `useOptimized` | `boolean` | `true` | Use 3-step Worker flow |
+
+## Generate Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `chainId` | `string` | **required** | Fallback chain ID |
+| `prompt` | `string` | **required** | The prompt to send |
+| `schema` | `object` | - | JSON schema for validation |
+| `cacheScope` | `'global' \| 'user' \| 'skip'` | `'global'` | Cache behavior |
+| `signal` | `AbortSignal` | - | Cancellation signal |
+| `maxRetries` | `number` | Client setting | Override retries |
+| `requestId` | `string` | Auto-generated | Custom request ID |
+| `files` | `FileAttachment[]` | - | File attachments |
+| `useOptimized` | `boolean` | `true` | Use 3-step flow |
 
 ## API Methods
 
@@ -98,10 +212,16 @@ const result = await client.generate({
 |--------|-------------|
 | `generate(options)` | Generate content with fallback chain |
 | `generateStream(options, callbacks)` | Stream JSON objects in real-time |
+| `generateBatch(chainId, items)` | Process multiple prompts |
 | `listModels()` | List available AI models |
 | `listChains()` | List your fallback chains |
-| `getUsageStats(options)` | Get usage statistics |
-| `healthCheck()` | Check API health |
+| `getUsage(options)` | Get usage statistics |
+| `health()` | Check API health |
+| `healthDetailed()` | Get detailed component health |
+| `registerWebhook(config)` | Register async webhook |
+| `unregisterWebhook(id)` | Remove a webhook |
+| `listWebhooks()` | List all webhooks |
+| `updateWebhook(id, updates)` | Modify webhook config |
 
 ## Error Handling
 
@@ -110,21 +230,62 @@ import {
   RateLimitError,
   TimeoutError,
   AuthenticationError,
-} from '@altsafe/aidirector';
+  QuotaExceededError,
+  WorkerError,
+  FileProcessingError,
+} from 'hydra-aidirector';
 
 try {
   const result = await client.generate({ ... });
 } catch (error) {
   if (error instanceof RateLimitError) {
     console.log(`Retry after ${error.retryAfterMs}ms`);
+  } else if (error instanceof QuotaExceededError) {
+    console.log(`Quota exceeded: ${error.used}/${error.limit} (${error.tier})`);
   } else if (error instanceof TimeoutError) {
-    console.log('Request timed out');
+    console.log(`Request timed out after ${error.timeoutMs}ms`);
   } else if (error instanceof AuthenticationError) {
     console.log('Invalid API key');
+  } else if (error instanceof WorkerError) {
+    console.log('Worker processing failed - will retry');
+  } else if (error instanceof FileProcessingError) {
+    console.log(`File error: ${error.reason} - ${error.filename}`);
   }
 }
 ```
 
+## Self-Healing Reports
+
+When `hydra-aidirector` fixes a malformed JSON response, it includes a `healingReport` in the data object:
+
+```typescript
+const result = await client.generate({ ... });
+
+if (result.success && result.meta.recovered) {
+  console.log('JSON was malformed but healed!');
+  console.log(result.data.healingReport); 
+  // [{ original: "{name: 'foo'", healed: {name: "foo"}, fixes: ["Added missing brace"] }]
+}
+```
+
+## AI-Directed Caching
+
+The AI can control caching by including a `_cache` directive in its JSON output:
+
+```json
+{
+  "data": { ... },
+  "_cache": { "scope": "user" }
+}
+```
+
+Scopes:
+- `global` - Share response across all users (default)
+- `user` - Cache per-user only
+- `skip` - Do not cache this response
+
+The directive is automatically stripped from the final response.
+
 ## Pricing
 
 BYOK (Bring Your Own Key) - You pay for AI costs directly to providers.

package/dist/index.d.mts

@@ -1,21 +1,21 @@
 /**
- * AI Director Client Types
+ * Hydra Client Types
  * Type definitions for the SDK
  */
 /**
- * Configuration for AI Director client
+ * Configuration for Hydra client
  */
-interface AIDirectorConfig {
+interface HydraConfig {
     /**
-     * Your AI Director secret key
-     * Get this from your dashboard at https://aidirector.dev/dashboard/keys
-     * Format: aid_sk_<random>
+     * Your Hydra secret key
+     * Get this from your dashboard at https://hydrai.dev/dashboard/keys
+     * Format: hyd_sk_<random>
      */
     secretKey: string;
     /**
      * API base URL
      * @default 'http://localhost:3000' in development
-     * @example 'https://api.aidirector.dev'
+     * @example 'https://api.hydrai.dev'
      */
     baseUrl?: string;
     /**
@@ -92,6 +92,35 @@ interface GenerateOptions {
      * @default true
      */
     useOptimized?: boolean;
+    /**
+     * Cache scope for this request.
+     * - 'global': Cache is shared across all users (default)
+     * - 'user': Cache is scoped to the authenticated user
+     * - 'skip': Do not cache this response
+     * @default 'global'
+     */
+    cacheScope?: 'global' | 'user' | 'skip';
+    /**
+     * AbortSignal for request cancellation.
+     * Pass a signal from an AbortController to cancel the request.
+     * @example
+     * ```typescript
+     * const controller = new AbortController();
+     * setTimeout(() => controller.abort(), 5000);
+     * await client.generate({ chainId: 'x', prompt: 'y', signal: controller.signal });
+     * ```
+     */
+    signal?: AbortSignal;
+    /**
+     * Override max retries for this specific request.
+     * Set to 0 to disable retries for idempotent-sensitive operations.
+     */
+    maxRetries?: number;
+    /**
+     * Client-generated request ID for tracing and debugging.
+     * If not provided, one will be generated automatically.
+     */
+    requestId?: string;
     /**
      * Generation parameters
      */
@@ -142,6 +171,12 @@ interface GenerationParameters {
      * System prompt to prepend
      */
     systemPrompt?: string;
+    /**
+     * Enable thinking/reasoning mode for supported models.
+     * When enabled, the model will show its reasoning process.
+     * Only works with models that support thinking (e.g., Gemini 2.0 Flash Thinking).
+     */
+    thinkingMode?: boolean;
 }
 /**
  * Result from the generate method
@@ -180,6 +215,15 @@ interface GenerateData {
      * Raw AI response text (useful for debugging)
      */
     rawContent?: string;
+    /**
+     * Report of auto-healed validation errors
+     * detailed log of how the system fixed invalid AI output
+     */
+    healingReport?: Array<{
+        original: unknown;
+        healed: unknown;
+        fixes: string[];
+    }>;
 }
 /**
  * Generation metadata
@@ -579,9 +623,9 @@ interface WebhookConfig {
 }
 
 /**
- * AI Director Client SDK
+ * Hydra Client SDK
  *
- * Production-grade client for the AI Director API gateway.
+ * Production-grade client for the Hydra API gateway.
  * Use in Next.js API routes, Server Actions, or any Node.js/Edge environment.
  *
  * Features:
@@ -593,11 +637,11 @@ interface WebhookConfig {
  *
  * @example
  * ```typescript
- * import { AIDirector } from '@aidirector/client';
+ * import { Hydra } from 'hydra-aidirector';
  *
- * const client = new AIDirector({
- *   secretKey: process.env.AIDIRECTOR_SECRET_KEY!,
- *   baseUrl: 'https://api.aidirector.dev',
+ * const client = new Hydra({
+ *   secretKey: process.env.HYDRA_SECRET_KEY!,
+ *   baseUrl: 'https://api.hydrai.dev',
  * });
  *
  * const result = await client.generate({
@@ -611,20 +655,20 @@ interface WebhookConfig {
  * }
  * ```
  */
-declare class AIDirector {
+declare class Hydra {
     private readonly secretKey;
     private readonly baseUrl;
     private readonly timeout;
     private readonly maxRetries;
     private readonly keyPrefix;
     private readonly debug;
-    constructor(config: AIDirectorConfig);
+    constructor(config: HydraConfig);
     /**
      * Generate content using your fallback chain
      *
      * @param options - Generation options
      * @returns Promise resolving to GenerateResult
-     * @throws AIDirectorError subclasses on failure
+     * @throws HydraError subclasses on failure
      *
      * @example
      * ```typescript
@@ -711,9 +755,9 @@ declare class AIDirector {
      * Useful for testing or switching environments
      *
      * @param overrides - Configuration overrides
-     * @returns New AIDirector instance
+     * @returns New Hydra instance
      */
-    withConfig(overrides: Partial<AIDirectorConfig>): AIDirector;
+    withConfig(overrides: Partial<HydraConfig>): Hydra;
     /**
      * Register a webhook for async notifications
      *
@@ -729,6 +773,43 @@ declare class AIDirector {
         registered: boolean;
         message: string;
     }>;
+    /**
+     * Unregister a webhook
+     *
+     * @param webhookId - ID of the webhook to unregister
+     * @returns Unregistration result
+     */
+    unregisterWebhook(webhookId: string): Promise<{
+        unregistered: boolean;
+        message: string;
+    }>;
+    /**
+     * List all registered webhooks
+     *
+     * @returns Array of webhook configurations
+     */
+    listWebhooks(): Promise<Array<{
+        id: string;
+        requestId: string;
+        url: string;
+        status: 'pending' | 'delivered' | 'failed';
+        retryCount: number;
+        createdAt: string;
+    }>>;
+    /**
+     * Update a webhook configuration
+     *
+     * @param webhookId - ID of the webhook to update
+     * @param updates - Fields to update
+     * @returns Updated webhook info
+     */
+    updateWebhook(webhookId: string, updates: {
+        url?: string;
+        retryCount?: number;
+    }): Promise<{
+        updated: boolean;
+        message: string;
+    }>;
     /**
      * Get detailed health information including component status
      *
@@ -802,13 +883,13 @@ declare class AIDirector {
 }
 
 /**
- * AI Director Error Classes
+ * Hydra Error Classes
  * Structured error types for better error handling
  */
 /**
- * Base error class for AI Director errors
+ * Base error class for Hydra errors
  */
-declare class AIDirectorError extends Error {
+declare class HydraError extends Error {
     readonly code: string;
     readonly retryable: boolean;
     readonly statusCode?: number;
@@ -822,59 +903,99 @@ declare class AIDirectorError extends Error {
 /**
  * Configuration error - invalid client setup
  */
-declare class ConfigurationError extends AIDirectorError {
+declare class ConfigurationError extends HydraError {
     constructor(message: string);
 }
 /**
  * Authentication error - invalid or expired credentials
  */
-declare class AuthenticationError extends AIDirectorError {
+declare class AuthenticationError extends HydraError {
     constructor(message: string, statusCode?: number);
 }
 /**
  * Rate limit error - too many requests
  */
-declare class RateLimitError extends AIDirectorError {
+declare class RateLimitError extends HydraError {
     readonly retryAfterMs: number;
     constructor(message: string, retryAfterMs?: number);
 }
 /**
  * Timeout error - request took too long
  */
-declare class TimeoutError extends AIDirectorError {
+declare class TimeoutError extends HydraError {
     readonly timeoutMs: number;
     constructor(timeoutMs: number);
 }
 /**
  * Network error - connection failed
  */
-declare class NetworkError extends AIDirectorError {
+declare class NetworkError extends HydraError {
     constructor(message: string, cause?: Error);
 }
 /**
  * Chain error - fallback chain execution failed
  */
-declare class ChainExecutionError extends AIDirectorError {
+declare class ChainExecutionError extends HydraError {
     readonly attemptedModels: string[];
     constructor(message: string, attemptedModels?: string[]);
 }
 /**
  * Validation error - schema validation failed
  */
-declare class ValidationError extends AIDirectorError {
+declare class ValidationError extends HydraError {
     readonly validationErrors: unknown[];
     constructor(message: string, validationErrors?: unknown[]);
 }
 /**
  * Server error - internal server error
  */
-declare class ServerError extends AIDirectorError {
+declare class ServerError extends HydraError {
     constructor(message: string, statusCode?: number);
 }
 /**
- * Check if error is an AI Director error
+ * Quota exceeded error - monthly request limit reached
+ */
+declare class QuotaExceededError extends HydraError {
+    readonly tier: string;
+    readonly limit: number;
+    readonly used: number;
+    constructor(message: string, options: {
+        tier: string;
+        limit: number;
+        used: number;
+    });
+}
+/**
+ * Worker error - Cloudflare Worker execution failed
+ */
+declare class WorkerError extends HydraError {
+    readonly workerDurationMs?: number;
+    constructor(message: string, workerDurationMs?: number);
+}
+/**
+ * File processing error - attachment handling failed
+ */
+declare class FileProcessingError extends HydraError {
+    readonly filename?: string;
+    readonly mimeType?: string;
+    readonly reason: 'unsupported_type' | 'conversion_failed' | 'too_large' | 'corrupted';
+    constructor(message: string, options: {
+        filename?: string;
+        mimeType?: string;
+        reason: 'unsupported_type' | 'conversion_failed' | 'too_large' | 'corrupted';
+    });
+}
+/**
+ * Invalid schema error - provided schema is malformed
+ */
+declare class InvalidSchemaError extends HydraError {
+    readonly schemaPath?: string;
+    constructor(message: string, schemaPath?: string);
+}
+/**
+ * Check if error is an Hydra error
  */
-declare function isAIDirectorError(error: unknown): error is AIDirectorError;
+declare function isHydraError(error: unknown): error is HydraError;
 /**
  * Check if error is retryable
  */
@@ -904,4 +1025,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 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 };
+export { AuthenticationError, ChainExecutionError, type ChainInfo, type ChainStep, ConfigurationError, type DetailedHealthResult, type FileAttachment, FileProcessingError, type GenerateData, type GenerateError, type GenerateMeta, type GenerateOptions, type GenerateResult, type GenerationParameters, type HealthResult, Hydra, type HydraConfig, HydraError, InvalidSchemaError, type ModelInfo, NetworkError, QuotaExceededError, RateLimitError, ServerError, type StreamCallbacks, type StreamCompleteResult, type StreamProgress, TimeoutError, type TokenUsage, type UsageStats, ValidationError, type WebhookConfig, WorkerError, generateSignature, getKeyPrefix, isHydraError, isRetryableError, isValidSecretKey };

package/dist/index.d.ts

@@ -1,21 +1,21 @@
 /**
- * AI Director Client Types
+ * Hydra Client Types
  * Type definitions for the SDK
  */
 /**
- * Configuration for AI Director client
+ * Configuration for Hydra client
  */
-interface AIDirectorConfig {
+interface HydraConfig {
     /**
-     * Your AI Director secret key
-     * Get this from your dashboard at https://aidirector.dev/dashboard/keys
-     * Format: aid_sk_<random>
+     * Your Hydra secret key
+     * Get this from your dashboard at https://hydrai.dev/dashboard/keys
+     * Format: hyd_sk_<random>
      */
     secretKey: string;
     /**
      * API base URL
      * @default 'http://localhost:3000' in development
-     * @example 'https://api.aidirector.dev'
+     * @example 'https://api.hydrai.dev'
      */
     baseUrl?: string;
     /**
@@ -92,6 +92,35 @@ interface GenerateOptions {
      * @default true
      */
     useOptimized?: boolean;
+    /**
+     * Cache scope for this request.
+     * - 'global': Cache is shared across all users (default)
+     * - 'user': Cache is scoped to the authenticated user
+     * - 'skip': Do not cache this response
+     * @default 'global'
+     */
+    cacheScope?: 'global' | 'user' | 'skip';
+    /**
+     * AbortSignal for request cancellation.
+     * Pass a signal from an AbortController to cancel the request.
+     * @example
+     * ```typescript
+     * const controller = new AbortController();
+     * setTimeout(() => controller.abort(), 5000);
+     * await client.generate({ chainId: 'x', prompt: 'y', signal: controller.signal });
+     * ```
+     */
+    signal?: AbortSignal;
+    /**
+     * Override max retries for this specific request.
+     * Set to 0 to disable retries for idempotent-sensitive operations.
+     */
+    maxRetries?: number;
+    /**
+     * Client-generated request ID for tracing and debugging.
+     * If not provided, one will be generated automatically.
+     */
+    requestId?: string;
     /**
      * Generation parameters
      */
@@ -142,6 +171,12 @@ interface GenerationParameters {
      * System prompt to prepend
      */
     systemPrompt?: string;
+    /**
+     * Enable thinking/reasoning mode for supported models.
+     * When enabled, the model will show its reasoning process.
+     * Only works with models that support thinking (e.g., Gemini 2.0 Flash Thinking).
+     */
+    thinkingMode?: boolean;
 }
 /**
  * Result from the generate method
@@ -180,6 +215,15 @@ interface GenerateData {
      * Raw AI response text (useful for debugging)
      */
     rawContent?: string;
+    /**
+     * Report of auto-healed validation errors
+     * detailed log of how the system fixed invalid AI output
+     */
+    healingReport?: Array<{
+        original: unknown;
+        healed: unknown;
+        fixes: string[];
+    }>;
 }
 /**
  * Generation metadata
@@ -579,9 +623,9 @@ interface WebhookConfig {
 }
 
 /**
- * AI Director Client SDK
+ * Hydra Client SDK
  *
- * Production-grade client for the AI Director API gateway.
+ * Production-grade client for the Hydra API gateway.
  * Use in Next.js API routes, Server Actions, or any Node.js/Edge environment.
  *
  * Features:
@@ -593,11 +637,11 @@ interface WebhookConfig {
  *
  * @example
  * ```typescript
- * import { AIDirector } from '@aidirector/client';
+ * import { Hydra } from 'hydra-aidirector';
  *
- * const client = new AIDirector({
- *   secretKey: process.env.AIDIRECTOR_SECRET_KEY!,
- *   baseUrl: 'https://api.aidirector.dev',
+ * const client = new Hydra({
+ *   secretKey: process.env.HYDRA_SECRET_KEY!,
+ *   baseUrl: 'https://api.hydrai.dev',
  * });
  *
  * const result = await client.generate({
@@ -611,20 +655,20 @@ interface WebhookConfig {
  * }
  * ```
  */
-declare class AIDirector {
+declare class Hydra {
     private readonly secretKey;
     private readonly baseUrl;
     private readonly timeout;
     private readonly maxRetries;
     private readonly keyPrefix;
     private readonly debug;
-    constructor(config: AIDirectorConfig);
+    constructor(config: HydraConfig);
     /**
      * Generate content using your fallback chain
      *
      * @param options - Generation options
      * @returns Promise resolving to GenerateResult
-     * @throws AIDirectorError subclasses on failure
+     * @throws HydraError subclasses on failure
      *
      * @example
      * ```typescript
@@ -711,9 +755,9 @@ declare class AIDirector {
      * Useful for testing or switching environments
      *
      * @param overrides - Configuration overrides
-     * @returns New AIDirector instance
+     * @returns New Hydra instance
      */
-    withConfig(overrides: Partial<AIDirectorConfig>): AIDirector;
+    withConfig(overrides: Partial<HydraConfig>): Hydra;
     /**
      * Register a webhook for async notifications
      *
@@ -729,6 +773,43 @@ declare class AIDirector {
         registered: boolean;
         message: string;
     }>;
+    /**
+     * Unregister a webhook
+     *
+     * @param webhookId - ID of the webhook to unregister
+     * @returns Unregistration result
+     */
+    unregisterWebhook(webhookId: string): Promise<{
+        unregistered: boolean;
+        message: string;
+    }>;
+    /**
+     * List all registered webhooks
+     *
+     * @returns Array of webhook configurations
+     */
+    listWebhooks(): Promise<Array<{
+        id: string;
+        requestId: string;
+        url: string;
+        status: 'pending' | 'delivered' | 'failed';
+        retryCount: number;
+        createdAt: string;
+    }>>;
+    /**
+     * Update a webhook configuration
+     *
+     * @param webhookId - ID of the webhook to update
+     * @param updates - Fields to update
+     * @returns Updated webhook info
+     */
+    updateWebhook(webhookId: string, updates: {
+        url?: string;
+        retryCount?: number;
+    }): Promise<{
+        updated: boolean;
+        message: string;
+    }>;
     /**
      * Get detailed health information including component status
      *
@@ -802,13 +883,13 @@ declare class AIDirector {
 }
 
 /**
- * AI Director Error Classes
+ * Hydra Error Classes
  * Structured error types for better error handling
  */
 /**
- * Base error class for AI Director errors
+ * Base error class for Hydra errors
  */
-declare class AIDirectorError extends Error {
+declare class HydraError extends Error {
     readonly code: string;
     readonly retryable: boolean;
     readonly statusCode?: number;
@@ -822,59 +903,99 @@ declare class AIDirectorError extends Error {
 /**
  * Configuration error - invalid client setup
  */
-declare class ConfigurationError extends AIDirectorError {
+declare class ConfigurationError extends HydraError {
     constructor(message: string);
 }
 /**
  * Authentication error - invalid or expired credentials
  */
-declare class AuthenticationError extends AIDirectorError {
+declare class AuthenticationError extends HydraError {
     constructor(message: string, statusCode?: number);
 }
 /**
  * Rate limit error - too many requests
  */
-declare class RateLimitError extends AIDirectorError {
+declare class RateLimitError extends HydraError {
     readonly retryAfterMs: number;
     constructor(message: string, retryAfterMs?: number);
 }
 /**
  * Timeout error - request took too long
  */
-declare class TimeoutError extends AIDirectorError {
+declare class TimeoutError extends HydraError {
     readonly timeoutMs: number;
     constructor(timeoutMs: number);
 }
 /**
  * Network error - connection failed
  */
-declare class NetworkError extends AIDirectorError {
+declare class NetworkError extends HydraError {
     constructor(message: string, cause?: Error);
 }
 /**
  * Chain error - fallback chain execution failed
  */
-declare class ChainExecutionError extends AIDirectorError {
+declare class ChainExecutionError extends HydraError {
     readonly attemptedModels: string[];
     constructor(message: string, attemptedModels?: string[]);
 }
 /**
  * Validation error - schema validation failed
  */
-declare class ValidationError extends AIDirectorError {
+declare class ValidationError extends HydraError {
     readonly validationErrors: unknown[];
     constructor(message: string, validationErrors?: unknown[]);
 }
 /**
  * Server error - internal server error
  */
-declare class ServerError extends AIDirectorError {
+declare class ServerError extends HydraError {
     constructor(message: string, statusCode?: number);
 }
 /**
- * Check if error is an AI Director error
+ * Quota exceeded error - monthly request limit reached
+ */
+declare class QuotaExceededError extends HydraError {
+    readonly tier: string;
+    readonly limit: number;
+    readonly used: number;
+    constructor(message: string, options: {
+        tier: string;
+        limit: number;
+        used: number;
+    });
+}
+/**
+ * Worker error - Cloudflare Worker execution failed
+ */
+declare class WorkerError extends HydraError {
+    readonly workerDurationMs?: number;
+    constructor(message: string, workerDurationMs?: number);
+}
+/**
+ * File processing error - attachment handling failed
+ */
+declare class FileProcessingError extends HydraError {
+    readonly filename?: string;
+    readonly mimeType?: string;
+    readonly reason: 'unsupported_type' | 'conversion_failed' | 'too_large' | 'corrupted';
+    constructor(message: string, options: {
+        filename?: string;
+        mimeType?: string;
+        reason: 'unsupported_type' | 'conversion_failed' | 'too_large' | 'corrupted';
+    });
+}
+/**
+ * Invalid schema error - provided schema is malformed
+ */
+declare class InvalidSchemaError extends HydraError {
+    readonly schemaPath?: string;
+    constructor(message: string, schemaPath?: string);
+}
+/**
+ * Check if error is an Hydra error
  */
-declare function isAIDirectorError(error: unknown): error is AIDirectorError;
+declare function isHydraError(error: unknown): error is HydraError;
 /**
  * Check if error is retryable
  */
@@ -904,4 +1025,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 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 };
+export { AuthenticationError, ChainExecutionError, type ChainInfo, type ChainStep, ConfigurationError, type DetailedHealthResult, type FileAttachment, FileProcessingError, type GenerateData, type GenerateError, type GenerateMeta, type GenerateOptions, type GenerateResult, type GenerationParameters, type HealthResult, Hydra, type HydraConfig, HydraError, InvalidSchemaError, type ModelInfo, NetworkError, QuotaExceededError, RateLimitError, ServerError, type StreamCallbacks, type StreamCompleteResult, type StreamProgress, TimeoutError, type TokenUsage, type UsageStats, ValidationError, type WebhookConfig, WorkerError, generateSignature, getKeyPrefix, isHydraError, isRetryableError, isValidSecretKey };

package/dist/index.js

@@ -1,4 +1,4 @@
-'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;
+'use strict';var K=typeof process<"u"&&process.versions?.node;async function H(n){let{createHash:e}=await import('crypto');return e("sha256").update(n).digest("hex")}async function G(n,e,t,r,o){let{createHmac:s}=await import('crypto'),c=[e.toUpperCase(),t,o.toString(),r].join(`
+`),d=await H(n);return s("sha256",d).update(c).digest("hex")}async function L(n){let t=new TextEncoder().encode(n),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 W(n,e,t,r,o){let s=new TextEncoder,c=[e.toUpperCase(),t,o.toString(),r].join(`
+`),d=await L(n),a=s.encode(d),i=await crypto.subtle.importKey("raw",a,{name:"HMAC",hash:"SHA-256"},false,["sign"]),m=await crypto.subtle.sign("HMAC",i,s.encode(c));return Array.from(new Uint8Array(m)).map(p=>p.toString(16).padStart(2,"0")).join("")}async function T(n,e,t,r,o){return K?G(n,e,t,r,o):W(n,e,t,r,o)}function U(n){return n.slice(0,12)}function C(n){return typeof n=="string"&&n.startsWith("hyd_sk_")&&n.length>=20}var u=class extends Error{constructor(e,t,r){super(e),this.name="HydraError",this.code=t,this.retryable=r?.retryable??false,this.statusCode=r?.statusCode,this.originalError=r?.cause;}},k=class extends u{constructor(e){super(e,"CONFIGURATION_ERROR",{retryable:false}),this.name="ConfigurationError";}},x=class extends u{constructor(e,t){super(e,"AUTH_ERROR",{retryable:false,statusCode:t}),this.name="AuthenticationError";}},E=class extends u{constructor(e,t=6e4){super(e,"RATE_LIMITED",{retryable:true,statusCode:429}),this.name="RateLimitError",this.retryAfterMs=t;}},R=class extends u{constructor(e){super(`Request timed out after ${e}ms`,"TIMEOUT",{retryable:true}),this.name="TimeoutError",this.timeoutMs=e;}},w=class extends u{constructor(e,t){super(e,"NETWORK_ERROR",{retryable:true,cause:t}),this.name="NetworkError";}},f=class extends u{constructor(e,t=[]){super(e,"CHAIN_FAILED",{retryable:false}),this.name="ChainExecutionError",this.attemptedModels=t;}},P=class extends u{constructor(e,t=[]){super(e,"VALIDATION_ERROR",{retryable:false}),this.name="ValidationError",this.validationErrors=t;}},g=class extends u{constructor(e,t=500){super(e,"SERVER_ERROR",{retryable:true,statusCode:t}),this.name="ServerError";}},v=class extends u{constructor(e,t){super(e,"QUOTA_EXCEEDED",{retryable:false,statusCode:402}),this.name="QuotaExceededError",this.tier=t.tier,this.limit=t.limit,this.used=t.used;}},O=class extends u{constructor(e,t){super(e,"WORKER_ERROR",{retryable:true}),this.name="WorkerError",this.workerDurationMs=t;}},I=class extends u{constructor(e,t){super(e,"FILE_PROCESSING_ERROR",{retryable:false}),this.name="FileProcessingError",this.filename=t.filename,this.mimeType=t.mimeType,this.reason=t.reason;}},M=class extends u{constructor(e,t){super(e,"INVALID_SCHEMA",{retryable:false}),this.name="InvalidSchemaError",this.schemaPath=t;}};function _(n){return n instanceof u}function q(n){return _(n)?n.retryable:false}var F="http://localhost:3000",$=6e5,B=3,N=[1e3,2e3,5e3];function J(n){let e=n.trim(),t=e.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);t&&(e=t[1].trim());let r=e.indexOf("{"),o=e.indexOf("["),s;if(r===-1&&o===-1)return e;r===-1?s=o:o===-1?s=r:s=Math.min(r,o);let c=e[s],d=c==="{"?"}":"]",a=0,i=false,m=false,y=-1;for(let h=s;h<e.length;h++){let b=e[h];if(m){m=false;continue}if(b==="\\"&&i){m=true;continue}if(b==='"'&&!m){i=!i;continue}if(!i){if(b===c)a++;else if(b===d&&(a--,a===0)){y=h;break}}}if(y!==-1)return e.slice(s,y+1);let p=e.lastIndexOf(d);return p>s?e.slice(s,p+1):e}var D=class n{constructor(e){if(!e.secretKey)throw new k("secretKey is required");if(!C(e.secretKey))throw new k("Invalid secret key format. Expected format: hyd_sk_<key>");this.secretKey=e.secretKey,this.baseUrl=(e.baseUrl||F).replace(/\/$/,""),this.timeout=e.timeout??$,this.maxRetries=e.maxRetries??B,this.keyPrefix=U(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",o=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",o);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 f("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}),a=await(await this.fetchWithTimeout(s.workerUrl,{method:"POST",headers:{"Content-Type":"application/json"},body:c},e.timeout??this.timeout)).json();if(!a.success||!a.content)return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:a.modelId||"",tokensUsed:a.tokensUsed||{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[a.modelId||""]},error:{code:a.errorCode||"GENERATION_FAILED",message:a.errorMessage||"Generation failed",retryable:false}};let i=[],m=[],y=J(a.content);try{let h=JSON.parse(y);Array.isArray(h)?i=h:i=[h];}catch{i=[y];}a.completionToken&&this.cacheCompletionAsync({completionToken:a.completionToken,content:a.content,tokensUsed:a.tokensUsed||{input:0,output:0},finishReason:a.finishReason||"stop",chainId:e.chainId,modelUsed:a.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 p=Date.now()-t;return this.debug&&this.log("generate success (optimized 3-step)",{latencyMs:p,modelUsed:a.modelId,tokensUsed:a.tokensUsed}),{success:true,data:{valid:i,invalid:m},meta:{cached:false,modelUsed:a.modelId,tokensUsed:a.tokensUsed||{input:0,output:0},latencyMs:p,attemptedModels:[a.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",o=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 a=0;a<=this.maxRetries;a++)try{let i=await this.makeAuthenticatedRequest(r,"POST",o,e.timeout),m=Date.now()-t;return this.debug&&this.log("generate success (legacy)",{latencyMs:m,attempt:a+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 ${a+1} failed`,{error:s.message}),!this.isRetryable(i)||a>=this.maxRetries)break;let m=N[Math.min(a,N.length-1)];i instanceof E&&i.retryAfterMs>m?await this.sleep(i.retryAfterMs):await this.sleep(m);}let c=Date.now()-t,d=s instanceof R;return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:"",tokensUsed:{input:0,output:0},latencyMs:c,attemptedModels:[]},error:{code:d?"TIMEOUT":"REQUEST_FAILED",message:s?.message||"Request failed after all retries",retryable:false}}}async generateStream(e,t){let r="/api/v1/generate/stream",o=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,options:e.options});try{let s=Date.now(),c=await T(this.secretKey,"POST",r,o,s),d=await this.fetchWithTimeout(`${this.baseUrl}${r}`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"text/event-stream","x-hydra-signature":c,"x-hydra-timestamp":s.toString(),"x-hydra-key":this.keyPrefix},body:o},e.timeout??this.timeout);if(!d.ok){let p=await d.json();throw this.parseError(d.status,p)}let a=d.body?.getReader();if(!a)throw new w("Response body is not readable");let i=new TextDecoder,m="",y=[];for(;;){let{done:p,value:h}=await a.read();if(p)break;m+=i.decode(h,{stream:!0});let b=m.split(`
+`);m=b.pop()||"";let A="";for(let S of b){if(S.startsWith("event: ")){A=S.slice(7).trim();continue}if(S.startsWith("data: ")){let j=S.slice(6);if(j==="[DONE]")break;try{let l=JSON.parse(j);switch(A){case "start":this.debug&&this.log("Stream started",l);break;case "object":l.object!==void 0&&(y.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:y,objectCount:l.objectCount,tokensUsed:l.tokensUsed,cached:l.cached});break;case "error":t.onError&&t.onError(new f(l.error||"Stream error",["STREAM_ERROR"]));break;default:l.chunk&&t.onChunk?.(l.chunk);}}catch{}A="";}}}}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 g(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 g(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 g(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,o=await t.json().catch(()=>({}));return {ok:t.ok,latencyMs:r,version:o.version}}catch{return {ok:false,latencyMs:Date.now()-e}}}withConfig(e){return new n({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 g(t.error?.message||"Failed to register webhook");return t.data}async unregisterWebhook(e){let t=await this.makeAuthenticatedRequest(`/api/v1/webhooks/${e}`,"DELETE","");if(!t.success||!t.data)throw new g(t.error?.message||"Failed to unregister webhook");return t.data}async listWebhooks(){let e=await this.makeAuthenticatedRequest("/api/v1/webhooks","GET","");if(!e.success)throw new g(e.error?.message||"Failed to list webhooks");return e.data||[]}async updateWebhook(e,t){let r=await this.makeAuthenticatedRequest(`/api/v1/webhooks/${e}`,"PATCH",JSON.stringify(t));if(!r.success||!r.data)throw new g(r.error?.message||"Failed to update webhook");return r.data}async healthDetailed(){return (await fetch(`${this.baseUrl}/api/v1/health/detailed`,{headers:{Accept:"application/json"}})).json()}async generateBatch(e,t,r={}){let o=await this.makeAuthenticatedRequest("/api/v1/generate/batch","POST",JSON.stringify({chainId:e,items:t,continueOnError:r.continueOnError??true}));if(!o.success||!o.data)throw new f(o.error?.message||"Batch generation failed",[]);return o.data}async makeAuthenticatedRequest(e,t,r,o){let s=Date.now(),c=await T(this.secretKey,t,e,r,s),d=await this.fetchWithTimeout(`${this.baseUrl}${e}`,{method:t,headers:{"Content-Type":"application/json",Accept:"application/json","x-hydra-signature":c,"x-hydra-timestamp":s.toString(),"x-hydra-key":this.keyPrefix},body:r},o??this.timeout),a=await d.json();if(!d.ok)throw this.parseError(d.status,a);return a}async fetchWithTimeout(e,t,r=this.timeout){let o=new AbortController,s=setTimeout(()=>o.abort(),r);try{return await fetch(e,{...t,signal:o.signal})}catch(c){throw c instanceof Error&&c.name==="AbortError"?new R(r):c instanceof Error?new w(c.message,c):new w(String(c))}finally{clearTimeout(s);}}parseError(e,t){let r=t?.error?.message||`HTTP ${e}`,o=t?.error?.code||"UNKNOWN";switch(e){case 401:return new x(r,e);case 429:let s=t?.retryAfterMs||6e4;return new E(r,s);case 500:case 502:case 503:case 504:return new g(r,e);default:return o==="CHAIN_FAILED"?new f(r,t?.error?.attemptedModels||[]):new u(r,o,{statusCode:e,retryable:e>=500})}}isRetryable(e){if(e instanceof u)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="[Hydra]";t?console.log(r,e,t):console.log(r,e);}};exports.AuthenticationError=x;exports.ChainExecutionError=f;exports.ConfigurationError=k;exports.FileProcessingError=I;exports.Hydra=D;exports.HydraError=u;exports.InvalidSchemaError=M;exports.NetworkError=w;exports.QuotaExceededError=v;exports.RateLimitError=E;exports.ServerError=g;exports.TimeoutError=R;exports.ValidationError=P;exports.WorkerError=O;exports.generateSignature=T;exports.getKeyPrefix=U;exports.isHydraError=_;exports.isRetryableError=q;exports.isValidSecretKey=C;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-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};
+var K=typeof process<"u"&&process.versions?.node;async function H(n){let{createHash:e}=await import('crypto');return e("sha256").update(n).digest("hex")}async function G(n,e,t,r,o){let{createHmac:s}=await import('crypto'),c=[e.toUpperCase(),t,o.toString(),r].join(`
+`),d=await H(n);return s("sha256",d).update(c).digest("hex")}async function L(n){let t=new TextEncoder().encode(n),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 W(n,e,t,r,o){let s=new TextEncoder,c=[e.toUpperCase(),t,o.toString(),r].join(`
+`),d=await L(n),a=s.encode(d),i=await crypto.subtle.importKey("raw",a,{name:"HMAC",hash:"SHA-256"},false,["sign"]),m=await crypto.subtle.sign("HMAC",i,s.encode(c));return Array.from(new Uint8Array(m)).map(p=>p.toString(16).padStart(2,"0")).join("")}async function T(n,e,t,r,o){return K?G(n,e,t,r,o):W(n,e,t,r,o)}function U(n){return n.slice(0,12)}function C(n){return typeof n=="string"&&n.startsWith("hyd_sk_")&&n.length>=20}var u=class extends Error{constructor(e,t,r){super(e),this.name="HydraError",this.code=t,this.retryable=r?.retryable??false,this.statusCode=r?.statusCode,this.originalError=r?.cause;}},k=class extends u{constructor(e){super(e,"CONFIGURATION_ERROR",{retryable:false}),this.name="ConfigurationError";}},x=class extends u{constructor(e,t){super(e,"AUTH_ERROR",{retryable:false,statusCode:t}),this.name="AuthenticationError";}},E=class extends u{constructor(e,t=6e4){super(e,"RATE_LIMITED",{retryable:true,statusCode:429}),this.name="RateLimitError",this.retryAfterMs=t;}},R=class extends u{constructor(e){super(`Request timed out after ${e}ms`,"TIMEOUT",{retryable:true}),this.name="TimeoutError",this.timeoutMs=e;}},w=class extends u{constructor(e,t){super(e,"NETWORK_ERROR",{retryable:true,cause:t}),this.name="NetworkError";}},f=class extends u{constructor(e,t=[]){super(e,"CHAIN_FAILED",{retryable:false}),this.name="ChainExecutionError",this.attemptedModels=t;}},P=class extends u{constructor(e,t=[]){super(e,"VALIDATION_ERROR",{retryable:false}),this.name="ValidationError",this.validationErrors=t;}},g=class extends u{constructor(e,t=500){super(e,"SERVER_ERROR",{retryable:true,statusCode:t}),this.name="ServerError";}},v=class extends u{constructor(e,t){super(e,"QUOTA_EXCEEDED",{retryable:false,statusCode:402}),this.name="QuotaExceededError",this.tier=t.tier,this.limit=t.limit,this.used=t.used;}},O=class extends u{constructor(e,t){super(e,"WORKER_ERROR",{retryable:true}),this.name="WorkerError",this.workerDurationMs=t;}},I=class extends u{constructor(e,t){super(e,"FILE_PROCESSING_ERROR",{retryable:false}),this.name="FileProcessingError",this.filename=t.filename,this.mimeType=t.mimeType,this.reason=t.reason;}},M=class extends u{constructor(e,t){super(e,"INVALID_SCHEMA",{retryable:false}),this.name="InvalidSchemaError",this.schemaPath=t;}};function _(n){return n instanceof u}function q(n){return _(n)?n.retryable:false}var F="http://localhost:3000",$=6e5,B=3,N=[1e3,2e3,5e3];function J(n){let e=n.trim(),t=e.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);t&&(e=t[1].trim());let r=e.indexOf("{"),o=e.indexOf("["),s;if(r===-1&&o===-1)return e;r===-1?s=o:o===-1?s=r:s=Math.min(r,o);let c=e[s],d=c==="{"?"}":"]",a=0,i=false,m=false,y=-1;for(let h=s;h<e.length;h++){let b=e[h];if(m){m=false;continue}if(b==="\\"&&i){m=true;continue}if(b==='"'&&!m){i=!i;continue}if(!i){if(b===c)a++;else if(b===d&&(a--,a===0)){y=h;break}}}if(y!==-1)return e.slice(s,y+1);let p=e.lastIndexOf(d);return p>s?e.slice(s,p+1):e}var D=class n{constructor(e){if(!e.secretKey)throw new k("secretKey is required");if(!C(e.secretKey))throw new k("Invalid secret key format. Expected format: hyd_sk_<key>");this.secretKey=e.secretKey,this.baseUrl=(e.baseUrl||F).replace(/\/$/,""),this.timeout=e.timeout??$,this.maxRetries=e.maxRetries??B,this.keyPrefix=U(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",o=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",o);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 f("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}),a=await(await this.fetchWithTimeout(s.workerUrl,{method:"POST",headers:{"Content-Type":"application/json"},body:c},e.timeout??this.timeout)).json();if(!a.success||!a.content)return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:a.modelId||"",tokensUsed:a.tokensUsed||{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[a.modelId||""]},error:{code:a.errorCode||"GENERATION_FAILED",message:a.errorMessage||"Generation failed",retryable:false}};let i=[],m=[],y=J(a.content);try{let h=JSON.parse(y);Array.isArray(h)?i=h:i=[h];}catch{i=[y];}a.completionToken&&this.cacheCompletionAsync({completionToken:a.completionToken,content:a.content,tokensUsed:a.tokensUsed||{input:0,output:0},finishReason:a.finishReason||"stop",chainId:e.chainId,modelUsed:a.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 p=Date.now()-t;return this.debug&&this.log("generate success (optimized 3-step)",{latencyMs:p,modelUsed:a.modelId,tokensUsed:a.tokensUsed}),{success:true,data:{valid:i,invalid:m},meta:{cached:false,modelUsed:a.modelId,tokensUsed:a.tokensUsed||{input:0,output:0},latencyMs:p,attemptedModels:[a.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",o=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 a=0;a<=this.maxRetries;a++)try{let i=await this.makeAuthenticatedRequest(r,"POST",o,e.timeout),m=Date.now()-t;return this.debug&&this.log("generate success (legacy)",{latencyMs:m,attempt:a+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 ${a+1} failed`,{error:s.message}),!this.isRetryable(i)||a>=this.maxRetries)break;let m=N[Math.min(a,N.length-1)];i instanceof E&&i.retryAfterMs>m?await this.sleep(i.retryAfterMs):await this.sleep(m);}let c=Date.now()-t,d=s instanceof R;return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:"",tokensUsed:{input:0,output:0},latencyMs:c,attemptedModels:[]},error:{code:d?"TIMEOUT":"REQUEST_FAILED",message:s?.message||"Request failed after all retries",retryable:false}}}async generateStream(e,t){let r="/api/v1/generate/stream",o=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,options:e.options});try{let s=Date.now(),c=await T(this.secretKey,"POST",r,o,s),d=await this.fetchWithTimeout(`${this.baseUrl}${r}`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"text/event-stream","x-hydra-signature":c,"x-hydra-timestamp":s.toString(),"x-hydra-key":this.keyPrefix},body:o},e.timeout??this.timeout);if(!d.ok){let p=await d.json();throw this.parseError(d.status,p)}let a=d.body?.getReader();if(!a)throw new w("Response body is not readable");let i=new TextDecoder,m="",y=[];for(;;){let{done:p,value:h}=await a.read();if(p)break;m+=i.decode(h,{stream:!0});let b=m.split(`
+`);m=b.pop()||"";let A="";for(let S of b){if(S.startsWith("event: ")){A=S.slice(7).trim();continue}if(S.startsWith("data: ")){let j=S.slice(6);if(j==="[DONE]")break;try{let l=JSON.parse(j);switch(A){case "start":this.debug&&this.log("Stream started",l);break;case "object":l.object!==void 0&&(y.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:y,objectCount:l.objectCount,tokensUsed:l.tokensUsed,cached:l.cached});break;case "error":t.onError&&t.onError(new f(l.error||"Stream error",["STREAM_ERROR"]));break;default:l.chunk&&t.onChunk?.(l.chunk);}}catch{}A="";}}}}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 g(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 g(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 g(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,o=await t.json().catch(()=>({}));return {ok:t.ok,latencyMs:r,version:o.version}}catch{return {ok:false,latencyMs:Date.now()-e}}}withConfig(e){return new n({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 g(t.error?.message||"Failed to register webhook");return t.data}async unregisterWebhook(e){let t=await this.makeAuthenticatedRequest(`/api/v1/webhooks/${e}`,"DELETE","");if(!t.success||!t.data)throw new g(t.error?.message||"Failed to unregister webhook");return t.data}async listWebhooks(){let e=await this.makeAuthenticatedRequest("/api/v1/webhooks","GET","");if(!e.success)throw new g(e.error?.message||"Failed to list webhooks");return e.data||[]}async updateWebhook(e,t){let r=await this.makeAuthenticatedRequest(`/api/v1/webhooks/${e}`,"PATCH",JSON.stringify(t));if(!r.success||!r.data)throw new g(r.error?.message||"Failed to update webhook");return r.data}async healthDetailed(){return (await fetch(`${this.baseUrl}/api/v1/health/detailed`,{headers:{Accept:"application/json"}})).json()}async generateBatch(e,t,r={}){let o=await this.makeAuthenticatedRequest("/api/v1/generate/batch","POST",JSON.stringify({chainId:e,items:t,continueOnError:r.continueOnError??true}));if(!o.success||!o.data)throw new f(o.error?.message||"Batch generation failed",[]);return o.data}async makeAuthenticatedRequest(e,t,r,o){let s=Date.now(),c=await T(this.secretKey,t,e,r,s),d=await this.fetchWithTimeout(`${this.baseUrl}${e}`,{method:t,headers:{"Content-Type":"application/json",Accept:"application/json","x-hydra-signature":c,"x-hydra-timestamp":s.toString(),"x-hydra-key":this.keyPrefix},body:r},o??this.timeout),a=await d.json();if(!d.ok)throw this.parseError(d.status,a);return a}async fetchWithTimeout(e,t,r=this.timeout){let o=new AbortController,s=setTimeout(()=>o.abort(),r);try{return await fetch(e,{...t,signal:o.signal})}catch(c){throw c instanceof Error&&c.name==="AbortError"?new R(r):c instanceof Error?new w(c.message,c):new w(String(c))}finally{clearTimeout(s);}}parseError(e,t){let r=t?.error?.message||`HTTP ${e}`,o=t?.error?.code||"UNKNOWN";switch(e){case 401:return new x(r,e);case 429:let s=t?.retryAfterMs||6e4;return new E(r,s);case 500:case 502:case 503:case 504:return new g(r,e);default:return o==="CHAIN_FAILED"?new f(r,t?.error?.attemptedModels||[]):new u(r,o,{statusCode:e,retryable:e>=500})}}isRetryable(e){if(e instanceof u)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="[Hydra]";t?console.log(r,e,t):console.log(r,e);}};export{x as AuthenticationError,f as ChainExecutionError,k as ConfigurationError,I as FileProcessingError,D as Hydra,u as HydraError,M as InvalidSchemaError,w as NetworkError,v as QuotaExceededError,E as RateLimitError,g as ServerError,R as TimeoutError,P as ValidationError,O as WorkerError,T as generateSignature,U as getKeyPrefix,_ as isHydraError,q as isRetryableError,C as isValidSecretKey};

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@altsafe/aidirector",
-    "version": "1.2.0",
-    "description": "Official TypeScript SDK for AI Director - Intelligent AI API Gateway with automatic failover, caching, and JSON extraction",
+    "version": "1.4.0",
+    "description": "Official TypeScript SDK for Hydra - Intelligent AI API Gateway with automatic failover, caching, and JSON extraction",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",
     "types": "./dist/index.d.ts",
@@ -32,7 +32,7 @@
         "prepublishOnly": "npm run build",
         "clean": "rimraf dist",
         "publish:check": "npm pack --dry-run",
-        "release": "npm run build && npm publish",
+        "release": "npm run build && npm publish --access public",
         "release:beta": "npm run build && npm publish --tag beta"
     },
     "keywords": [
@@ -51,17 +51,17 @@
         "hmac"
     ],
     "author": {
-        "name": "AI Director",
-        "url": "https://aidirector.dev"
+        "name": "Hydra",
+        "url": "https://hydrai.dev"
     },
     "license": "MIT",
-    "homepage": "https://aidirector.dev",
+    "homepage": "https://hydrai.dev",
     "bugs": {
-        "url": "https://github.com/aidirector/client/issues"
+        "url": "https://github.com/hydrai/client/issues"
     },
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/aidirector/client.git"
+        "url": "git+https://github.com/hydrai/client.git"
     },
     "publishConfig": {
         "access": "public",