ai-experiments 2.1.3 → 2.4.0

package/dist/clickhouse-storage.js

@@ -0,0 +1,522 @@
+/**
+ * ClickHouse storage backend for AI experiments.
+ *
+ * Migrated (per [ADR-0003](../../../docs/adr/0003-storage-strategy-pg-clickhouse-default.md))
+ * from the standalone embedded `chdb` adapter to the canonical
+ * `ClickHouseProvider` from `ai-database`. Experiment runs are recorded as
+ * SVO Actions on the canonical `actions` table:
+ *
+ * - `verb` — event type (e.g. `variant.complete`)
+ * - `subject` — `experimentId`
+ * - `object` — `variantId`
+ * - `roles` — `{ runId }` (other named roles can be carried here)
+ * - `data` — JSON payload (`experimentName`, `variantName`, `dimensions`,
+ *    `runId`, `success`, `durationMs`, `result`, `metricName`,
+ *    `metricValue`, `errorMessage`, `errorStack`, `metadata`)
+ * - `status` — `'completed'` for successful runs, `'failed'` otherwise
+ *
+ * Writes go through {@link ClickHouseProvider.recordAction} (and
+ * {@link ClickHouseProvider.commitBatch} when bulk-storing). Aggregations
+ * use {@link ClickHouseProvider.analyticsQuery} against the `actions` table
+ * with `JSONExtract*` against the `data` column. This is the **option (c)
+ * hybrid** approach from the migration plan: SVO surface for writes, raw
+ * analytical SQL for the experiment-specific aggregations the SVO surface
+ * doesn't expose directly (cartesian grids, time-series rollups,
+ * best-variant selection by metric).
+ *
+ * Deployment shift: the previous `chdb` adapter used embedded ClickHouse
+ * (file-system path). This adapter is HTTP-based — callers wire up a
+ * ClickHouse server (self-hosted or ClickHouse Cloud) via
+ * {@link createClickHouseHttpFetcher}. Tests use a fake fetcher.
+ *
+ * @packageDocumentation
+ */
+import { createClickHouseProvider, bootstrapClickHouseSchema, } from 'ai-database';
+const DEFAULT_NAMESPACE = 'experiments';
+/**
+ * Generate a stable event id. Timestamp + monotonic counter inside the
+ * process — ClickHouse de-dupes on `actions.id` only via explicit DELETE,
+ * so collisions across processes are tolerated (each becomes a separate
+ * row).
+ */
+function makeEventIdFactory() {
+    let counter = 0;
+    return () => `evt-${Date.now()}-${++counter}`;
+}
+/**
+ * Map a {@link TrackingEvent} to the SVO Action shape.
+ *
+ * `verb` carries the event type (`variant.complete`, etc.).
+ * `subject` = `experimentId`, `object` = `variantId`. Everything else
+ * lands in `data` so analytical queries can `JSONExtract*` whatever they
+ * need without changing the schema.
+ */
+function eventToActionInput(event, eventId) {
+    const data = event.data;
+    const experimentId = String(data['experimentId'] ?? '');
+    const variantId = String(data['variantId'] ?? '');
+    const runId = String(data['runId'] ?? '');
+    const success = data['success'] !== false;
+    const status = event.type === 'variant.error' || !success ? 'failed' : 'completed';
+    // Capture every payload field — aggregation SQL uses JSONExtract* against
+    // the `data` JSON blob.
+    const errorMessage = data['error'] instanceof Error
+        ? data['error'].message
+        : data['errorMessage'] !== undefined
+            ? String(data['errorMessage'])
+            : '';
+    const errorStack = data['error'] instanceof Error ? data['error'].stack ?? '' : '';
+    const durationMs = Number(data['duration'] ?? data['durationMs'] ?? 0);
+    const payload = {
+        eventId,
+        eventType: event.type,
+        timestamp: event.timestamp.toISOString(),
+        experimentId,
+        experimentName: String(data['experimentName'] ?? ''),
+        variantId,
+        variantName: String(data['variantName'] ?? ''),
+        runId,
+        success: success ? 1 : 0,
+        durationMs,
+        dimensions: data['dimensions'] ?? data['config'] ?? {},
+        result: data['result'] ?? {},
+        metricName: String(data['metricName'] ?? ''),
+        metricValue: Number(data['metricValue'] ?? 0),
+        errorMessage,
+        errorStack,
+        metadata: data['metadata'] ?? {},
+    };
+    return {
+        id: eventId,
+        verb: event.type,
+        subject: experimentId,
+        object: variantId,
+        roles: runId ? { runId } : {},
+        data: payload,
+        status,
+    };
+}
+/**
+ * ClickHouse-backed experiment storage built on the canonical
+ * {@link ClickHouseProvider} adapter. Implements
+ * {@link TrackingBackend}.
+ *
+ * @example
+ * ```ts
+ * import { configureTracking } from 'ai-experiments'
+ * import { createClickHouseExperimentStorage } from 'ai-experiments/storage'
+ * import { createClickHouseHttpFetcher } from 'ai-database'
+ *
+ * const fetcher = createClickHouseHttpFetcher({
+ *   url: process.env.CLICKHOUSE_URL!,
+ *   username: process.env.CLICKHOUSE_USER,
+ *   password: process.env.CLICKHOUSE_PASSWORD,
+ *   database: 'aidb',
+ * })
+ * const storage = createClickHouseExperimentStorage({ fetcher })
+ *
+ * configureTracking({ backend: storage })
+ *
+ * // Later: analyse results
+ * const best = await storage.getBestVariant('my-experiment')
+ * ```
+ */
+export class ClickHouseExperimentStorage {
+    provider;
+    fetcher;
+    database;
+    namespace;
+    autoBootstrap;
+    bootstrapped = false;
+    nextEventId = makeEventIdFactory();
+    constructor(options) {
+        this.fetcher = options.fetcher;
+        this.database = options.database ?? 'aidb';
+        this.namespace = options.namespace ?? DEFAULT_NAMESPACE;
+        this.autoBootstrap = options.autoBootstrap ?? false;
+        this.provider = createClickHouseProvider({
+            fetcher: options.fetcher,
+            database: this.database,
+            namespace: this.namespace,
+        });
+    }
+    /** Underlying canonical CH provider (escape hatch for advanced callers). */
+    getProvider() {
+        return this.provider;
+    }
+    async ensureBootstrap() {
+        if (this.bootstrapped)
+            return;
+        if (this.autoBootstrap) {
+            await bootstrapClickHouseSchema(this.fetcher, { database: this.database });
+        }
+        this.bootstrapped = true;
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // TrackingBackend implementation
+    // ───────────────────────────────────────────────────────────────────────────
+    async track(event) {
+        await this.ensureBootstrap();
+        const eventId = this.nextEventId();
+        const action = eventToActionInput(event, eventId);
+        await this.provider.recordAction({
+            verb: action.verb,
+            subject: action.subject,
+            object: action.object,
+            roles: action.roles,
+            data: action.data,
+            status: action.status,
+        });
+    }
+    async flush() {
+        // Writes go straight through HTTP — nothing to flush.
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // Direct experiment-result API
+    // ───────────────────────────────────────────────────────────────────────────
+    async storeResult(result) {
+        await this.track({
+            type: 'variant.complete',
+            timestamp: result.completedAt,
+            data: {
+                experimentId: result.experimentId,
+                variantId: result.variantId,
+                variantName: result.variantName,
+                runId: result.runId,
+                success: result.success,
+                duration: result.duration,
+                result: result.result,
+                metricValue: result.metricValue,
+                error: result.error,
+                metadata: result.metadata,
+            },
+        });
+    }
+    /**
+     * Bulk-store results via {@link ClickHouseProvider.commitBatch}. One
+     * HTTP POST per call carries the entire batch as `JSONEachRow`.
+     */
+    async storeResults(results) {
+        if (results.length === 0)
+            return;
+        await this.ensureBootstrap();
+        const actions = results.map((r) => {
+            const action = eventToActionInput({
+                type: 'variant.complete',
+                timestamp: r.completedAt,
+                data: {
+                    experimentId: r.experimentId,
+                    variantId: r.variantId,
+                    variantName: r.variantName,
+                    runId: r.runId,
+                    success: r.success,
+                    duration: r.duration,
+                    result: r.result,
+                    metricValue: r.metricValue,
+                    error: r.error,
+                    metadata: r.metadata,
+                },
+            }, this.nextEventId());
+            return action;
+        });
+        await this.provider.commitBatch({ actions });
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // Analytics queries (raw SQL via canonical adapter's analyticsQuery)
+    // ───────────────────────────────────────────────────────────────────────────
+    /** Quote a SQL string literal — same shape as the canonical adapter. */
+    quote(value) {
+        return `'${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+    }
+    /**
+     * Get all experiments seen in the actions table (variant.complete events).
+     */
+    async getExperiments() {
+        await this.ensureBootstrap();
+        const ns = this.quote(this.namespace);
+        const sql = `
+      SELECT
+        subject AS experimentId,
+        any(JSONExtractString(data, 'experimentName')) AS experimentName,
+        uniq(object) AS variantCount,
+        count() AS runCount,
+        toString(min(created_at)) AS firstRun,
+        toString(max(created_at)) AS lastRun
+      FROM ${this.database}.actions
+      WHERE ns = ${ns} AND verb = 'variant.complete' AND subject != ''
+      GROUP BY subject
+      ORDER BY lastRun DESC
+    `;
+        const rows = await this.provider.analyticsQuery(sql);
+        return rows.map((row) => ({
+            experimentId: String(row['experimentId'] ?? ''),
+            experimentName: String(row['experimentName'] ?? ''),
+            variantCount: Number(row['variantCount'] ?? 0),
+            runCount: Number(row['runCount'] ?? 0),
+            firstRun: String(row['firstRun'] ?? ''),
+            lastRun: String(row['lastRun'] ?? ''),
+        }));
+    }
+    async getVariantStats(experimentId) {
+        await this.ensureBootstrap();
+        const ns = this.quote(this.namespace);
+        const exp = this.quote(experimentId);
+        const sql = `
+      SELECT
+        object AS variantId,
+        any(JSONExtractString(data, 'variantName')) AS variantName,
+        count() AS runCount,
+        countIf(JSONExtractInt(data, 'success') = 1) AS successCount,
+        countIf(JSONExtractInt(data, 'success') = 1) / count() AS successRate,
+        avg(JSONExtractFloat(data, 'durationMs')) AS avgDuration,
+        avg(JSONExtractFloat(data, 'metricValue')) AS avgMetric,
+        min(JSONExtractFloat(data, 'metricValue')) AS minMetric,
+        max(JSONExtractFloat(data, 'metricValue')) AS maxMetric
+      FROM ${this.database}.actions
+      WHERE ns = ${ns} AND verb = 'variant.complete' AND subject = ${exp}
+      GROUP BY object
+      ORDER BY avgMetric DESC
+    `;
+        const rows = await this.provider.analyticsQuery(sql);
+        return rows.map((row) => ({
+            variantId: String(row['variantId'] ?? ''),
+            variantName: String(row['variantName'] ?? ''),
+            runCount: Number(row['runCount'] ?? 0),
+            successCount: Number(row['successCount'] ?? 0),
+            successRate: Number(row['successRate'] ?? 0),
+            avgDuration: Number(row['avgDuration'] ?? 0),
+            avgMetric: Number(row['avgMetric'] ?? 0),
+            minMetric: Number(row['minMetric'] ?? 0),
+            maxMetric: Number(row['maxMetric'] ?? 0),
+        }));
+    }
+    async getBestVariant(experimentId, options = {}) {
+        await this.ensureBootstrap();
+        const { metric = 'avgMetric', minimumRuns = 1 } = options;
+        const ns = this.quote(this.namespace);
+        const exp = this.quote(experimentId);
+        const orderBy = metric === 'avgDuration' ? 'ASC' : 'DESC';
+        const metricExpr = metric === 'successRate'
+            ? "countIf(JSONExtractInt(data, 'success') = 1) / count()"
+            : metric === 'avgDuration'
+                ? "avg(JSONExtractFloat(data, 'durationMs'))"
+                : "avg(JSONExtractFloat(data, 'metricValue'))";
+        const sql = `
+      SELECT
+        object AS variantId,
+        any(JSONExtractString(data, 'variantName')) AS variantName,
+        ${metricExpr} AS metricValue,
+        count() AS runCount
+      FROM ${this.database}.actions
+      WHERE ns = ${ns} AND verb = 'variant.complete' AND subject = ${exp}
+      GROUP BY object
+      HAVING runCount >= ${Number(minimumRuns)}
+      ORDER BY metricValue ${orderBy}
+      LIMIT 1
+    `;
+        const rows = await this.provider.analyticsQuery(sql);
+        if (rows.length === 0)
+            return null;
+        const row = rows[0];
+        return {
+            variantId: String(row['variantId'] ?? ''),
+            variantName: String(row['variantName'] ?? ''),
+            metricValue: Number(row['metricValue'] ?? 0),
+            runCount: Number(row['runCount'] ?? 0),
+        };
+    }
+    async getCartesianAnalysis(experimentId, dimension) {
+        await this.ensureBootstrap();
+        const ns = this.quote(this.namespace);
+        const exp = this.quote(experimentId);
+        const dimQuoted = this.quote(dimension);
+        const sql = `
+      SELECT
+        JSONExtractString(JSONExtractRaw(data, 'dimensions'), ${dimQuoted}) AS dimensionValue,
+        count() AS runCount,
+        avg(JSONExtractFloat(data, 'metricValue')) AS avgMetric,
+        countIf(JSONExtractInt(data, 'success') = 1) / count() AS successRate
+      FROM ${this.database}.actions
+      WHERE ns = ${ns} AND verb = 'variant.complete' AND subject = ${exp}
+      GROUP BY dimensionValue
+      HAVING dimensionValue != ''
+      ORDER BY avgMetric DESC
+    `;
+        const rows = await this.provider.analyticsQuery(sql);
+        return rows.map((row) => ({
+            dimensionValue: String(row['dimensionValue'] ?? ''),
+            runCount: Number(row['runCount'] ?? 0),
+            avgMetric: Number(row['avgMetric'] ?? 0),
+            successRate: Number(row['successRate'] ?? 0),
+        }));
+    }
+    async getCartesianGrid(experimentId, dimensions) {
+        await this.ensureBootstrap();
+        const ns = this.quote(this.namespace);
+        const exp = this.quote(experimentId);
+        const dimExtracts = dimensions
+            .map((d) => `JSONExtractString(JSONExtractRaw(data, 'dimensions'), ${this.quote(d)}) AS dim_${d}`)
+            .join(', ');
+        const dimGroupBy = dimensions.map((d) => `dim_${d}`).join(', ');
+        const sql = `
+      SELECT
+        ${dimExtracts},
+        count() AS runCount,
+        avg(JSONExtractFloat(data, 'metricValue')) AS avgMetric,
+        countIf(JSONExtractInt(data, 'success') = 1) / count() AS successRate
+      FROM ${this.database}.actions
+      WHERE ns = ${ns} AND verb = 'variant.complete' AND subject = ${exp}
+      GROUP BY ${dimGroupBy}
+      ORDER BY avgMetric DESC
+    `;
+        const rows = await this.provider.analyticsQuery(sql);
+        return rows.map((row) => {
+            const dims = {};
+            for (const d of dimensions) {
+                dims[d] = String(row[`dim_${d}`] ?? '');
+            }
+            return {
+                dimensions: dims,
+                runCount: Number(row['runCount'] ?? 0),
+                avgMetric: Number(row['avgMetric'] ?? 0),
+                successRate: Number(row['successRate'] ?? 0),
+            };
+        });
+    }
+    async getTimeSeries(experimentId, options = {}) {
+        await this.ensureBootstrap();
+        const { interval = 'day', variantId } = options;
+        const ns = this.quote(this.namespace);
+        const exp = this.quote(experimentId);
+        const dateFunc = interval === 'hour'
+            ? 'toStartOfHour(created_at)'
+            : interval === 'week'
+                ? 'toStartOfWeek(created_at)'
+                : 'toStartOfDay(created_at)';
+        const variantFilter = variantId ? `AND object = ${this.quote(variantId)}` : '';
+        const sql = `
+      SELECT
+        toString(${dateFunc}) AS period,
+        count() AS runCount,
+        avg(JSONExtractFloat(data, 'metricValue')) AS avgMetric,
+        countIf(JSONExtractInt(data, 'success') = 1) / count() AS successRate
+      FROM ${this.database}.actions
+      WHERE ns = ${ns} AND verb = 'variant.complete' AND subject = ${exp}
+        ${variantFilter}
+      GROUP BY period
+      ORDER BY period ASC
+    `;
+        const rows = await this.provider.analyticsQuery(sql);
+        return rows.map((row) => ({
+            period: String(row['period'] ?? ''),
+            runCount: Number(row['runCount'] ?? 0),
+            avgMetric: Number(row['avgMetric'] ?? 0),
+            successRate: Number(row['successRate'] ?? 0),
+        }));
+    }
+    async getEvents(experimentId, options = {}) {
+        await this.ensureBootstrap();
+        const { eventType, variantId, limit = 100 } = options;
+        const ns = this.quote(this.namespace);
+        const exp = this.quote(experimentId);
+        const filters = [`ns = ${ns}`, `subject = ${exp}`];
+        if (eventType)
+            filters.push(`verb = ${this.quote(eventType)}`);
+        if (variantId)
+            filters.push(`object = ${this.quote(variantId)}`);
+        const sql = `
+      SELECT
+        verb AS eventType,
+        toString(created_at) AS createdAt,
+        data
+      FROM ${this.database}.actions
+      WHERE ${filters.join(' AND ')}
+      ORDER BY created_at DESC
+      LIMIT ${Number(limit)}
+    `;
+        const rows = await this.provider.analyticsQuery(sql);
+        return rows.map((row) => {
+            const dataStr = row['data'];
+            let payload = {};
+            if (typeof dataStr === 'string' && dataStr.length > 0) {
+                try {
+                    payload = JSON.parse(dataStr);
+                }
+                catch {
+                    payload = {};
+                }
+            }
+            else if (dataStr && typeof dataStr === 'object') {
+                payload = dataStr;
+            }
+            const createdAt = String(row['createdAt'] ?? '');
+            const ts = createdAt ? new Date(createdAt) : new Date();
+            return {
+                type: String(row['eventType'] ?? ''),
+                timestamp: Number.isNaN(ts.getTime()) ? new Date() : ts,
+                data: payload,
+            };
+        });
+    }
+    /**
+     * Raw analytical SQL pass-through. Routes to
+     * {@link ClickHouseProvider.analyticsQuery}.
+     */
+    async query(sql) {
+        return this.provider.analyticsQuery(sql);
+    }
+    /** No-op (kept for backwards compat with the chdb-era API). */
+    close() {
+        // HTTP fetcher has nothing to release.
+    }
+}
+/**
+ * Bootstrap the canonical CH schema (`things`, `actions`, `verbs`).
+ * Convenience wrapper around the canonical
+ * {@link bootstrapClickHouseSchema}.
+ */
+export async function bootstrapExperimentsSchema(fetcher, options = {}) {
+    await bootstrapClickHouseSchema(fetcher, options.database !== undefined ? { database: options.database } : {});
+}
+/**
+ * Create a ClickHouse-backed experiment storage backend.
+ *
+ * @example
+ * ```ts
+ * import { configureTracking } from 'ai-experiments'
+ * import { createClickHouseExperimentStorage } from 'ai-experiments/storage'
+ * import { createClickHouseHttpFetcher } from 'ai-database'
+ *
+ * const fetcher = createClickHouseHttpFetcher({
+ *   url: process.env.CLICKHOUSE_URL!,
+ *   username: process.env.CLICKHOUSE_USER,
+ *   password: process.env.CLICKHOUSE_PASSWORD,
+ *   database: 'aidb',
+ * })
+ * const storage = createClickHouseExperimentStorage({ fetcher })
+ *
+ * configureTracking({ backend: storage })
+ *
+ * const best = await storage.getBestVariant('my-experiment')
+ * ```
+ */
+export function createClickHouseExperimentStorage(options) {
+    return new ClickHouseExperimentStorage(options);
+}
+// =============================================================================
+// Backwards-compat aliases (chdb-era names)
+// =============================================================================
+/**
+ * @deprecated Renamed to {@link ClickHouseExperimentStorage}. The class
+ * now wraps the canonical `ClickHouseProvider` from `ai-database` instead
+ * of embedded chdb. The old `dataPath` constructor option is ignored —
+ * supply a `fetcher` instead.
+ */
+export const ChdbStorage = ClickHouseExperimentStorage;
+/**
+ * @deprecated Renamed to {@link createClickHouseExperimentStorage}.
+ */
+export function createChdbBackend(options) {
+    return createClickHouseExperimentStorage(options);
+}
+//# sourceMappingURL=clickhouse-storage.js.map

package/dist/clickhouse-storage.js.map

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

package/dist/decide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../src/decide.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAC5B,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CA2C5B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAC3C,CAAC,CA0BH;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CA6C5B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,OAAO,EAAE,CAAC,EAAE,EACZ,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACjD,CAAC,CA+BH;AAuDD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EACxC,OAAO,EAAE,CAAC,EAAE,EACZ,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACjD,MAAM,EAAE;IACN,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAA;IACzB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAA;CACnB,GACA,CAAC,CAwCH"}
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../src/decide.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CA2CrF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,CAAC,CA0BjF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAiD5B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,OAAO,EAAE,CAAC,EAAE,EACZ,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACjD,CAAC,CA6BH;AAuDD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EACxC,OAAO,EAAE,CAAC,EAAE,EACZ,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACjD,MAAM,EAAE;IACN,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAA;IACzB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAA;CACnB,GACA,CAAC,CAwCH"}

package/dist/decide.js

@@ -166,7 +166,11 @@ export async function decideEpsilonGreedy(options) {
         };
     }
     // Exploitation: best option
-    const result = await decide({ options: choices, score, context });
+    const result = await decide({
+        options: choices,
+        score,
+        ...(context !== undefined && { context }),
+    });
     track({
         type: 'decision.made',
         timestamp: new Date(),
@@ -213,7 +217,7 @@ export function decideThompsonSampling(options, priors) {
         };
     });
     // Select option with highest sample
-    const best = samples.reduce((prev, current) => current.sample > prev.sample ? current : prev);
+    const best = samples.reduce((prev, current) => (current.sample > prev.sample ? current : prev));
     track({
         type: 'decision.made',
         timestamp: new Date(),

package/dist/decide.js.map

@@ -1 +1 @@
-{"version":3,"file":"decide.js","sourceRoot":"","sources":["../src/decide.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"decide.js","sourceRoot":"","sources":["../src/decide.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,OAAyB;IACvD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IAEvE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;IACrD,CAAC;IAED,oBAAoB;IACpB,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CACrC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC3B,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAA;QACvC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,CAAA;IACvC,CAAC,CAAC,CACH,CAAA;IAED,gCAAgC;IAChC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;IAE9D,qBAAqB;IACrB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAE,CAAA;IAEvB,iBAAiB;IACjB,KAAK,CAAC;QACJ,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,IAAI,EAAE;YACJ,OAAO;YACP,WAAW,EAAE,OAAO,CAAC,MAAM;YAC3B,aAAa,EAAE,IAAI,CAAC,KAAK;YACzB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;SACtC;KACF,CAAC,CAAA;IAEF,MAAM,MAAM,GAAsB;QAChC,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAA;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,UAAU,GAAG,MAAM,CAAA;IAC5B,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAAI,OAA4C;IAC5E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;IACrD,CAAC;IAED,yBAAyB;IACzB,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAErE,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;IAClD,CAAC;IAED,kDAAkD;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAA;IAE1C,wDAAwD;IACxD,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,UAAU,IAAI,MAAM,CAAC,MAAM,CAAA;QAC3B,IAAI,MAAM,IAAI,UAAU,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC,KAAK,CAAA;QACrB,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,KAAK,CAAA;AAC3C,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA+C;IAE/C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;IAE7D,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IACpD,CAAC;IAED,gCAAgC;IAChC,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;QAC9D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAE,CAAA;QACtC,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAA;QAE3C,KAAK,CAAC;YACJ,IAAI,EAAE,eAAe;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,IAAI,EAAE;gBACJ,OAAO;gBACP,QAAQ,EAAE,wBAAwB;gBAClC,OAAO;gBACP,aAAa;aACd;SACF,CAAC,CAAA;QAEF,OAAO;YACL,QAAQ;YACR,KAAK,EAAE,aAAa;SACrB,CAAA;IACH,CAAC;IAED,4BAA4B;IAC5B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;QAC1B,OAAO,EAAE,OAAO;QAChB,KAAK;QACL,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;KAC1C,CAAC,CAAA;IAEF,KAAK,CAAC;QACJ,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,IAAI,EAAE;YACJ,OAAO;YACP,QAAQ,EAAE,wBAAwB;YAClC,OAAO;YACP,aAAa,EAAE,MAAM,CAAC,KAAK;SAC5B;KACF,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAY,EACZ,MAAkD;IAElD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;IACrD,CAAC;IAED,gDAAgD;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACrC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;QACtC,OAAO;YACL,MAAM;YACN,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC;SAChC,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,oCAAoC;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAE/F,KAAK,CAAC;QACJ,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,IAAI,EAAE;YACJ,QAAQ,EAAE,mBAAmB;YAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;SAC5B;KACF,CAAC,CAAA;IAEF,OAAO,IAAI,CAAC,MAAM,CAAA;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,KAAa,EAAE,IAAY;IAC7C,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IAC/B,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAC9B,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,KAAa,EAAE,KAAa;IAC/C,uCAAuC;IACvC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,oDAAoD;QACpD,OAAO,WAAW,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAA;IAC3E,CAAC;IAED,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAA;IACvB,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAE9B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAS,CAAA;QACb,IAAI,CAAS,CAAA;QAEb,GAAG,CAAC;YACF,CAAC,GAAG,YAAY,EAAE,CAAA;YAClB,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACf,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAC;QAEhB,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;QAEvB,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACtB,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACtB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,YAAY;IACnB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;IACxB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;AAClE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,SAAS,CACvB,OAAY,EACZ,KAAiD,EACjD,MAKC;IAED,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,GAAG,MAAM,CAAA;IAEhD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;IACrD,CAAC;IAED,gCAAgC;IAChC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QAErC,mCAAmC;QACnC,MAAM,gBAAgB,GACpB,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;QAE1E,OAAO;YACL,MAAM;YACN,GAAG,EAAE,IAAI,GAAG,gBAAgB;YAC5B,IAAI;YACJ,KAAK;SACN,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,iCAAiC;IACjC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAE3F,KAAK,CAAC;QACJ,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,IAAI,EAAE;YACJ,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,IAAI,CAAC,MAAM;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,iBAAiB;SAClB;KACF,CAAC,CAAA;IAEF,OAAO,IAAI,CAAC,MAAM,CAAA;AACpB,CAAC"}

package/dist/experiment.js

@@ -55,9 +55,9 @@ export async function Experiment(config, options = {}) {
         // Parallel execution with optional concurrency limit
         const executeVariant = async (variant) => {
             return runVariant(config, variant, contextData, {
-                onVariantStart,
-                onVariantComplete,
-                onVariantError,
+                ...(onVariantStart !== undefined && { onVariantStart }),
+                ...(onVariantComplete !== undefined && { onVariantComplete }),
+                ...(onVariantError !== undefined && { onVariantError }),
             });
         };
         if (maxConcurrency && maxConcurrency > 0) {
@@ -82,9 +82,9 @@ export async function Experiment(config, options = {}) {
         // Sequential execution
         for (const variant of config.variants) {
             const result = await runVariant(config, variant, contextData, {
-                onVariantStart,
-                onVariantComplete,
-                onVariantError,
+                ...(onVariantStart !== undefined && { onVariantStart }),
+                ...(onVariantComplete !== undefined && { onVariantComplete }),
+                ...(onVariantError !== undefined && { onVariantError }),
             });
             results.push(result);
             // Stop on first error if configured
@@ -110,7 +110,7 @@ export async function Experiment(config, options = {}) {
         experimentId: config.id,
         experimentName: config.name,
         results,
-        bestVariant,
+        ...(bestVariant !== undefined && { bestVariant }),
         totalDuration,
         successCount: results.filter((r) => r.success).length,
         failureCount: results.filter((r) => !r.success).length,
@@ -144,7 +144,7 @@ async function runVariant(config, variant, contextData, callbacks) {
         variantId: variant.id,
         runId,
         startedAt: startTime,
-        data: contextData,
+        ...(contextData !== undefined && { data: contextData }),
     };
     // Track variant start
     track({
@@ -184,7 +184,7 @@ async function runVariant(config, variant, contextData, callbacks) {
             variantName: variant.name,
             runId,
             result,
-            metricValue,
+            ...(metricValue !== undefined && { metricValue }),
             duration,
             startedAt: startTime,
             completedAt: endTime,