@prismatic-io/lux 0.0.1

package/lib/core/hash.js

@@ -0,0 +1,214 @@
+import { createHash } from "node:crypto";
+const typedArrayConstructors = new Set([
+    Int8Array,
+    Uint8Array,
+    Uint8ClampedArray,
+    Int16Array,
+    Uint16Array,
+    Int32Array,
+    Uint32Array,
+    Float32Array,
+    Float64Array,
+    BigInt64Array,
+    BigUint64Array,
+    Buffer,
+]);
+const ownStateKeys = (value, allowed) => Reflect.ownKeys(value).flatMap((key) => {
+    if (typeof key === "symbol") {
+        throw new TypeError("valueHash does not support symbol-keyed state");
+    }
+    return allowed.has(key) ? [] : [key];
+});
+const assertNoAttachedState = (value, allowed) => {
+    const keys = ownStateKeys(value, allowed);
+    if (keys.length > 0) {
+        throw new TypeError(`valueHash does not support attached state on ${value.constructor?.name ?? "value"}: ${keys.join(", ")}`);
+    }
+};
+const numberValue = (value) => {
+    if (Number.isNaN(value))
+        return "NaN";
+    if (value === Number.POSITIVE_INFINITY)
+        return "Infinity";
+    if (value === Number.NEGATIVE_INFINITY)
+        return "-Infinity";
+    if (Object.is(value, -0))
+        return "-0";
+    return value;
+};
+const arrayIndex = (key, length) => {
+    if (!/^(?:0|[1-9]\d*)$/.test(key))
+        return null;
+    const index = Number(key);
+    return Number.isSafeInteger(index) && index >= 0 && index < length ? index : null;
+};
+const canonicalizeObject = (value, traversal) => {
+    const reference = traversal.active.get(value);
+    if (reference !== undefined)
+        return ["reference", reference];
+    const id = traversal.nextId++;
+    traversal.active.set(value, id);
+    try {
+        if (Array.isArray(value)) {
+            if (Object.getPrototypeOf(value) !== Array.prototype) {
+                throw new TypeError("valueHash does not support Array subclasses");
+            }
+            const ownKeys = ownStateKeys(value, new Set(["length"]));
+            for (const key of ownKeys) {
+                if (arrayIndex(key, value.length) === null) {
+                    throw new TypeError(`valueHash does not support array property '${key}'`);
+                }
+                const descriptor = Object.getOwnPropertyDescriptor(value, key);
+                if (descriptor && !("value" in descriptor)) {
+                    throw new TypeError(`valueHash does not support accessor property '${key}'`);
+                }
+            }
+            return [
+                "array",
+                Array.from({ length: value.length }, (_, index) => Object.hasOwn(value, index)
+                    ? canonicalize(value[index], traversal)
+                    : ["array-hole"]),
+            ];
+        }
+        if (value instanceof Date) {
+            if (Object.getPrototypeOf(value) !== Date.prototype) {
+                throw new TypeError("valueHash does not support Date subclasses");
+            }
+            assertNoAttachedState(value, new Set());
+            return ["date", numberValue(value.getTime())];
+        }
+        if (value instanceof RegExp) {
+            if (Object.getPrototypeOf(value) !== RegExp.prototype) {
+                throw new TypeError("valueHash does not support RegExp subclasses");
+            }
+            assertNoAttachedState(value, new Set(["lastIndex"]));
+            return ["regexp", value.source, value.flags, value.lastIndex];
+        }
+        if (value instanceof Map) {
+            if (Object.getPrototypeOf(value) !== Map.prototype) {
+                throw new TypeError("valueHash does not support Map subclasses");
+            }
+            assertNoAttachedState(value, new Set());
+            return [
+                "map",
+                Array.from(value.entries(), ([key, item]) => [
+                    canonicalize(key, traversal),
+                    canonicalize(item, traversal),
+                ]),
+            ];
+        }
+        if (value instanceof Set) {
+            if (Object.getPrototypeOf(value) !== Set.prototype) {
+                throw new TypeError("valueHash does not support Set subclasses");
+            }
+            assertNoAttachedState(value, new Set());
+            return ["set", Array.from(value, (item) => canonicalize(item, traversal))];
+        }
+        if (value instanceof ArrayBuffer) {
+            if (Object.getPrototypeOf(value) !== ArrayBuffer.prototype) {
+                throw new TypeError("valueHash does not support ArrayBuffer subclasses");
+            }
+            assertNoAttachedState(value, new Set());
+            return ["array-buffer", Buffer.from(value).toString("base64")];
+        }
+        if (ArrayBuffer.isView(value)) {
+            if (typeof SharedArrayBuffer !== "undefined" && value.buffer instanceof SharedArrayBuffer) {
+                throw new TypeError("valueHash does not support shared mutable buffers");
+            }
+            if (value instanceof DataView) {
+                if (Object.getPrototypeOf(value) !== DataView.prototype) {
+                    throw new TypeError("valueHash does not support DataView subclasses");
+                }
+                assertNoAttachedState(value, new Set());
+                return [
+                    "data-view",
+                    Buffer.from(value.buffer, value.byteOffset, value.byteLength).toString("base64"),
+                ];
+            }
+            const viewConstructor = Object.getPrototypeOf(value)?.constructor;
+            if (typeof viewConstructor !== "function" || !typedArrayConstructors.has(viewConstructor)) {
+                throw new TypeError("valueHash does not support custom typed-array classes");
+            }
+            const indexedKeys = new Set(Array.from({ length: value.length }, (_, index) => String(index)));
+            assertNoAttachedState(value, indexedKeys);
+            return [
+                "typed-array",
+                viewConstructor.name,
+                Array.from(value, (item) => canonicalize(item, traversal)),
+            ];
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new TypeError(`valueHash does not support class instance '${value.constructor?.name ?? "unknown"}'`);
+        }
+        const entries = ownStateKeys(value, new Set())
+            .sort((a, b) => a.localeCompare(b))
+            .map((key) => {
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            if (!descriptor?.enumerable) {
+                throw new TypeError(`valueHash does not support non-enumerable property '${key}'`);
+            }
+            if (!("value" in descriptor)) {
+                throw new TypeError(`valueHash does not support accessor property '${key}'`);
+            }
+            return [key, canonicalize(descriptor.value, traversal)];
+        });
+        return [prototype === null ? "null-object" : "object", entries];
+    }
+    finally {
+        traversal.active.delete(value);
+    }
+};
+const canonicalize = (value, traversal) => {
+    if (value === null)
+        return ["null"];
+    if (value === undefined)
+        return ["undefined"];
+    if (typeof value === "string")
+        return ["string", value];
+    if (typeof value === "boolean")
+        return ["boolean", value];
+    if (typeof value === "number")
+        return ["number", numberValue(value)];
+    if (typeof value === "bigint")
+        return ["bigint", value.toString()];
+    if (typeof value === "symbol") {
+        throw new TypeError("valueHash does not support symbols");
+    }
+    if (typeof value === "function") {
+        const ownKeys = Reflect.ownKeys(value);
+        if (ownKeys.some((key) => typeof key === "symbol")) {
+            throw new TypeError("valueHash does not support symbol-keyed function state");
+        }
+        const standardKeys = new Set(["length", "name", "arguments", "caller", "prototype"]);
+        const attached = ownKeys.filter((key) => typeof key === "string" && !standardKeys.has(key));
+        if (attached.length > 0) {
+            throw new TypeError(`valueHash does not support attached function state: ${attached.join(", ")}`);
+        }
+        if (Object.hasOwn(value, "prototype")) {
+            const prototype = value.prototype;
+            if (!prototype ||
+                typeof prototype !== "object" ||
+                Reflect.ownKeys(prototype).some((key) => key !== "constructor") ||
+                Object.getOwnPropertyDescriptor(prototype, "constructor")?.value !== value) {
+                throw new TypeError("valueHash does not support modified function prototypes");
+            }
+        }
+        const source = Function.prototype.toString.call(value);
+        if (source.includes("[native code]")) {
+            throw new TypeError("valueHash does not support native or bound functions");
+        }
+        // JavaScript exposes source text but not captured closure values. Evaluator
+        // state that affects behavior must therefore live in source or explicit config.
+        return ["function-source", source];
+    }
+    return canonicalizeObject(value, traversal);
+};
+/**
+ * Tagged structural encoding for ledger identity. Functions encode observable
+ * source text only; JavaScript provides no access to captured closure values.
+ */
+export const stableJson = (value) => JSON.stringify(["lux-value", 2, canonicalize(value, { active: new Map(), nextId: 0 })]);
+export const contentHash = (value) => createHash("sha256").update(value).digest("hex");
+export const valueHash = (value) => contentHash(stableJson(value));
+//# sourceMappingURL=hash.js.map

package/lib/core/hash.js.map

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

package/lib/core/index.d.ts

@@ -0,0 +1,29 @@
+export * from "./annotation.js";
+export * from "./answerer.js";
+export * from "./artifact-evidence.js";
+export * from "./artifact-snapshot.js";
+export * from "./assertion.js";
+export * from "./case.js";
+export * from "./conversation-turn.js";
+export * from "./driver.js";
+export * from "./emitter.js";
+export * from "./events.js";
+export * from "./exec.js";
+export * from "./experiment.js";
+export * from "./glob.js";
+export * from "./hash.js";
+export * from "./lifecycle-fixtures.js";
+export * from "./lifecycle-hooks.js";
+export * from "./mcp-events.js";
+export * from "./model-cli.js";
+export * from "./observer.js";
+export * from "./registry.js";
+export * from "./rubric.js";
+export * from "./run.js";
+export * from "./statistics.js";
+export * from "./subject.js";
+export * from "./tool-events.js";
+export * from "./usage.js";
+export * from "./wire.js";
+export * from "./zod.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/lib/core/index.js

@@ -0,0 +1,29 @@
+export * from "./annotation.js";
+export * from "./answerer.js";
+export * from "./artifact-evidence.js";
+export * from "./artifact-snapshot.js";
+export * from "./assertion.js";
+export * from "./case.js";
+export * from "./conversation-turn.js";
+export * from "./driver.js";
+export * from "./emitter.js";
+export * from "./events.js";
+export * from "./exec.js";
+export * from "./experiment.js";
+export * from "./glob.js";
+export * from "./hash.js";
+export * from "./lifecycle-fixtures.js";
+export * from "./lifecycle-hooks.js";
+export * from "./mcp-events.js";
+export * from "./model-cli.js";
+export * from "./observer.js";
+export * from "./registry.js";
+export * from "./rubric.js";
+export * from "./run.js";
+export * from "./statistics.js";
+export * from "./subject.js";
+export * from "./tool-events.js";
+export * from "./usage.js";
+export * from "./wire.js";
+export * from "./zod.js";
+//# sourceMappingURL=index.js.map

package/lib/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/lib/core/lifecycle-fixtures.d.ts

@@ -0,0 +1,20 @@
+import { type CaseLifecycleHookContext, type LifecycleHooksPlugin, type SuiteLifecycleHookContext } from "./lifecycle-hooks.js";
+export type LifecycleFixtureUse = () => PromiseLike<void>;
+export type LifecycleFixture<Context extends SuiteLifecycleHookContext> = (context: Context, use: LifecycleFixtureUse) => void | Promise<void>;
+export type LifecycleFixturesDefinition = {
+    name: string;
+    pluginVersion: string;
+    /**
+     * Public, non-secret values captured by the fixture callbacks and relevant
+     * to execution identity.
+     */
+    identity?: unknown;
+    suite?: LifecycleFixture<SuiteLifecycleHookContext>;
+    case?: LifecycleFixture<CaseLifecycleHookContext>;
+};
+/**
+ * Define suite and case lifetimes with Vitest-style `await use()` fixtures.
+ * Setup belongs before `use`; teardown belongs after it.
+ */
+export declare const defineFixtures: (definition: LifecycleFixturesDefinition) => LifecycleHooksPlugin;
+//# sourceMappingURL=lifecycle-fixtures.d.ts.map

package/lib/core/lifecycle-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-fixtures.d.ts","sourceRoot":"","sources":["../../src/core/lifecycle-fixtures.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC/B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,mBAAmB,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;AAE1D,MAAM,MAAM,gBAAgB,CAAC,OAAO,SAAS,yBAAyB,IAAI,CACxE,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,mBAAmB,KACrB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,gBAAgB,CAAC,yBAAyB,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;CACnD,CAAC;AAgFF;;;GAGG;AACH,eAAO,MAAM,cAAc,eAAgB,2BAA2B,KAAG,oBAkCxE,CAAC"}

package/lib/core/lifecycle-fixtures.js

@@ -0,0 +1,109 @@
+import { valueHash } from "./hash.js";
+import { defineLifecycleHooks, } from "./lifecycle-hooks.js";
+const errorMessage = (error) => error instanceof Error ? error.message : String(error);
+const activateFixture = async (fixture, context, label) => {
+    let releaseUse;
+    const useLifetime = new Promise((resolve) => {
+        releaseUse = resolve;
+    });
+    let acceptSetup;
+    let rejectSetup;
+    const setup = new Promise((resolve, reject) => {
+        acceptSetup = resolve;
+        rejectSetup = reject;
+    });
+    let useCalls = 0;
+    let useObservations = 0;
+    let settled = false;
+    let completionError;
+    const completion = (async () => {
+        try {
+            await fixture(context, () => {
+                useCalls += 1;
+                if (useCalls > 1) {
+                    throw new TypeError(`${label} called use() more than once`);
+                }
+                return {
+                    // biome-ignore lint/suspicious/noThenProperty: a custom thenable lets us detect a discarded use() lifetime.
+                    then: (onfulfilled, onrejected) => {
+                        useObservations += 1;
+                        if (useObservations > 1) {
+                            return Promise.reject(new TypeError(`${label} awaited one use() more than once`)).then(onfulfilled, onrejected);
+                        }
+                        acceptSetup?.();
+                        return useLifetime.then(onfulfilled, onrejected);
+                    },
+                };
+            });
+            if (useCalls === 0) {
+                throw new TypeError(`${label} must call and await use() exactly once`);
+            }
+            if (useObservations === 0) {
+                throw new TypeError(`${label} must await use()`);
+            }
+        }
+        catch (error) {
+            completionError = error;
+            if (useObservations === 0)
+                rejectSetup?.(error);
+        }
+        finally {
+            settled = true;
+        }
+    })();
+    await setup;
+    await Promise.resolve();
+    if (settled) {
+        throw new TypeError(completionError
+            ? `${label} failed before its lifetime began: ${errorMessage(completionError)}`
+            : `${label} must await use()`, { cause: completionError });
+    }
+    let cleaned = false;
+    return async () => {
+        if (cleaned)
+            return;
+        cleaned = true;
+        releaseUse?.();
+        await completion;
+        if (completionError)
+            throw completionError;
+    };
+};
+/**
+ * Define suite and case lifetimes with Vitest-style `await use()` fixtures.
+ * Setup belongs before `use`; teardown belongs after it.
+ */
+export const defineFixtures = (definition) => {
+    if (!definition.suite && !definition.case) {
+        throw new TypeError("fixtures plugin must define suite or case");
+    }
+    if (definition.suite !== undefined && typeof definition.suite !== "function") {
+        throw new TypeError("fixtures plugin suite must be a function");
+    }
+    if (definition.case !== undefined && typeof definition.case !== "function") {
+        throw new TypeError("fixtures plugin case must be a function");
+    }
+    const suiteFixture = definition.suite;
+    const caseFixture = definition.case;
+    return defineLifecycleHooks({
+        name: definition.name,
+        pluginVersion: definition.pluginVersion,
+        ...(definition.identity === undefined ? {} : { identity: definition.identity }),
+        implementationHash: valueHash({
+            identity: definition.identity,
+            suite: definition.suite,
+            case: definition.case,
+        }),
+        ...(suiteFixture
+            ? {
+                setupSuite: (context) => activateFixture(suiteFixture, context, `suite fixture '${definition.name}'`),
+            }
+            : {}),
+        ...(caseFixture
+            ? {
+                setupCase: (context) => activateFixture(caseFixture, context, `case fixture '${definition.name}'`),
+            }
+            : {}),
+    });
+};
+//# sourceMappingURL=lifecycle-fixtures.js.map

package/lib/core/lifecycle-fixtures.js.map

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

package/lib/core/lifecycle-hooks.d.ts

@@ -0,0 +1,52 @@
+export type LifecycleHookCleanup = () => void | Promise<void>;
+export type LifecycleHookSetupResult = LifecycleHookCleanup | undefined;
+export type SuiteLifecycleHookItem = {
+    id: string;
+    caseId: string;
+    path: string;
+};
+export type SuiteLifecycleHookContext = {
+    suiteId: string;
+    suiteDir: string;
+    runsRoot: string;
+    concurrency: number;
+    items: readonly SuiteLifecycleHookItem[];
+    abortSignal?: AbortSignal;
+};
+export type CaseLifecycleHookContext = SuiteLifecycleHookContext & {
+    index: number;
+    item: SuiteLifecycleHookItem;
+};
+export type LifecycleHooksPlugin = {
+    name: string;
+    /** Author-maintained identity for setup and teardown behavior. */
+    pluginVersion: string;
+    /**
+     * Public, non-secret values captured by hook closures and relevant to
+     * execution identity. Included in the implementation hash.
+     */
+    identity?: unknown;
+    /**
+     * Hash of the authored callbacks when an adapter wraps them in closures.
+     * `defineLifecycleHooks` and `defineFixtures` populate this automatically.
+     */
+    implementationHash?: string;
+    /**
+     * Prepare resources shared by the selected suite. A returned cleanup runs
+     * exactly once after all cases settle, including abort and failure paths.
+     */
+    setupSuite?(context: SuiteLifecycleHookContext): LifecycleHookSetupResult | Promise<LifecycleHookSetupResult>;
+    /**
+     * Prepare resources private to one case attempt. A returned cleanup runs
+     * exactly once after that attempt settles. Concurrent cases may invoke this
+     * hook concurrently.
+     */
+    setupCase?(context: CaseLifecycleHookContext): LifecycleHookSetupResult | Promise<LifecycleHookSetupResult>;
+};
+export declare const lifecycleHooksPluginIssue: (definition: Partial<LifecycleHooksPlugin>) => string | undefined;
+/**
+ * Define versioned suite/case resource hooks for registration in
+ * the `lifecycleFixtures` list in `lux.config.ts`.
+ */
+export declare const defineLifecycleHooks: (definition: LifecycleHooksPlugin) => LifecycleHooksPlugin;
+//# sourceMappingURL=lifecycle-hooks.d.ts.map

package/lib/core/lifecycle-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-hooks.d.ts","sourceRoot":"","sources":["../../src/core/lifecycle-hooks.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9D,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,GAAG,SAAS,CAAC;AAExE,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACzC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,yBAAyB,GAAG;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,sBAAsB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,UAAU,CAAC,CACT,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAChE;;;;OAIG;IACH,SAAS,CAAC,CACR,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACjE,CAAC;AAEF,eAAO,MAAM,yBAAyB,eACxB,OAAO,CAAC,oBAAoB,CAAC,KACxC,MAAM,GAAG,SAuBX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,eAAgB,oBAAoB,KAAG,oBAavE,CAAC"}

package/lib/core/lifecycle-hooks.js

@@ -0,0 +1,42 @@
+import { valueHash } from "./hash.js";
+export const lifecycleHooksPluginIssue = (definition) => {
+    if (typeof definition.name !== "string" || !definition.name.trim()) {
+        return "lifecycle hooks plugin name must not be empty";
+    }
+    if (typeof definition.pluginVersion !== "string" || !definition.pluginVersion.trim()) {
+        return "lifecycle hooks plugin pluginVersion must not be empty";
+    }
+    if (definition.implementationHash !== undefined &&
+        !/^[0-9a-f]{64}$/.test(definition.implementationHash)) {
+        return "lifecycle hooks plugin implementationHash must be a SHA-256 hex digest";
+    }
+    if (definition.setupSuite !== undefined && typeof definition.setupSuite !== "function") {
+        return "lifecycle hooks plugin setupSuite must be a function";
+    }
+    if (definition.setupCase !== undefined && typeof definition.setupCase !== "function") {
+        return "lifecycle hooks plugin setupCase must be a function";
+    }
+    if (!definition.setupSuite && !definition.setupCase) {
+        return "lifecycle hooks plugin must define setupSuite or setupCase";
+    }
+    return undefined;
+};
+/**
+ * Define versioned suite/case resource hooks for registration in
+ * the `lifecycleFixtures` list in `lux.config.ts`.
+ */
+export const defineLifecycleHooks = (definition) => {
+    const issue = lifecycleHooksPluginIssue(definition);
+    if (issue)
+        throw new TypeError(issue);
+    return {
+        ...definition,
+        implementationHash: definition.implementationHash ??
+            valueHash({
+                identity: definition.identity,
+                setupSuite: definition.setupSuite,
+                setupCase: definition.setupCase,
+            }),
+    };
+};
+//# sourceMappingURL=lifecycle-hooks.js.map

package/lib/core/lifecycle-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-hooks.js","sourceRoot":"","sources":["../../src/core/lifecycle-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAwDtC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,UAAyC,EACrB,EAAE;IACtB,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACnE,OAAO,+CAA+C,CAAC;IACzD,CAAC;IACD,IAAI,OAAO,UAAU,CAAC,aAAa,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;QACrF,OAAO,wDAAwD,CAAC;IAClE,CAAC;IACD,IACE,UAAU,CAAC,kBAAkB,KAAK,SAAS;QAC3C,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EACrD,CAAC;QACD,OAAO,wEAAwE,CAAC;IAClF,CAAC;IACD,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,UAAU,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QACvF,OAAO,sDAAsD,CAAC;IAChE,CAAC;IACD,IAAI,UAAU,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,UAAU,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACrF,OAAO,qDAAqD,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;QACpD,OAAO,4DAA4D,CAAC;IACtE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAgC,EAAwB,EAAE;IAC7F,MAAM,KAAK,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,KAAK;QAAE,MAAM,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO;QACL,GAAG,UAAU;QACb,kBAAkB,EAChB,UAAU,CAAC,kBAAkB;YAC7B,SAAS,CAAC;gBACR,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,UAAU,EAAE,UAAU,CAAC,UAAU;gBACjC,SAAS,EAAE,UAAU,CAAC,SAAS;aAChC,CAAC;KACL,CAAC;AACJ,CAAC,CAAC"}

package/lib/core/mcp-events.d.ts

@@ -0,0 +1,44 @@
+import type { RunEvent } from "./events.js";
+/**
+ * MCP-specific `progress` event kinds. Generic tool calls and results live in
+ * `tool-events`; MCP discovery metadata rides the same open progress stream.
+ */
+export declare const MCP_INIT_KIND: "mcp-init";
+export declare const MCP_TOOLS_LIST_KIND: "mcp-tools-list";
+/** A tool as reported by `tools/list`. */
+export type ListedTool = {
+    name: string;
+    title?: string;
+    description?: string;
+    inputSchema?: unknown;
+    outputSchema?: unknown;
+    annotations?: Record<string, unknown>;
+    execution?: Record<string, unknown>;
+    icons?: unknown[];
+    _meta?: Record<string, unknown>;
+};
+/** `initialize` result metadata, captured once when the server connects. */
+export type McpInitPayload = {
+    serverInfo?: {
+        name?: string;
+        version?: string;
+    };
+    capabilities?: Record<string, unknown>;
+    instructions?: string;
+};
+export type McpToolsListPayload = {
+    tools: ListedTool[];
+};
+type ProgressEvent = Extract<RunEvent, {
+    type: "progress";
+}>;
+export declare const isMcpInitEvent: (e: RunEvent) => e is ProgressEvent;
+export declare const isMcpToolsListEvent: (e: RunEvent) => e is ProgressEvent;
+/** The `initialize` metadata (the last `mcp-init` event wins), or undefined. */
+export declare const mcpInit: (events: RunEvent[]) => McpInitPayload | undefined;
+/** Tools from the last `tools/list` capture in the run. */
+export declare const listedTools: (events: RunEvent[]) => ListedTool[];
+export declare const hasMcpInit: (events: RunEvent[]) => boolean;
+export declare const hasMcpToolsList: (events: RunEvent[]) => boolean;
+export {};
+//# sourceMappingURL=mcp-events.d.ts.map

package/lib/core/mcp-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-events.d.ts","sourceRoot":"","sources":["../../src/core/mcp-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAG,UAAmB,CAAC;AACjD,eAAO,MAAM,mBAAmB,EAAG,gBAAyB,CAAC;AAE7D,0CAA0C;AAC1C,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAE1D,KAAK,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAK7D,eAAO,MAAM,cAAc,MAAO,QAAQ,KAAG,CAAC,IAAI,aAAiD,CAAC;AAEpG,eAAO,MAAM,mBAAmB,MAAO,QAAQ,KAAG,CAAC,IAAI,aACf,CAAC;AAEzC,gFAAgF;AAChF,eAAO,MAAM,OAAO,WAAY,QAAQ,EAAE,KAAG,cAAc,GAAG,SAG7D,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,WAAW,WAAY,QAAQ,EAAE,KAAG,UAAU,EAI1D,CAAC;AAEF,eAAO,MAAM,UAAU,WAAY,QAAQ,EAAE,KAAG,OAAsC,CAAC;AAEvF,eAAO,MAAM,eAAe,WAAY,QAAQ,EAAE,KAAG,OAA2C,CAAC"}

package/lib/core/mcp-events.js

@@ -0,0 +1,23 @@
+/**
+ * MCP-specific `progress` event kinds. Generic tool calls and results live in
+ * `tool-events`; MCP discovery metadata rides the same open progress stream.
+ */
+export const MCP_INIT_KIND = "mcp-init";
+export const MCP_TOOLS_LIST_KIND = "mcp-tools-list";
+const isProgressKind = (e, kind) => e.type === "progress" && e.kind === kind;
+export const isMcpInitEvent = (e) => isProgressKind(e, MCP_INIT_KIND);
+export const isMcpToolsListEvent = (e) => isProgressKind(e, MCP_TOOLS_LIST_KIND);
+/** The `initialize` metadata (the last `mcp-init` event wins), or undefined. */
+export const mcpInit = (events) => {
+    const hit = events.filter(isMcpInitEvent).at(-1);
+    return hit ? hit.payload : undefined;
+};
+/** Tools from the last `tools/list` capture in the run. */
+export const listedTools = (events) => {
+    const hit = events.filter(isMcpToolsListEvent).at(-1);
+    const payload = hit?.payload;
+    return Array.isArray(payload?.tools) ? payload.tools : [];
+};
+export const hasMcpInit = (events) => events.some(isMcpInitEvent);
+export const hasMcpToolsList = (events) => events.some(isMcpToolsListEvent);
+//# sourceMappingURL=mcp-events.js.map

package/lib/core/mcp-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-events.js","sourceRoot":"","sources":["../../src/core/mcp-events.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,UAAmB,CAAC;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAyB,CAAC;AA0B7D,MAAM,cAAc,GAAG,CAAC,CAAW,EAAE,IAAY,EAAsB,EAAE,CACvE,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAW,EAAsB,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;AAEpG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAW,EAAsB,EAAE,CACrE,cAAc,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAEzC,gFAAgF;AAChF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAkB,EAA8B,EAAE;IACxE,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,OAA0B,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC,CAAC;AAEF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAgB,EAAE;IAC9D,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,GAAG,EAAE,OAA0C,CAAC;IAChE,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAkB,EAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAEvF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAkB,EAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC"}