@kraken-e2e/core 0.1.0

package/dist/scheduler.js

@@ -0,0 +1,190 @@
+import { KrakenError, serializeError } from '@kraken-e2e/contracts';
+/**
+ * Named background tasks (the detach/join escape hatch — ADR-0001 §5.9).
+ * An unjoined handle at scenario end fails the scenario (leak detection).
+ */
+export class TaskRegistry {
+    #tasks = new Map();
+    /**
+     * Check-then-start: the duplicate-handle check runs BEFORE the task body is
+     * invoked, so a rejected registration never leaves an untracked task running
+     * (and never produces an unhandled rejection).
+     */
+    register(handle, start, startedBy) {
+        if (this.#tasks.has(handle)) {
+            throw new KrakenError('KRK-PLAN-DUPLICATE-TASK', `A background task named "${handle}" is already running.`, { fix: 'Use a distinct handle per detached task within a scenario.' });
+        }
+        // Track the settlement so an early rejection never becomes an unhandled one.
+        const outcome = start().then(() => ({ ok: true }), (error) => ({ ok: false, error }));
+        this.#tasks.set(handle, { outcome, startedBy, joined: false });
+    }
+    async join(handle, timeoutMs) {
+        const entry = this.#tasks.get(handle);
+        if (!entry) {
+            throw new KrakenError('KRK-PLAN-UNKNOWN-TASK', `No background task named "${handle}" was started.`, { fix: 'Start it with a detached step before joining it.' });
+        }
+        entry.joined = true;
+        let timer;
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(() => resolve('timeout'), timeoutMs);
+        });
+        const result = await Promise.race([entry.outcome, timeout]);
+        clearTimeout(timer);
+        if (result === 'timeout') {
+            throw new KrakenError('KRK-PLAN-TASK-JOIN-TIMEOUT', `Background task "${handle}" (started by ${entry.startedBy}) did not complete within ${timeoutMs}ms.`);
+        }
+        if (!result.ok) {
+            throw KrakenError.wrap(result.error, 'KRK-STEP-FAILED', `Background task "${handle}" failed`);
+        }
+    }
+    unjoined() {
+        return [...this.#tasks.entries()]
+            .filter(([, entry]) => !entry.joined)
+            .map(([handle, entry]) => ({ handle, startedBy: entry.startedBy }));
+    }
+    /**
+     * Settle everything (ignoring outcomes) so nothing dangles past the
+     * scenario — with a budget: a detached task that ignores the AbortSignal
+     * must never hang the run forever. Returns the handles still pending after
+     * the budget so the caller can fail the scenario explicitly.
+     */
+    async drain(timeoutMs) {
+        const entries = [...this.#tasks.entries()];
+        const settled = new Set();
+        await Promise.race([
+            Promise.all(entries.map(async ([handle, entry]) => {
+                await entry.outcome;
+                settled.add(handle);
+            })),
+            new Promise((resolve) => setTimeout(resolve, timeoutMs)),
+        ]);
+        return entries.map(([handle]) => handle).filter((handle) => !settled.has(handle));
+    }
+}
+/**
+ * Executes a ScenarioPlan (ADR-0002 D7). The default shape is a chain, so
+ * execution is sequential in text order; `detach` nodes spawn tracked tasks;
+ * `join` nodes await them. Failure policy is failFast: the first failure
+ * aborts in-flight sibling work via the shared AbortSignal.
+ */
+export async function executePlan(plan, deps) {
+    const world = {};
+    const tasks = new TaskRegistry();
+    const { events, abortController } = deps;
+    const contextFor = (actorId) => {
+        const actor = deps.actors.get(actorId);
+        if (!actor) {
+            throw new KrakenError('KRK-STEP-UNKNOWN-ACTOR', `Plan node references actor "${actorId}" but no session was booted for it.`);
+        }
+        return { actor, world, tasks, abort: abortController.signal, actors: deps.actors };
+    };
+    let failure;
+    for (const node of plan.nodes) {
+        if (failure)
+            break;
+        const startedAt = Date.now();
+        events.emit({
+            type: 'stepStarted',
+            scenarioId: plan.scenarioId,
+            stepId: node.id,
+            actorId: node.actorId,
+            text: node.title,
+        });
+        try {
+            if (node.kind === 'detach') {
+                const handle = node.taskHandle;
+                if (!handle) {
+                    throw new KrakenError('KRK-PLAN-UNKNOWN-TASK', `Detach node "${node.id}" has no task handle.`);
+                }
+                // Spawn without awaiting; the step itself passes once the task starts.
+                tasks.register(handle, () => node.run(contextFor(node.actorId)), node.title);
+            }
+            else if (node.kind === 'join') {
+                const handle = node.taskHandle;
+                if (!handle) {
+                    throw new KrakenError('KRK-PLAN-UNKNOWN-TASK', `Join node "${node.id}" has no task handle.`);
+                }
+                if (node.joinTimeoutMs === undefined) {
+                    // Explicit-duration policy (ADR-0003 D4 / ADR-0004 D6): no silent default.
+                    throw new KrakenError('KRK-PLAN-UNKNOWN-TASK', `Join node "${node.id}" has no joinTimeoutMs.`);
+                }
+                await tasks.join(handle, node.joinTimeoutMs);
+            }
+            else {
+                await node.run(contextFor(node.actorId));
+            }
+            events.emit({
+                type: 'stepFinished',
+                scenarioId: plan.scenarioId,
+                stepId: node.id,
+                actorId: node.actorId,
+                text: node.title,
+                status: 'passed',
+                durationMs: Date.now() - startedAt,
+            });
+        }
+        catch (error) {
+            failure = { error, nodeId: node.id };
+            abortController.abort();
+            events.emit({
+                type: 'stepFinished',
+                scenarioId: plan.scenarioId,
+                stepId: node.id,
+                actorId: node.actorId,
+                text: node.title,
+                status: 'failed',
+                durationMs: Date.now() - startedAt,
+                error: serializeError(error),
+            });
+        }
+    }
+    // Skipped steps after a failure are reported so the timeline stays complete.
+    if (failure) {
+        const failedIndex = plan.nodes.findIndex((node) => node.id === failure?.nodeId);
+        for (const node of plan.nodes.slice(failedIndex + 1)) {
+            events.emit({
+                type: 'stepStarted',
+                scenarioId: plan.scenarioId,
+                stepId: node.id,
+                actorId: node.actorId,
+                text: node.title,
+            });
+            events.emit({
+                type: 'stepFinished',
+                scenarioId: plan.scenarioId,
+                stepId: node.id,
+                actorId: node.actorId,
+                text: node.title,
+                status: 'skipped',
+                durationMs: 0,
+            });
+        }
+    }
+    const unsettled = await tasks.drain(deps.drainTimeoutMs ?? 5_000);
+    if (!failure && unsettled.length > 0) {
+        failure = {
+            error: new KrakenError('KRK-PLAN-UNJOINED-TASK', `Background task(s) did not settle after the scenario ended (abort ignored?): ${unsettled.join(', ')}.`, { fix: 'Detached task bodies must honor ctx.abort (AbortSignal).' }),
+            nodeId: 'scenario-end',
+        };
+        abortController.abort();
+    }
+    if (!failure) {
+        const leaked = tasks.unjoined();
+        if (leaked.length > 0) {
+            const description = leaked
+                .map((leak) => `"${leak.handle}" (started by ${leak.startedBy})`)
+                .join(', ');
+            failure = {
+                error: new KrakenError('KRK-PLAN-UNJOINED-TASK', `Scenario ended with unjoined background task(s): ${description}.`, {
+                    fix: 'Join every detached task with a "…background task {handle} completes within…" step.',
+                }),
+                nodeId: 'scenario-end',
+            };
+            abortController.abort();
+        }
+    }
+    return failure
+        ? { status: 'failed', error: failure.error, failedNodeId: failure.nodeId }
+        : { status: 'passed' };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

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

package/dist/testing/fake-driver.d.ts

@@ -0,0 +1,54 @@
+import { type CoreOperation, type KrakenDriver, type SemanticKey, type TargetLocator } from '@kraken-e2e/contracts';
+export interface FakeElement {
+    text: string;
+    visible: boolean;
+}
+export interface FakeAction {
+    readonly actorId: string;
+    readonly op: 'tap' | 'typeText' | 'pressKey' | 'navigate' | 'scrollIntoView';
+    readonly target?: TargetLocator;
+    readonly text?: string;
+    readonly key?: SemanticKey;
+    readonly destination?: string;
+}
+/**
+ * The shared "app backend": per-actor screens plus latency-simulated effects.
+ * Wire app behavior with onAction — e.g. when alice taps "send", set bob's
+ * message cell after 120ms.
+ */
+export declare class FakeAppWorld {
+    #private;
+    readonly actions: FakeAction[];
+    /** App behavior hook — the "backend logic" of the fake app. */
+    onAction: ((action: FakeAction, world: FakeAppWorld) => void) | undefined;
+    screen(actorId: string): Map<string, FakeElement>;
+    setElement(actorId: string, testId: string, element: FakeElement): this;
+    getElement(actorId: string, testId: string): FakeElement | undefined;
+    /** Simulates app latency: apply an effect after `ms` (e.g. message delivery). */
+    after(ms: number, effect: () => void): void;
+    get pendingEffects(): number;
+    record(action: FakeAction): void;
+}
+export interface FakeDriverOptions {
+    readonly world: FakeAppWorld;
+    /** Driver id (default 'fake'). */
+    readonly id?: string;
+    /** Platforms this fake provides (default ['fake']). */
+    readonly platforms?: readonly string[];
+    /** Simulate a host-gated driver (the C4b test uses a darwin-only fake). */
+    readonly hostRequirements?: {
+        readonly platforms?: readonly string[];
+    };
+    /** Ops to declare unsupported (they throw KRK-SESSION-OP-UNSUPPORTED). */
+    readonly unsupported?: readonly CoreOperation[];
+    /** Make specific ops fail (orchestrator failure-path tests). */
+    readonly failOn?: {
+        readonly op: CoreOperation;
+        readonly actorId?: string;
+    };
+    /** Per-op artificial latency in ms. */
+    readonly opLatencyMs?: number;
+}
+/** Build a fake driver bound to a shared world. Dogfoods defineDriver(). */
+export declare function createFakeDriver(options: FakeDriverOptions): KrakenDriver<FakeDriverOptions>;
+//# sourceMappingURL=fake-driver.d.ts.map

package/dist/testing/fake-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-driver.d.ts","sourceRoot":"","sources":["../../src/testing/fake-driver.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,aAAa,EAGlB,KAAK,YAAY,EAGjB,KAAK,WAAW,EAEhB,KAAK,aAAa,EAGnB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,KAAK,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,gBAAgB,CAAC;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,qBAAa,YAAY;;IAEvB,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,CAAM;IAEpC,+DAA+D;IAC/D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAE1E,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC;IASjD,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAKvE,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIpE,iFAAiF;IACjF,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI;IAW3C,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;CAIjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IACvE,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAChD,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,uCAAuC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAsKD,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAmB5F"}

package/dist/testing/fake-driver.js

@@ -0,0 +1,209 @@
+/**
+ * FakeDriver (ADR-0002 D9): a first-class in-memory driver implementing the
+ * full contract, NOT test scaffolding. Per-actor screens plus a SHARED
+ * FakeAppWorld let one actor's action change another actor's screen after a
+ * configurable latency — so the whole engine (orchestrator, scheduler,
+ * signaling, reporting) exercises real cross-actor E2E with zero devices.
+ */
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { CORE_OPERATIONS, defineDriver, KrakenError, } from '@kraken-e2e/contracts';
+/**
+ * The shared "app backend": per-actor screens plus latency-simulated effects.
+ * Wire app behavior with onAction — e.g. when alice taps "send", set bob's
+ * message cell after 120ms.
+ */
+export class FakeAppWorld {
+    #screens = new Map();
+    actions = [];
+    #pendingEffects = 0;
+    /** App behavior hook — the "backend logic" of the fake app. */
+    onAction;
+    screen(actorId) {
+        let screen = this.#screens.get(actorId);
+        if (!screen) {
+            screen = new Map();
+            this.#screens.set(actorId, screen);
+        }
+        return screen;
+    }
+    setElement(actorId, testId, element) {
+        this.screen(actorId).set(testId, { ...element });
+        return this;
+    }
+    getElement(actorId, testId) {
+        return this.screen(actorId).get(testId);
+    }
+    /** Simulates app latency: apply an effect after `ms` (e.g. message delivery). */
+    after(ms, effect) {
+        this.#pendingEffects += 1;
+        setTimeout(() => {
+            try {
+                effect();
+            }
+            finally {
+                this.#pendingEffects -= 1;
+            }
+        }, ms);
+    }
+    get pendingEffects() {
+        return this.#pendingEffects;
+    }
+    record(action) {
+        this.actions.push(action);
+        this.onAction?.(action, this);
+    }
+}
+class FakeSession {
+    world;
+    options;
+    services;
+    actorId;
+    driverId;
+    platform;
+    capabilities;
+    #disposed = false;
+    #screenshotCount = 0;
+    constructor(world, options, actor, services) {
+        this.world = world;
+        this.options = options;
+        this.services = services;
+        this.actorId = actor.id;
+        this.driverId = options.id ?? 'fake';
+        this.platform = actor.platform;
+        const unsupported = new Set(options.unsupported ?? []);
+        this.capabilities = Object.fromEntries(CORE_OPERATIONS.map((op) => [op, unsupported.has(op) ? 'unsupported' : 'supported']));
+    }
+    async #guard(op) {
+        if (this.capabilities[op] === 'unsupported') {
+            throw new KrakenError('KRK-SESSION-OP-UNSUPPORTED', `Operation "${op}" is not supported by ${this.driverId} (declared in capabilities).`);
+        }
+        if (this.options.failOn?.op === op) {
+            const { actorId } = this.options.failOn;
+            if (actorId === undefined || actorId === this.actorId) {
+                throw new KrakenError('KRK-STEP-FAILED', `Injected failure on ${op} for ${this.actorId}.`);
+            }
+        }
+        const latency = this.options.opLatencyMs ?? 0;
+        if (latency > 0)
+            await new Promise((resolve) => setTimeout(resolve, latency));
+    }
+    #find(target) {
+        const element = this.#lookup(target);
+        if (!element) {
+            throw new KrakenError('KRK-SESSION-ELEMENT-NOT-FOUND', `Actor "${this.actorId}" has no element matching ${target.by}="${target.value}".`, { data: { target: { ...target } } });
+        }
+        return element;
+    }
+    #lookup(target) {
+        const screen = this.world.screen(this.actorId);
+        if (target.by === 'testId' || target.by === 'a11y' || target.by === 'native') {
+            return screen.get(target.value);
+        }
+        // by text: first element whose text matches
+        for (const element of screen.values()) {
+            const matches = target.exact
+                ? element.text === target.value
+                : element.text.includes(target.value);
+            if (matches)
+                return element;
+        }
+        return undefined;
+    }
+    async tap(target) {
+        await this.#guard('tap');
+        this.#find(target);
+        this.world.record({ actorId: this.actorId, op: 'tap', target });
+    }
+    async typeText(target, text) {
+        await this.#guard('typeText');
+        const element = this.#find(target);
+        element.text = text;
+        this.world.record({ actorId: this.actorId, op: 'typeText', target, text });
+    }
+    async readText(target) {
+        await this.#guard('readText');
+        return this.#find(target).text;
+    }
+    async waitFor(target, state, opts) {
+        await this.#guard('waitFor');
+        const timeoutMs = opts?.timeoutMs ?? 1_000;
+        const pollMs = opts?.pollMs ?? 15;
+        const startedAt = Date.now();
+        for (;;) {
+            const element = this.#lookup(target);
+            const satisfied = state === 'visible'
+                ? element?.visible === true
+                : state === 'hidden'
+                    ? element === undefined || element.visible === false
+                    : element !== undefined; // 'attached'
+            if (satisfied)
+                return;
+            if (Date.now() - startedAt >= timeoutMs) {
+                throw new KrakenError('KRK-SESSION-WAIT-TIMEOUT', `Actor "${this.actorId}" waited ${timeoutMs}ms for ${target.by}="${target.value}" to be ${state}.`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, pollMs));
+        }
+    }
+    async isDisplayed(target) {
+        await this.#guard('isDisplayed');
+        return this.#lookup(target)?.visible === true;
+    }
+    async scrollIntoView(target) {
+        await this.#guard('scrollIntoView');
+        this.#find(target);
+        this.world.record({ actorId: this.actorId, op: 'scrollIntoView', target });
+    }
+    async pressKey(key) {
+        await this.#guard('pressKey');
+        this.world.record({ actorId: this.actorId, op: 'pressKey', key });
+    }
+    async navigate(destination) {
+        await this.#guard('navigate');
+        this.world.record({ actorId: this.actorId, op: 'navigate', destination });
+    }
+    async screenshot() {
+        await this.#guard('screenshot');
+        this.#screenshotCount += 1;
+        const path = join(this.services.artifactsDir, `${this.actorId}-screen-${this.#screenshotCount}.txt`);
+        writeFileSync(path, await this.source());
+        return { kind: 'screenshot', path };
+    }
+    async source() {
+        await this.#guard('source');
+        const screen = this.world.screen(this.actorId);
+        return JSON.stringify(Object.fromEntries(screen.entries()), null, 2);
+    }
+    async dispose() {
+        // Idempotent by contract.
+        this.#disposed = true;
+    }
+    get disposed() {
+        return this.#disposed;
+    }
+    native(kind) {
+        throw new KrakenError('KRK-SESSION-OP-UNSUPPORTED', `FakeDriver has no native session (requested "${String(kind)}").`);
+    }
+}
+/** Build a fake driver bound to a shared world. Dogfoods defineDriver(). */
+export function createFakeDriver(options) {
+    const factory = defineDriver((opts) => ({
+        manifest: {
+            id: opts.id ?? 'fake',
+            platforms: [...(opts.platforms ?? ['fake'])],
+            version: '0.0.0',
+            platformLabel: `Fake (${opts.id ?? 'fake'}, in-memory)`,
+            ...(opts.hostRequirements !== undefined
+                ? {
+                    hostRequirements: { platforms: opts.hostRequirements.platforms ?? [] },
+                    disabledFix: 'This fake driver is host-gated for testing purposes.',
+                }
+                : {}),
+        },
+        start: async () => { },
+        createSession: async (actor, services) => new FakeSession(opts.world, opts, actor, services),
+        stop: async () => { },
+    }));
+    return factory(options);
+}
+//# sourceMappingURL=fake-driver.js.map

package/dist/testing/fake-driver.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,2 @@
+export { createFakeDriver, type FakeAction, FakeAppWorld, type FakeDriverOptions, type FakeElement, } from './fake-driver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,EACf,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,2 @@
+export { createFakeDriver, FakeAppWorld, } from './fake-driver.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAEhB,YAAY,GAGb,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@kraken-e2e/core",
+  "version": "0.1.0",
+  "description": "Orchestrator: session manager, DAG step scheduler, plugin registry, host detection, event bus; exports the driver Conformance Test Kit at @kraken-e2e/core/ctk",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./ctk": {
+      "types": "./dist/ctk.d.ts",
+      "default": "./dist/ctk.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "dependencies": {
+    "zod": "^4.0.0",
+    "@kraken-e2e/contracts": "0.1.0",
+    "@kraken-e2e/signaling": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.9"
+  },
+  "peerDependencies": {
+    "vitest": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  },
+  "license": "GPL-3.0-only",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}