@dotdo/do 0.1.0

package/dist/ai/embeddings.js

@@ -0,0 +1,217 @@
+/**
+ * Embeddings - Vector Representations
+ *
+ * Generate vector embeddings for semantic search and similarity.
+ *
+ * Features:
+ * - Single and batch embedding generation
+ * - Multiple provider support
+ * - Configurable dimensions
+ * - Caching for repeated texts
+ *
+ * @module ai/embeddings
+ */
+/**
+ * Default embedding model by provider
+ */
+const DEFAULT_MODELS = {
+    openai: 'text-embedding-3-small',
+    cohere: 'embed-english-v3.0',
+    mistral: 'mistral-embed',
+    google: 'text-embedding-004',
+    voyage: 'voyage-3',
+    cloudflare: '@cf/baai/bge-base-en-v1.5',
+};
+/**
+ * Max batch size by provider
+ */
+const MAX_BATCH_SIZE = {
+    openai: 2048,
+    cohere: 96,
+    mistral: 512,
+    google: 250,
+    voyage: 128,
+    cloudflare: 100,
+};
+/**
+ * Generate embedding for a single text
+ *
+ * @param text - The text to embed
+ * @param options - Embedding options
+ * @returns Embedding result with vector
+ *
+ * @example
+ * ```typescript
+ * // Simple embedding
+ * const result = await embed('Hello world')
+ * console.log(result.embedding) // number[]
+ * console.log(result.dimensions) // e.g., 1536
+ *
+ * // With options
+ * const result = await embed('Hello', {
+ *   provider: 'openai',
+ *   model: 'text-embedding-3-large',
+ *   dimensions: 1024
+ * })
+ * ```
+ */
+export async function embed(text, options) {
+    // TODO: Implement single embedding
+    // 1. Select provider and model
+    // 2. Build provider-specific request
+    // 3. Make gateway request
+    // 4. Normalize response
+    throw new Error('Not implemented');
+}
+/**
+ * Generate embeddings for multiple texts
+ *
+ * Automatically handles batching based on provider limits.
+ *
+ * @param texts - Array of texts to embed
+ * @param options - Embedding options
+ * @returns Batch embedding result
+ *
+ * @example
+ * ```typescript
+ * const results = await embedBatch([
+ *   'First document',
+ *   'Second document',
+ *   'Third document'
+ * ])
+ *
+ * results.embeddings.forEach((e, i) => {
+ *   console.log(`Document ${i}: ${e.dimensions} dimensions`)
+ * })
+ * ```
+ */
+export async function embedBatch(texts, options) {
+    // TODO: Implement batch embedding
+    // 1. Select provider and model
+    // 2. Split into chunks based on provider batch limits
+    // 3. Make parallel requests for each chunk
+    // 4. Combine results
+    // 5. Track total usage
+    throw new Error('Not implemented');
+}
+/**
+ * Compute cosine similarity between two embeddings
+ *
+ * @param a - First embedding vector
+ * @param b - Second embedding vector
+ * @returns Similarity score between -1 and 1
+ *
+ * @example
+ * ```typescript
+ * const e1 = await embed('Hello')
+ * const e2 = await embed('Hi there')
+ * const similarity = cosineSimilarity(e1.embedding, e2.embedding)
+ * // => 0.85 (high similarity)
+ * ```
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error('Embedding dimensions must match');
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+/**
+ * Compute Euclidean distance between two embeddings
+ *
+ * @param a - First embedding vector
+ * @param b - Second embedding vector
+ * @returns Distance (0 = identical)
+ */
+export function euclideanDistance(a, b) {
+    if (a.length !== b.length) {
+        throw new Error('Embedding dimensions must match');
+    }
+    let sum = 0;
+    for (let i = 0; i < a.length; i++) {
+        const diff = a[i] - b[i];
+        sum += diff * diff;
+    }
+    return Math.sqrt(sum);
+}
+/**
+ * Find the most similar embeddings from a set
+ *
+ * @param query - Query embedding
+ * @param candidates - Array of candidate embeddings
+ * @param topK - Number of results to return
+ * @returns Indices and scores of most similar candidates
+ *
+ * @example
+ * ```typescript
+ * const queryEmbed = await embed('programming languages')
+ * const docEmbeds = await embedBatch(['Python', 'JavaScript', 'Cooking', 'Music'])
+ *
+ * const results = findSimilar(
+ *   queryEmbed.embedding,
+ *   docEmbeds.embeddings.map(e => e.embedding),
+ *   2
+ * )
+ * // => [{ index: 0, score: 0.9 }, { index: 1, score: 0.88 }]
+ * ```
+ */
+export function findSimilar(query, candidates, topK = 5) {
+    const scores = candidates.map((candidate, index) => ({
+        index,
+        score: cosineSimilarity(query, candidate),
+    }));
+    scores.sort((a, b) => b.score - a.score);
+    return scores.slice(0, topK);
+}
+/**
+ * Normalize embedding to unit length
+ *
+ * @param embedding - Embedding vector
+ * @returns Normalized vector
+ */
+export function normalizeEmbedding(embedding) {
+    const norm = Math.sqrt(embedding.reduce((sum, val) => sum + val * val, 0));
+    return embedding.map((val) => val / norm);
+}
+/**
+ * Get the default model for a provider
+ *
+ * @internal
+ */
+export function getDefaultModel(provider) {
+    return DEFAULT_MODELS[provider];
+}
+/**
+ * Get the max batch size for a provider
+ *
+ * @internal
+ */
+export function getMaxBatchSize(provider) {
+    return MAX_BATCH_SIZE[provider];
+}
+/**
+ * Format embedding request for provider
+ *
+ * @internal
+ */
+function formatEmbeddingRequest(texts, provider, options) {
+    // TODO: Handle provider-specific request formats
+    throw new Error('Not implemented');
+}
+/**
+ * Parse embedding response from provider
+ *
+ * @internal
+ */
+function parseEmbeddingResponse(response, provider) {
+    // TODO: Normalize provider responses
+    throw new Error('Not implemented');
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/ai/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../ai/embeddings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH;;GAEG;AACH,MAAM,cAAc,GAAsC;IACxD,MAAM,EAAE,wBAAwB;IAChC,MAAM,EAAE,oBAAoB;IAC5B,OAAO,EAAE,eAAe;IACxB,MAAM,EAAE,oBAAoB;IAC5B,MAAM,EAAE,UAAU;IAClB,UAAU,EAAE,2BAA2B;CACxC,CAAA;AAED;;GAEG;AACH,MAAM,cAAc,GAAsC;IACxD,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,GAAG;IACZ,MAAM,EAAE,GAAG;IACX,MAAM,EAAE,GAAG;IACX,UAAU,EAAE,GAAG;CAChB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,IAAY,EACZ,OAA0B;IAE1B,mCAAmC;IACnC,+BAA+B;IAC/B,qCAAqC;IACrC,0BAA0B;IAC1B,wBAAwB;IACxB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAe,EACf,OAA0B;IAE1B,kCAAkC;IAClC,+BAA+B;IAC/B,sDAAsD;IACtD,2CAA2C;IAC3C,qBAAqB;IACrB,uBAAuB;IACvB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IACpD,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACzB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACpB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACtB,CAAC;IAED,OAAO,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;AAC3D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAW,EAAE,CAAW;IACxD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IACpD,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACxB,GAAG,IAAI,IAAI,GAAG,IAAI,CAAA;IACpB,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CACzB,KAAe,EACf,UAAsB,EACtB,OAAe,CAAC;IAEhB,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACnD,KAAK;QACL,KAAK,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC;KAC1C,CAAC,CAAC,CAAA;IAEH,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;IAExC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAmB;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IAC1E,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,CAAA;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAA2B;IACzD,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAA;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAA2B;IACzD,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAA;AACjC,CAAC;AAED;;;;GAIG;AACH,SAAS,sBAAsB,CAC7B,KAAe,EACf,QAA2B,EAC3B,OAA0B;IAE1B,iDAAiD;IACjD,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC;AAED;;;;GAIG;AACH,SAAS,sBAAsB,CAC7B,QAAiB,EACjB,QAA2B;IAE3B,qCAAqC;IACrC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC"}

package/dist/ai/gateway.d.ts

@@ -0,0 +1,139 @@
+/**
+ * AI Gateway - Cloudflare AI Gateway Client
+ *
+ * Provides unified routing to multiple AI providers through Cloudflare AI Gateway.
+ *
+ * Features:
+ * - Multi-provider routing (OpenAI, Anthropic, Google, etc.)
+ * - Rate limiting and caching
+ * - Cost tracking and observability
+ * - Automatic retries with fallback providers
+ *
+ * @module ai/gateway
+ */
+import type { AIGatewayConfig, AIGatewayUsage, TextLLMProvider, EmbeddingProvider, ImageProvider, VoiceSynthesisProvider, SpeechRecognitionProvider } from '../types/ai';
+/**
+ * Configure the AI Gateway
+ *
+ * @param config - Gateway configuration
+ *
+ * @example
+ * ```typescript
+ * setGateway({
+ *   gatewayId: 'my-gateway',
+ *   accountId: 'cf-account-id',
+ *   cacheEnabled: true,
+ *   cacheTtl: 3600,
+ *   rateLimit: { requestsPerMinute: 60 },
+ *   fallbackProviders: ['anthropic', 'openai']
+ * })
+ * ```
+ */
+export declare function setGateway(config: AIGatewayConfig): void;
+/**
+ * Get current gateway configuration
+ *
+ * @returns Current gateway config or null if not configured
+ */
+export declare function getGateway(): AIGatewayConfig | null;
+/**
+ * Build gateway URL for a provider
+ *
+ * @param provider - The AI provider
+ * @returns Full gateway URL
+ *
+ * @example
+ * ```typescript
+ * const url = getGatewayUrl('openai')
+ * // => 'https://gateway.ai.cloudflare.com/v1/{accountId}/{gatewayId}/openai'
+ * ```
+ */
+export declare function getGatewayUrl(provider: TextLLMProvider | EmbeddingProvider | ImageProvider | VoiceSynthesisProvider | SpeechRecognitionProvider): string;
+/**
+ * Make a request through the AI Gateway
+ *
+ * Handles:
+ * - Authentication headers per provider
+ * - Caching headers
+ * - Rate limiting
+ * - Retries with exponential backoff
+ * - Fallback to alternative providers
+ *
+ * @param provider - The AI provider
+ * @param endpoint - API endpoint path
+ * @param body - Request body
+ * @param options - Additional request options
+ * @returns Response from the provider
+ *
+ * @example
+ * ```typescript
+ * const response = await gatewayRequest('openai', '/chat/completions', {
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'Hello' }]
+ * })
+ * ```
+ */
+export declare function gatewayRequest<T>(provider: TextLLMProvider | EmbeddingProvider | ImageProvider, endpoint: string, body: unknown, options?: {
+    /** Skip cache for this request */
+    skipCache?: boolean;
+    /** Custom timeout in ms */
+    timeout?: number;
+    /** Stream response */
+    stream?: boolean;
+}): Promise<T>;
+/**
+ * Make a streaming request through the AI Gateway
+ *
+ * @param provider - The AI provider
+ * @param endpoint - API endpoint path
+ * @param body - Request body
+ * @returns AsyncIterable of response chunks
+ *
+ * @example
+ * ```typescript
+ * for await (const chunk of gatewayStream('openai', '/chat/completions', {
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'Hello' }],
+ *   stream: true
+ * })) {
+ *   process.stdout.write(chunk)
+ * }
+ * ```
+ */
+export declare function gatewayStream(provider: TextLLMProvider, endpoint: string, body: unknown): AsyncIterable<string>;
+/**
+ * Get usage statistics from the gateway
+ *
+ * @param startDate - Start timestamp (ms)
+ * @param endDate - End timestamp (ms)
+ * @returns Array of usage records
+ *
+ * @example
+ * ```typescript
+ * const usage = await getUsage(
+ *   Date.now() - 86400000, // Last 24 hours
+ *   Date.now()
+ * )
+ * const totalCost = usage.reduce((sum, u) => sum + u.cost, 0)
+ * ```
+ */
+export declare function getUsage(startDate?: number, endDate?: number): Promise<AIGatewayUsage[]>;
+/**
+ * Track a request for usage/cost monitoring
+ *
+ * @internal
+ */
+export declare function trackUsage(usage: AIGatewayUsage): void;
+/**
+ * Get authentication headers for a provider
+ *
+ * @internal
+ */
+export declare function getProviderHeaders(provider: TextLLMProvider | EmbeddingProvider | ImageProvider | VoiceSynthesisProvider | SpeechRecognitionProvider): Record<string, string>;
+/**
+ * Normalize error from provider to standard format
+ *
+ * @internal
+ */
+export declare function normalizeError(error: unknown, provider: string): Error;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/ai/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../ai/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,yBAAyB,EAC1B,MAAM,aAAa,CAAA;AAOpB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAGxD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,eAAe,GAAG,IAAI,CAGnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,eAAe,GAAG,iBAAiB,GAAG,aAAa,GAAG,sBAAsB,GAAG,yBAAyB,GACjH,MAAM,CAMR;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,QAAQ,EAAE,eAAe,GAAG,iBAAiB,GAAG,aAAa,EAC7D,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IACR,kCAAkC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sBAAsB;IACtB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,GACA,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAuB,aAAa,CAClC,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GACZ,aAAa,CAAC,MAAM,CAAC,CAQvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,QAAQ,CAC5B,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CAI3B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAGtD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,GAAG,iBAAiB,GAAG,aAAa,GAAG,sBAAsB,GAAG,yBAAyB,GACjH,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,KAAK,CAIP"}

package/dist/ai/gateway.js

@@ -0,0 +1,179 @@
+/**
+ * AI Gateway - Cloudflare AI Gateway Client
+ *
+ * Provides unified routing to multiple AI providers through Cloudflare AI Gateway.
+ *
+ * Features:
+ * - Multi-provider routing (OpenAI, Anthropic, Google, etc.)
+ * - Rate limiting and caching
+ * - Cost tracking and observability
+ * - Automatic retries with fallback providers
+ *
+ * @module ai/gateway
+ */
+/**
+ * Gateway state (singleton)
+ */
+let gatewayConfig = null;
+/**
+ * Configure the AI Gateway
+ *
+ * @param config - Gateway configuration
+ *
+ * @example
+ * ```typescript
+ * setGateway({
+ *   gatewayId: 'my-gateway',
+ *   accountId: 'cf-account-id',
+ *   cacheEnabled: true,
+ *   cacheTtl: 3600,
+ *   rateLimit: { requestsPerMinute: 60 },
+ *   fallbackProviders: ['anthropic', 'openai']
+ * })
+ * ```
+ */
+export function setGateway(config) {
+    // TODO: Implement gateway configuration
+    gatewayConfig = config;
+}
+/**
+ * Get current gateway configuration
+ *
+ * @returns Current gateway config or null if not configured
+ */
+export function getGateway() {
+    // TODO: Implement getter
+    return gatewayConfig;
+}
+/**
+ * Build gateway URL for a provider
+ *
+ * @param provider - The AI provider
+ * @returns Full gateway URL
+ *
+ * @example
+ * ```typescript
+ * const url = getGatewayUrl('openai')
+ * // => 'https://gateway.ai.cloudflare.com/v1/{accountId}/{gatewayId}/openai'
+ * ```
+ */
+export function getGatewayUrl(provider) {
+    // TODO: Implement URL construction
+    if (!gatewayConfig) {
+        throw new Error('AI Gateway not configured. Call setGateway() first.');
+    }
+    return `https://gateway.ai.cloudflare.com/v1/${gatewayConfig.accountId}/${gatewayConfig.gatewayId}/${provider}`;
+}
+/**
+ * Make a request through the AI Gateway
+ *
+ * Handles:
+ * - Authentication headers per provider
+ * - Caching headers
+ * - Rate limiting
+ * - Retries with exponential backoff
+ * - Fallback to alternative providers
+ *
+ * @param provider - The AI provider
+ * @param endpoint - API endpoint path
+ * @param body - Request body
+ * @param options - Additional request options
+ * @returns Response from the provider
+ *
+ * @example
+ * ```typescript
+ * const response = await gatewayRequest('openai', '/chat/completions', {
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'Hello' }]
+ * })
+ * ```
+ */
+export async function gatewayRequest(provider, endpoint, body, options) {
+    // TODO: Implement gateway request
+    // 1. Build URL
+    // 2. Get provider auth headers
+    // 3. Add caching headers if enabled
+    // 4. Make request with retry logic
+    // 5. Handle fallback on error
+    // 6. Track usage
+    throw new Error('Not implemented');
+}
+/**
+ * Make a streaming request through the AI Gateway
+ *
+ * @param provider - The AI provider
+ * @param endpoint - API endpoint path
+ * @param body - Request body
+ * @returns AsyncIterable of response chunks
+ *
+ * @example
+ * ```typescript
+ * for await (const chunk of gatewayStream('openai', '/chat/completions', {
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'Hello' }],
+ *   stream: true
+ * })) {
+ *   process.stdout.write(chunk)
+ * }
+ * ```
+ */
+export async function* gatewayStream(provider, endpoint, body) {
+    // TODO: Implement streaming gateway request
+    // 1. Build URL
+    // 2. Get provider auth headers
+    // 3. Make streaming request
+    // 4. Parse SSE chunks
+    // 5. Yield text content
+    throw new Error('Not implemented');
+}
+/**
+ * Get usage statistics from the gateway
+ *
+ * @param startDate - Start timestamp (ms)
+ * @param endDate - End timestamp (ms)
+ * @returns Array of usage records
+ *
+ * @example
+ * ```typescript
+ * const usage = await getUsage(
+ *   Date.now() - 86400000, // Last 24 hours
+ *   Date.now()
+ * )
+ * const totalCost = usage.reduce((sum, u) => sum + u.cost, 0)
+ * ```
+ */
+export async function getUsage(startDate, endDate) {
+    // TODO: Implement usage retrieval from gateway
+    // May require Cloudflare API call or internal tracking
+    throw new Error('Not implemented');
+}
+/**
+ * Track a request for usage/cost monitoring
+ *
+ * @internal
+ */
+export function trackUsage(usage) {
+    // TODO: Implement usage tracking
+    // Store in memory or send to analytics
+}
+/**
+ * Get authentication headers for a provider
+ *
+ * @internal
+ */
+export function getProviderHeaders(provider) {
+    // TODO: Implement provider-specific auth headers
+    // Read from environment variables
+    throw new Error('Not implemented');
+}
+/**
+ * Normalize error from provider to standard format
+ *
+ * @internal
+ */
+export function normalizeError(error, provider) {
+    // TODO: Map provider-specific errors to standard codes
+    // RATE_LIMIT, CONTEXT_LENGTH, CONTENT_FILTER, PROVIDER_ERROR, etc.
+    throw new Error('Not implemented');
+}
+//# sourceMappingURL=gateway.js.map

package/dist/ai/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../ai/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAYH;;GAEG;AACH,IAAI,aAAa,GAA2B,IAAI,CAAA;AAEhD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,UAAU,CAAC,MAAuB;IAChD,wCAAwC;IACxC,aAAa,GAAG,MAAM,CAAA;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACxB,yBAAyB;IACzB,OAAO,aAAa,CAAA;AACtB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAkH;IAElH,mCAAmC;IACnC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;IACxE,CAAC;IACD,OAAO,wCAAwC,aAAa,CAAC,SAAS,IAAI,aAAa,CAAC,SAAS,IAAI,QAAQ,EAAE,CAAA;AACjH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAA6D,EAC7D,QAAgB,EAChB,IAAa,EACb,OAOC;IAED,kCAAkC;IAClC,eAAe;IACf,+BAA+B;IAC/B,oCAAoC;IACpC,mCAAmC;IACnC,8BAA8B;IAC9B,iBAAiB;IACjB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,aAAa,CAClC,QAAyB,EACzB,QAAgB,EAChB,IAAa;IAEb,4CAA4C;IAC5C,eAAe;IACf,+BAA+B;IAC/B,4BAA4B;IAC5B,sBAAsB;IACtB,wBAAwB;IACxB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,SAAkB,EAClB,OAAgB;IAEhB,+CAA+C;IAC/C,uDAAuD;IACvD,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAqB;IAC9C,iCAAiC;IACjC,uCAAuC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAkH;IAElH,iDAAiD;IACjD,kCAAkC;IAClC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,QAAgB;IAEhB,uDAAuD;IACvD,mEAAmE;IACnE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC"}

package/dist/ai/image.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Image Generation and Analysis
+ *
+ * Generate images from text prompts and analyze images with vision models.
+ *
+ * Features:
+ * - Text-to-image generation
+ * - Image analysis/understanding (vision)
+ * - Multiple provider support
+ * - Various sizes and styles
+ *
+ * @module ai/image
+ */
+import type { ImageGenerationOptions, ImageGenerationResult, ImageAnalysisOptions, ImageInput, GeneratedImage } from '../types/ai';
+/**
+ * Generate image from text prompt
+ *
+ * @param prompt - Text description of the image
+ * @param options - Generation options
+ * @returns Generated image(s)
+ *
+ * @example
+ * ```typescript
+ * // Simple generation
+ * const result = await generateImage('A sunset over mountains')
+ * console.log(result.images[0].url)
+ *
+ * // With options
+ * const result = await generateImage('A futuristic city', {
+ *   provider: 'openai',
+ *   size: '1024x1024',
+ *   quality: 'hd',
+ *   style: 'vivid',
+ *   n: 2
+ * })
+ *
+ * // Using Flux
+ * const result = await generateImage('Portrait photo', {
+ *   provider: 'flux',
+ *   model: 'flux-1.1-pro'
+ * })
+ * ```
+ */
+export declare function generateImage(prompt: string, options?: ImageGenerationOptions): Promise<ImageGenerationResult>;
+/**
+ * Analyze image with vision model
+ *
+ * @param image - Image to analyze (URL or base64)
+ * @param prompt - Question or instruction about the image
+ * @param options - Analysis options
+ * @returns Text description/analysis
+ *
+ * @example
+ * ```typescript
+ * // Analyze from URL
+ * const description = await analyzeImage(
+ *   { url: 'https://example.com/image.jpg' },
+ *   'Describe this image in detail'
+ * )
+ *
+ * // Analyze from base64
+ * const description = await analyzeImage(
+ *   { base64: imageData, mediaType: 'image/png' },
+ *   'What objects are in this image?'
+ * )
+ *
+ * // With specific model
+ * const description = await analyzeImage(
+ *   { url: 'https://example.com/chart.png' },
+ *   'Extract the data from this chart',
+ *   { model: 'gpt-4o' }
+ * )
+ * ```
+ */
+export declare function analyzeImage(image: ImageInput, prompt: string, options?: ImageAnalysisOptions): Promise<string>;
+/**
+ * Edit an existing image with a prompt
+ *
+ * @param image - Original image
+ * @param prompt - Edit instructions
+ * @param mask - Optional mask for inpainting
+ * @param options - Generation options
+ * @returns Edited image
+ *
+ * @example
+ * ```typescript
+ * const result = await editImage(
+ *   { url: 'https://example.com/photo.jpg' },
+ *   'Add a rainbow in the sky',
+ *   { url: 'https://example.com/mask.png' }
+ * )
+ * ```
+ */
+export declare function editImage(image: ImageInput, prompt: string, mask?: ImageInput, options?: ImageGenerationOptions): Promise<ImageGenerationResult>;
+/**
+ * Create variations of an existing image
+ *
+ * @param image - Original image
+ * @param n - Number of variations
+ * @param options - Generation options
+ * @returns Image variations
+ *
+ * @example
+ * ```typescript
+ * const result = await createVariations(
+ *   { url: 'https://example.com/image.jpg' },
+ *   4
+ * )
+ * ```
+ */
+export declare function createVariations(image: ImageInput, n?: number, options?: ImageGenerationOptions): Promise<ImageGenerationResult>;
+/**
+ * Upscale image resolution
+ *
+ * @param image - Image to upscale
+ * @param scale - Scale factor (2x, 4x)
+ * @returns Upscaled image
+ *
+ * @example
+ * ```typescript
+ * const result = await upscaleImage(
+ *   { url: 'https://example.com/small.jpg' },
+ *   4
+ * )
+ * ```
+ */
+export declare function upscaleImage(image: ImageInput, scale?: 2 | 4): Promise<GeneratedImage>;
+/**
+ * Convert image input to base64
+ *
+ * @param image - Image input (URL or already base64)
+ * @returns Base64 encoded image with media type
+ *
+ * @internal
+ */
+export declare function imageToBase64(image: ImageInput): Promise<{
+    base64: string;
+    mediaType: string;
+}>;
+//# sourceMappingURL=image.d.ts.map

package/dist/ai/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../ai/image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,UAAU,EAEV,cAAc,EACf,MAAM,aAAa,CAAA;AAmBpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAQhC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAIhC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,EACjB,CAAC,GAAE,MAAU,EACb,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAGhC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,UAAU,EACjB,KAAK,GAAE,CAAC,GAAG,CAAK,GACf,OAAO,CAAC,cAAc,CAAC,CAIzB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAOhD"}