@kraken-e2e/core 0.1.0

package/dist/runner.js

@@ -0,0 +1,363 @@
+import { randomUUID } from 'node:crypto';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { KrakenError, serializeError } from '@kraken-e2e/contracts';
+import { SignalTimeoutError, } from '@kraken-e2e/signaling';
+import { EventBus } from './event-bus.js';
+import { createLogger, silentLogger } from './logger.js';
+import { executePlan } from './scheduler.js';
+/**
+ * Wraps an ActorSignals handle so every publish/wait surfaces in the event
+ * stream (signalSent / signalWaitStarted / signalReceived / signalTimedOut —
+ * the live UI's signature moments, ADR-0001 §5.11/§5.12), and so scenario
+ * aborts cancel pending waits by default.
+ */
+class InstrumentedActorSignals {
+    inner;
+    events;
+    scenarioId;
+    abort;
+    constructor(inner, events, scenarioId, abort) {
+        this.inner = inner;
+        this.events = events;
+        this.scenarioId = scenarioId;
+        this.abort = abort;
+    }
+    get subscriberId() {
+        return this.inner.subscriberId;
+    }
+    async publish(name, payload) {
+        const record = await this.inner.publish(name, payload);
+        this.events.emit({
+            type: 'signalSent',
+            scenarioId: this.scenarioId,
+            signal: name,
+            from: this.subscriberId,
+            recordSeq: record.seq,
+        });
+        return record;
+    }
+    async waitFor(name, opts) {
+        this.events.emit({
+            type: 'signalWaitStarted',
+            scenarioId: this.scenarioId,
+            signal: name,
+            actorId: this.subscriberId,
+            timeoutMs: opts.timeoutMs,
+        });
+        const startedAt = Date.now();
+        try {
+            const record = await this.inner.waitFor(name, {
+                ...opts,
+                signal: opts.signal ?? this.abort,
+            });
+            this.events.emit({
+                type: 'signalReceived',
+                scenarioId: this.scenarioId,
+                signal: name,
+                by: this.subscriberId,
+                from: record.from,
+                latencyMs: Date.now() - startedAt,
+            });
+            return record;
+        }
+        catch (error) {
+            if (error instanceof SignalTimeoutError) {
+                this.events.emit({
+                    type: 'signalTimedOut',
+                    scenarioId: this.scenarioId,
+                    signal: name,
+                    actorId: this.subscriberId,
+                    timeoutMs: opts.timeoutMs,
+                });
+            }
+            throw error;
+        }
+    }
+    async barrier(name, opts) {
+        await this.publish(`${name}:${this.subscriberId}`);
+        await Promise.all(opts.participants
+            .filter((participant) => participant !== this.subscriberId)
+            .map((participant) => this.waitFor(`${name}:${participant}`, {
+            timeoutMs: opts.timeoutMs,
+            ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        })));
+    }
+}
+function driverServices(deps, source, abort) {
+    const logger = deps.logSink ? createLogger(source, deps.logSink) : (deps.logger ?? silentLogger);
+    return {
+        runId: deps.events.runId,
+        logger,
+        artifactsDir: deps.artifactsDir,
+        abort,
+        emit: (emission) => {
+            if (emission.type === 'driverLog') {
+                deps.events.emit({
+                    type: 'driverLog',
+                    source,
+                    level: emission.level,
+                    message: emission.message,
+                });
+            }
+            else {
+                deps.events.emit({
+                    type: 'artifactCaptured',
+                    kind: emission.kind,
+                    path: emission.path,
+                    ...(emission.actorId !== undefined ? { actorId: emission.actorId } : {}),
+                });
+            }
+        },
+    };
+}
+const DISPOSE_TIMEOUT_MS = 15_000;
+async function withTimeout(work, ms) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve('timeout'), ms);
+    });
+    const outcome = await Promise.race([
+        work.then(() => 'ok', () => 'error'),
+        timeout,
+    ]);
+    clearTimeout(timer);
+    return outcome;
+}
+/**
+ * Runs one scenario end to end (ADR-0002 D7): boot all actor sessions
+ * (allSettled + rollback — never leak a booted device), open the signal scope,
+ * execute the plan, capture artifacts from ALL actors on failure, and tear
+ * everything down in finally with timeout guards.
+ */
+export class ScenarioRunner {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async run(plan) {
+        const { deps } = this;
+        const startedAt = Date.now();
+        const abortController = new AbortController();
+        // Resolve every actor's driver BEFORE any session boots: an iOS actor on a
+        // non-macOS host fails here, fast and explicit (C4b).
+        const bindings = plan.actors.map((actor) => ({
+            actor,
+            driver: deps.registry.driverFor(actor.platform),
+        }));
+        deps.events.emit({
+            type: 'scenarioStarted',
+            scenarioId: plan.scenarioId,
+            name: plan.name,
+            ...(plan.featureUri !== undefined ? { featureUri: plan.featureUri } : {}),
+            actors: bindings.map(({ actor, driver }) => ({
+                id: actor.id,
+                platform: actor.platform,
+                driverId: driver.manifest.id,
+            })),
+        });
+        const finish = (status, error) => {
+            deps.events.emit({
+                type: 'scenarioFinished',
+                scenarioId: plan.scenarioId,
+                status,
+                durationMs: Date.now() - startedAt,
+                ...(error !== undefined ? { error: serializeError(error) } : {}),
+            });
+            return {
+                scenarioId: plan.scenarioId,
+                name: plan.name,
+                status,
+                durationMs: Date.now() - startedAt,
+                ...(error !== undefined ? { error } : {}),
+            };
+        };
+        // ── Boot sessions: allSettled, roll back the booted ones on any failure ──
+        const settled = await Promise.allSettled(bindings.map(async ({ actor, driver }) => {
+            const services = driverServices(deps, `driver:${driver.manifest.id}/${actor.id}`, abortController.signal);
+            const session = await driver.createSession(actor, services);
+            return { actor, driver, session };
+        }));
+        const booted = settled.flatMap((result) => result.status === 'fulfilled' ? [result.value] : []);
+        const bootFailures = settled.flatMap((result) => result.status === 'rejected' ? [result.reason] : []);
+        if (bootFailures.length > 0) {
+            await Promise.all(booted.map((b) => withTimeout(b.session.dispose(), DISPOSE_TIMEOUT_MS)));
+            const cause = bootFailures[0];
+            return finish('failed', KrakenError.is(cause)
+                ? cause
+                : KrakenError.wrap(cause, 'KRK-SESSION-CREATE-FAILED', 'Actor session boot failed'));
+        }
+        for (const { actor, driver } of booted) {
+            deps.events.emit({
+                type: 'actorSessionStarted',
+                scenarioId: plan.scenarioId,
+                actorId: actor.id,
+                driverId: driver.manifest.id,
+                platformLabel: driver.manifest.platformLabel,
+            });
+        }
+        // ── Signal scope + actor runtimes ──
+        const scoped = deps.signalBus.scope({
+            runId: deps.events.runId,
+            scenarioId: plan.scenarioId,
+        });
+        await scoped.open();
+        const actors = new Map(booted.map(({ actor, session }) => [
+            actor.id,
+            {
+                id: actor.id,
+                platform: actor.platform,
+                session,
+                signals: new InstrumentedActorSignals(scoped.forActor(actor.id), deps.events, plan.scenarioId, abortController.signal),
+                log: deps.logSink
+                    ? createLogger(`actor:${actor.id}`, deps.logSink)
+                    : (deps.logger ?? silentLogger),
+            },
+        ]));
+        let result;
+        try {
+            const execution = await executePlan(plan, {
+                actors,
+                events: deps.events,
+                abortController,
+            });
+            if (execution.status === 'failed') {
+                await this.#captureFailureArtifacts(plan.scenarioId, actors);
+                result = finish('failed', execution.error);
+            }
+            else {
+                result = finish('passed');
+            }
+        }
+        finally {
+            // Sessions first: device teardown must never depend on transport health.
+            await Promise.all(booted.map(async ({ actor, session }) => {
+                const outcome = await withTimeout(session.dispose(), DISPOSE_TIMEOUT_MS);
+                deps.events.emit({
+                    type: 'actorSessionFinished',
+                    scenarioId: plan.scenarioId,
+                    actorId: actor.id,
+                    status: outcome === 'ok' ? 'ok' : 'failed',
+                });
+            }));
+            try {
+                await scoped.destroy();
+            }
+            catch {
+                // A failing transport must not mask the scenario result.
+            }
+        }
+        return result;
+    }
+    /** Best-effort screenshots from EVERY actor — the all-actors snapshot (ADR-0002 D7). */
+    async #captureFailureArtifacts(scenarioId, actors) {
+        await Promise.all([...actors.values()].map(async (actor) => {
+            try {
+                const artifact = await actor.session.screenshot();
+                this.deps.events.emit({
+                    type: 'artifactCaptured',
+                    kind: artifact.kind,
+                    path: artifact.path,
+                    scenarioId,
+                    actorId: actor.id,
+                });
+            }
+            catch {
+                // Artifact capture must never mask the real failure.
+            }
+            try {
+                // ADR-0002 D7: screenshot + SOURCE from every actor, best-effort.
+                const dump = await actor.session.source();
+                const path = join(this.deps.artifactsDir, `${scenarioId}-${actor.id}-source.txt`.replace(/[^\w.-]+/g, '_'));
+                writeFileSync(path, dump);
+                this.deps.events.emit({
+                    type: 'artifactCaptured',
+                    kind: 'source',
+                    path,
+                    scenarioId,
+                    actorId: actor.id,
+                });
+            }
+            catch {
+                // Best-effort, same rule.
+            }
+        }));
+    }
+}
+/**
+ * The run coordinator: starts each involved driver once, runs scenarios
+ * sequentially, stops drivers and flushes reporters in finally
+ * (ADR-0002 D7; Phase 1 runs scenarios serially — parallel scenario
+ * scheduling is a later concern).
+ */
+export async function runScenarios(options) {
+    const runId = options.runId ?? randomUUID();
+    const events = new EventBus(runId, {
+        ...(options.onReporterError !== undefined ? { onReporterError: options.onReporterError } : {}),
+    });
+    for (const reporter of options.reporters ?? []) {
+        events.subscribe(reporter);
+    }
+    const artifactsDir = options.artifactsDir ?? join(process.cwd(), '.kraken', 'runs', runId);
+    mkdirSync(artifactsDir, { recursive: true });
+    const runAbort = new AbortController();
+    const deps = {
+        registry: options.registry,
+        signalBus: options.signalBus,
+        events,
+        hostContext: options.hostContext,
+        artifactsDir,
+        ...(options.logSink !== undefined ? { logSink: options.logSink } : {}),
+    };
+    events.emit({ type: 'runStarted', protocol: 1, scenarioCount: options.plans.length });
+    const startedAt = Date.now();
+    const scenarios = [];
+    // Start each involved driver exactly once per run (ADR-0002 D2).
+    const startedDrivers = [];
+    try {
+        const uniqueDrivers = new Map();
+        for (const plan of options.plans) {
+            for (const actor of plan.actors) {
+                const driver = options.registry.driverFor(actor.platform);
+                uniqueDrivers.set(driver.manifest.id, driver);
+            }
+        }
+        for (const driver of uniqueDrivers.values()) {
+            try {
+                await driver.start(options.hostContext, driverServices(deps, `driver:${driver.manifest.id}`, runAbort.signal));
+                startedDrivers.push(driver);
+            }
+            catch (cause) {
+                throw KrakenError.wrap(cause, 'KRK-DRIVER-START-FAILED', `Driver "${driver.manifest.id}" failed to start`);
+            }
+        }
+        const runner = new ScenarioRunner(deps);
+        for (const plan of options.plans) {
+            scenarios.push(await runner.run(plan));
+        }
+    }
+    finally {
+        runAbort.abort();
+        for (const driver of startedDrivers.reverse()) {
+            try {
+                await driver.stop();
+            }
+            catch {
+                // stop() is declared idempotent/best-effort; a failing stop must not mask results.
+            }
+        }
+        const status = scenarios.length === options.plans.length && scenarios.every((s) => s.status === 'passed')
+            ? 'passed'
+            : 'failed';
+        events.emit({ type: 'runFinished', status, durationMs: Date.now() - startedAt });
+        await events.flush();
+    }
+    return {
+        runId,
+        status: scenarios.every((s) => s.status === 'passed') ? 'passed' : 'failed',
+        scenarios,
+    };
+}
+/** Boot-failure sessions and similar cleanup share this constant. */
+export const SESSION_DISPOSE_TIMEOUT_MS = DISPOSE_TIMEOUT_MS;
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAML,kBAAkB,GAEnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,QAAQ,EAAkB,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAgB,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAqB,WAAW,EAAqB,MAAM,gBAAgB,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,wBAAwB;IAET;IACA;IACA;IACA;IAJnB,YACmB,KAAmB,EACnB,MAAiB,EACjB,UAAkB,EAClB,KAAkB;QAHlB,UAAK,GAAL,KAAK,CAAc;QACnB,WAAM,GAAN,MAAM,CAAW;QACjB,eAAU,GAAV,UAAU,CAAQ;QAClB,UAAK,GAAL,KAAK,CAAa;IAClC,CAAC;IAEJ,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAO,CAA0B,IAAY,EAAE,OAAW;QAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,YAAY;YAClB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,IAAI,CAAC,YAAY;YACvB,SAAS,EAAE,MAAM,CAAC,GAAG;SACtB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,IAAoB;QAEpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,mBAAmB;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;gBAC5C,GAAG,IAAI;gBACP,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK;aAClC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,gBAAgB;gBACtB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,MAAM,EAAE,IAAI;gBACZ,EAAE,EAAE,IAAI,CAAC,YAAY;gBACrB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aAClC,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,gBAAgB;oBACtB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,MAAM,EAAE,IAAI;oBACZ,OAAO,EAAE,IAAI,CAAC,YAAY;oBAC1B,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B,CAAC,CAAC;YACL,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,IAAkF;QAElF,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACnD,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,YAAY;aACd,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,KAAK,IAAI,CAAC,YAAY,CAAC;aAC1D,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CACnB,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,WAAW,EAAE,EAAE;YACrC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CACH,CACJ,CAAC;IACJ,CAAC;CACF;AAoBD,SAAS,cAAc,CACrB,IAAwB,EACxB,MAAc,EACd,KAAkB;IAElB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,CAAC;IACjG,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;QACxB,MAAM;QACN,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,KAAK;QACL,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE;YACjB,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,WAAW;oBACjB,MAAM;oBACN,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;iBAC1B,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,kBAAkB;oBACxB,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACzE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAIlC,KAAK,UAAU,WAAW,CAAC,IAAmB,EAAE,EAAU;IACxD,IAAI,KAAiC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;QACjD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;QACjC,IAAI,CAAC,IAAI,CACP,GAAmB,EAAE,CAAC,IAAI,EAC1B,GAAmB,EAAE,CAAC,OAAO,CAC9B;QACD,OAAO;KACR,CAAC,CAAC;IACH,YAAY,CAAC,KAAK,CAAC,CAAC;IACpB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,IAAwB;QAAxB,SAAI,GAAJ,IAAI,CAAoB;IAAG,CAAC;IAEzD,KAAK,CAAC,GAAG,CAAC,IAAkB;QAC1B,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAE9C,2EAA2E;QAC3E,sDAAsD;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC3C,KAAK;YACL,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC;SAChD,CAAC,CAAC,CAAC;QAEJ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,iBAAiB;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC3C,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;aAC7B,CAAC,CAAC;SACJ,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,CAAC,MAA2B,EAAE,KAAe,EAAkB,EAAE;YAC9E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,kBAAkB;gBACxB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,MAAM;gBACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjE,CAAC,CAAC;YACH,OAAO;gBACL,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM;gBACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1C,CAAC;QACJ,CAAC,CAAC;QAEF,4EAA4E;QAC5E,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;YACvC,MAAM,QAAQ,GAAG,cAAc,CAC7B,IAAI,EACJ,UAAU,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,EAAE,EAC1C,eAAe,CAAC,MAAM,CACvB,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACpC,CAAC,CAAC,CACH,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CACxC,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CACpD,CAAC;QACF,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAC9C,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CACpD,CAAC;QACF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;YAC3F,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAC9B,OAAO,MAAM,CACX,QAAQ,EACR,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC;gBACnB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,2BAA2B,EAAE,2BAA2B,CAAC,CACtF,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,qBAAqB;gBAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;gBAC5B,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa;aAC7C,CAAC,CAAC;QACL,CAAC;QAED,sCAAsC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAClC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YACxB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAEpB,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YACjC,KAAK,CAAC,EAAE;YACR;gBACE,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,OAAO;gBACP,OAAO,EAAE,IAAI,wBAAwB,CACnC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EACzB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,UAAU,EACf,eAAe,CAAC,MAAM,CACvB;gBACD,GAAG,EAAE,IAAI,CAAC,OAAO;oBACf,CAAC,CAAC,YAAY,CAAC,SAAS,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC;oBACjD,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC;aAClC;SACF,CAAC,CACH,CAAC;QAEF,IAAI,MAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE;gBACxC,MAAM;gBACN,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,eAAe;aAChB,CAAC,CAAC;YAEH,IAAI,SAAS,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAClC,MAAM,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;gBAC7D,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,yEAAyE;YACzE,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;gBACtC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,CAAC;gBACzE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,sBAAsB;oBAC5B,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,OAAO,EAAE,KAAK,CAAC,EAAE;oBACjB,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;iBAC3C,CAAC,CAAC;YACL,CAAC,CAAC,CACH,CAAC;YACF,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,yDAAyD;YAC3D,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,wFAAwF;IACxF,KAAK,CAAC,wBAAwB,CAC5B,UAAkB,EAClB,MAAyC;QAEzC,MAAM,OAAO,CAAC,GAAG,CACf,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACvC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBAClD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;oBACpB,IAAI,EAAE,kBAAkB;oBACxB,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,UAAU;oBACV,OAAO,EAAE,KAAK,CAAC,EAAE;iBAClB,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,qDAAqD;YACvD,CAAC;YACD,IAAI,CAAC;gBACH,kEAAkE;gBAClE,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC1C,MAAM,IAAI,GAAG,IAAI,CACf,IAAI,CAAC,IAAI,CAAC,YAAY,EACtB,GAAG,UAAU,IAAI,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CACjE,CAAC;gBACF,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC1B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;oBACpB,IAAI,EAAE,kBAAkB;oBACxB,IAAI,EAAE,QAAQ;oBACd,IAAI;oBACJ,UAAU;oBACV,OAAO,EAAE,KAAK,CAAC,EAAE;iBAClB,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF;AAoBD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAmB;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE;QACjC,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/F,CAAC,CAAC;IACH,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3F,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,MAAM,IAAI,GAAuB;QAC/B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM;QACN,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY;QACZ,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAqB,EAAE,CAAC;IAEvC,iEAAiE;IACjE,MAAM,cAAc,GAAmB,EAAE,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;QACtD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC1D,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,CAChB,OAAO,CAAC,WAAW,EACnB,cAAc,CAAC,IAAI,EAAE,UAAU,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CACtE,CAAC;gBACF,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,WAAW,CAAC,IAAI,CACpB,KAAK,EACL,yBAAyB,EACzB,WAAW,MAAM,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CACjD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,SAAS,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,MAAM,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,mFAAmF;YACrF,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GACV,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;YACxF,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QACjF,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,OAAO;QACL,KAAK;QACL,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QAC3E,SAAS;KACV,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC"}

package/dist/scenario.d.ts

@@ -0,0 +1,25 @@
+import type { ResolvedActor } from '@kraken-e2e/contracts';
+import type { ScenarioPlan, StepRunContext } from './scheduler.js';
+/**
+ * The programmatic scenario API (ADR-0001 §7 Phase 1): a plan builder
+ * mirroring the DSL's screenplay semantics — same orchestrator, no Gherkin.
+ *
+ *   const plan = scenario('direct message')
+ *     .step('alice', 'opens the conversation', async ({ actor }) => { ... })
+ *     .step('bob', 'sees the message', async ({ actor }) => { ... })
+ *     .build({ actors });
+ */
+export declare function scenario(name: string): ScenarioBuilder;
+export declare class ScenarioBuilder {
+    #private;
+    constructor(name: string);
+    step(actorId: string, title: string, run: (ctx: StepRunContext) => Promise<void>): this;
+    /** Starts a named background task; MUST be joined before the scenario ends. */
+    detach(actorId: string, title: string, handle: string, run: (ctx: StepRunContext) => Promise<void>): this;
+    join(actorId: string, title: string, handle: string, timeoutMs: number): this;
+    build(options: {
+        actors: readonly ResolvedActor[];
+        scenarioId?: string;
+    }): ScenarioPlan;
+}
+//# sourceMappingURL=scenario.d.ts.map

package/dist/scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../src/scenario.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,OAAO,KAAK,EAAY,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE7E;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAEtD;AAED,qBAAa,eAAe;;gBAKd,IAAI,EAAE,MAAM;IAcxB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAYvF,+EAA+E;IAC/E,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAC1C,IAAI;IAaP,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAc7E,KAAK,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY;CAmBxF"}

package/dist/scenario.js

@@ -0,0 +1,85 @@
+import { KrakenError } from '@kraken-e2e/contracts';
+/**
+ * The programmatic scenario API (ADR-0001 §7 Phase 1): a plan builder
+ * mirroring the DSL's screenplay semantics — same orchestrator, no Gherkin.
+ *
+ *   const plan = scenario('direct message')
+ *     .step('alice', 'opens the conversation', async ({ actor }) => { ... })
+ *     .step('bob', 'sees the message', async ({ actor }) => { ... })
+ *     .build({ actors });
+ */
+export function scenario(name) {
+    return new ScenarioBuilder(name);
+}
+export class ScenarioBuilder {
+    #name;
+    #nodes = [];
+    #counter = 0;
+    constructor(name) {
+        this.#name = name;
+    }
+    #nextId() {
+        this.#counter += 1;
+        return `node-${this.#counter}`;
+    }
+    #chainDependency() {
+        const last = this.#nodes.at(-1);
+        return last ? [last.id] : [];
+    }
+    step(actorId, title, run) {
+        this.#nodes.push({
+            id: this.#nextId(),
+            actorId,
+            kind: 'step',
+            title,
+            dependsOn: this.#chainDependency(),
+            run,
+        });
+        return this;
+    }
+    /** Starts a named background task; MUST be joined before the scenario ends. */
+    detach(actorId, title, handle, run) {
+        this.#nodes.push({
+            id: this.#nextId(),
+            actorId,
+            kind: 'detach',
+            title,
+            dependsOn: this.#chainDependency(),
+            taskHandle: handle,
+            run,
+        });
+        return this;
+    }
+    join(actorId, title, handle, timeoutMs) {
+        this.#nodes.push({
+            id: this.#nextId(),
+            actorId,
+            kind: 'join',
+            title,
+            dependsOn: this.#chainDependency(),
+            taskHandle: handle,
+            joinTimeoutMs: timeoutMs,
+            run: async () => { },
+        });
+        return this;
+    }
+    build(options) {
+        const declared = new Set(options.actors.map((actor) => actor.id));
+        for (const node of this.#nodes) {
+            if (!declared.has(node.actorId)) {
+                const known = [...declared].join(', ');
+                throw new KrakenError('KRK-STEP-UNKNOWN-ACTOR', `Step "${node.title}" is addressed to undeclared actor "${node.actorId}". Declared actors: ${known}.`, { fix: 'Declare the actor in the actors list, or fix the actor name in the step.' });
+            }
+        }
+        return {
+            scenarioId: options.scenarioId ?? `scenario-${cryptoRandomId()}`,
+            name: this.#name,
+            actors: options.actors,
+            nodes: this.#nodes,
+        };
+    }
+}
+function cryptoRandomId() {
+    return Math.random().toString(36).slice(2, 10);
+}
+//# sourceMappingURL=scenario.js.map

package/dist/scenario.js.map

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

package/dist/scheduler.d.ts

@@ -0,0 +1,87 @@
+import type { Logger, ResolvedActor, UserSession } from '@kraken-e2e/contracts';
+import type { SignalHandle } from '@kraken-e2e/signaling';
+import type { EventSink } from './event-bus.js';
+/** What a step's run() receives for its addressed actor. */
+export interface ActorRuntime {
+    readonly id: string;
+    readonly platform: string;
+    readonly session: UserSession;
+    readonly signals: SignalHandle;
+    readonly log: Logger;
+}
+export interface StepRunContext {
+    readonly actor: ActorRuntime;
+    /** Per-scenario shared state across all actors' steps. */
+    readonly world: Record<string, unknown>;
+    readonly tasks: TaskRegistry;
+    /** Fired on failFast — long operations must honor it. */
+    readonly abort: AbortSignal;
+    /** All actor runtimes, for the rare step that must inspect another actor. */
+    readonly actors: ReadonlyMap<string, ActorRuntime>;
+}
+export type PlanNodeKind = 'step' | 'detach' | 'join';
+export interface PlanNode {
+    readonly id: string;
+    readonly actorId: string;
+    readonly kind: PlanNodeKind;
+    /** Human-readable step text (Gherkin text or programmatic title). */
+    readonly title: string;
+    /** Default compilation is a chain (screenplay total order — ADR-0001 D6). */
+    readonly dependsOn: readonly string[];
+    /** detach/join: the named background-task handle. */
+    readonly taskHandle?: string;
+    /** join: how long to wait for the task. */
+    readonly joinTimeoutMs?: number;
+    run(ctx: StepRunContext): Promise<void>;
+}
+export interface ScenarioPlan {
+    readonly scenarioId: string;
+    readonly name: string;
+    readonly featureUri?: string;
+    readonly actors: readonly ResolvedActor[];
+    readonly nodes: readonly PlanNode[];
+}
+/**
+ * Named background tasks (the detach/join escape hatch — ADR-0001 §5.9).
+ * An unjoined handle at scenario end fails the scenario (leak detection).
+ */
+export declare class TaskRegistry {
+    #private;
+    /**
+     * 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: string, start: () => Promise<void>, startedBy: string): void;
+    join(handle: string, timeoutMs: number): Promise<void>;
+    unjoined(): readonly {
+        handle: string;
+        startedBy: string;
+    }[];
+    /**
+     * 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.
+     */
+    drain(timeoutMs: number): Promise<readonly string[]>;
+}
+export interface PlanExecutionResult {
+    readonly status: 'passed' | 'failed';
+    readonly error?: unknown;
+    readonly failedNodeId?: string;
+}
+/**
+ * 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 declare function executePlan(plan: ScenarioPlan, deps: {
+    readonly actors: ReadonlyMap<string, ActorRuntime>;
+    readonly events: EventSink;
+    readonly abortController: AbortController;
+    /** Grace period for abort-ignoring detached tasks. */
+    readonly drainTimeoutMs?: number;
+}): Promise<PlanExecutionResult>;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

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