ai-experiments 2.3.0 → 2.4.0

package/dist/tracking.js

@@ -0,0 +1,310 @@
+/**
+ * Event tracking for experiments
+ */
+/**
+ * Default tracking configuration
+ */
+let trackingConfig = {
+    backend: createConsoleBackend(),
+    enabled: true,
+    metadata: {},
+};
+/**
+ * Configure tracking
+ *
+ * @example
+ * ```ts
+ * import { configureTracking } from 'ai-experiments'
+ *
+ * // Use console backend (default)
+ * configureTracking({
+ *   enabled: true,
+ *   metadata: { projectId: 'my-project' },
+ * })
+ *
+ * // Use custom backend
+ * configureTracking({
+ *   backend: {
+ *     track: async (event) => {
+ *       await fetch('/api/analytics', {
+ *         method: 'POST',
+ *         body: JSON.stringify(event),
+ *       })
+ *     },
+ *   },
+ * })
+ *
+ * // Disable tracking
+ * configureTracking({ enabled: false })
+ * ```
+ */
+export function configureTracking(options) {
+    trackingConfig = {
+        backend: options.backend ?? trackingConfig.backend,
+        enabled: options.enabled ?? trackingConfig.enabled,
+        metadata: options.metadata ?? trackingConfig.metadata,
+    };
+}
+/**
+ * Track an event
+ *
+ * @example
+ * ```ts
+ * import { track } from 'ai-experiments'
+ *
+ * track({
+ *   type: 'experiment.start',
+ *   timestamp: new Date(),
+ *   data: {
+ *     experimentId: 'my-experiment',
+ *     variantCount: 3,
+ *   },
+ * })
+ * ```
+ */
+export function track(event) {
+    if (!trackingConfig.enabled) {
+        return;
+    }
+    // Merge global metadata
+    const enrichedEvent = {
+        ...event,
+        data: {
+            ...event.data,
+            ...trackingConfig.metadata,
+        },
+    };
+    // Track via backend (handle both sync and async)
+    const result = trackingConfig.backend.track(enrichedEvent);
+    if (result instanceof Promise) {
+        // Don't await - fire and forget
+        result.catch((error) => {
+            console.error('Error tracking event:', error);
+        });
+    }
+}
+/**
+ * Flush pending events
+ *
+ * Call this before the process exits to ensure all events are sent.
+ *
+ * @example
+ * ```ts
+ * import { flush } from 'ai-experiments'
+ *
+ * process.on('SIGINT', async () => {
+ *   await flush()
+ *   process.exit(0)
+ * })
+ * ```
+ */
+export async function flush() {
+    if (trackingConfig.backend.flush) {
+        await trackingConfig.backend.flush();
+    }
+}
+/**
+ * Create a console-based tracking backend
+ *
+ * Logs events to console.log in a human-readable format.
+ */
+export function createConsoleBackend(options) {
+    const { verbose = false } = options ?? {};
+    return {
+        track: (event) => {
+            const timestamp = event.timestamp.toISOString();
+            if (verbose) {
+                console.log(`[${timestamp}] ${event.type}`, event.data);
+            }
+            else {
+                // Condensed format
+                const key = extractKey(event);
+                console.log(`[${timestamp}] ${event.type} ${key}`);
+            }
+        },
+    };
+}
+/**
+ * Create an in-memory tracking backend that stores events
+ *
+ * Useful for testing or collecting events for batch processing.
+ *
+ * @example
+ * ```ts
+ * import { createMemoryBackend } from 'ai-experiments'
+ *
+ * const backend = createMemoryBackend()
+ * configureTracking({ backend })
+ *
+ * // Run experiments...
+ *
+ * // Get all events
+ * const events = backend.getEvents()
+ * console.log(`Tracked ${events.length} events`)
+ *
+ * // Clear events
+ * backend.clear()
+ * ```
+ */
+export function createMemoryBackend() {
+    const events = [];
+    return {
+        track: (event) => {
+            events.push(event);
+        },
+        getEvents: () => [...events],
+        clear: () => {
+            events.length = 0;
+        },
+    };
+}
+/**
+ * Create a batching tracking backend
+ *
+ * Batches events and sends them in groups to reduce network overhead.
+ *
+ * @example
+ * ```ts
+ * import { createBatchBackend } from 'ai-experiments'
+ *
+ * const backend = createBatchBackend({
+ *   batchSize: 10,
+ *   flushInterval: 5000, // 5 seconds
+ *   send: async (events) => {
+ *     await fetch('/api/analytics/batch', {
+ *       method: 'POST',
+ *       body: JSON.stringify({ events }),
+ *     })
+ *   },
+ * })
+ *
+ * configureTracking({ backend })
+ * ```
+ */
+export function createBatchBackend(options) {
+    const { batchSize, flushInterval, send } = options;
+    const batch = [];
+    let flushTimer = null;
+    const flush = async () => {
+        if (batch.length === 0)
+            return;
+        const eventsToSend = [...batch];
+        batch.length = 0;
+        try {
+            await send(eventsToSend);
+        }
+        catch (error) {
+            console.error('Error sending batch:', error);
+            // Re-add failed events to batch (simple retry strategy)
+            batch.unshift(...eventsToSend);
+        }
+    };
+    const scheduleFlush = () => {
+        if (flushTimer) {
+            clearTimeout(flushTimer);
+        }
+        if (flushInterval) {
+            flushTimer = setTimeout(() => {
+                flush().catch(console.error);
+            }, flushInterval);
+        }
+    };
+    return {
+        track: (event) => {
+            batch.push(event);
+            // Auto-flush if batch is full
+            if (batch.length >= batchSize) {
+                flush().catch(console.error);
+            }
+            else {
+                scheduleFlush();
+            }
+        },
+        flush: async () => {
+            if (flushTimer) {
+                clearTimeout(flushTimer);
+                flushTimer = null;
+            }
+            await flush();
+        },
+    };
+}
+/**
+ * Create a file-based tracking backend
+ *
+ * Writes events to a file (JSONL format).
+ *
+ * @example
+ * ```ts
+ * import { createFileBackend } from 'ai-experiments'
+ *
+ * const backend = createFileBackend({
+ *   path: './experiments.jsonl',
+ * })
+ *
+ * configureTracking({ backend })
+ * ```
+ */
+export function createFileBackend(options) {
+    // Note: This requires Node.js fs module
+    // Import dynamically to avoid breaking in non-Node environments
+    let fs = null;
+    let writeStream = null;
+    const ensureStream = async () => {
+        if (!writeStream) {
+            try {
+                fs = await import('fs');
+                writeStream = fs.createWriteStream(options.path, { flags: 'a' });
+            }
+            catch (error) {
+                console.error('Failed to create file stream:', error);
+                throw error;
+            }
+        }
+        return writeStream;
+    };
+    return {
+        track: async (event) => {
+            try {
+                const stream = await ensureStream();
+                const line = JSON.stringify(event) + '\n';
+                stream.write(line);
+            }
+            catch (error) {
+                console.error('Failed to write event to file:', error);
+            }
+        },
+        flush: async () => {
+            if (writeStream) {
+                return new Promise((resolve, reject) => {
+                    writeStream.end((error) => {
+                        if (error)
+                            reject(error);
+                        else
+                            resolve();
+                    });
+                });
+            }
+        },
+    };
+}
+/**
+ * Extract a key identifier from event data for logging
+ */
+function extractKey(event) {
+    const data = event.data;
+    if ('experimentId' in data)
+        return `exp=${data['experimentId']}`;
+    if ('variantId' in data)
+        return `variant=${data['variantId']}`;
+    if ('runId' in data)
+        return `run=${data['runId']}`;
+    return '';
+}
+/**
+ * Get current tracking configuration
+ */
+export function getTrackingConfig() {
+    return { ...trackingConfig };
+}
+//# sourceMappingURL=tracking.js.map

package/dist/tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.js","sourceRoot":"","sources":["../src/tracking.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Core types for AI experimentation
+ */
+/**
+ * A variant within an experiment
+ */
+export interface ExperimentVariant<TConfig = unknown> {
+    /** Unique identifier for the variant */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Variant configuration */
+    config: TConfig;
+    /** Weight for weighted random selection (default: 1) */
+    weight?: number;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Configuration for an experiment
+ */
+export interface ExperimentConfig<TConfig = unknown, TResult = unknown> {
+    /** Unique experiment identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Experiment description */
+    description?: string;
+    /** List of variants to test */
+    variants: ExperimentVariant<TConfig>[];
+    /** Function to execute for each variant */
+    execute: (config: TConfig, context?: ExperimentContext) => Promise<TResult> | TResult;
+    /** Optional success metric function */
+    metric?: (result: TResult) => number | Promise<number>;
+    /** Metadata for the experiment */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Context passed to experiment execution
+ */
+export interface ExperimentContext {
+    /** Experiment ID */
+    experimentId: string;
+    /** Variant ID */
+    variantId: string;
+    /** Run ID (unique per execution) */
+    runId: string;
+    /** Timestamp when execution started */
+    startedAt: Date;
+    /** Additional context data */
+    data?: Record<string, unknown>;
+}
+/**
+ * Result of executing an experiment variant
+ */
+export interface ExperimentResult<TResult = unknown> {
+    /** Experiment ID */
+    experimentId: string;
+    /** Variant ID */
+    variantId: string;
+    /** Variant name */
+    variantName: string;
+    /** Run ID */
+    runId: string;
+    /** Execution result */
+    result: TResult;
+    /** Computed metric value (if metric function provided) */
+    metricValue?: number;
+    /** Execution duration in milliseconds */
+    duration: number;
+    /** Timestamp when execution started */
+    startedAt: Date;
+    /** Timestamp when execution completed */
+    completedAt: Date;
+    /** Error if execution failed */
+    error?: Error;
+    /** Success flag */
+    success: boolean;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Summary of experiment results across all variants
+ */
+export interface ExperimentSummary<TResult = unknown> {
+    /** Experiment ID */
+    experimentId: string;
+    /** Experiment name */
+    experimentName: string;
+    /** Results for each variant */
+    results: ExperimentResult<TResult>[];
+    /** Best performing variant (by metric) */
+    bestVariant?: {
+        variantId: string;
+        variantName: string;
+        metricValue: number;
+    };
+    /** Total execution duration */
+    totalDuration: number;
+    /** Number of successful runs */
+    successCount: number;
+    /** Number of failed runs */
+    failureCount: number;
+    /** Timestamp when experiment started */
+    startedAt: Date;
+    /** Timestamp when experiment completed */
+    completedAt: Date;
+}
+/**
+ * Options for running an experiment
+ */
+export interface RunExperimentOptions {
+    /** Run variants in parallel (default: true) */
+    parallel?: boolean;
+    /** Maximum concurrent executions (default: unlimited) */
+    maxConcurrency?: number;
+    /** Stop on first error (default: false) */
+    stopOnError?: boolean;
+    /** Custom context data */
+    context?: Record<string, unknown>;
+    /** Event callbacks */
+    onVariantStart?: (variantId: string, variantName: string) => void;
+    onVariantComplete?: (result: ExperimentResult) => void;
+    onVariantError?: (variantId: string, error: Error) => void;
+}
+/**
+ * Parameters for cartesian product generation
+ */
+export type CartesianParams = Record<string, unknown[]>;
+/**
+ * Result of cartesian product - array of parameter combinations
+ */
+export type CartesianResult<T extends CartesianParams> = Array<{
+    [K in keyof T]: T[K][number];
+}>;
+/**
+ * Decision options
+ */
+export interface DecideOptions<T> {
+    /** Options to choose from */
+    options: T[];
+    /** Scoring function for each option */
+    score: (option: T) => number | Promise<number>;
+    /** Context or prompt for decision making */
+    context?: string;
+    /** Whether to return all options sorted by score (default: false) */
+    returnAll?: boolean;
+}
+/**
+ * Result of a decision
+ */
+export interface DecisionResult<T> {
+    /** The selected option */
+    selected: T;
+    /** Score of the selected option */
+    score: number;
+    /** All options with their scores (if returnAll was true) */
+    allOptions?: Array<{
+        option: T;
+        score: number;
+    }>;
+}
+/**
+ * Tracking event types
+ */
+export type TrackingEventType = 'experiment.start' | 'experiment.complete' | 'variant.start' | 'variant.complete' | 'variant.error' | 'metric.computed' | 'decision.made';
+/**
+ * Tracking event
+ */
+export interface TrackingEvent {
+    /** Event type */
+    type: TrackingEventType;
+    /** Timestamp */
+    timestamp: Date;
+    /** Event data */
+    data: Record<string, unknown>;
+}
+/**
+ * Tracking backend interface
+ */
+export interface TrackingBackend {
+    /** Track an event */
+    track(event: TrackingEvent): void | Promise<void>;
+    /** Flush pending events */
+    flush?(): void | Promise<void>;
+}
+/**
+ * Options for tracking configuration
+ */
+export interface TrackingOptions {
+    /** Custom tracking backend */
+    backend?: TrackingBackend;
+    /** Whether tracking is enabled (default: true) */
+    enabled?: boolean;
+    /** Additional metadata to include with all events */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,GAAG,OAAO;IAClD,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,MAAM,EAAE,OAAO,CAAA;IACf,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACpE,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+BAA+B;IAC/B,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAA;IACtC,2CAA2C;IAC3C,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;IACrF,uCAAuC;IACvC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACtD,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,SAAS,EAAE,IAAI,CAAA;IACf,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,OAAO,GAAG,OAAO;IACjD,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa;IACb,KAAK,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,MAAM,EAAE,OAAO,CAAA;IACf,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,uCAAuC;IACvC,SAAS,EAAE,IAAI,CAAA;IACf,yCAAyC;IACzC,WAAW,EAAE,IAAI,CAAA;IACjB,gCAAgC;IAChC,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,mBAAmB;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,GAAG,OAAO;IAClD,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,+BAA+B;IAC/B,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAA;IACpC,0CAA0C;IAC1C,WAAW,CAAC,EAAE;QACZ,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,SAAS,EAAE,IAAI,CAAA;IACf,0CAA0C;IAC1C,WAAW,EAAE,IAAI,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,sBAAsB;IACtB,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAA;IACjE,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAA;IACtD,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CAC3D;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;AAEvD;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,eAAe,IAAI,KAAK,CAAC;KAC5D,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;CAC7B,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,6BAA6B;IAC7B,OAAO,EAAE,CAAC,EAAE,CAAA;IACZ,uCAAuC;IACvC,KAAK,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9C,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,CAAA;IACX,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACjD;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,GAClB,qBAAqB,GACrB,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,eAAe,CAAA;AAEnB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,IAAI,EAAE,iBAAiB,CAAA;IACvB,gBAAgB;IAChB,SAAS,EAAE,IAAI,CAAA;IACf,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,2BAA2B;IAC3B,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core types for AI experimentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-experiments",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Runtime A/B testing for AI variants in production - traffic splitting, decision strategies, and ClickHouse-backed outcome tracking",
   "type": "module",
   "main": "dist/index.js",
@@ -24,8 +24,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "ai-database": "2.3.0",
-    "ai-functions": "2.3.0"
+    "ai-database": "2.4.0",
+    "ai-functions": "2.4.0"
   },
   "keywords": [
     "ai",