@prismatic-io/lux 0.0.2-preview.4 → 0.0.2-preview.41

package/lib/core/command-verification.js.map

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

package/lib/core/driver-execution.d.ts

@@ -0,0 +1,83 @@
+import { z } from "zod";
+export declare const ContainerExecutionSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"container">;
+    image: z.ZodString;
+    command: z.ZodOptional<z.ZodString>;
+    worker: z.ZodOptional<z.ZodString>;
+    driverModule: z.ZodOptional<z.ZodString>;
+    mounts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodOptional<z.ZodString>;
+        readOnly: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    passEnv: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    homeFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        destination: z.ZodString;
+        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"file">;
+            path: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"keychain">;
+            service: z.ZodString;
+            account: z.ZodString;
+            encoding: z.ZodOptional<z.ZodEnum<{
+                "go-keyring-base64": "go-keyring-base64";
+                utf8: "utf8";
+            }>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>>>;
+    network: z.ZodOptional<z.ZodEnum<{
+        bridge: "bridge";
+        none: "none";
+    }>>;
+    user: z.ZodOptional<z.ZodString>;
+    memory: z.ZodOptional<z.ZodString>;
+    cpus: z.ZodOptional<z.ZodNumber>;
+    pidsLimit: z.ZodOptional<z.ZodNumber>;
+    startupTimeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const DriverExecutionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"host">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"container">;
+    image: z.ZodString;
+    command: z.ZodOptional<z.ZodString>;
+    worker: z.ZodOptional<z.ZodString>;
+    driverModule: z.ZodOptional<z.ZodString>;
+    mounts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodOptional<z.ZodString>;
+        readOnly: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    passEnv: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    homeFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        destination: z.ZodString;
+        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"file">;
+            path: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"keychain">;
+            service: z.ZodString;
+            account: z.ZodString;
+            encoding: z.ZodOptional<z.ZodEnum<{
+                "go-keyring-base64": "go-keyring-base64";
+                utf8: "utf8";
+            }>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>>>;
+    network: z.ZodOptional<z.ZodEnum<{
+        bridge: "bridge";
+        none: "none";
+    }>>;
+    user: z.ZodOptional<z.ZodString>;
+    memory: z.ZodOptional<z.ZodString>;
+    cpus: z.ZodOptional<z.ZodNumber>;
+    pidsLimit: z.ZodOptional<z.ZodNumber>;
+    startupTimeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>], "kind">;
+export type DriverExecution = z.infer<typeof DriverExecutionSchema>;
+export type ContainerExecution = z.infer<typeof ContainerExecutionSchema>;
+export declare const driverExecutionOf: (reference: unknown) => DriverExecution | undefined;
+//# sourceMappingURL=driver-execution.d.ts.map

package/lib/core/driver-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-execution.d.ts","sourceRoot":"","sources":["../../src/core/driver-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwD1B,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAGhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,iBAAiB,cAAe,OAAO,KAAG,eAAe,GAAG,SAKxE,CAAC"}

package/lib/core/driver-execution.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+const homePath = z
+    .string()
+    .min(1)
+    .refine((value) => !value.startsWith("/") &&
+    !value.includes("\\") &&
+    value.split("/").every((part) => part !== ".." && part !== "." && part !== ""), "must be a relative path within the container home");
+export const ContainerExecutionSchema = z
+    .object({
+    kind: z.literal("container"),
+    /** A locally available image containing Lux and the selected Linux harness. */
+    image: z.string().min(1),
+    command: z.string().min(1).optional(),
+    /** The worker shipped with the same Lux build as the host. */
+    worker: z.string().min(1).optional(),
+    /** Optional module in the image exporting a custom DriverPlugin as default. */
+    driverModule: z.string().min(1).optional(),
+    mounts: z
+        .array(z
+        .object({
+        source: z.string().min(1),
+        target: z.string().min(1).optional(),
+        readOnly: z.boolean().optional(),
+    })
+        .strict())
+        .optional(),
+    /** Only these host environment variables enter the container. */
+    passEnv: z.array(z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/)).optional(),
+    env: z.record(z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/), z.string()).optional(),
+    /** Private copies, never host-home mounts; deleted after the run. */
+    homeFiles: z
+        .array(z
+        .object({
+        destination: homePath,
+        source: z.discriminatedUnion("kind", [
+            z.object({ kind: z.literal("file"), path: z.string().min(1) }).strict(),
+            z
+                .object({
+                kind: z.literal("keychain"),
+                service: z.string().min(1),
+                account: z.string().min(1),
+                encoding: z.enum(["utf8", "go-keyring-base64"]).optional(),
+            })
+                .strict(),
+        ]),
+    })
+        .strict())
+        .max(32)
+        .optional(),
+    network: z.enum(["bridge", "none"]).optional(),
+    user: z.string().min(1).optional(),
+    memory: z
+        .string()
+        .regex(/^[1-9][0-9]*[bkmgt]?$/i)
+        .optional(),
+    cpus: z.number().positive().optional(),
+    pidsLimit: z.number().int().positive().optional(),
+    startupTimeoutMs: z.number().int().positive().optional(),
+})
+    .strict();
+export const DriverExecutionSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("host") }).strict(),
+    ContainerExecutionSchema,
+]);
+export const driverExecutionOf = (reference) => {
+    if (!reference || typeof reference !== "object" || !("execution" in reference))
+        return undefined;
+    return reference.execution === undefined
+        ? undefined
+        : DriverExecutionSchema.parse(reference.execution);
+};
+//# sourceMappingURL=driver-execution.js.map

package/lib/core/driver-execution.js.map

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

package/lib/core/driver-metrics.d.ts

@@ -0,0 +1,98 @@
+import { z } from "zod";
+export declare const DriverMetricUnitSchema: z.ZodEnum<{
+    bytes: "bytes";
+    count: "count";
+    milliseconds: "milliseconds";
+    number: "number";
+    percent: "percent";
+    ratio: "ratio";
+    score: "score";
+    tokens: "tokens";
+    usd: "usd";
+}>;
+export type DriverMetricUnit = z.infer<typeof DriverMetricUnitSchema>;
+export declare const DriverMetricDescriptorSchema: z.ZodObject<{
+    unit: z.ZodDefault<z.ZodEnum<{
+        bytes: "bytes";
+        count: "count";
+        milliseconds: "milliseconds";
+        number: "number";
+        percent: "percent";
+        ratio: "ratio";
+        score: "score";
+        tokens: "tokens";
+        usd: "usd";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    better: z.ZodDefault<z.ZodEnum<{
+        higher: "higher";
+        lower: "lower";
+        neutral: "neutral";
+    }>>;
+}, z.core.$strict>;
+export type DriverMetricDescriptor = z.infer<typeof DriverMetricDescriptorSchema>;
+export declare const DriverMetricSchema: z.ZodObject<{
+    unit: z.ZodDefault<z.ZodEnum<{
+        bytes: "bytes";
+        count: "count";
+        milliseconds: "milliseconds";
+        number: "number";
+        percent: "percent";
+        ratio: "ratio";
+        score: "score";
+        tokens: "tokens";
+        usd: "usd";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    better: z.ZodDefault<z.ZodEnum<{
+        higher: "higher";
+        lower: "lower";
+        neutral: "neutral";
+    }>>;
+    value: z.ZodNumber;
+}, z.core.$strict>;
+export type DriverMetric = z.infer<typeof DriverMetricSchema>;
+export declare const DriverMetricsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    unit: z.ZodDefault<z.ZodEnum<{
+        bytes: "bytes";
+        count: "count";
+        milliseconds: "milliseconds";
+        number: "number";
+        percent: "percent";
+        ratio: "ratio";
+        score: "score";
+        tokens: "tokens";
+        usd: "usd";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    better: z.ZodDefault<z.ZodEnum<{
+        higher: "higher";
+        lower: "lower";
+        neutral: "neutral";
+    }>>;
+    value: z.ZodNumber;
+}, z.core.$strict>>;
+export type DriverMetrics = z.infer<typeof DriverMetricsSchema>;
+export declare const ReportedDriverMetricsSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+    unit: z.ZodDefault<z.ZodEnum<{
+        bytes: "bytes";
+        count: "count";
+        milliseconds: "milliseconds";
+        number: "number";
+        percent: "percent";
+        ratio: "ratio";
+        score: "score";
+        tokens: "tokens";
+        usd: "usd";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    better: z.ZodDefault<z.ZodEnum<{
+        higher: "higher";
+        lower: "lower";
+        neutral: "neutral";
+    }>>;
+    value: z.ZodNumber;
+}, z.core.$strict>]>>;
+export type ReportedDriverMetrics = z.input<typeof ReportedDriverMetricsSchema>;
+export declare const normalizeDriverMetrics: (value: unknown) => DriverMetrics;
+//# sourceMappingURL=driver-metrics.d.ts.map

package/lib/core/driver-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-metrics.d.ts","sourceRoot":"","sources":["../../src/core/driver-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;EAUjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;kBAM9B,CAAC;AACZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;kBAEpB,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;mBAA2D,CAAC;AAC5F,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAGhE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;qBAGvC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,sBAAsB,UAAW,OAAO,KAAG,aAWvD,CAAC"}

package/lib/core/driver-metrics.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export const DriverMetricUnitSchema = z.enum([
+    "number",
+    "count",
+    "milliseconds",
+    "bytes",
+    "tokens",
+    "usd",
+    "ratio",
+    "percent",
+    "score",
+]);
+export const DriverMetricDescriptorSchema = z
+    .object({
+    unit: DriverMetricUnitSchema.default("number"),
+    label: z.string().min(1).max(120).optional(),
+    better: z.enum(["lower", "higher", "neutral"]).default("neutral"),
+})
+    .strict();
+export const DriverMetricSchema = DriverMetricDescriptorSchema.extend({
+    value: z.number().finite(),
+}).strict();
+export const DriverMetricsSchema = z.record(z.string().min(1).max(120), DriverMetricSchema);
+const ReportedDriverMetricSchema = z.union([z.number().finite(), DriverMetricSchema]);
+export const ReportedDriverMetricsSchema = z.record(z.string().min(1).max(120), ReportedDriverMetricSchema);
+export const normalizeDriverMetrics = (value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return {};
+    return Object.fromEntries(Object.entries(value).flatMap(([name, metric]) => {
+        if (name.length === 0 || name.length > 120)
+            return [];
+        const parsed = DriverMetricSchema.safeParse(typeof metric === "number" ? { value: metric } : metric).data;
+        return parsed ? [[name, parsed]] : [];
+    }));
+};
+//# sourceMappingURL=driver-metrics.js.map

package/lib/core/driver-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-metrics.js","sourceRoot":"","sources":["../../src/core/driver-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,QAAQ;IACR,OAAO;IACP,cAAc;IACd,OAAO;IACP,QAAQ;IACR,KAAK;IACL,OAAO;IACP,SAAS;IACT,OAAO;CACR,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,IAAI,EAAE,sBAAsB,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CAClE,CAAC;KACD,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,kBAAkB,GAAG,4BAA4B,CAAC,MAAM,CAAC;IACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;CAC3B,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,kBAAkB,CAAC,CAAC;AAG5F,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CACjD,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAC1B,0BAA0B,CAC3B,CAAC;AAGF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAc,EAAiB,EAAE;IACtE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3E,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;QAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;YAAE,OAAO,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CACzC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CACxD,CAAC,IAAI,CAAC;QACP,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC"}

package/lib/core/driver.d.ts

@@ -1,10 +1,17 @@
 import { z } from "zod";
+import type { DriverExecution } from "./driver-execution.js";
 import type { EventHandler } from "./emitter.js";
 import type { Answer, Done, ErrorEvent, Interrupt, Progress, ReadyState } from "./events.js";
+import type { ReasoningEffort } from "./harness-catalog.js";
 import type { FixtureValueBinding } from "./lifecycle-hooks.js";
 export declare const ArtifactSchema: z.ZodObject<{
     path: z.ZodString;
     root: z.ZodExactOptional<z.ZodString>;
+    origin: z.ZodExactOptional<z.ZodEnum<{
+        fixture: "fixture";
+        generated: "generated";
+        modified: "modified";
+    }>>;
     contentType: z.ZodExactOptional<z.ZodString>;
     size: z.ZodExactOptional<z.ZodNumber>;
     meta: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -18,6 +25,8 @@ export type ResolvedFixtures = z.infer<typeof ResolvedFixturesSchema>;
 export type StartContext = {
     /** Stable selected case id, available to drivers that multiplex scenarios. */
     caseId?: string;
+    /** Private home owned by an outer execution boundary; never the caller’s home. */
+    isolatedHome?: string;
     prompt: string;
     fixtures?: ResolvedFixtures | undefined;
     /** Authored fixture values selected for this case. */
@@ -57,11 +66,66 @@ export interface AgentDriver {
      * responsible for stopping background writers before this promise resolves.
      */
     collect(): Promise<Artifact[]>;
+    /** Optional quiesced full execution tree for private command verification, until close. */
+    verificationWorkspace?(): Promise<string | undefined>;
     close(): Promise<void>;
 }
+export declare const DriverCapabilitySchema: z.ZodEnum<{
+    artifacts: "artifacts";
+    cost: "cost";
+    interactive: "interactive";
+    isolation: "isolation";
+    subagents: "subagents";
+    "tool-calls": "tool-calls";
+    "tool-results": "tool-results";
+    usage: "usage";
+}>;
+export type DriverCapability = z.infer<typeof DriverCapabilitySchema>;
+export type DriverRuntime = {
+    commands: string[];
+    /** Missing keys mean unknown; false means the adapter cannot provide the capability. */
+    capabilities: Partial<Record<DriverCapability, boolean>>;
+};
+export type DriverExperiment<Cfg> = {
+    version: string;
+    /** Bind a configuration to the experiment environment; Lux validates the returned config. */
+    prepare(config: Cfg): unknown;
+    /** Fingerprint behavior outside authored cases/configuration and the reported executables. */
+    identity(config: Cfg, context: {
+        rootDir: string;
+    }): unknown | Promise<unknown>;
+};
+/** Model and reasoning effort chosen by a harness matrix permutation. */
+export type HarnessSelection = {
+    model?: string | undefined;
+    effort?: ReasoningEffort | undefined;
+};
 export type DriverPlugin<Cfg = unknown> = {
     name: string;
     configSchema?: z.ZodTypeAny;
     create: (config: Cfg) => AgentDriver | Promise<AgentDriver>;
+    runtime?: (config: Cfg) => DriverRuntime;
+    /** Ordinary runs remain supported when controlled experiments are not declared. */
+    experiment?: DriverExperiment<Cfg>;
+    /**
+     * Apply a matrix selection to raw (unvalidated) configuration. Drivers
+     * without a model concept leave this undefined and reject selection.
+     */
+    selectHarness?: (config: unknown, selection: HarnessSelection) => unknown;
+};
+/** Selection for drivers whose configuration uses `model` and `reasoningEffort`. */
+export declare const selectModelAndReasoningEffort: (config: unknown, selection: HarnessSelection) => unknown;
+export declare const defineDriver: <S extends z.ZodType>(definition: Omit<DriverPlugin<z.output<S>>, "configSchema"> & {
+    configSchema: S;
+}) => Omit<DriverPlugin<z.output<S>>, "configSchema"> & {
+    configSchema: S;
+};
+export declare const driverRef: <S extends z.ZodType>(plugin: {
+    name: string;
+    configSchema: S;
+}, config: z.input<S>, execution?: DriverExecution) => {
+    name: string;
+    config: z.input<S>;
+    execution?: DriverExecution;
 };
 //# sourceMappingURL=driver.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/core/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,eAAO,MAAM,cAAc;;;;;;iBAWzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,sBAAsB;;;iBAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,MAAM,MAAM,YAAY,GAAG;IACzB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACxC,sDAAsD;IACtD,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,CAAC;IAC3D,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9C,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7F,GAAG,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9F,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;OAIG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,CAAC,GAAG,GAAG,OAAO,IAAI;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7D,CAAC"}
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/core/driver.ts"],"names":[],"mappings":"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"}

package/lib/core/driver.js

@@ -7,6 +7,8 @@ export const ArtifactSchema = z.object({
      * Consumers resolve `path` against this before falling back to the default.
      */
     root: z.exactOptional(z.string()),
+    /** Assigned by Lux against fixture bytes frozen before the subject starts. */
+    origin: z.exactOptional(z.enum(["generated", "modified", "fixture"])),
     contentType: z.exactOptional(z.string()),
     size: z.exactOptional(z.number()),
     meta: z.exactOptional(z.record(z.string(), z.unknown())),
@@ -15,4 +17,30 @@ export const ResolvedFixturesSchema = z.object({
     rootDir: z.string(),
     meta: z.exactOptional(z.record(z.string(), z.unknown())),
 });
+export const DriverCapabilitySchema = z.enum([
+    "interactive",
+    "tool-calls",
+    "tool-results",
+    "artifacts",
+    "subagents",
+    "usage",
+    "cost",
+    "isolation",
+]);
+/** Selection for drivers whose configuration uses `model` and `reasoningEffort`. */
+export const selectModelAndReasoningEffort = (config, selection) => ({
+    ...(config && typeof config === "object" && !Array.isArray(config)
+        ? config
+        : {}),
+    ...(selection.model !== undefined ? { model: selection.model } : {}),
+    ...(selection.effort !== undefined || selection.model !== undefined
+        ? { reasoningEffort: selection.effort }
+        : {}),
+});
+export const defineDriver = (definition) => definition;
+export const driverRef = (plugin, config, execution) => ({
+    name: plugin.name,
+    config,
+    ...(execution ? { execution } : {}),
+});
 //# sourceMappingURL=driver.js.map

package/lib/core/driver.js.map

@@ -1 +1 @@
-{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../src/core/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB;;;;OAIG;IACH,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;CACzD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;CACzD,CAAC,CAAC"}
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../src/core/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB;;;;OAIG;IACH,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,8EAA8E;IAC9E,MAAM,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;IACrE,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;CACzD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;CACzD,CAAC,CAAC;AAuDH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,aAAa;IACb,YAAY;IACZ,cAAc;IACd,WAAW;IACX,WAAW;IACX,OAAO;IACP,MAAM;IACN,WAAW;CACZ,CAAC,CAAC;AAqCH,oFAAoF;AACpF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,MAAe,EACf,SAA2B,EAClB,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAChE,CAAC,CAAE,MAAkC;QACrC,CAAC,CAAC,EAAE,CAAC;IACP,GAAG,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS;QACjE,CAAC,CAAC,EAAE,eAAe,EAAE,SAAS,CAAC,MAAM,EAAE;QACvC,CAAC,CAAC,EAAE,CAAC;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,UAAiF,EACV,EAAE,CAAC,UAAU,CAAC;AAEvF,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,MAAyC,EACzC,MAAkB,EAClB,SAA2B,EACwC,EAAE,CAAC,CAAC;IACvE,IAAI,EAAE,MAAM,CAAC,IAAI;IACjB,MAAM;IACN,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACpC,CAAC,CAAC"}

package/lib/core/duration.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+/** Explicit units prevent ambiguous numeric configuration and Node timer overflow. */
+export declare const durationMs: (value: string) => number;
+export declare const DurationSchema: z.ZodString;
+//# sourceMappingURL=duration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/core/duration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB,sFAAsF;AACtF,eAAO,MAAM,UAAU,UAAW,MAAM,KAAG,MAiB1C,CAAC;AAIF,eAAO,MAAM,cAAc,aAMzB,CAAC"}

package/lib/core/duration.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+const UNITS = {
+    ms: 1,
+    millisecond: 1,
+    milliseconds: 1,
+    s: 1000,
+    second: 1000,
+    seconds: 1000,
+    m: 60_000,
+    minute: 60_000,
+    minutes: 60_000,
+    h: 3_600_000,
+    hour: 3_600_000,
+    hours: 3_600_000,
+    d: 86_400_000,
+    day: 86_400_000,
+    days: 86_400_000,
+};
+const MAX_TIMER_MS = 2_147_483_647;
+const INVALID_DURATION = 'Expected a positive duration such as "20 minutes", "1.5 hours", or "500 ms", up to 2147483647 milliseconds';
+/** Explicit units prevent ambiguous numeric configuration and Node timer overflow. */
+export const durationMs = (value) => {
+    if (value.length > 80)
+        throw new Error(INVALID_DURATION);
+    const match = /^(\d+(?:\.\d+)?)\s*(ms|milliseconds?|s|seconds?|m|minutes?|h|hours?|d|days?)$/i.exec(value.trim());
+    const amount = match?.[1];
+    const multiplier = match?.[2] ? UNITS[match[2].toLowerCase()] : undefined;
+    if (!amount || !multiplier)
+        throw new Error(INVALID_DURATION);
+    const [whole, fraction = ""] = amount.split(".");
+    const scale = 10n ** BigInt(fraction.length);
+    const numerator = BigInt(`${whole}${fraction}`) * BigInt(multiplier);
+    const milliseconds = numerator / scale;
+    if (numerator % scale !== 0n || milliseconds <= 0n || milliseconds > BigInt(MAX_TIMER_MS)) {
+        throw new Error(INVALID_DURATION);
+    }
+    return Number(milliseconds);
+};
+// Keep strings in validated configs: schema validation may run again during
+// experiment preparation or replay. Conversion belongs at the timer boundary.
+export const DurationSchema = z.string().superRefine((value, ctx) => {
+    try {
+        durationMs(value);
+    }
+    catch {
+        ctx.addIssue({ code: "custom", message: INVALID_DURATION });
+    }
+});
+//# sourceMappingURL=duration.js.map

package/lib/core/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../src/core/duration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,KAAK,GAA2B;IACpC,EAAE,EAAE,CAAC;IACL,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,CAAC;IACf,CAAC,EAAE,IAAI;IACP,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,CAAC,EAAE,MAAM;IACT,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,MAAM;IACf,CAAC,EAAE,SAAS;IACZ,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,CAAC,EAAE,UAAU;IACb,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,UAAU;CACjB,CAAC;AACF,MAAM,YAAY,GAAG,aAAa,CAAC;AACnC,MAAM,gBAAgB,GACpB,4GAA4G,CAAC;AAE/G,sFAAsF;AACtF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE;IAClD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACzD,MAAM,KAAK,GACT,gFAAgF,CAAC,IAAI,CACnF,KAAK,CAAC,IAAI,EAAE,CACb,CAAC;IACJ,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,UAAU,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC9D,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,KAAK,GAAG,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC;IACvC,IAAI,SAAS,GAAG,KAAK,KAAK,EAAE,IAAI,YAAY,IAAI,EAAE,IAAI,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,4EAA4E;AAC5E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAClE,IAAI,CAAC;QACH,UAAU,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC,CAAC,CAAC"}

package/lib/core/environment.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+/** Author-declared execution conditions. Lux records these without enforcing or verifying them. */
+export declare const EnvironmentDeclarationSchema: z.ZodObject<{
+    imageDigest: z.ZodOptional<z.ZodString>;
+    toolchains: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    network: z.ZodOptional<z.ZodEnum<{
+        disabled: "disabled";
+        restricted: "restricted";
+        unrestricted: "unrestricted";
+    }>>;
+    resources: z.ZodOptional<z.ZodObject<{
+        cpuCount: z.ZodOptional<z.ZodNumber>;
+        memoryBytes: z.ZodOptional<z.ZodNumber>;
+        diskBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type EnvironmentDeclaration = z.infer<typeof EnvironmentDeclarationSchema>;
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/core/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mGAAmG;AACnG,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;kBAiB9B,CAAC;AACZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/lib/core/environment.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+/** Author-declared execution conditions. Lux records these without enforcing or verifying them. */
+export const EnvironmentDeclarationSchema = z
+    .object({
+    imageDigest: z
+        .string()
+        .regex(/^(?:[^@\s]+@)?sha256:[a-f0-9]{64}$/)
+        .optional(),
+    toolchains: z.record(z.string().min(1), z.string().min(1)).optional(),
+    network: z.enum(["disabled", "restricted", "unrestricted"]).optional(),
+    resources: z
+        .object({
+        cpuCount: z.number().positive().optional(),
+        memoryBytes: z.number().int().positive().optional(),
+        diskBytes: z.number().int().positive().optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+//# sourceMappingURL=environment.js.map

package/lib/core/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/core/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mGAAmG;AACnG,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,KAAK,CAAC,oCAAoC,CAAC;SAC3C,QAAQ,EAAE;IACb,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtE,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACnD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KAClD,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;CACd,CAAC;KACD,MAAM,EAAE,CAAC"}

package/lib/core/evaluation-clusters.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export declare const EvaluationMetadataSchema: z.ZodObject<{
+    cluster: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodUnknown>>;
+export declare const clusterKey: (id: string, cluster: string | undefined) => string;
+export declare const independentClusterCount: (items: readonly {
+    id: string;
+    cluster?: string | undefined;
+}[]) => number;
+export declare const assertDisjointClusters: (splits: readonly {
+    name: string;
+    items: readonly {
+        id: string;
+        cluster?: string | undefined;
+    }[];
+}[]) => void;
+//# sourceMappingURL=evaluation-clusters.d.ts.map

package/lib/core/evaluation-clusters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation-clusters.d.ts","sourceRoot":"","sources":["../../src/core/evaluation-clusters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;kCAKb,CAAC;AAEzB,eAAO,MAAM,UAAU,OAAQ,MAAM,WAAW,MAAM,GAAG,SAAS,KAAG,MACQ,CAAC;AAE9E,eAAO,MAAM,uBAAuB,UAC3B,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAAE,KAC7D,MAA8E,CAAC;AAElF,eAAO,MAAM,sBAAsB,WACzB,SAAS;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;CAChE,EAAE,KACF,IAaF,CAAC"}

package/lib/core/evaluation-clusters.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export const EvaluationMetadataSchema = z
+    .object({
+    /** Related perturbations share one independent statistical unit. */
+    cluster: z.string().trim().min(1).optional(),
+})
+    .catchall(z.unknown());
+export const clusterKey = (id, cluster) => JSON.stringify(cluster === undefined ? ["case", id] : ["cluster", cluster]);
+export const independentClusterCount = (items) => new Set(items.map((item) => clusterKey(item.id, item.cluster))).size;
+export const assertDisjointClusters = (splits) => {
+    const owners = new Map();
+    for (const split of splits) {
+        for (const item of split.items) {
+            if (item.cluster === undefined)
+                continue;
+            const owner = owners.get(item.cluster);
+            if (owner !== undefined && owner !== split.name)
+                throw new Error(`evaluation cluster '${item.cluster}' appears in both ${owner} and ${split.name} splits`);
+            owners.set(item.cluster, split.name);
+        }
+    }
+};
+//# sourceMappingURL=evaluation-clusters.js.map