@prismatic-io/lux 0.0.1

package/lib/cli/render/tty.js

@@ -0,0 +1,283 @@
+/**
+ * Terminal primitives for the live runner. Hand-rolled: the CLI needs
+ * perhaps 40 lines of this, and a dependency here would have to ship as a
+ * runtime dep of the published package for the sake of its `bin`.
+ */
+// Assembled from a variable so the escape byte never appears as a literal
+// control character inside a regex or string constant.
+const ESC = String.fromCharCode(27);
+const ANSI_PATTERN = new RegExp(`${ESC}\\[[0-9;?]*[A-Za-z]`, "g");
+const ANSI_PREFIX = new RegExp(`^${ESC}\\[[0-9;?]*[A-Za-z]`);
+const RESET = `${ESC}[0m`;
+const CURSOR_HIDE = `${ESC}[?25l`;
+const CURSOR_SHOW = `${ESC}[?25h`;
+const ERASE_BELOW = `${ESC}[0J`;
+const cursorUp = (rows) => (rows > 0 ? `${ESC}[${rows}A` : "");
+export const stripAnsi = (text) => text.replace(ANSI_PATTERN, "");
+/**
+ * Code points we render that occupy two terminal cells. The CJK/emoji block
+ * ranges cover most of it; the explicit set is the handful of pre-emoji
+ * symbols (⚡ especially) that default to emoji presentation and therefore
+ * render wide despite living below U+1F300.
+ */
+const WIDE_SINGLETONS = new Set([0x231a, 0x231b, 0x23f0, 0x23f3, 0x26a1, 0x2705, 0x274c, 0x2b50]);
+const charWidth = (codePoint) => {
+    if (WIDE_SINGLETONS.has(codePoint))
+        return 2;
+    if (codePoint >= 0x1100 && codePoint <= 0x115f)
+        return 2;
+    if (codePoint >= 0x2e80 && codePoint <= 0xa4cf)
+        return 2;
+    if (codePoint >= 0xac00 && codePoint <= 0xd7a3)
+        return 2;
+    if (codePoint >= 0xf900 && codePoint <= 0xfaff)
+        return 2;
+    if (codePoint >= 0xfe30 && codePoint <= 0xfe6f)
+        return 2;
+    if (codePoint >= 0xff00 && codePoint <= 0xff60)
+        return 2;
+    if (codePoint >= 0xffe0 && codePoint <= 0xffe6)
+        return 2;
+    if (codePoint >= 0x1f300 && codePoint <= 0x1faff)
+        return 2;
+    return 1;
+};
+const graphemes = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+// Per-code-point counting over-counts ZWJ emoji sequences (a family emoji is
+// seven code points but one two-cell glyph), so width is measured per
+// grapheme cluster: any wide code point inside makes the whole cluster wide.
+const clusterWidth = (cluster) => {
+    for (const char of cluster) {
+        if (charWidth(char.codePointAt(0) ?? 0) === 2)
+            return 2;
+    }
+    return 1;
+};
+export const visibleWidth = (text) => {
+    let width = 0;
+    for (const { segment } of graphemes.segment(stripAnsi(text)))
+        width += clusterWidth(segment);
+    return width;
+};
+/**
+ * Cut `text` to `maxWidth` visible cells, counting styling as zero-width.
+ * A line wider than the terminal would wrap, and a wrapped line breaks the
+ * cursor arithmetic the live region depends on — so every painted row goes
+ * through here.
+ */
+export const truncate = (text, maxWidth) => {
+    if (maxWidth <= 0)
+        return "";
+    if (visibleWidth(text) <= maxWidth)
+        return text;
+    let out = "";
+    let width = 0;
+    let index = 0;
+    let styled = false;
+    scan: while (index < text.length) {
+        if (text.startsWith(ESC, index)) {
+            const sequence = text.slice(index).match(ANSI_PREFIX)?.[0];
+            if (!sequence)
+                break;
+            out += sequence;
+            styled = true;
+            index += sequence.length;
+            continue;
+        }
+        // Segment the plain-text run up to the next escape so a grapheme cluster
+        // is never split mid-sequence.
+        const nextEsc = text.indexOf(ESC, index);
+        const run = text.slice(index, nextEsc === -1 ? text.length : nextEsc);
+        for (const { segment } of graphemes.segment(run)) {
+            const next = width + clusterWidth(segment);
+            // Reserve one cell for the ellipsis.
+            if (next > maxWidth - 1)
+                break scan;
+            out += segment;
+            width = next;
+        }
+        index += run.length;
+    }
+    return `${out}…${styled ? RESET : ""}`;
+};
+const wrap = (open, close) => (s) => `${ESC}[${open}m${s}${ESC}[${close}m`;
+const plain = (s) => s;
+export const makeTheme = (color) => color
+    ? {
+        bold: wrap("1", "22"),
+        dim: wrap("2", "22"),
+        green: wrap("32", "39"),
+        red: wrap("31", "39"),
+        yellow: wrap("33", "39"),
+        cyan: wrap("36", "39"),
+        inverse: wrap("7", "27"),
+    }
+    : {
+        bold: plain,
+        dim: plain,
+        green: plain,
+        red: plain,
+        yellow: plain,
+        cyan: plain,
+        inverse: plain,
+    };
+/**
+ * Honour the two conventions users actually rely on: `NO_COLOR` to force
+ * plain output anywhere, `FORCE_COLOR` to keep colour through a pipe (CI
+ * log viewers that render ANSI).
+ */
+export const shouldColor = (stream, env) => {
+    if (env.NO_COLOR)
+        return false;
+    if (env.FORCE_COLOR)
+        return env.FORCE_COLOR !== "0";
+    return Boolean(stream.isTTY);
+};
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+export const spinnerFrame = (tick) => SPINNER_FRAMES[tick % SPINNER_FRAMES.length] ?? "-";
+/**
+ * A block of lines pinned to the bottom of the terminal, repainted on a
+ * timer so elapsed clocks tick. Anything else that writes to the terminal
+ * while it is active is intercepted, printed *above* the block, and the
+ * block repainted underneath — otherwise a stray write lands mid-frame and
+ * every subsequent cursor-up is off by one. Off a TTY the whole mechanism
+ * collapses to plain `staticLine` writes.
+ */
+export class LiveRegion {
+    stdout;
+    writeRaw;
+    frameIntervalMs;
+    live;
+    renderFrame = () => [];
+    paintedRows = 0;
+    timer = null;
+    patched = [];
+    held = new Map();
+    started = false;
+    constructor(options = {}) {
+        this.stdout = options.stdout ?? process.stdout;
+        // Captured before any interception, so the region's own paints never
+        // recurse back through the patched writer.
+        const original = this.stdout.write.bind(this.stdout);
+        this.writeRaw = (chunk) => {
+            original(chunk);
+        };
+        this.live = options.live ?? Boolean(this.stdout.isTTY);
+        this.frameIntervalMs = options.frameIntervalMs ?? 80;
+    }
+    start(renderFrame) {
+        this.renderFrame = renderFrame;
+        if (!this.live || this.started)
+            return;
+        this.started = true;
+        this.writeRaw(CURSOR_HIDE);
+        this.intercept(process.stderr);
+        this.timer = setInterval(() => this.repaint(), this.frameIntervalMs);
+        // Never let the repaint timer be the reason the process stays alive.
+        this.timer.unref();
+        // Interrupt handling belongs to the CLI, which has a run to unwind; the
+        // region only guarantees the cursor comes back however the process ends.
+        process.once("exit", this.onExit);
+        this.paint();
+    }
+    /**
+     * Print a permanent line above the live block. Before `start()` and after
+     * `stop()` there is no block to move, so the line goes straight out — which
+     * is also exactly the non-TTY behaviour.
+     */
+    staticLine(text) {
+        if (!this.live || !this.started) {
+            this.writeRaw(`${text}\n`);
+            return;
+        }
+        this.clear();
+        this.writeRaw(`${text}\n`);
+        this.paint();
+    }
+    repaint() {
+        if (!this.live || !this.started)
+            return;
+        this.clear();
+        this.paint();
+    }
+    stop() {
+        if (!this.live || !this.started)
+            return;
+        this.started = false;
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+        this.clear();
+        for (const { stream, original, restore } of this.patched) {
+            const rest = this.held.get(stream);
+            if (rest)
+                original(`${rest}\n`);
+            restore();
+        }
+        this.patched = [];
+        this.held.clear();
+        this.writeRaw(CURSOR_SHOW);
+        process.off("exit", this.onExit);
+    }
+    onExit = () => {
+        if (this.started)
+            this.writeRaw(CURSOR_SHOW);
+    };
+    clear() {
+        if (this.paintedRows === 0)
+            return;
+        this.writeRaw(cursorUp(this.paintedRows) + ERASE_BELOW);
+        this.paintedRows = 0;
+    }
+    paint() {
+        const columns = this.stdout.columns ?? 80;
+        const maxRows = Math.max(1, (this.stdout.rows ?? 24) - 1);
+        const lines = this.renderFrame()
+            .slice(-maxRows)
+            .map((line) => truncate(line, columns - 1));
+        if (lines.length === 0)
+            return;
+        this.writeRaw(lines.map((line) => `${line}\n`).join(""));
+        this.paintedRows = lines.length;
+    }
+    /**
+     * Buffer a foreign stream to whole lines before letting it through: a
+     * half-written line cannot be painted over cleanly, and the subprocess
+     * driver relays agent stderr in arbitrary chunks.
+     */
+    intercept(stream) {
+        if (!stream.isTTY)
+            return;
+        const original = stream.write.bind(stream);
+        const emit = (chunk) => {
+            original(chunk);
+        };
+        const patched = (chunk, encoding, callback) => {
+            const done = typeof encoding === "function" ? encoding : callback;
+            const text = typeof chunk === "string" ? chunk : Buffer.from(chunk).toString("utf-8");
+            const buffered = (this.held.get(stream) ?? "") + text;
+            const lastBreak = buffered.lastIndexOf("\n");
+            if (lastBreak === -1) {
+                this.held.set(stream, buffered);
+            }
+            else {
+                this.held.set(stream, buffered.slice(lastBreak + 1));
+                this.clear();
+                emit(buffered.slice(0, lastBreak + 1));
+                this.paint();
+            }
+            if (typeof done === "function")
+                done();
+            return true;
+        };
+        stream.write = patched;
+        this.patched.push({
+            stream,
+            original: emit,
+            restore: () => {
+                stream.write = original;
+            },
+        });
+    }
+}
+//# sourceMappingURL=tty.js.map

package/lib/cli/render/tty.js.map

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

package/lib/cli/run-options.d.ts

@@ -0,0 +1,27 @@
+export type RunOptions = {
+    tag?: string[];
+    loop?: number;
+    concurrency?: number;
+    list?: boolean;
+    listTags?: boolean;
+    interactive?: boolean;
+    claudeAnswerer?: boolean;
+    runsRoot?: string;
+    profile?: string;
+    subjectRoot?: string;
+    verbose?: boolean;
+};
+export declare const collectTags: (value: string, previous: string[]) => string[];
+export declare const collectValues: (value: string, previous: string[]) => string[];
+export declare const parseAnnotationAssertion: (value: string) => [string, {
+    passed: boolean;
+    score?: number;
+}];
+export declare const parsePositiveInt: (value: string) => number;
+export declare const parseUnitInterval: (value: string) => number;
+export declare const resolveConcurrency: (options: Pick<RunOptions, "concurrency" | "interactive" | "claudeAnswerer">, configured: number) => {
+    concurrency: number;
+    note?: string;
+};
+export declare const resolveAnswererOverride: (options: RunOptions) => string | undefined;
+//# sourceMappingURL=run-options.d.ts.map

package/lib/cli/run-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-options.d.ts","sourceRoot":"","sources":["../../src/cli/run-options.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,WAAW,UAAW,MAAM,YAAY,MAAM,EAAE,KAAG,MAAM,EAMnE,CAAC;AAEJ,eAAO,MAAM,aAAa,UAAW,MAAM,YAAY,MAAM,EAAE,KAAG,MAAM,EAA0B,CAAC;AAEnG,eAAO,MAAM,wBAAwB,UAC5B,MAAM,KACZ,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAa9C,CAAC;AAEF,eAAO,MAAM,gBAAgB,UAAW,MAAM,KAAG,MAOhD,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAAW,MAAM,KAAG,MAMjD,CAAC;AAEF,eAAO,MAAM,kBAAkB,YACpB,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,aAAa,GAAG,gBAAgB,CAAC,cAC/D,MAAM,KACjB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAYtC,CAAC;AAEF,eAAO,MAAM,uBAAuB,YAAa,UAAU,KAAG,MAAM,GAAG,SAItE,CAAC"}

package/lib/cli/run-options.js

@@ -0,0 +1,58 @@
+import { InvalidArgumentError } from "commander";
+export const collectTags = (value, previous) => previous.concat(value
+    .split(",")
+    .map((tag) => tag.trim())
+    .filter(Boolean));
+export const collectValues = (value, previous) => [...previous, value];
+export const parseAnnotationAssertion = (value) => {
+    const match = /^(.+)=(pass|fail)(?::(.+))?$/.exec(value);
+    if (!match?.[1] || !match[2]) {
+        throw new InvalidArgumentError("--assertion must use id=pass, id=fail, or id=pass:0.8 syntax");
+    }
+    const score = match[3] === undefined ? undefined : parseUnitInterval(match[3]);
+    return [
+        match[1],
+        {
+            passed: match[2] === "pass",
+            ...(score !== undefined ? { score } : {}),
+        },
+    ];
+};
+export const parsePositiveInt = (value) => {
+    // Number() rejects partial numbers such as "3abc" and "2.9".
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+        throw new InvalidArgumentError("must be a positive integer");
+    }
+    return parsed;
+};
+export const parseUnitInterval = (value) => {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
+        throw new InvalidArgumentError("must be a number between 0 and 1");
+    }
+    return parsed;
+};
+export const resolveConcurrency = (options, configured) => {
+    const requested = options.concurrency ?? configured;
+    let liveFlag = null;
+    if (options.interactive)
+        liveFlag = "--interactive";
+    else if (options.claudeAnswerer)
+        liveFlag = "--claude-answerer";
+    if (liveFlag && requested > 1) {
+        return {
+            concurrency: 1,
+            note: `lux: ${liveFlag} is a live session; running one case at a time (ignoring concurrency ${requested})\n`,
+        };
+    }
+    return { concurrency: requested };
+};
+export const resolveAnswererOverride = (options) => {
+    if (options.interactive)
+        return "terminal";
+    if (options.claudeAnswerer)
+        return "claude-code";
+    return undefined;
+};
+//# sourceMappingURL=run-options.js.map

package/lib/cli/run-options.js.map

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

package/lib/cli/skills.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+declare const PlatformSchema: z.ZodEnum<{
+    all: "all";
+    claude: "claude";
+    "claude-code": "claude-code";
+    codex: "codex";
+}>;
+export type SkillsPlatform = z.infer<typeof PlatformSchema>;
+declare const SkillNameSchema: z.ZodEnum<{
+    lux: "lux";
+    "lux-answerer": "lux-answerer";
+}>;
+export type BundledSkillName = z.infer<typeof SkillNameSchema>;
+declare const InstallSkillsOptionsSchema: z.ZodObject<{
+    cwd: z.ZodString;
+    platform: z.ZodEnum<{
+        all: "all";
+        claude: "claude";
+        "claude-code": "claude-code";
+        codex: "codex";
+    }>;
+    project: z.ZodDefault<z.ZodBoolean>;
+    dir: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodEnum<{
+        lux: "lux";
+        "lux-answerer": "lux-answerer";
+    }>>;
+}, z.core.$strict>;
+export interface InstalledSkill {
+    name: BundledSkillName;
+    platform: "claude-code" | "codex";
+    path: string;
+}
+export declare const formatSkillsList: () => string;
+export declare const installSkills: (options: z.input<typeof InstallSkillsOptionsSchema>) => Promise<InstalledSkill[]>;
+export declare const formatSkillsInstall: (installed: InstalledSkill[], cwd: string) => string;
+export {};
+//# sourceMappingURL=skills.d.ts.map

package/lib/cli/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/cli/skills.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,cAAc;;;;;EAAoD,CAAC;AACzE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,QAAA,MAAM,eAAe;;;EAAkC,CAAC;AACxD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE/D,QAAA,MAAM,0BAA0B;;;;;;;;;;;;;;kBAQrB,CAAC;AAEZ,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD,eAAO,MAAM,gBAAgB,QAAO,MAGtB,CAAC;AA2Df,eAAO,MAAM,aAAa,YACf,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,KAClD,OAAO,CAAC,cAAc,EAAE,CAU1B,CAAC;AAEF,eAAO,MAAM,mBAAmB,cAAe,cAAc,EAAE,OAAO,MAAM,KAAG,MAQhE,CAAC"}

package/lib/cli/skills.js

@@ -0,0 +1,84 @@
+import { lstat, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+const PlatformSchema = z.enum(["claude", "claude-code", "codex", "all"]);
+const SkillNameSchema = z.enum(["lux", "lux-answerer"]);
+const InstallSkillsOptionsSchema = z
+    .object({
+    cwd: z.string().min(1),
+    platform: PlatformSchema,
+    project: z.boolean().default(false),
+    dir: z.string().min(1).optional(),
+    name: SkillNameSchema.optional(),
+})
+    .strict();
+const BUNDLED_SKILLS = [
+    {
+        name: "lux",
+        description: "Author and drive coding-agent evals with Lux",
+        platforms: ["claude-code", "codex"],
+    },
+    {
+        name: "lux-answerer",
+        description: "Play a simulated user for a running Lux eval",
+        platforms: ["claude-code"],
+    },
+];
+export const formatSkillsList = () => BUNDLED_SKILLS.map(({ name, description, platforms }) => `${name}\t${description}\t${platforms.join(",")}`).join("\n");
+const targetsFor = (platform, cwd, project, dir, name) => {
+    const platforms = platform === "all"
+        ? ["claude-code", "codex"]
+        : [platform === "claude" ? "claude-code" : platform];
+    const scopeRoot = project ? resolve(cwd) : homedir();
+    const skills = name ? BUNDLED_SKILLS.filter((skill) => skill.name === name) : BUNDLED_SKILLS;
+    return platforms.flatMap((platformName) => skills
+        .filter((skill) => skill.platforms.includes(platformName))
+        .map((skill) => ({
+        name: skill.name,
+        platform: platformName,
+        source: fileURLToPath(new URL(`../../skills/${skill.name}`, import.meta.url)),
+        path: dir
+            ? join(resolve(dir), skill.name)
+            : join(scopeRoot, platformName === "claude-code" ? ".claude" : ".codex", "skills", skill.name),
+    })));
+};
+const copySkillDirectory = async (source, target) => {
+    const sourceInfo = await lstat(source);
+    if (!sourceInfo.isDirectory() || sourceInfo.isSymbolicLink()) {
+        throw new Error(`lux skills: bundled skill source is not a real directory: ${source}`);
+    }
+    await mkdir(target, { recursive: true });
+    for (const entry of await readdir(source, { withFileTypes: true })) {
+        const sourcePath = join(source, entry.name);
+        const targetPath = join(target, entry.name);
+        if (entry.isSymbolicLink()) {
+            throw new Error(`lux skills: bundled skill contains a symbolic link: ${sourcePath}`);
+        }
+        if (entry.isDirectory()) {
+            await copySkillDirectory(sourcePath, targetPath);
+        }
+        else if (entry.isFile()) {
+            await mkdir(dirname(targetPath), { recursive: true });
+            await writeFile(targetPath, await readFile(sourcePath));
+        }
+        else {
+            throw new Error(`lux skills: bundled skill contains an unsupported entry: ${sourcePath}`);
+        }
+    }
+};
+export const installSkills = async (options) => {
+    const parsed = InstallSkillsOptionsSchema.parse(options);
+    const targets = targetsFor(parsed.platform, parsed.cwd, parsed.project, parsed.dir, parsed.name);
+    if (targets.length === 0) {
+        throw new Error(`lux skills: '${parsed.name}' is not available for platform '${parsed.platform}'`);
+    }
+    for (const target of targets)
+        await copySkillDirectory(target.source, target.path);
+    return targets.map(({ source: _, ...installed }) => installed);
+};
+export const formatSkillsInstall = (installed, cwd) => installed
+    .map(({ name, platform, path }) => `installed ${name} skill for ${platform} at ${relative(cwd, path).split(sep).join("/") || "."}`)
+    .join("\n");
+//# sourceMappingURL=skills.js.map

package/lib/cli/skills.js.map

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

package/lib/core/annotation.d.ts

@@ -0,0 +1,56 @@
+import { z } from "zod";
+export declare const GraderAnnotationSchema: z.ZodObject<{
+    id: z.ZodString;
+    runDir: z.ZodString;
+    rubricPath: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    expected: z.ZodObject<{
+        casePassed: z.ZodOptional<z.ZodBoolean>;
+        caseScore: z.ZodOptional<z.ZodNumber>;
+        assertions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            passed: z.ZodBoolean;
+            score: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    source: z.ZodEnum<{
+        human: "human";
+        synthetic: "synthetic";
+    }>;
+    annotator: z.ZodOptional<z.ZodString>;
+    labeledAt: z.ZodOptional<z.ZodString>;
+    reviewer: z.ZodOptional<z.ZodString>;
+    feedback: z.ZodOptional<z.ZodString>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type GraderAnnotation = z.output<typeof GraderAnnotationSchema>;
+export declare const GraderAnnotationDatasetSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    annotations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        runDir: z.ZodString;
+        rubricPath: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        expected: z.ZodObject<{
+            casePassed: z.ZodOptional<z.ZodBoolean>;
+            caseScore: z.ZodOptional<z.ZodNumber>;
+            assertions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+                passed: z.ZodBoolean;
+                score: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+        source: z.ZodEnum<{
+            human: "human";
+            synthetic: "synthetic";
+        }>;
+        annotator: z.ZodOptional<z.ZodString>;
+        labeledAt: z.ZodOptional<z.ZodString>;
+        reviewer: z.ZodOptional<z.ZodString>;
+        feedback: z.ZodOptional<z.ZodString>;
+        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type GraderAnnotationDatasetInput = z.input<typeof GraderAnnotationDatasetSchema>;
+export type GraderAnnotationDataset = z.output<typeof GraderAnnotationDatasetSchema>;
+export declare const defineGraderAnnotations: (input: GraderAnnotationDatasetInput) => GraderAnnotationDataset;
+//# sourceMappingURL=annotation.d.ts.map

package/lib/core/annotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../../src/core/annotation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;kBA2D/B,CAAC;AACL,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmBtC,CAAC;AACL,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACzF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAErF,eAAO,MAAM,uBAAuB,UAC3B,4BAA4B,KAClC,uBAMF,CAAC"}