@cursor/july 0.1.108 → 0.1.109

package/dist/ab.d.ts

@@ -1,209 +0,0 @@
-/**
- * Live A/B metrics plug-in for agent-serve.
- *
- * Author `agent/ab.ts` (or `agent/ab/<name>.ts`) with {@link defineAB}. At
- * session creation the engine runs {@link ABConfig.split} and appends durable
- * `ab.assigned` events; arms are exposed on {@link SessionInfo.abs} for the
- * agent loop (tools / optional per-variant `instructions`). {@link ABCollector}
- * folds the event stream into metrics and calls {@link ABConfig.onSample}.
- * There is no `agent-sdk ab` test runner.
- *
- * Assignments and foldable metrics live in each session's `events.ndjson`
- * (survive serve restart). Optional project defaults in `agent/ab.config.ts`
- * ({@link defineABConfig}) cap the playground fold window; durable
- * sample/snapshot export lives on the `defineStorage` `abs` table.
- *
- * ```ts
- * import { defineAB, splitBySessionHash } from "@cursor/july/ab";
- *
- * export default defineAB({
- *   name: "concise-instructions",
- *   variants: {
- *     control: { label: "Baseline" },
- *     treatment: { label: "Shorter" },
- *   },
- *   split: splitBySessionHash({ holdout: 0.1 }),
- *   onSample(sample) {
- *     console.log(sample.variant, sample.metrics);
- *   },
- * });
- * ```
- */
-import type { SessionEvent, SessionInfo } from "./types.js";
-export type { ABSnapshot } from "./internal/ab-snapshot.js";
-export interface ABVariantMeta {
-    label?: string;
-    description?: string;
-    /**
-     * Optional prompt overlay for this arm. Appended to the agent's
-     * instructions for the session (local `AGENTS.md` + cloud first-turn
-     * preamble) after sticky enrollment.
-     */
-    instructions?: string;
-}
-export interface ABSplitContext {
-    agent: {
-        name: string;
-    };
-    channel: {
-        id: string;
-    };
-    /**
-     * Live sessions only — the engine never calls `split` for
-     * `purpose: "eval"` harness sessions.
-     */
-    session: SessionInfo;
-    experiment: string;
-    /** Variant keys from {@link ABConfig.variants}, in declaration order. */
-    variants: string[];
-}
-export interface ABCollectContext {
-    agent: {
-        name: string;
-    };
-    channel: {
-        id: string;
-    };
-    session: SessionInfo;
-    experiment: string;
-    variant: string;
-}
-/** Cumulative per-session metrics for one experiment arm. */
-export interface ABMetrics {
-    turns: number;
-    turnFailures: number;
-    toolCalls: number;
-    toolErrors: number;
-    inputTokens: number;
-    outputTokens: number;
-    cacheReadTokens: number;
-    cacheWriteTokens: number;
-    /**
-     * Sum of estimated turn costs in USD (the `cost.totalUsd` recorded on
-     * `turn.completed` events). Turns whose model has no known rates
-     * contribute 0.
-     */
-    costUsd: number;
-    /** Sum of turn wall times (turn.started → turn.completed/failed). */
-    wallTimeMs: number;
-    /** Custom counters from {@link ABConfig.derive}. */
-    custom: Record<string, number>;
-}
-export type ABSampleReason = "turn.completed" | "turn.failed";
-export interface ABMetricSample {
-    experiment: string;
-    variant: string;
-    variantLabel?: string;
-    sessionId: string;
-    channelId: string;
-    metrics: ABMetrics;
-    reason: ABSampleReason;
-    at: string;
-}
-/** Variant key to enroll, or `null` to leave the session out (sticky). */
-export type ABSplitResult = string | null;
-/**
- * Sticky enrollment decision. Return a variant key, or `null` to skip.
- * Prefer helpers ({@link splitBySessionHash}, {@link splitIf}, …).
- */
-export type ABSplit = (ctx: ABSplitContext) => ABSplitResult | Promise<ABSplitResult>;
-export interface ABSplitOptions {
-    /** Relative weights per variant key (default: equal). */
-    weights?: Record<string, number>;
-    /** Fraction of sessions left out (`0`–`1`, sticky). */
-    holdout?: number;
-    /** Salt so a new rollout reshuffles without renaming the experiment. */
-    salt?: string;
-}
-/** Sticky hash of session id → arm (recommended default). */
-export declare function splitBySessionHash(options?: ABSplitOptions): ABSplit;
-/** Random draw once per new session (then sticky via persistence). */
-export declare function splitByRandom(options?: Omit<ABSplitOptions, "salt">): ABSplit;
-/** Pin every new session to one arm. */
-export declare function splitAlways(variant: string): ABSplit;
-/** Skip every session (pause without deleting the experiment). */
-export declare function splitNone(): ABSplit;
-/** Run `inner` only when `predicate` is true; otherwise skip. */
-export declare function splitIf(predicate: (ctx: ABSplitContext) => boolean | Promise<boolean>, inner: ABSplit): ABSplit;
-export interface ABConfig {
-    /** Experiment id. Defaults to the file stem (`ab/concise.ts` → `concise`). */
-    name?: string;
-    /**
-     * Named arms (at least two). Prefer `control` / `treatment` over `a` / `b`.
-     */
-    variants: Record<string, ABVariantMeta>;
-    /**
-     * Choose an arm at session creation, or return `null` to skip. The engine
-     * appends a durable `ab.assigned` event; the collector folds that stream.
-     */
-    split: ABSplit;
-    /**
-     * Optional custom metric extractors. Return a numeric delta, or
-     * `null`/`undefined` to skip. Called on **every** session event (including
-     * high-frequency `message.appended` deltas) — keep these synchronous and
-     * cheap; do not await I/O.
-     */
-    derive?: Record<string, (event: SessionEvent, ctx: ABCollectContext) => number | null | undefined | Promise<number | null | undefined>>;
-    /**
-     * Called on turn complete/fail for enrolled sessions only. Observe-only;
-     * errors are logged and never fatal.
-     */
-    onSample: (sample: ABMetricSample) => void | Promise<void>;
-}
-export type ABDefinition = ABConfig & {
-    readonly __agentServe: "ab";
-};
-/** Author a live A/B metrics experiment under `agent/ab`. */
-export declare function defineAB(config: ABConfig): ABDefinition;
-/** Resolve {@link ABConfig.split} to a variant key or `null`. */
-export declare function resolveABSplit(split: ABSplit, ctx: ABSplitContext): Promise<ABSplitResult>;
-/** FNV-1a → [0, 1). */
-export declare function hashToUnitInterval(input: string): number;
-export declare function pickWeightedVariant(variantKeys: readonly string[], weights: Record<string, number> | undefined, unitInterval: number): string;
-export declare function emptyABMetrics(): ABMetrics;
-export declare function cloneABMetrics(metrics: ABMetrics): ABMetrics;
-/**
- * Append enrolled per-variant `instructions` overlays onto the base agent
- * prompt. Used by the session engine before materializing the harness.
- */
-export declare function mergeABInstructions(base: string | undefined, abs: Readonly<Record<string, string | null>> | undefined, experiments: ReadonlyArray<{
-    name: string;
-    definition: ABDefinition;
-}>): string | undefined;
-/** Default sessions folded into `GET /v1/abs` / the A/Bs tab. */
-export declare const AB_DEFAULT_MAX_PLAYGROUND_SESSIONS = 200;
-/** Hard ceiling for {@link ABConfigFile.maxPlaygroundSessions}. */
-export declare const AB_MAX_PLAYGROUND_SESSIONS = 10000;
-/**
- * Project-wide A/B defaults (`agent/ab.config.ts`).
- *
- * **Assignments and foldable metrics** already persist in each session's
- * `events.ndjson` under `--state-root`; durable sample/snapshot export
- * lives on the `defineStorage` `abs` table (`agent/storage.ts`). This
- * config only caps how many sessions the playground / `GET /v1/abs` folds.
- */
-export interface ABConfigFile {
-    /**
-     * Optional. Max newest sessions folded into **`GET /v1/abs` / the A/Bs
-     * tab**. Does not prune session logs or change assignment.
-     *
-     * Default {@link AB_DEFAULT_MAX_PLAYGROUND_SESSIONS}; hard-capped at
-     * {@link AB_MAX_PLAYGROUND_SESSIONS}.
-     */
-    maxPlaygroundSessions?: number;
-}
-/**
- * Defaults for every experiment under `agent/ab*` (`agent/ab.config.ts`).
- *
- * Session event logs remain the assignment/metrics source of truth;
- * durable exports go through the `defineStorage` `abs` table.
- */
-export declare function defineABConfig(config: ABConfigFile): ABConfigFile;
-/** Validate {@link ABConfigFile.maxPlaygroundSessions}. */
-export declare function normalizeABMaxPlaygroundSessions(value: unknown): number;
-/**
- * Effective `GET /v1/abs` fold window. Invalid values fall back to
- * {@link AB_DEFAULT_MAX_PLAYGROUND_SESSIONS}.
- */
-export declare function resolveABMaxPlaygroundSessions(value: unknown): number;
-//# sourceMappingURL=ab.d.ts.map

package/dist/ab.d.ts.map

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

package/dist/ab.js

@@ -1,246 +0,0 @@
-/**
- * Live A/B metrics plug-in for agent-serve.
- *
- * Author `agent/ab.ts` (or `agent/ab/<name>.ts`) with {@link defineAB}. At
- * session creation the engine runs {@link ABConfig.split} and appends durable
- * `ab.assigned` events; arms are exposed on {@link SessionInfo.abs} for the
- * agent loop (tools / optional per-variant `instructions`). {@link ABCollector}
- * folds the event stream into metrics and calls {@link ABConfig.onSample}.
- * There is no `agent-sdk ab` test runner.
- *
- * Assignments and foldable metrics live in each session's `events.ndjson`
- * (survive serve restart). Optional project defaults in `agent/ab.config.ts`
- * ({@link defineABConfig}) cap the playground fold window; durable
- * sample/snapshot export lives on the `defineStorage` `abs` table.
- *
- * ```ts
- * import { defineAB, splitBySessionHash } from "@cursor/july/ab";
- *
- * export default defineAB({
- *   name: "concise-instructions",
- *   variants: {
- *     control: { label: "Baseline" },
- *     treatment: { label: "Shorter" },
- *   },
- *   split: splitBySessionHash({ holdout: 0.1 }),
- *   onSample(sample) {
- *     console.log(sample.variant, sample.metrics);
- *   },
- * });
- * ```
- */
-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 { normalizePositiveInt } from "./internal/bounded-int.js";
-import { brandDefinition } from "./internal/brand.js";
-/** Sticky hash of session id → arm (recommended default). */
-export function splitBySessionHash(options) {
-    assertHoldout(options === null || options === void 0 ? void 0 : options.holdout);
-    return (ctx) => { var _a; return pickArm(ctx.variants, options === null || options === void 0 ? void 0 : options.weights, hashToUnitInterval(`${(_a = options === null || options === void 0 ? void 0 : options.salt) !== null && _a !== void 0 ? _a : ""}\0${ctx.session.id}`), options === null || options === void 0 ? void 0 : options.holdout); };
-}
-/** Random draw once per new session (then sticky via persistence). */
-export function splitByRandom(options) {
-    assertHoldout(options === null || options === void 0 ? void 0 : options.holdout);
-    return (ctx) => pickArm(ctx.variants, options === null || options === void 0 ? void 0 : options.weights, Math.random(), options === null || options === void 0 ? void 0 : options.holdout);
-}
-/** Pin every new session to one arm. */
-export function splitAlways(variant) {
-    return () => variant;
-}
-/** Skip every session (pause without deleting the experiment). */
-export function splitNone() {
-    return () => null;
-}
-/** Run `inner` only when `predicate` is true; otherwise skip. */
-export function splitIf(predicate, inner) {
-    return (ctx) => __awaiter(this, void 0, void 0, function* () { return ((yield predicate(ctx)) ? inner(ctx) : null); });
-}
-/** Author a live A/B metrics experiment under `agent/ab`. */
-export function defineAB(config) {
-    var _a;
-    const keys = Object.keys((_a = config.variants) !== null && _a !== void 0 ? _a : {});
-    if (keys.length < 2) {
-        throw new Error(`defineAB: variants needs at least two arms (got ${keys.length})`);
-    }
-    for (const key of keys) {
-        if (key.length === 0 || key.includes("/") || key.includes("\\")) {
-            throw new Error(`defineAB: invalid variant key ${JSON.stringify(key)} (single segment)`);
-        }
-    }
-    if (typeof config.split !== "function") {
-        throw new Error("defineAB: split must be a function (splitBySessionHash(), splitIf(...), or custom)");
-    }
-    if (typeof config.onSample !== "function") {
-        throw new Error("defineAB: onSample(sample) is required");
-    }
-    if (config.derive !== undefined) {
-        for (const [key, fn] of Object.entries(config.derive)) {
-            if (typeof fn !== "function") {
-                throw new Error(`defineAB: derive.${key} must be a function`);
-            }
-        }
-    }
-    return brandDefinition("ab", config);
-}
-/** Resolve {@link ABConfig.split} to a variant key or `null`. */
-export function resolveABSplit(split, ctx) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const result = yield split(ctx);
-        if (result === null || result === undefined) {
-            return null;
-        }
-        if (typeof result === "string") {
-            return result;
-        }
-        throw new Error(`defineAB: split must return a variant key or null (got ${typeof result})`);
-    });
-}
-function assertHoldout(holdout) {
-    if (holdout === undefined) {
-        return;
-    }
-    if (!Number.isFinite(holdout) || holdout < 0 || holdout > 1) {
-        throw new Error("defineAB: holdout must be a finite number in [0, 1]");
-    }
-}
-/** Pick a variant (or `null` via holdout) from a unit interval in `[0, 1)`. */
-function pickArm(variantKeys, weights, unitInterval, holdout) {
-    const u = clampUnit(unitInterval);
-    const out = holdout !== null && holdout !== void 0 ? holdout : 0;
-    if (out >= 1 || (out > 0 && u < out)) {
-        return null;
-    }
-    const remapped = out > 0 ? (u - out) / (1 - out) : u;
-    return pickWeightedVariant(variantKeys, weights, remapped);
-}
-/** FNV-1a → [0, 1). */
-export function hashToUnitInterval(input) {
-    let h = 2166136261;
-    for (let i = 0; i < input.length; i++) {
-        h ^= input.charCodeAt(i);
-        h = Math.imul(h, 16777619);
-    }
-    return (h >>> 0) / 4294967296;
-}
-export function pickWeightedVariant(variantKeys, weights, unitInterval) {
-    var _a;
-    const u = clampUnit(unitInterval);
-    const rows = [];
-    let total = 0;
-    for (const key of variantKeys) {
-        const weight = (_a = weights === null || weights === void 0 ? void 0 : weights[key]) !== null && _a !== void 0 ? _a : 1;
-        if (weight > 0 && Number.isFinite(weight)) {
-            rows.push({ key, weight });
-            total += weight;
-        }
-    }
-    if (rows.length === 0 || total <= 0) {
-        throw new Error("defineAB: no positive-weight variants to split across");
-    }
-    let cursor = u * total;
-    for (const row of rows) {
-        cursor -= row.weight;
-        if (cursor < 0) {
-            return row.key;
-        }
-    }
-    return rows[rows.length - 1].key;
-}
-function clampUnit(unitInterval) {
-    return Math.min(Math.max(unitInterval, 0), 0.999999999);
-}
-export function emptyABMetrics() {
-    return {
-        turns: 0,
-        turnFailures: 0,
-        toolCalls: 0,
-        toolErrors: 0,
-        inputTokens: 0,
-        outputTokens: 0,
-        cacheReadTokens: 0,
-        cacheWriteTokens: 0,
-        costUsd: 0,
-        wallTimeMs: 0,
-        custom: {},
-    };
-}
-export function cloneABMetrics(metrics) {
-    return Object.assign(Object.assign({}, metrics), { custom: Object.assign({}, metrics.custom) });
-}
-/**
- * Append enrolled per-variant `instructions` overlays onto the base agent
- * prompt. Used by the session engine before materializing the harness.
- */
-export function mergeABInstructions(base, abs, experiments) {
-    var _a;
-    var _b;
-    if (abs === undefined) {
-        return base;
-    }
-    const extras = [];
-    for (const experiment of experiments) {
-        const variant = abs[experiment.name];
-        if (variant === undefined || variant === null) {
-            continue;
-        }
-        const extra = (_a = experiment.definition.variants[variant]) === null || _a === void 0 ? void 0 : _a.instructions;
-        if (typeof extra === "string" && extra.trim() !== "") {
-            extras.push(extra.trim());
-        }
-    }
-    if (extras.length === 0) {
-        return base;
-    }
-    const baseText = (_b = base === null || base === void 0 ? void 0 : base.trim()) !== null && _b !== void 0 ? _b : "";
-    return baseText === ""
-        ? extras.join("\n\n")
-        : `${baseText}\n\n${extras.join("\n\n")}`;
-}
-// ---------------------------------------------------------------------------
-// Project config (`agent/ab.config.ts`) — playground fold window
-// ---------------------------------------------------------------------------
-/** Default sessions folded into `GET /v1/abs` / the A/Bs tab. */
-export const AB_DEFAULT_MAX_PLAYGROUND_SESSIONS = 200;
-/** Hard ceiling for {@link ABConfigFile.maxPlaygroundSessions}. */
-export const AB_MAX_PLAYGROUND_SESSIONS = 10000;
-/**
- * Defaults for every experiment under `agent/ab*` (`agent/ab.config.ts`).
- *
- * Session event logs remain the assignment/metrics source of truth;
- * durable exports go through the `defineStorage` `abs` table.
- */
-export function defineABConfig(config) {
-    var _a;
-    return {
-        maxPlaygroundSessions: normalizeABMaxPlaygroundSessions((_a = config.maxPlaygroundSessions) !== null && _a !== void 0 ? _a : AB_DEFAULT_MAX_PLAYGROUND_SESSIONS),
-    };
-}
-/** Validate {@link ABConfigFile.maxPlaygroundSessions}. */
-export function normalizeABMaxPlaygroundSessions(value) {
-    return normalizePositiveInt(value, {
-        label: "ab.config.ts: maxPlaygroundSessions",
-        max: AB_MAX_PLAYGROUND_SESSIONS,
-    });
-}
-/**
- * Effective `GET /v1/abs` fold window. Invalid values fall back to
- * {@link AB_DEFAULT_MAX_PLAYGROUND_SESSIONS}.
- */
-export function resolveABMaxPlaygroundSessions(value) {
-    if (value === undefined) {
-        return AB_DEFAULT_MAX_PLAYGROUND_SESSIONS;
-    }
-    try {
-        return normalizeABMaxPlaygroundSessions(value);
-    }
-    catch (_a) {
-        return AB_DEFAULT_MAX_PLAYGROUND_SESSIONS;
-    }
-}