@cursor/july 0.1.108 → 0.1.109

package/dist/internal/ab-fold.js

@@ -1,175 +0,0 @@
-/**
- * Pure fold of a session event stream into A/B arms + cumulative metrics.
- * Shared by {@link ABCollector} (live) and {@link buildABSnapshot} (read API).
- */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { cloneABMetrics, emptyABMetrics, } from "../ab.js";
-import { describeError } from "./describe-error.js";
-export function emptyFoldedABSession() {
-    return { arms: new Map(), metrics: new Map() };
-}
-/** Ensure a metrics bucket exists for an enrolled arm. */
-export function ensureArmAccum(state, experiment, variant) {
-    let accum = state.metrics.get(experiment);
-    if (accum === undefined) {
-        accum = {
-            variant,
-            metrics: emptyABMetrics(),
-            turnStartedAt: null,
-        };
-        state.metrics.set(experiment, accum);
-    }
-    return accum;
-}
-/** Fold one event's built-in metrics + assignment. Does not run `derive`. */
-export function foldABEvent(state, event) {
-    if (event.type === "ab.assigned") {
-        const { experiment, variant } = event.data;
-        state.arms.set(experiment, variant);
-        if (variant === null) {
-            state.metrics.delete(experiment);
-        }
-        else {
-            state.metrics.set(experiment, {
-                variant,
-                metrics: emptyABMetrics(),
-                turnStartedAt: null,
-            });
-        }
-        return;
-    }
-    if (state.arms.size === 0) {
-        return;
-    }
-    for (const [experiment, variant] of state.arms) {
-        if (variant === null) {
-            continue;
-        }
-        applyBuiltinMetrics(ensureArmAccum(state, experiment, variant), event);
-    }
-}
-export function foldABStream(events) {
-    const state = emptyFoldedABSession();
-    for (const event of events) {
-        foldABEvent(state, event);
-    }
-    return state;
-}
-/**
- * Apply `derive` extractors for one event into `custom` counters.
- * Errors are reported via `onError` and skipped.
- */
-export function applyDeriveForEvent(custom, derive, event, collectCtx, onError) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        for (const [key, extract] of Object.entries(derive)) {
-            try {
-                const delta = yield extract(event, collectCtx);
-                if (typeof delta === "number" && Number.isFinite(delta)) {
-                    custom[key] = ((_a = custom[key]) !== null && _a !== void 0 ? _a : 0) + delta;
-                }
-            }
-            catch (error) {
-                onError(key, error);
-            }
-        }
-    });
-}
-function collectContext(experiment, variant, sessionInfo, agentName) {
-    return {
-        agent: { name: agentName },
-        channel: { id: sessionInfo.channelId },
-        session: sessionInfo,
-        experiment,
-        variant,
-    };
-}
-/**
- * Re-run `derive` extractors over the stream for enrolled arms.
- * Mutates `state.metrics` in place. Errors are logged and skipped.
- */
-export function applyABDerive(state, events, experiments, sessionInfo, agentName, logger) {
-    return __awaiter(this, void 0, void 0, function* () {
-        for (const experiment of experiments) {
-            const variant = state.arms.get(experiment.name);
-            if (variant === undefined || variant === null) {
-                continue;
-            }
-            const def = experiment.definition;
-            if (def.derive === undefined) {
-                continue;
-            }
-            const accum = ensureArmAccum(state, experiment.name, variant);
-            // Reset custom so a re-fold is idempotent.
-            accum.metrics.custom = {};
-            const ctx = collectContext(experiment.name, variant, sessionInfo, agentName);
-            for (const event of events) {
-                yield applyDeriveForEvent(accum.metrics.custom, def.derive, event, ctx, (key, error) => {
-                    logger(`[agent-sdk] ab "${experiment.name}" derive.${key} threw: ${describeError(error)}`);
-                });
-            }
-        }
-    });
-}
-export function applyBuiltinMetrics(accum, event) {
-    const m = accum.metrics;
-    switch (event.type) {
-        case "turn.started":
-            accum.turnStartedAt = event.at;
-            break;
-        case "turn.completed": {
-            m.turns += 1;
-            const usage = event.data.usage;
-            if (usage !== undefined) {
-                m.inputTokens += usage.inputTokens;
-                m.outputTokens += usage.outputTokens;
-                m.cacheReadTokens += usage.cacheReadTokens;
-                m.cacheWriteTokens += usage.cacheWriteTokens;
-            }
-            const cost = event.data.cost;
-            if (cost !== undefined) {
-                m.costUsd += cost.totalUsd;
-            }
-            addWallTime(accum, event.at);
-            break;
-        }
-        case "turn.failed":
-            m.turns += 1;
-            m.turnFailures += 1;
-            addWallTime(accum, event.at);
-            break;
-        case "action.result":
-            m.toolCalls += 1;
-            if (event.data.isError) {
-                m.toolErrors += 1;
-            }
-            break;
-        default:
-            break;
-    }
-}
-function addWallTime(accum, endedAt) {
-    if (accum.turnStartedAt === null) {
-        return;
-    }
-    const start = Date.parse(accum.turnStartedAt);
-    const end = Date.parse(endedAt);
-    accum.turnStartedAt = null;
-    if (Number.isFinite(start) && Number.isFinite(end) && end >= start) {
-        accum.metrics.wallTimeMs += end - start;
-    }
-}
-export function cloneFoldedMetrics(accum) {
-    if (accum === undefined) {
-        return undefined;
-    }
-    return cloneABMetrics(accum.metrics);
-}

package/dist/internal/ab-snapshot.d.ts

@@ -1,68 +0,0 @@
-/**
- * Read-only A/B metrics snapshot: fold durable session event streams into
- * per-session assignments and aggregate arm totals. Used by `GET /v1/abs`.
- */
-import { type ABMetrics, type ABVariantMeta } from "../ab.js";
-import type { DiscoveredAB, SessionEvent, SessionInfo, SessionRecord, SessionSummary } from "../types.js";
-export interface ABSnapshotAssignment {
-    experiment: string;
-    variant: string | null;
-    variantLabel?: string;
-    /** Present when enrolled (`variant` non-null). */
-    metrics?: ABMetrics;
-}
-export interface ABSnapshotSession {
-    sessionId: string;
-    channelId: string;
-    mode: string;
-    title?: string;
-    turnCount: number;
-    updatedAt?: string;
-    assignments: ABSnapshotAssignment[];
-}
-export interface ABSnapshotArm {
-    variant: string;
-    variantLabel?: string;
-    description?: string;
-    /** Sessions enrolled in this arm. */
-    sessions: number;
-    metrics: ABMetrics;
-}
-export interface ABSnapshotExperiment {
-    name: string;
-    variants: Record<string, ABVariantMeta>;
-    /** Sessions with sticky skip (`variant: null`). */
-    skipped: number;
-    arms: ABSnapshotArm[];
-}
-export interface ABSnapshotConfig {
-    /** Newest-first session fold window for this snapshot (`GET /v1/abs`). */
-    maxPlaygroundSessions?: number;
-    /** True when the `defineStorage` `abs` table is configured. */
-    durableSamples?: boolean;
-    /** True when the `abs` table also stores the aggregate snapshot. */
-    durableSnapshots?: boolean;
-}
-export interface ABSnapshot {
-    experiments: ABSnapshotExperiment[];
-    sessions: ABSnapshotSession[];
-    config?: ABSnapshotConfig;
-}
-export interface BuildABSnapshotInput {
-    experiments: readonly DiscoveredAB[];
-    agentName: string;
-    /** Newest-first session list (same order as `GET /v1/sessions`). */
-    sessions: readonly SessionSummary[];
-    loadRecord: (sessionId: string) => Promise<SessionRecord | undefined>;
-    loadEvents: (sessionId: string) => Promise<SessionEvent[]>;
-    sessionInfo: (record: SessionRecord) => SessionInfo;
-    logger: (line: string) => void;
-    /** Max concurrent event-log reads (default 8). */
-    concurrency?: number;
-    /** Attached to the returned snapshot (playground / persistence meta). */
-    config?: ABSnapshotConfig;
-}
-export declare function buildABSnapshot(input: BuildABSnapshotInput): Promise<ABSnapshot>;
-/** Narrow helper so callers don't need the unused DiscoveredAB import above. */
-export type { DiscoveredAB };
-//# sourceMappingURL=ab-snapshot.d.ts.map

package/dist/internal/ab-snapshot.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ab-snapshot.d.ts","sourceRoot":"","sources":["../../src/internal/ab-snapshot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,aAAa,EAGnB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,cAAc,EACf,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,+DAA+D;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,SAAS,YAAY,EAAE,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IACtE,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC3D,WAAW,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,WAAW,CAAC;IACpD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,UAAU,CAAC,CA8NrB;AAkBD,gFAAgF;AAChF,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/internal/ab-snapshot.js

@@ -1,208 +0,0 @@
-/**
- * Read-only A/B metrics snapshot: fold durable session event streams into
- * per-session assignments and aggregate arm totals. Used by `GET /v1/abs`.
- */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { cloneABMetrics, emptyABMetrics, } from "../ab.js";
-import { applyABDerive, cloneFoldedMetrics, foldABStream } from "./ab-fold.js";
-import { mapPool } from "./map-pool.js";
-export function buildABSnapshot(input) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
-        const experiments = input.experiments;
-        const armTotals = new Map();
-        const skipped = new Map();
-        for (const experiment of experiments) {
-            armTotals.set(experiment.name, new Map());
-            skipped.set(experiment.name, 0);
-            for (const variant of Object.keys(experiment.definition.variants)) {
-                armTotals.get(experiment.name).set(variant, {
-                    sessions: 0,
-                    metrics: emptyABMetrics(),
-                });
-            }
-        }
-        const concurrency = Math.max(1, (_a = input.concurrency) !== null && _a !== void 0 ? _a : 8);
-        const sessionRows = [];
-        function processOne(summary) {
-            return __awaiter(this, void 0, void 0, function* () {
-                var _a, _b;
-                var _c, _d;
-                const record = yield input.loadRecord(summary.sessionId);
-                if (record === undefined) {
-                    return;
-                }
-                // Eval harness sessions never enroll; keep them out of aggregates too.
-                if (record.purpose === "eval") {
-                    return;
-                }
-                const events = yield input.loadEvents(summary.sessionId);
-                const folded = foldABStream(events);
-                if (experiments.length > 0) {
-                    yield applyABDerive(folded, events, experiments, input.sessionInfo(record), input.agentName, input.logger);
-                }
-                const assignments = [];
-                // Prefer declared experiment order; include unknown arms from the log after.
-                const seen = new Set();
-                for (const experiment of experiments) {
-                    seen.add(experiment.name);
-                    const variant = folded.arms.get(experiment.name);
-                    if (variant === undefined) {
-                        continue;
-                    }
-                    const def = experiment.definition;
-                    const label = variant === null ? undefined : (_a = def.variants[variant]) === null || _a === void 0 ? void 0 : _a.label;
-                    const metrics = variant === null
-                        ? undefined
-                        : cloneFoldedMetrics(folded.metrics.get(experiment.name));
-                    assignments.push(Object.assign(Object.assign({ experiment: experiment.name, variant }, (label !== undefined ? { variantLabel: label } : {})), (metrics !== undefined ? { metrics } : {})));
-                    if (variant === null) {
-                        skipped.set(experiment.name, ((_c = skipped.get(experiment.name)) !== null && _c !== void 0 ? _c : 0) + 1);
-                    }
-                    else {
-                        const bucket = (_b = armTotals.get(experiment.name)) === null || _b === void 0 ? void 0 : _b.get(variant);
-                        if (bucket !== undefined && metrics !== undefined) {
-                            bucket.sessions += 1;
-                            addMetrics(bucket.metrics, metrics);
-                        }
-                        else if (bucket === undefined) {
-                            // Assigned to an arm no longer in the definition — still surface it.
-                            const arms = (_d = armTotals.get(experiment.name)) !== null && _d !== void 0 ? _d : new Map();
-                            const created = {
-                                sessions: 1,
-                                metrics: metrics !== undefined
-                                    ? cloneABMetrics(metrics)
-                                    : emptyABMetrics(),
-                            };
-                            arms.set(variant, created);
-                            armTotals.set(experiment.name, arms);
-                        }
-                    }
-                }
-                for (const [experiment, variant] of folded.arms) {
-                    if (seen.has(experiment)) {
-                        continue;
-                    }
-                    const metrics = variant === null
-                        ? undefined
-                        : cloneFoldedMetrics(folded.metrics.get(experiment));
-                    assignments.push(Object.assign({ experiment,
-                        variant }, (metrics !== undefined ? { metrics } : {})));
-                }
-                if (assignments.length === 0) {
-                    return;
-                }
-                sessionRows.push(Object.assign(Object.assign(Object.assign(Object.assign({ sessionId: summary.sessionId, channelId: summary.channelId, mode: summary.mode }, (summary.title === undefined ? {} : { title: summary.title })), { turnCount: summary.turnCount }), (summary.updatedAt === undefined
-                    ? {}
-                    : { updatedAt: summary.updatedAt })), { assignments }));
-            });
-        }
-        yield mapPool(input.sessions, concurrency, (summary) => __awaiter(this, void 0, void 0, function* () {
-            yield processOne(summary);
-        }));
-        // Preserve newest-first order from the sessions list.
-        const order = new Map(input.sessions.map((summary, index) => [summary.sessionId, index]));
-        sessionRows.sort((a, b) => { var _a, _b; return ((_a = order.get(a.sessionId)) !== null && _a !== void 0 ? _a : 0) - ((_b = order.get(b.sessionId)) !== null && _b !== void 0 ? _b : 0); });
-        const experimentRows = experiments.map((experiment) => {
-            var _a;
-            var _b, _c, _d;
-            const def = experiment.definition;
-            const arms = [];
-            for (const [variant, meta] of Object.entries(def.variants)) {
-                const bucket = (_b = (_a = armTotals.get(experiment.name)) === null || _a === void 0 ? void 0 : _a.get(variant)) !== null && _b !== void 0 ? _b : {
-                    sessions: 0,
-                    metrics: emptyABMetrics(),
-                };
-                arms.push(Object.assign(Object.assign(Object.assign({ variant }, (meta.label !== undefined ? { variantLabel: meta.label } : {})), (meta.description !== undefined
-                    ? { description: meta.description }
-                    : {})), { sessions: bucket.sessions, metrics: cloneABMetrics(bucket.metrics) }));
-            }
-            // Orphan arms from the log (no longer in definition).
-            for (const [variant, bucket] of (_c = armTotals.get(experiment.name)) !== null && _c !== void 0 ? _c : []) {
-                if (variant in def.variants) {
-                    continue;
-                }
-                arms.push({
-                    variant,
-                    sessions: bucket.sessions,
-                    metrics: cloneABMetrics(bucket.metrics),
-                });
-            }
-            return {
-                name: experiment.name,
-                variants: def.variants,
-                skipped: (_d = skipped.get(experiment.name)) !== null && _d !== void 0 ? _d : 0,
-                arms,
-            };
-        });
-        // Experiments that appear only in logs (definition removed).
-        const known = new Set(experiments.map((experiment) => experiment.name));
-        const orphanNames = new Set();
-        for (const row of sessionRows) {
-            for (const assignment of row.assignments) {
-                if (!known.has(assignment.experiment)) {
-                    orphanNames.add(assignment.experiment);
-                }
-            }
-        }
-        for (const name of orphanNames) {
-            const armsMap = new Map();
-            let skipCount = 0;
-            for (const row of sessionRows) {
-                for (const assignment of row.assignments) {
-                    if (assignment.experiment !== name) {
-                        continue;
-                    }
-                    if (assignment.variant === null) {
-                        skipCount += 1;
-                        continue;
-                    }
-                    const bucket = (_b = armsMap.get(assignment.variant)) !== null && _b !== void 0 ? _b : {
-                        sessions: 0,
-                        metrics: emptyABMetrics(),
-                    };
-                    bucket.sessions += 1;
-                    if (assignment.metrics !== undefined) {
-                        addMetrics(bucket.metrics, assignment.metrics);
-                    }
-                    armsMap.set(assignment.variant, bucket);
-                }
-            }
-            experimentRows.push({
-                name,
-                variants: {},
-                skipped: skipCount,
-                arms: [...armsMap.entries()].map(([variant, bucket]) => ({
-                    variant,
-                    sessions: bucket.sessions,
-                    metrics: cloneABMetrics(bucket.metrics),
-                })),
-            });
-        }
-        return Object.assign({ experiments: experimentRows, sessions: sessionRows }, (input.config === undefined ? {} : { config: input.config }));
-    });
-}
-function addMetrics(target, delta) {
-    var _a;
-    target.turns += delta.turns;
-    target.turnFailures += delta.turnFailures;
-    target.toolCalls += delta.toolCalls;
-    target.toolErrors += delta.toolErrors;
-    target.inputTokens += delta.inputTokens;
-    target.outputTokens += delta.outputTokens;
-    target.cacheReadTokens += delta.cacheReadTokens;
-    target.cacheWriteTokens += delta.cacheWriteTokens;
-    target.costUsd += delta.costUsd;
-    target.wallTimeMs += delta.wallTimeMs;
-    for (const [key, value] of Object.entries(delta.custom)) {
-        target.custom[key] = ((_a = target.custom[key]) !== null && _a !== void 0 ? _a : 0) + value;
-    }
-}

package/dist/internal/discovery/ab.d.ts

@@ -1,9 +0,0 @@
-/**
- * `agent/ab.ts` or `agent/ab/*.ts` plus `agent/ab.config.ts`: live A/B experiments.
- */
-import type { ABConfigFile } from "../../ab.js";
-import type { DiscoveredAB } from "../../types.js";
-import { type DiscoveryContext } from "./context.js";
-export declare function loadABs(ctx: DiscoveryContext, agentDir: string, onDisable?: (source: string, path: string) => void): Promise<DiscoveredAB[]>;
-export declare function loadABConfig(ctx: DiscoveryContext, agentDir: string): Promise<ABConfigFile | undefined>;
-//# sourceMappingURL=ab.d.ts.map

package/dist/internal/discovery/ab.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ab.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/ab.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAUlE,wBAAsB,OAAO,CAC3B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GACjD,OAAO,CAAC,YAAY,EAAE,CAAC,CAiEzB;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAyBnC"}

package/dist/internal/discovery/ab.js

@@ -1,113 +0,0 @@
-/**
- * `agent/ab.ts` or `agent/ab/*.ts` plus `agent/ab.config.ts`: live A/B experiments.
- */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { basename, extname, join, relative } from "node:path";
-import { getDefinitionKind } from "../brand.js";
-import { displayPath } from "./context.js";
-import { findModuleFile, isDirectory, isModuleFile, toPosix, walkFiles, } from "./fs.js";
-import { importDefault } from "./modules.js";
-export function loadABs(ctx, agentDir, onDisable) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const abs = [];
-        const seen = new Set();
-        const single = yield findModuleFile(agentDir, "ab");
-        if (single !== undefined) {
-            const definition = yield importDefault(ctx, single, onDisable === undefined ? "ab" : ["ab", "disabled"]);
-            if (definition !== undefined) {
-                if (getDefinitionKind(definition) === "disabled") {
-                    onDisable === null || onDisable === void 0 ? void 0 : onDisable("ab", single);
-                }
-                else {
-                    const name = resolveABName(definition, "ab");
-                    seen.add(name);
-                    abs.push({
-                        name,
-                        source: "ab",
-                        definition: definition,
-                    });
-                }
-            }
-        }
-        const absDir = join(agentDir, "ab");
-        if (yield isDirectory(absDir)) {
-            for (const filePath of yield walkFiles(absDir)) {
-                if (!isModuleFile(basename(filePath))) {
-                    continue;
-                }
-                const rel = toPosix(relative(absDir, filePath));
-                const stem = rel.slice(0, -extname(rel).length);
-                const definition = yield importDefault(ctx, filePath, onDisable === undefined ? "ab" : ["ab", "disabled"]);
-                if (definition === undefined) {
-                    continue;
-                }
-                if (getDefinitionKind(definition) === "disabled") {
-                    onDisable === null || onDisable === void 0 ? void 0 : onDisable(stem, filePath);
-                    continue;
-                }
-                const name = resolveABName(definition, stem);
-                if (seen.has(name)) {
-                    ctx.diagnostics.push({
-                        severity: "error",
-                        path: displayPath(ctx, filePath),
-                        message: `Duplicate A/B experiment name ${JSON.stringify(name)}.`,
-                    });
-                    continue;
-                }
-                seen.add(name);
-                abs.push({
-                    name,
-                    source: stem,
-                    definition: definition,
-                });
-            }
-        }
-        return abs;
-    });
-}
-export function loadABConfig(ctx, agentDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const path = yield findModuleFile(agentDir, "ab.config");
-        if (path === undefined) {
-            return undefined;
-        }
-        try {
-            const mod = yield ctx.importModule(path);
-            if (mod.default === null || typeof mod.default !== "object") {
-                ctx.diagnostics.push({
-                    severity: "error",
-                    path: displayPath(ctx, path),
-                    message: "ab.config.ts must default-export defineABConfig({ ... }) from @cursor/july/ab.",
-                });
-                return undefined;
-            }
-            return mod.default;
-        }
-        catch (error) {
-            ctx.diagnostics.push({
-                severity: "error",
-                path: displayPath(ctx, path),
-                message: `Failed to load ab.config: ${error instanceof Error ? error.message : String(error)}`,
-            });
-            return undefined;
-        }
-    });
-}
-function resolveABName(definition, fallback) {
-    if (typeof definition === "object" &&
-        definition !== null &&
-        "name" in definition &&
-        typeof definition.name === "string" &&
-        definition.name.length > 0) {
-        return definition.name;
-    }
-    return fallback;
-}