askui 0.12.0 → 0.12.2

package/dist/cjs/core/reporting/default-step.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DefaultStep = void 0;
+const lodash_1 = require("lodash");
 const control_command_error_1 = require("../../execution/control-command-error");
 class DefaultStep {
     constructor(instruction) {
@@ -53,18 +54,18 @@ class DefaultStep {
                 status: 'running',
                 begin: snapshot,
             }];
-        return this;
+        return (0, lodash_1.cloneDeep)(this);
     }
     onRetry(snapshot, error) {
         this.onEnd(snapshot, error);
         this.onBegin(snapshot);
-        return this;
+        return (0, lodash_1.cloneDeep)(this);
     }
     onEnd(snapshot, error) {
         this.runs = [...this.runs.slice(0, -1), Object.assign(Object.assign({}, this.lastRun), { status: DefaultStep.determineLastRunStatus(error), end: snapshot, error, 
                 // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                 duration: snapshot.createdAt.getTime() - this.lastRun.begin.createdAt.getTime() })];
-        return this;
+        return (0, lodash_1.cloneDeep)(this);
     }
     static determineLastRunStatus(error) {
         if (error instanceof control_command_error_1.ControlCommandError) {

package/dist/cjs/core/reporting/index.d.ts

@@ -1,4 +1,3 @@
-export * from './default-reporter';
 export * from './instruction';
 export * from './reporter-config';
 export * from './reporter';

package/dist/cjs/core/reporting/index.js

@@ -10,7 +10,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./default-reporter"), exports);
 __exportStar(require("./instruction"), exports);
 __exportStar(require("./reporter-config"), exports);
 __exportStar(require("./reporter"), exports);

package/dist/cjs/core/reporting/snapshot-detail-level.d.ts

@@ -19,3 +19,4 @@ export declare type SnapshotDetailLevel =
  *  before and after a step has been run no matter if it failed or not for debugging.
  */
 'always';
+export declare function maxSnapshotDetailLevel(...levels: SnapshotDetailLevel[]): SnapshotDetailLevel;

package/dist/cjs/core/reporting/snapshot-detail-level.js

@@ -1,2 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.maxSnapshotDetailLevel = void 0;
+const levelsOrdered = ['required', 'onFailure', 'begin', 'always'];
+const levelValues = levelsOrdered.reduce((acc, level, index) => (Object.assign(Object.assign({}, acc), { [level]: index })), {});
+function maxSnapshotDetailLevel(...levels) {
+    var _a;
+    return (_a = levelsOrdered[Math.max(...levels.map((level) => levelValues[level]))]) !== null && _a !== void 0 ? _a : 'required';
+}
+exports.maxSnapshotDetailLevel = maxSnapshotDetailLevel;

package/dist/cjs/core/reporting/step-reporter.d.ts

@@ -4,13 +4,14 @@ import { Reporter } from './reporter';
 import { ReporterConfig } from './reporter-config';
 import { DefaultStep } from './default-step';
 export declare class StepReporter {
-    private reporter;
-    currentStep?: DefaultStep | undefined;
-    constructor(reporter: Required<Reporter> & {
-        config: Required<ReporterConfig>;
-    });
-    get config(): Required<ReporterConfig>;
+    private _currentStep?;
+    private reporters;
+    readonly config: Required<ReporterConfig>;
+    constructor(reporter?: Reporter | Reporter[] | undefined);
+    flush(): Promise<void>;
+    get currentStep(): DefaultStep | undefined;
     resetStep(instruction: Instruction): void;
+    private enqueueReporterCalls;
     onStepBegin(snapshot: Snapshot): Promise<void>;
     onStepRetry(snapshot: Snapshot, error: Error): Promise<void>;
     onStepEnd(snapshot: Snapshot, error?: Error): Promise<void>;

package/dist/cjs/core/reporting/step-reporter.js

@@ -12,68 +12,83 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StepReporter = void 0;
 const default_step_1 = require("./default-step");
 const logger_1 = require("../../lib/logger");
+const snapshot_detail_level_1 = require("./snapshot-detail-level");
+function buildReportersWithPromiseQueue(reporter) {
+    if (reporter === undefined) {
+        return [];
+    }
+    if (Array.isArray(reporter)) {
+        return reporter.map((r) => ({
+            reporter: r,
+            promiseQueue: Promise.resolve(),
+        }));
+    }
+    return [
+        {
+            reporter,
+            promiseQueue: Promise.resolve(),
+        },
+    ];
+}
 class StepReporter {
     constructor(reporter) {
-        this.reporter = reporter;
+        this.reporters = buildReportersWithPromiseQueue(reporter);
+        this.config = {
+            withScreenshots: (0, snapshot_detail_level_1.maxSnapshotDetailLevel)(...this.reporters.map((r) => { var _a, _b; return (_b = (_a = r.reporter.config) === null || _a === void 0 ? void 0 : _a.withScreenshots) !== null && _b !== void 0 ? _b : 'onFailure'; })),
+            withDetectedElements: (0, snapshot_detail_level_1.maxSnapshotDetailLevel)(...this.reporters.map((r) => { var _a, _b; return (_b = (_a = r.reporter.config) === null || _a === void 0 ? void 0 : _a.withDetectedElements) !== null && _b !== void 0 ? _b : 'onFailure'; })),
+        };
     }
-    get config() {
-        return this.reporter.config;
+    flush() {
+        return Promise.all(this.reporters.map((reporter) => reporter.promiseQueue)).then(() => { });
+    }
+    get currentStep() {
+        return this._currentStep;
     }
     resetStep(instruction) {
-        this.currentStep = new default_step_1.DefaultStep(instruction);
+        this._currentStep = new default_step_1.DefaultStep(instruction);
+    }
+    enqueueReporterCalls(type, step) {
+        this.reporters = this.reporters.map((reporter) => (Object.assign(Object.assign({}, reporter), { promiseQueue: reporter.promiseQueue
+                .then(() => { var _a, _b, _c; return (_c = (_b = (_a = reporter.reporter)[type]) === null || _b === void 0 ? void 0 : _b.call(_a, step)) !== null && _c !== void 0 ? _c : Promise.resolve(); })
+                .catch((error) => {
+                logger_1.logger.error(error);
+                return Promise.resolve();
+            }) })));
     }
     onStepBegin(snapshot) {
-        var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
-            if (this.currentStep === undefined) {
+            if (this._currentStep === undefined) {
                 throw new Error('Cannot begin step if step is undefined.');
             }
-            if (this.currentStep.status !== 'pending') {
+            if (this._currentStep.status !== 'pending') {
                 throw new Error('Cannot begin step that is not pending.');
             }
-            this.currentStep.onBegin(snapshot);
-            try {
-                yield ((_b = (_a = this.reporter).onStepBegin) === null || _b === void 0 ? void 0 : _b.call(_a, this.currentStep));
-            }
-            catch (reporterError) {
-                logger_1.logger.error(reporterError);
-            }
+            this._currentStep = this._currentStep.onBegin(snapshot);
+            this.enqueueReporterCalls('onStepBegin', this._currentStep);
         });
     }
     onStepRetry(snapshot, error) {
-        var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
-            if (this.currentStep === undefined) {
+            if (this._currentStep === undefined) {
                 throw new Error('Cannot retry step if step is undefined.');
             }
-            if (this.currentStep.status !== 'running') {
+            if (this._currentStep.status !== 'running') {
                 throw new Error('Cannot retry step that has not been running.');
             }
-            this.currentStep.onRetry(snapshot, error);
-            try {
-                yield ((_b = (_a = this.reporter).onStepRetry) === null || _b === void 0 ? void 0 : _b.call(_a, this.currentStep));
-            }
-            catch (reporterError) {
-                logger_1.logger.error(reporterError);
-            }
+            this._currentStep = this._currentStep.onRetry(snapshot, error);
+            this.enqueueReporterCalls('onStepRetry', this._currentStep);
         });
     }
     onStepEnd(snapshot, error) {
-        var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
-            if (this.currentStep === undefined) {
+            if (this._currentStep === undefined) {
                 throw new Error('Cannot end step if step is undefined.');
             }
-            if (this.currentStep.status !== 'running') {
+            if (this._currentStep.status !== 'running') {
                 throw new Error('Cannot end step that has not been running.');
             }
-            this.currentStep.onEnd(snapshot, error);
-            try {
-                yield ((_b = (_a = this.reporter).onStepEnd) === null || _b === void 0 ? void 0 : _b.call(_a, this.currentStep));
-            }
-            catch (reporterError) {
-                logger_1.logger.error(reporterError);
-            }
+            this._currentStep = this._currentStep.onEnd(snapshot, error);
+            this.enqueueReporterCalls('onStepEnd', this._currentStep);
         });
     }
 }

package/dist/cjs/execution/ui-control-client-dependency-builder.d.ts

@@ -9,6 +9,5 @@ export declare class UiControlClientDependencyBuilder {
         executionRuntime: ExecutionRuntime;
         stepReporter: StepReporter;
     }>;
-    private static buildReporter;
     static getClientArgsWithDefaults(clientArgs: ClientArgs): Promise<ClientArgsWithDefaults>;
 }

package/dist/cjs/execution/ui-control-client-dependency-builder.js

@@ -49,22 +49,10 @@ class UiControlClientDependencyBuilder {
             };
         });
     }
-    static buildReporter(reporterArg) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        return {
-            config: {
-                withScreenshots: (_b = (_a = reporterArg === null || reporterArg === void 0 ? void 0 : reporterArg.config) === null || _a === void 0 ? void 0 : _a.withScreenshots) !== null && _b !== void 0 ? _b : reporting_1.DEFAULT_REPORTER.config.withScreenshots,
-                withDetectedElements: (_d = (_c = reporterArg === null || reporterArg === void 0 ? void 0 : reporterArg.config) === null || _c === void 0 ? void 0 : _c.withDetectedElements) !== null && _d !== void 0 ? _d : reporting_1.DEFAULT_REPORTER.config.withDetectedElements,
-            },
-            onStepBegin: (_f = (_e = reporterArg === null || reporterArg === void 0 ? void 0 : reporterArg.onStepBegin) === null || _e === void 0 ? void 0 : _e.bind(reporterArg)) !== null && _f !== void 0 ? _f : reporting_1.DEFAULT_REPORTER.onStepBegin.bind(reporting_1.DEFAULT_REPORTER),
-            onStepRetry: (_h = (_g = reporterArg === null || reporterArg === void 0 ? void 0 : reporterArg.onStepRetry) === null || _g === void 0 ? void 0 : _g.bind(reporterArg)) !== null && _h !== void 0 ? _h : reporting_1.DEFAULT_REPORTER.onStepRetry.bind(reporting_1.DEFAULT_REPORTER),
-            onStepEnd: (_k = (_j = reporterArg === null || reporterArg === void 0 ? void 0 : reporterArg.onStepEnd) === null || _j === void 0 ? void 0 : _j.bind(reporterArg)) !== null && _k !== void 0 ? _k : reporting_1.DEFAULT_REPORTER.onStepEnd.bind(reporting_1.DEFAULT_REPORTER),
-        };
-    }
     static getClientArgsWithDefaults(clientArgs) {
         var _a, _b, _c, _d;
         return __awaiter(this, void 0, void 0, function* () {
-            return Object.assign(Object.assign({}, clientArgs), { uiControllerUrl: (_a = clientArgs.uiControllerUrl) !== null && _a !== void 0 ? _a : 'http://127.0.0.1:6769', inferenceServerUrl: (_b = clientArgs.inferenceServerUrl) !== null && _b !== void 0 ? _b : 'https://inference.askui.com', credentials: (_c = clientArgs.credentials) !== null && _c !== void 0 ? _c : (0, read_environment_credentials_1.envCredentials)(), proxyAgents: (_d = clientArgs.proxyAgents) !== null && _d !== void 0 ? _d : yield (0, proxy_builder_1.envProxyAgents)(), reporter: UiControlClientDependencyBuilder.buildReporter(clientArgs.reporter) });
+            return Object.assign(Object.assign({}, clientArgs), { uiControllerUrl: (_a = clientArgs.uiControllerUrl) !== null && _a !== void 0 ? _a : 'http://127.0.0.1:6769', inferenceServerUrl: (_b = clientArgs.inferenceServerUrl) !== null && _b !== void 0 ? _b : 'https://inference.askui.com', credentials: (_c = clientArgs.credentials) !== null && _c !== void 0 ? _c : (0, read_environment_credentials_1.envCredentials)(), proxyAgents: (_d = clientArgs.proxyAgents) !== null && _d !== void 0 ? _d : yield (0, proxy_builder_1.envProxyAgents)() });
         });
     }
 }

package/dist/cjs/execution/ui-controller-client-interface.d.ts

@@ -1,7 +1,7 @@
 import { CredentialArgs } from './credentials-args';
 import { ProxyAgentArgs } from '../shared/proxy-agent-args';
 import { ModelCompositionBranch } from './model-composition-branch';
-import { Reporter, ReporterConfig } from '../core/reporting';
+import { Reporter } from '../core/reporting';
 /**
  * Configuration options for the askui UI Control Client
  *
@@ -21,7 +21,8 @@ import { Reporter, ReporterConfig } from '../core/reporting';
  * the authentication of the askui Inference Server.
  * You have three options: `DISABLED`, `ON_FAILURE`, `ALL`.
  * @param {ProxyAgentArgs} proxyAgents - To configure the proxy agents for http(s) requests.
- * @param {Reporter} reporter - To configure the reporter to report on step runs.
+ * @param {Reporter | Reporter[]} reporter - To configure the reporter(s)
+ *  to report on step runs/executions.
  */
 export interface ClientArgs {
     readonly uiControllerUrl?: string;
@@ -30,12 +31,9 @@ export interface ClientArgs {
     readonly proxyAgents?: ProxyAgentArgs | undefined;
     readonly resize?: number;
     readonly modelComposition?: ModelCompositionBranch[];
-    readonly reporter?: Reporter | undefined;
+    readonly reporter?: Reporter | Reporter[] | undefined;
 }
 export interface ClientArgsWithDefaults extends ClientArgs {
     readonly uiControllerUrl: string;
     readonly inferenceServerUrl: string;
-    readonly reporter: Required<Reporter> & {
-        config: Required<ReporterConfig>;
-    };
 }

package/dist/cjs/utils/base_64_image/base-64-image.d.ts

@@ -1,18 +1,15 @@
-/// <reference types="node" />
+import type sharp from 'sharp';
 export declare class Base64Image {
-    private readonly aSharp;
-    private info;
     private buffer;
     static readonly strPrefix = "data:image/png;base64,";
+    private _sharp?;
     private constructor();
-    private static fromSharp;
     static fromPathOrString(pathOrStr: string): Promise<Base64Image>;
-    static fromPath(path: string): Promise<Base64Image>;
+    static fromPath(filePath: string): Promise<Base64Image>;
     static fromString(str: string): Promise<Base64Image>;
-    static fromBuffer(buffer: Buffer): Promise<Base64Image>;
-    get width(): number;
-    get height(): number;
+    private static fromBuffer;
+    private getSharp;
+    getInfo(): Promise<sharp.OutputInfo>;
     resizeToFitInto(dimension: number): Promise<Base64Image>;
     toString(): string;
-    toBuffer(): Buffer;
 }

package/dist/cjs/utils/base_64_image/base-64-image.js

@@ -13,36 +13,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Base64Image = void 0;
-const sharp_1 = __importDefault(require("sharp"));
+const fs_1 = __importDefault(require("fs"));
+const sharp_1 = require("./sharp");
 const base_64_image_string_error_1 = require("./base-64-image-string-error");
 class Base64Image {
-    constructor(aSharp, info, buffer) {
-        this.aSharp = aSharp;
-        this.info = info;
+    constructor(buffer) {
         this.buffer = buffer;
     }
-    static fromSharp(s) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { info, data } = yield s.toBuffer({ resolveWithObject: true });
-            return new Base64Image(s, info, data);
-        });
-    }
     static fromPathOrString(pathOrStr) {
         return __awaiter(this, void 0, void 0, function* () {
-            try {
-                return yield Base64Image.fromString(pathOrStr);
-            }
-            catch (error) {
-                if (!(error instanceof base_64_image_string_error_1.Base64ImageStringError)) {
-                    throw error;
-                }
+            if (pathOrStr.startsWith(Base64Image.strPrefix)) {
+                return Base64Image.fromString(pathOrStr);
             }
             return Base64Image.fromPath(pathOrStr);
         });
     }
-    static fromPath(path) {
+    static fromPath(filePath) {
         return __awaiter(this, void 0, void 0, function* () {
-            return Base64Image.fromSharp((0, sharp_1.default)(path));
+            const data = yield fs_1.default.promises.readFile(filePath, 'base64');
+            return Base64Image.fromString(`${Base64Image.strPrefix}${data}`);
         });
     }
     static fromString(str) {
@@ -51,36 +40,46 @@ class Base64Image {
                 throw new base_64_image_string_error_1.Base64ImageStringError(str, Base64Image.strPrefix);
             }
             const data = str.substring(Base64Image.strPrefix.length);
-            return Base64Image.fromSharp((0, sharp_1.default)(Buffer.from(data, 'base64')));
+            return new Base64Image(Buffer.from(data, 'base64'));
         });
     }
     static fromBuffer(buffer) {
         return __awaiter(this, void 0, void 0, function* () {
-            return Base64Image.fromSharp((0, sharp_1.default)(buffer));
+            return new Base64Image(buffer);
         });
     }
-    get width() {
-        return this.info.width;
+    getSharp() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._sharp === undefined) {
+                const createSharp = yield (0, sharp_1.getSharpFactory)();
+                this._sharp = createSharp(this.buffer);
+            }
+            return this._sharp;
+        });
     }
-    get height() {
-        return this.info.height;
+    getInfo() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (yield this.getSharp())
+                .toBuffer({ resolveWithObject: true })
+                .then(({ info }) => info);
+        });
     }
     resizeToFitInto(dimension) {
         return __awaiter(this, void 0, void 0, function* () {
-            const buffer = yield this.aSharp.resize({
-                width: this.width >= this.height ? dimension : undefined,
-                height: this.height > this.width ? dimension : undefined,
-                fit: sharp_1.default.fit.contain,
-            }).toBuffer();
+            const { width, height } = yield this.getInfo();
+            const buffer = yield (yield this.getSharp())
+                .resize({
+                width: width >= height ? dimension : undefined,
+                height: height > width ? dimension : undefined,
+                fit: 'contain',
+            })
+                .toBuffer();
             return Base64Image.fromBuffer(buffer);
         });
     }
     toString() {
         return `${Base64Image.strPrefix}${this.buffer.toString('base64')}`;
     }
-    toBuffer() {
-        return this.buffer;
-    }
 }
 exports.Base64Image = Base64Image;
 Base64Image.strPrefix = 'data:image/png;base64,';

package/dist/cjs/utils/base_64_image/sharp.d.ts

@@ -0,0 +1,2 @@
+import type sharp from 'sharp';
+export declare function getSharpFactory(): Promise<typeof sharp>;

package/dist/cjs/utils/base_64_image/sharp.js

@@ -0,0 +1,56 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSharpFactory = void 0;
+let lazilyInitializedSharpFactory;
+class SharpImportError extends Error {
+}
+function dynamicallyImportSharp() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const sharp = yield Promise.resolve().then(() => __importStar(require('sharp')));
+            return sharp.default;
+        }
+        catch (err) {
+            throw new SharpImportError('Can\'t find "sharp" module to do resizing of image!'
+                + ' Please, install sharp for resizing support with'
+                + ' "npm install --save-dev sharp" or "npm install --save sharp".');
+        }
+    });
+}
+function getSharpFactory() {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (lazilyInitializedSharpFactory === undefined) {
+            lazilyInitializedSharpFactory = yield dynamicallyImportSharp();
+        }
+        return lazilyInitializedSharpFactory;
+    });
+}
+exports.getSharpFactory = getSharpFactory;

package/dist/cjs/utils/proxy/proxy-builder.js

@@ -40,7 +40,9 @@ function dynmicImportHpagent() {
             return yield Promise.resolve().then(() => __importStar(require('hpagent')));
         }
         catch (err) {
-            throw new ProxyImportError('Can\'t find "hpagent" module to configure proxy! Please, install hpagent for proxy support with "npm install --save-dev hpagent".');
+            throw new ProxyImportError('Can\'t find "hpagent" module to configure proxy!'
+                + ' Please, install hpagent for proxy support with'
+                + ' "npm install --save-dev hpagent" or "npm install --save hpagent".');
         }
     });
 }

package/dist/cjs/utils/transformations.js

@@ -28,13 +28,15 @@ function resizeBase64ImageWithSameRatio(base64ImageString, maxEdge = 1400) {
         lib_1.logger.debug('Image resizing');
         try {
             const image = yield base_64_image_1.Base64Image.fromString(base64ImageString);
-            if (image.height <= maxEdge && image.width <= maxEdge) {
+            const imageInfo = yield image.getInfo();
+            if (imageInfo.height <= maxEdge && imageInfo.width <= maxEdge) {
                 return { base64Image: base64ImageString, resizeRatio: 1 };
             }
             const resizedImage = yield image.resizeToFitInto(maxEdge);
+            const resizedImageInfo = yield resizedImage.getInfo();
             return {
                 base64Image: resizedImage.toString(),
-                resizeRatio: image.width / resizedImage.width,
+                resizeRatio: imageInfo.width / resizedImageInfo.width,
             };
         }
         catch (error) {

package/dist/esm/core/reporting/default-step.js

@@ -1,3 +1,4 @@
+import { cloneDeep } from 'lodash';
 import { ControlCommandError } from '../../execution/control-command-error';
 export class DefaultStep {
     constructor(instruction) {
@@ -50,18 +51,18 @@ export class DefaultStep {
                 status: 'running',
                 begin: snapshot,
             }];
-        return this;
+        return cloneDeep(this);
     }
     onRetry(snapshot, error) {
         this.onEnd(snapshot, error);
         this.onBegin(snapshot);
-        return this;
+        return cloneDeep(this);
     }
     onEnd(snapshot, error) {
         this.runs = [...this.runs.slice(0, -1), Object.assign(Object.assign({}, this.lastRun), { status: DefaultStep.determineLastRunStatus(error), end: snapshot, error, 
                 // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                 duration: snapshot.createdAt.getTime() - this.lastRun.begin.createdAt.getTime() })];
-        return this;
+        return cloneDeep(this);
     }
     static determineLastRunStatus(error) {
         if (error instanceof ControlCommandError) {

package/dist/esm/core/reporting/index.d.ts

@@ -1,4 +1,3 @@
-export * from './default-reporter';
 export * from './instruction';
 export * from './reporter-config';
 export * from './reporter';

package/dist/esm/core/reporting/index.js

@@ -1,4 +1,3 @@
-export * from './default-reporter';
 export * from './instruction';
 export * from './reporter-config';
 export * from './reporter';

package/dist/esm/core/reporting/snapshot-detail-level.d.ts

@@ -19,3 +19,4 @@ export declare type SnapshotDetailLevel =
  *  before and after a step has been run no matter if it failed or not for debugging.
  */
 'always';
+export declare function maxSnapshotDetailLevel(...levels: SnapshotDetailLevel[]): SnapshotDetailLevel;

package/dist/esm/core/reporting/snapshot-detail-level.js

@@ -1 +1,6 @@
-export {};
+const levelsOrdered = ['required', 'onFailure', 'begin', 'always'];
+const levelValues = levelsOrdered.reduce((acc, level, index) => (Object.assign(Object.assign({}, acc), { [level]: index })), {});
+export function maxSnapshotDetailLevel(...levels) {
+    var _a;
+    return (_a = levelsOrdered[Math.max(...levels.map((level) => levelValues[level]))]) !== null && _a !== void 0 ? _a : 'required';
+}

package/dist/esm/core/reporting/step-reporter.d.ts

@@ -4,13 +4,14 @@ import { Reporter } from './reporter';
 import { ReporterConfig } from './reporter-config';
 import { DefaultStep } from './default-step';
 export declare class StepReporter {
-    private reporter;
-    currentStep?: DefaultStep | undefined;
-    constructor(reporter: Required<Reporter> & {
-        config: Required<ReporterConfig>;
-    });
-    get config(): Required<ReporterConfig>;
+    private _currentStep?;
+    private reporters;
+    readonly config: Required<ReporterConfig>;
+    constructor(reporter?: Reporter | Reporter[] | undefined);
+    flush(): Promise<void>;
+    get currentStep(): DefaultStep | undefined;
     resetStep(instruction: Instruction): void;
+    private enqueueReporterCalls;
     onStepBegin(snapshot: Snapshot): Promise<void>;
     onStepRetry(snapshot: Snapshot, error: Error): Promise<void>;
     onStepEnd(snapshot: Snapshot, error?: Error): Promise<void>;