@kraken-e2e/contracts 0.1.0

package/dist/driver.d.ts

@@ -0,0 +1,106 @@
+/**
+ * The driver SPI (ADR-0001 §5.10 / ADR-0002 D2). A driver package's default
+ * export is a factory produced by defineDriver(); the brand symbol survives
+ * duplicate copies of this package in the tree, and the baked CONTRACT_VERSION
+ * is what the registry checks at load time.
+ */
+import type { HostContext, HostRequirements } from './host.js';
+import type { UserSession } from './session.js';
+import { type ContractVersion } from './version.js';
+export declare const DRIVER_BRAND: unique symbol;
+export interface DriverManifest {
+    readonly kind: 'kraken-driver';
+    /** Short id: 'android' | 'ios' | 'web' | custom. */
+    readonly id: string;
+    /** Platform ids actors bind to (usually [id]; web may expose more). */
+    readonly platforms: readonly string[];
+    /** The driver package's own version. */
+    readonly version: string;
+    /** Baked by defineDriver — never hand-written. */
+    readonly contract: ContractVersion;
+    /** Human label for messages: 'iOS (XCUITest via Appium 3)'. */
+    readonly platformLabel: string;
+    readonly hostRequirements?: HostRequirements;
+    /** Actionable remediation shown when the driver is host-disabled. */
+    readonly disabledFix?: string;
+    /** Printed after `kraken plugins install`. */
+    readonly setupHints?: readonly string[];
+}
+/** Drivers NEVER write to stdout — they get a logger (ADR-0001 §5.11). */
+export interface Logger {
+    debug(message: string, meta?: Readonly<Record<string, unknown>>): void;
+    info(message: string, meta?: Readonly<Record<string, unknown>>): void;
+    warn(message: string, meta?: Readonly<Record<string, unknown>>): void;
+    error(message: string, meta?: Readonly<Record<string, unknown>>): void;
+}
+/** The only events a driver may emit directly; core stamps the envelope. */
+export type DriverEmission = {
+    readonly type: 'driverLog';
+    readonly level: 'debug' | 'info' | 'warn' | 'error';
+    readonly message: string;
+} | {
+    readonly type: 'artifactCaptured';
+    readonly kind: 'screenshot' | 'log' | 'video' | 'source';
+    readonly path: string;
+    readonly actorId?: string;
+};
+export interface DriverServices {
+    readonly runId: string;
+    readonly logger: Logger;
+    /** Per-run scratch for videos, server logs, screenshots. */
+    readonly artifactsDir: string;
+    /** Fired on failFast teardown/SIGINT — long driver operations must honor it. */
+    readonly abort: AbortSignal;
+    emit(event: DriverEmission): void;
+}
+export interface ResolvedActor {
+    readonly id: string;
+    readonly platform: string;
+    /** Driver-specific actor configuration from kraken.config.ts, passed through. */
+    readonly config: Readonly<Record<string, unknown>>;
+}
+export type DoctorStatus = 'ok' | 'warn' | 'fail';
+export interface DoctorCheckResult {
+    readonly status: DoctorStatus;
+    readonly detail?: string;
+    /** Actionable remediation — the whole point of kraken doctor (constraint C10). */
+    readonly fix?: string;
+}
+export interface DoctorCheck {
+    /** Stable id, e.g. 'ios.xcode-version'. */
+    readonly id: string;
+    readonly title: string;
+    run(host: HostContext): Promise<DoctorCheckResult>;
+}
+export interface KrakenDriver<Opts = unknown> {
+    readonly [DRIVER_BRAND]: true;
+    readonly manifest: DriverManifest;
+    /** Environment checks contributed to `kraken doctor` (ADR-0002 D2). */
+    readonly doctor?: readonly DoctorCheck[];
+    /** Boot shared infra (e.g. an Appium server) once per run. */
+    start(host: HostContext, services: DriverServices): Promise<void>;
+    /** One INDEPENDENT session per actor (ADR-0001 §5.6 — never multiremote). */
+    createSession(actor: ResolvedActor, services: DriverServices): Promise<UserSession>;
+    /** Idempotent — SIGINT teardown may call it more than once. */
+    stop(): Promise<void>;
+    /** Phantom marker so Opts survives inference; never set at runtime. */
+    readonly __optionsType?: Opts;
+}
+/** What driver authors write; defineDriver adds the brand and bakes the contract. */
+export interface DriverSpec {
+    readonly manifest: Omit<DriverManifest, 'kind' | 'contract'>;
+    readonly doctor?: readonly DoctorCheck[];
+    start(host: HostContext, services: DriverServices): Promise<void>;
+    createSession(actor: ResolvedActor, services: DriverServices): Promise<UserSession>;
+    stop(): Promise<void>;
+}
+/**
+ * Factory-returning: kraken.config.ts calls `android({ avd: 'Pixel_8' })` and
+ * registers the VALUE — dependency injection, the hexagonal answer
+ * (ADR-0001 §5.10). The driver package's main entry must stay import-safe on
+ * every host (ADR-0001 §5.5): dynamic-import heavy deps inside start().
+ */
+export declare function defineDriver<Opts = void>(build: (opts: Opts) => DriverSpec): (opts?: Opts) => KrakenDriver<Opts>;
+/** Runtime check the registry uses; works across duplicate contract copies. */
+export declare function isKrakenDriver(value: unknown): value is KrakenDriver;
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

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

package/dist/driver.js

@@ -0,0 +1,28 @@
+import { CONTRACT_VERSION } from './version.js';
+export const DRIVER_BRAND = Symbol.for('kraken.driver/v1');
+/**
+ * Factory-returning: kraken.config.ts calls `android({ avd: 'Pixel_8' })` and
+ * registers the VALUE — dependency injection, the hexagonal answer
+ * (ADR-0001 §5.10). The driver package's main entry must stay import-safe on
+ * every host (ADR-0001 §5.5): dynamic-import heavy deps inside start().
+ */
+export function defineDriver(build) {
+    return (opts) => {
+        const spec = build(opts);
+        return {
+            [DRIVER_BRAND]: true,
+            manifest: { ...spec.manifest, kind: 'kraken-driver', contract: CONTRACT_VERSION },
+            ...(spec.doctor !== undefined ? { doctor: spec.doctor } : {}),
+            start: spec.start,
+            createSession: spec.createSession,
+            stop: spec.stop,
+        };
+    };
+}
+/** Runtime check the registry uses; works across duplicate contract copies. */
+export function isKrakenDriver(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value[DRIVER_BRAND] === true);
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAwB,MAAM,cAAc,CAAC;AAEtE,MAAM,CAAC,MAAM,YAAY,GAAkB,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAU,CAAC;AAoGnF;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAiC;IAEjC,OAAO,CAAC,IAAW,EAAsB,EAAE;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAY,CAAC,CAAC;QACjC,OAAO;YACL,CAAC,YAAY,CAAC,EAAE,IAAa;YAC7B,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,gBAAgB,EAAE;YACjF,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAsC,CAAC,YAAY,CAAC,KAAK,IAAI,CAC/D,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Error taxonomy (ADR-0001 §5.12 / ADR-0002 D6): stable KRK-* codes so CLI,
+ * doctor, reporters, and the future GUI render errors consistently.
+ * Stability rule: released codes are NEVER renamed or reused.
+ * Third-party drivers mint codes under `KRK-DRV-<ID>-*`.
+ */
+export declare const KrakenErrorCodes: {
+    /** Generic host gate; driver-specific variants are composed as `KRK-HOST-<ID>-UNSUPPORTED`. */
+    readonly HOST_UNSUPPORTED: "KRK-HOST-UNSUPPORTED";
+    readonly CONFIG_INVALID: "KRK-CONFIG-INVALID";
+    readonly CONFIG_NOT_FOUND: "KRK-CONFIG-NOT-FOUND";
+    readonly PLUGIN_NOT_FOUND: "KRK-PLUGIN-NOT-FOUND";
+    readonly PLUGIN_INVALID: "KRK-PLUGIN-INVALID";
+    readonly PLUGIN_INCOMPATIBLE: "KRK-PLUGIN-INCOMPATIBLE";
+    readonly DRIVER_UNKNOWN_PLATFORM: "KRK-DRIVER-UNKNOWN-PLATFORM";
+    readonly DRIVER_START_FAILED: "KRK-DRIVER-START-FAILED";
+    readonly SESSION_CREATE_FAILED: "KRK-SESSION-CREATE-FAILED";
+    readonly SESSION_OP_UNSUPPORTED: "KRK-SESSION-OP-UNSUPPORTED";
+    readonly SESSION_ELEMENT_NOT_FOUND: "KRK-SESSION-ELEMENT-NOT-FOUND";
+    readonly SESSION_WAIT_TIMEOUT: "KRK-SESSION-WAIT-TIMEOUT";
+    readonly SIGNAL_TIMEOUT: "KRK-SIGNAL-TIMEOUT";
+    readonly STEP_UNMATCHED: "KRK-STEP-UNMATCHED";
+    readonly STEP_AMBIGUOUS: "KRK-STEP-AMBIGUOUS";
+    readonly STEP_UNKNOWN_ACTOR: "KRK-STEP-UNKNOWN-ACTOR";
+    readonly STEP_FAILED: "KRK-STEP-FAILED";
+    readonly PLAN_DEADLOCK: "KRK-PLAN-DEADLOCK";
+    readonly PLAN_UNJOINED_TASK: "KRK-PLAN-UNJOINED-TASK";
+    readonly PLAN_UNKNOWN_TASK: "KRK-PLAN-UNKNOWN-TASK";
+    readonly PLAN_DUPLICATE_TASK: "KRK-PLAN-DUPLICATE-TASK";
+    readonly TASK_JOIN_TIMEOUT: "KRK-PLAN-TASK-JOIN-TIMEOUT";
+    readonly RUN_ABORTED: "KRK-RUN-ABORTED";
+};
+export type KrakenErrorCode = (typeof KrakenErrorCodes)[keyof typeof KrakenErrorCodes] | `KRK-HOST-${string}-UNSUPPORTED` | `KRK-DRV-${string}`;
+export interface SerializedKrakenError {
+    readonly code: string;
+    readonly message: string;
+    readonly fix?: string;
+    readonly data?: Readonly<Record<string, unknown>>;
+}
+export declare class KrakenError extends Error {
+    readonly name = "KrakenError";
+    readonly code: KrakenErrorCode;
+    /** Actionable remediation — what CLI/doctor/GUI render next to the message. */
+    readonly fix: string | undefined;
+    readonly data: Readonly<Record<string, unknown>> | undefined;
+    constructor(code: KrakenErrorCode, message: string, options?: {
+        fix?: string | undefined;
+        data?: Readonly<Record<string, unknown>> | undefined;
+        cause?: unknown;
+    });
+    toJSON(): SerializedKrakenError;
+    static is(error: unknown): error is KrakenError;
+    /** Wraps a foreign error, preserving it as `cause`. */
+    static wrap(error: unknown, code: KrakenErrorCode, message?: string): KrakenError;
+}
+/** Serializes any error into the event-carriable shape. */
+export declare function serializeError(error: unknown): SerializedKrakenError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,gBAAgB;IAC3B,+FAA+F;;;;;;;;;;;;;;;;;;;;;;;;CAwBvF,CAAC;AAEX,MAAM,MAAM,eAAe,GACvB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,GACxD,YAAY,MAAM,cAAc,GAChC,WAAW,MAAM,EAAE,CAAC;AAExB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAkB,IAAI,iBAAiB;IACvC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;gBAG3D,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;QACrD,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;IAQH,MAAM,IAAI,qBAAqB;IAS/B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW;IAI/C,uDAAuD;IACvD,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW;CAKlF;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAMpE"}

package/dist/errors.js

@@ -0,0 +1,73 @@
+/**
+ * Error taxonomy (ADR-0001 §5.12 / ADR-0002 D6): stable KRK-* codes so CLI,
+ * doctor, reporters, and the future GUI render errors consistently.
+ * Stability rule: released codes are NEVER renamed or reused.
+ * Third-party drivers mint codes under `KRK-DRV-<ID>-*`.
+ */
+export const KrakenErrorCodes = {
+    /** Generic host gate; driver-specific variants are composed as `KRK-HOST-<ID>-UNSUPPORTED`. */
+    HOST_UNSUPPORTED: 'KRK-HOST-UNSUPPORTED',
+    CONFIG_INVALID: 'KRK-CONFIG-INVALID',
+    CONFIG_NOT_FOUND: 'KRK-CONFIG-NOT-FOUND',
+    PLUGIN_NOT_FOUND: 'KRK-PLUGIN-NOT-FOUND',
+    PLUGIN_INVALID: 'KRK-PLUGIN-INVALID',
+    PLUGIN_INCOMPATIBLE: 'KRK-PLUGIN-INCOMPATIBLE',
+    DRIVER_UNKNOWN_PLATFORM: 'KRK-DRIVER-UNKNOWN-PLATFORM',
+    DRIVER_START_FAILED: 'KRK-DRIVER-START-FAILED',
+    SESSION_CREATE_FAILED: 'KRK-SESSION-CREATE-FAILED',
+    SESSION_OP_UNSUPPORTED: 'KRK-SESSION-OP-UNSUPPORTED',
+    SESSION_ELEMENT_NOT_FOUND: 'KRK-SESSION-ELEMENT-NOT-FOUND',
+    SESSION_WAIT_TIMEOUT: 'KRK-SESSION-WAIT-TIMEOUT',
+    SIGNAL_TIMEOUT: 'KRK-SIGNAL-TIMEOUT',
+    STEP_UNMATCHED: 'KRK-STEP-UNMATCHED',
+    STEP_AMBIGUOUS: 'KRK-STEP-AMBIGUOUS',
+    STEP_UNKNOWN_ACTOR: 'KRK-STEP-UNKNOWN-ACTOR',
+    STEP_FAILED: 'KRK-STEP-FAILED',
+    PLAN_DEADLOCK: 'KRK-PLAN-DEADLOCK',
+    PLAN_UNJOINED_TASK: 'KRK-PLAN-UNJOINED-TASK',
+    PLAN_UNKNOWN_TASK: 'KRK-PLAN-UNKNOWN-TASK',
+    PLAN_DUPLICATE_TASK: 'KRK-PLAN-DUPLICATE-TASK',
+    TASK_JOIN_TIMEOUT: 'KRK-PLAN-TASK-JOIN-TIMEOUT',
+    RUN_ABORTED: 'KRK-RUN-ABORTED',
+};
+export class KrakenError extends Error {
+    name = 'KrakenError';
+    code;
+    /** Actionable remediation — what CLI/doctor/GUI render next to the message. */
+    fix;
+    data;
+    constructor(code, message, options) {
+        super(message, options?.cause === undefined ? undefined : { cause: options.cause });
+        this.code = code;
+        this.fix = options?.fix;
+        this.data = options?.data;
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            ...(this.fix !== undefined ? { fix: this.fix } : {}),
+            ...(this.data !== undefined ? { data: this.data } : {}),
+        };
+    }
+    static is(error) {
+        return error instanceof KrakenError;
+    }
+    /** Wraps a foreign error, preserving it as `cause`. */
+    static wrap(error, code, message) {
+        if (KrakenError.is(error))
+            return error;
+        const detail = error instanceof Error ? error.message : String(error);
+        return new KrakenError(code, message ? `${message}: ${detail}` : detail, { cause: error });
+    }
+}
+/** Serializes any error into the event-carriable shape. */
+export function serializeError(error) {
+    if (KrakenError.is(error))
+        return error.toJSON();
+    if (error instanceof Error) {
+        return { code: 'KRK-STEP-FAILED', message: `${error.name}: ${error.message}` };
+    }
+    return { code: 'KRK-STEP-FAILED', message: String(error) };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,109 @@
+/**
+ * The structured event stream (ADR-0001 §5.12 / ADR-0002 D5) — the GUI-ready
+ * spine. Envelope: { type, ts, runId, seq } with seq monotonic per run.
+ *
+ * Evolution rules (cucumber-messages model): additive-only. New OPTIONAL
+ * fields at most; a semantic change is a NEW event type; consumers MUST ignore
+ * unknown types/fields. A single `protocol: 1` literal lives in runStarted.
+ * Validation schemas (zod) live inside @kraken-e2e/core, never here.
+ */
+import type { SerializedKrakenError } from './errors.js';
+export interface KrakenEventBase {
+    readonly ts: number;
+    readonly runId: string;
+    /** Monotonic per run — total ordering for any consumer without clock trust. */
+    readonly seq: number;
+}
+export type StepStatus = 'passed' | 'failed' | 'skipped';
+export type RunStatus = 'passed' | 'failed';
+export interface ActorSummary {
+    readonly id: string;
+    readonly platform: string;
+    readonly driverId: string;
+}
+type Ev<TType extends string, TPayload> = KrakenEventBase & {
+    readonly type: TType;
+} & Readonly<TPayload>;
+export type KrakenEvent = Ev<'runStarted', {
+    protocol: 1;
+    scenarioCount: number;
+}> | Ev<'runFinished', {
+    status: RunStatus;
+    durationMs: number;
+}> | Ev<'scenarioStarted', {
+    scenarioId: string;
+    name: string;
+    featureUri?: string;
+    actors: readonly ActorSummary[];
+}> | Ev<'scenarioFinished', {
+    scenarioId: string;
+    status: StepStatus;
+    durationMs: number;
+    error?: SerializedKrakenError;
+}> | Ev<'stepStarted', {
+    scenarioId: string;
+    stepId: string;
+    actorId: string;
+    text: string;
+}> | Ev<'stepFinished', {
+    scenarioId: string;
+    stepId: string;
+    actorId: string;
+    text: string;
+    status: StepStatus;
+    durationMs: number;
+    error?: SerializedKrakenError;
+}> | Ev<'actorSessionStarted', {
+    scenarioId: string;
+    actorId: string;
+    driverId: string;
+    platformLabel: string;
+}> | Ev<'actorSessionFinished', {
+    scenarioId: string;
+    actorId: string;
+    status: 'ok' | 'failed';
+}> | Ev<'signalSent', {
+    scenarioId: string;
+    signal: string;
+    from: string;
+    recordSeq: number;
+}> | Ev<'signalWaitStarted', {
+    scenarioId: string;
+    signal: string;
+    actorId: string;
+    timeoutMs: number;
+}> | Ev<'signalReceived', {
+    scenarioId: string;
+    signal: string;
+    by: string;
+    from: string;
+    latencyMs: number;
+}> | Ev<'signalTimedOut', {
+    scenarioId: string;
+    signal: string;
+    actorId: string;
+    timeoutMs: number;
+}> | Ev<'driverRegistered', {
+    driverId: string;
+    version: string;
+    platforms: readonly string[];
+}> | Ev<'driverDisabled', {
+    driverId: string;
+    code: string;
+    reason: string;
+    fix: string;
+}> | Ev<'artifactCaptured', {
+    kind: 'screenshot' | 'log' | 'video' | 'source';
+    path: string;
+    scenarioId?: string;
+    actorId?: string;
+}> | Ev<'driverLog', {
+    source: string;
+    level: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+}>;
+export type KrakenEventType = KrakenEvent['type'];
+/** What the EventBus accepts: an event minus the envelope it stamps. */
+export type KrakenEventInput = KrakenEvent extends infer E ? E extends KrakenEvent ? Omit<E, keyof KrakenEventBase> : never : never;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":""}

package/dist/host.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Host-platform detection contracts (ADR-0001 §5.5 / constraint C4b).
+ * The single implementation reading process.platform/arch lives in
+ * @kraken-e2e/core (`systemHostProbe`); everything else receives HostInfo values.
+ */
+export interface HostInfo {
+    readonly platform: 'darwin' | 'linux' | 'win32' | (string & {});
+    readonly arch: 'arm64' | 'x64' | (string & {});
+    /** Without the leading 'v', e.g. '22.19.0'. */
+    readonly nodeVersion: string;
+}
+/** Injectable so the non-darwin branch is a plain unit test (C4b). */
+export interface HostProbe {
+    detect(): HostInfo;
+}
+/** What a driver's manifest declares about the hosts it can run on. */
+export interface HostRequirements {
+    readonly platforms?: readonly string[];
+    readonly archs?: readonly string[];
+    readonly minNodeMajor?: number;
+}
+/** What drivers receive at start(): host facts plus the environment. */
+export interface HostContext extends HostInfo {
+    readonly projectRoot?: string;
+    readonly env: Readonly<Record<string, string | undefined>>;
+}
+export type HostCheckResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+    readonly fix: string;
+};
+/** Pure — trivially unit-testable with injected values (never reads process.*). */
+export declare function checkHostRequirements(requirements: HostRequirements | undefined, host: HostInfo): HostCheckResult;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAChE,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC/C,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,sEAAsE;AACtE,MAAM,WAAW,SAAS;IACxB,MAAM,IAAI,QAAQ,CAAC;CACpB;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CAC5D;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,mFAAmF;AACnF,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,gBAAgB,GAAG,SAAS,EAC1C,IAAI,EAAE,QAAQ,GACb,eAAe,CA6BjB"}

package/dist/host.js

@@ -0,0 +1,37 @@
+/**
+ * Host-platform detection contracts (ADR-0001 §5.5 / constraint C4b).
+ * The single implementation reading process.platform/arch lives in
+ * @kraken-e2e/core (`systemHostProbe`); everything else receives HostInfo values.
+ */
+/** Pure — trivially unit-testable with injected values (never reads process.*). */
+export function checkHostRequirements(requirements, host) {
+    if (!requirements)
+        return { ok: true };
+    if (requirements.platforms && !requirements.platforms.includes(host.platform)) {
+        return {
+            ok: false,
+            reason: `requires host platform ${requirements.platforms.join(' or ')}, ` +
+                `but this host is ${host.platform}/${host.arch}`,
+            fix: `Run on a supported host (${requirements.platforms.join(', ')}). Other drivers remain available on this host.`,
+        };
+    }
+    if (requirements.archs && !requirements.archs.includes(host.arch)) {
+        return {
+            ok: false,
+            reason: `requires CPU architecture ${requirements.archs.join(' or ')}, but this host is ${host.arch}`,
+            fix: `Run on a supported architecture (${requirements.archs.join(', ')}).`,
+        };
+    }
+    if (requirements.minNodeMajor !== undefined) {
+        const major = Number.parseInt(host.nodeVersion.split('.')[0] ?? '0', 10);
+        if (major < requirements.minNodeMajor) {
+            return {
+                ok: false,
+                reason: `requires Node >= ${requirements.minNodeMajor}, but this host runs ${host.nodeVersion}`,
+                fix: `Upgrade Node.js to ${requirements.minNodeMajor} or newer.`,
+            };
+        }
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA+BH,mFAAmF;AACnF,MAAM,UAAU,qBAAqB,CACnC,YAA0C,EAC1C,IAAc;IAEd,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,YAAY,CAAC,SAAS,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9E,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EACJ,0BAA0B,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI;gBACjE,oBAAoB,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE;YAClD,GAAG,EAAE,4BAA4B,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,iDAAiD;SACpH,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,CAAC,KAAK,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClE,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,6BAA6B,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,IAAI,CAAC,IAAI,EAAE;YACrG,GAAG,EAAE,oCAAoC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;SAC3E,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;QACzE,IAAI,KAAK,GAAG,YAAY,CAAC,YAAY,EAAE,CAAC;YACtC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,oBAAoB,YAAY,CAAC,YAAY,wBAAwB,IAAI,CAAC,WAAW,EAAE;gBAC/F,GAAG,EAAE,sBAAsB,YAAY,CAAC,YAAY,YAAY;aACjE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @kraken-e2e/contracts — zero-runtime-dependency SPI (ADR-0001 §5.3, ADR-0002).
+ *
+ * The hexagonal boundary every plugin compiles against: driver/reporter
+ * interfaces, the core session surface, event types, error codes, host
+ * detection contracts, and CONTRACT_VERSION. Drivers peer-depend on THIS
+ * package, never on @kraken-e2e/core, so core ships majors freely (ADR-0001 §5.10).
+ *
+ * The signal-transport SPI is owned by @kraken-e2e/signaling and re-exported here
+ * type-only (erased at runtime — this package keeps zero runtime imports).
+ */
+export type { SignalPayload, SignalRecord, SignalScope, SignalTransport, } from '@kraken-e2e/signaling';
+export { type DoctorCheck, type DoctorCheckResult, type DoctorStatus, DRIVER_BRAND, type DriverEmission, type DriverManifest, type DriverServices, type DriverSpec, defineDriver, isKrakenDriver, type KrakenDriver, type Logger, type ResolvedActor, } from './driver.js';
+export { KrakenError, type KrakenErrorCode, KrakenErrorCodes, type SerializedKrakenError, serializeError, } from './errors.js';
+export type { ActorSummary, KrakenEvent, KrakenEventBase, KrakenEventInput, KrakenEventType, RunStatus, StepStatus, } from './events.js';
+export { checkHostRequirements, type HostCheckResult, type HostContext, type HostInfo, type HostProbe, type HostRequirements, } from './host.js';
+export { defineReporter, type Reporter } from './reporter.js';
+export { type ArtifactRef, CORE_OPERATIONS, type CoreOperation, type KrakenNativeSessions, type SemanticKey, type SessionWaitOptions, type TargetLocator, type UserSession, type WaitState, } from './session.js';
+export { CONTRACT_VERSION, type ContractVersion, isContractCompatible } from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,YAAY,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,YAAY,EACZ,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,KAAK,eAAe,EACpB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EACL,KAAK,WAAW,EAChB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @kraken-e2e/contracts — zero-runtime-dependency SPI (ADR-0001 §5.3, ADR-0002).
+ *
+ * The hexagonal boundary every plugin compiles against: driver/reporter
+ * interfaces, the core session surface, event types, error codes, host
+ * detection contracts, and CONTRACT_VERSION. Drivers peer-depend on THIS
+ * package, never on @kraken-e2e/core, so core ships majors freely (ADR-0001 §5.10).
+ *
+ * The signal-transport SPI is owned by @kraken-e2e/signaling and re-exported here
+ * type-only (erased at runtime — this package keeps zero runtime imports).
+ */
+export { DRIVER_BRAND, defineDriver, isKrakenDriver, } from './driver.js';
+export { KrakenError, KrakenErrorCodes, serializeError, } from './errors.js';
+export { checkHostRequirements, } from './host.js';
+export { defineReporter } from './reporter.js';
+export { CORE_OPERATIONS, } from './session.js';
+export { CONTRACT_VERSION, isContractCompatible } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,OAAO,EAIL,YAAY,EAKZ,YAAY,EACZ,cAAc,GAIf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EAEX,gBAAgB,EAEhB,cAAc,GACf,MAAM,aAAa,CAAC;AAUrB,OAAO,EACL,qBAAqB,GAMtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAiB,MAAM,eAAe,CAAC;AAC9D,OAAO,EAEL,eAAe,GAQhB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAwB,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/reporter.d.ts

@@ -0,0 +1,15 @@
+import type { KrakenEvent } from './events.js';
+/**
+ * Reporters are single-method subscribers of the serialized event stream
+ * (ADR-0001 §5.12): transport-symmetric — identical whether the subscriber is
+ * Allure in-process, a JSONL file sink, or a future GUI over WebSocket.
+ */
+export interface Reporter {
+    readonly id: string;
+    onEvent(event: KrakenEvent): void | Promise<void>;
+    /** Awaited at run end — drain buffers, close files. */
+    flush?(): Promise<void>;
+}
+/** Identity helper for symmetry with defineDriver (and future branding). */
+export declare function defineReporter(reporter: Reporter): Reporter;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,uDAAuD;IACvD,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAE3D"}

package/dist/reporter.js

@@ -0,0 +1,5 @@
+/** Identity helper for symmetry with defineDriver (and future branding). */
+export function defineReporter(reporter) {
+    return reporter;
+}
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAcA,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,QAAkB;IAC/C,OAAO,QAAQ,CAAC;AAClB,CAAC"}