@opentap/runner-client 4.9.0-beta.1.40294477159 → 4.9.0-beta.3.41598982309

package/dist/cjs/DTOs.d.ts

@@ -107,6 +107,7 @@ export interface ISession {
 /**
  * Where a session's image comes from. The concrete type is named by the `ProvisionType` property on the wire.
  * Each type replaces one part of the session's image; the other parts stay what the session has.
+ * An image that is not the one the session has is installed into the session, which is restarted on it.
  */
 export declare abstract class SessionProvision {
     protected _discriminator: string;
@@ -115,7 +116,10 @@ export declare abstract class SessionProvision {
     static fromJS(data: any): SessionProvision;
     toJSON(data?: any): any;
 }
-/** Uses `image` on top of the Runner's default image. The session keeps its test plan and settings. */
+/**
+ * Uses `image` on top of the Runner's default image. The session keeps its test plan and settings, but their
+ * dependencies are not added to the image.
+ */
 export declare class ExactProvision extends SessionProvision implements IExactProvision {
     /** Packages that replace the session's packages, combined with the Runner's default image. */
     image?: Image | undefined;
@@ -163,9 +167,22 @@ export declare class TestPlanReferenceProvision extends SessionProvision impleme
 export interface ITestPlanReferenceProvision {
     testPlanReference?: RepositoryPackageReference | undefined;
 }
+/**
+ * Replaces the session's test plan with an empty one. The session has no test plan reference afterwards, and the
+ * dependencies of its previous test plan are no longer part of the image.
+ */
+export declare class EmptyTestPlanProvision extends SessionProvision implements IEmptyTestPlanProvision {
+    constructor(data?: IEmptyTestPlanProvision);
+    static fromJS(data: any): EmptyTestPlanProvision;
+}
+export interface IEmptyTestPlanProvision {
+}
 /** Configuration of an existing session, sent to ConfigureSession. A property that is undefined keeps the session's current value. */
 export declare class SessionConfiguration implements ISessionConfiguration {
-    /** The image the session asks for. The session must be idle. */
+    /**
+     * The image the session asks for. The session must be idle. If it is not the image the session has, the Runner installs it
+     * into the session and restarts the session on it before it loads anything. That needs OpenTAP 9.31 or newer on the Runner.
+     */
     provision?: SessionProvision | undefined;
     /** An empty title removes the title. */
     title?: string | undefined;
@@ -188,30 +205,56 @@ export interface ISessionConfiguration {
         [key: string]: string;
     } | undefined;
 }
-/** Published by the Runner after every successful ConfigureSession request. */
-export declare class SessionConfigurationChangedEvent implements ISessionConfigurationChangedEvent {
+/** Published by the Runner as a ConfigureSession request progresses. */
+export declare class SessionConfigurationProgressEvent implements ISessionConfigurationProgressEvent {
+    sessionId?: string | undefined;
+    progress?: SessionConfigurationProgress | undefined;
+    constructor(data?: ISessionConfigurationProgressEvent);
+    init(_data?: any): void;
+    static fromJS(data: any): SessionConfigurationProgressEvent;
+    toJSON(data?: any): any;
+}
+export interface ISessionConfigurationProgressEvent {
+    sessionId?: string | undefined;
+    progress?: SessionConfigurationProgress | undefined;
+}
+/** What happened to a ConfigureSession request. The concrete type is named by the `ProgressType` property on the wire. */
+export declare abstract class SessionConfigurationProgress {
+    protected _discriminator: string;
+    constructor();
+    init(_data?: any): void;
+    static fromJS(data: any): SessionConfigurationProgress;
+    toJSON(data?: any): any;
+}
+/** The Runner accepted the request and is applying it. */
+export declare class SessionConfigurationStarted extends SessionConfigurationProgress implements ISessionConfigurationStarted {
+    constructor(data?: ISessionConfigurationStarted);
+    static fromJS(data: any): SessionConfigurationStarted;
+}
+export interface ISessionConfigurationStarted {
+}
+/** The session is configured. */
+export declare class SessionConfigurationSucceeded extends SessionConfigurationProgress implements ISessionConfigurationSucceeded {
     /** The session after the change, as GetSessions reports it. */
     session?: Session | undefined;
-    constructor(data?: ISessionConfigurationChangedEvent);
+    constructor(data?: ISessionConfigurationSucceeded);
     init(_data?: any): void;
-    static fromJS(data: any): SessionConfigurationChangedEvent;
+    static fromJS(data: any): SessionConfigurationSucceeded;
     toJSON(data?: any): any;
 }
-export interface ISessionConfigurationChangedEvent {
+export interface ISessionConfigurationSucceeded {
     session?: Session | undefined;
 }
-/** Published by the Runner when it accepted a ConfigureSession request with a `provision`, and could not complete it. */
-export declare class SessionConfigurationFailedEvent implements ISessionConfigurationFailedEvent {
-    sessionId?: string | undefined;
+/** The Runner accepted the request, and could not complete it. */
+export declare class SessionConfigurationFailed extends SessionConfigurationProgress implements ISessionConfigurationFailed {
     /** Why the configuration failed. For people to read; do not parse it. */
     message?: string | undefined;
-    constructor(data?: ISessionConfigurationFailedEvent);
+    constructor(data?: ISessionConfigurationFailed);
     init(_data?: any): void;
-    static fromJS(data: any): SessionConfigurationFailedEvent;
+    static fromJS(data: any): SessionConfigurationFailed;
     toJSON(data?: any): any;
 }
-export interface ISessionConfigurationFailedEvent {
-    sessionId?: string | undefined;
+export interface ISessionConfigurationFailed {
     message?: string | undefined;
 }
 export declare class Links implements ILinks {

package/dist/cjs/DTOs.js

@@ -26,9 +26,9 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileDescriptor = exports.Resource = exports.PluginTypeSelectorControl = exports.PictureControl = exports.PasswordControl = exports.MultiSelectControl = exports.DropdownControl = exports.EnabledControl = exports.DirectoryPathControl = exports.FilePathControl = exports.ComboBoxControl = exports.TextBoxControl = exports.DataGridControl = exports.DataGridReferenceControl = exports.CheckBoxControl = exports.AvailableValue = exports.ButtonsControl = exports.ButtonControl = exports.ExternalParameter = exports.MetaData = exports.DisplayAttribute = exports.VisualStatus = exports.UnitAttribute = exports.Icon = exports.ColumnDisplayName = exports.LayoutMode = exports.Layout = exports.Setting = exports.ComponentSettingsListItem = exports.AnnotatedObject = exports.ComponentSettingsList = exports.DisplayMode = exports.ComponentSettingsIdentifier = exports.ComponentSettingsBase = exports.Links = exports.SessionConfigurationFailedEvent = exports.SessionConfigurationChangedEvent = exports.SessionConfiguration = exports.TestPlanReferenceProvision = exports.SettingsProvision = exports.AdditionalPackagesProvision = exports.ExactProvision = exports.SessionProvision = exports.Session = exports.LifecyclePolicy = exports.ImageResolveErrorResponse = exports.NoResponderError = exports.ErrorResponse = exports.PackageSpecifier = exports.Image = void 0;
-exports.SessionMetricInfo = exports.MetricsPollRate = exports.SessionMetricType = exports.SessionMetricKind = exports.ResultColumn = exports.Result = exports.LogEvent = exports.TestStepRun = exports.WatchDog = exports.Parameter = exports.BreakPoints = exports.InstalledFile = exports.Interaction = exports.CommonContext = exports.CommonSettings = exports.ValidationError = exports.TestStepValidationError = exports.TestStepCopy = exports.TestStepType = exports.TestStep = exports.TestPlan = exports.SessionState = exports.Verdict = exports.EditStatus = exports.RunStatus = exports.MissingLicenseResponse = exports.LogEntry = exports.LogList = exports.ApiException = exports.ImageCreationFailed = exports.ImageCreated = exports.ImageCreating = exports.ImageEventArgs = exports.SessionInactivityLimitHit = exports.SessionShutdownFailed = exports.SessionShutdown = exports.SessionShutdownInitiated = exports.SessionStartFailed = exports.SessionStarted = exports.SessionStartInitiated = exports.SessionEventArgs = exports.SettingsTapPackage = exports.SaveTestPlanToRepositoryResponse = exports.GetTestPlanReferenceResponse = exports.RepositorySettingsPackageDefinition = exports.RepositoryPackageDefinition = exports.RepositoryPackageReference = exports.ProfileGroup = exports.ListItemType = exports.ComponentSettings = void 0;
-exports.AssetDiscoveryResponse = exports.AssetDiscoveryResult = exports.DiscoveredAsset = exports.EnableMetricsPollingResponse = exports.GetLocalTestPlansResponse = exports.RunnerStatus = exports.StreamInfoStatus = exports.RemoteConnection = exports.SaveDefaultSettings = exports.AssetUpdatedEvent = exports.MetadataUpdatedEvent = exports.RunnerDeletedEvent = exports.RunnerUpdatedEvent = exports.RunnerRegisteredEvent = exports.RunnerEvent = exports.TestPlanRunCompletedEvent = exports.TestPlanRunStartEvent = exports.TestPlanRunEvent = exports.OnTestStepRun = exports.OnTestPlanRun = exports.RestartCompletedEvent = exports.RestartInitiatedEvent = exports.UserInputChangedEvent = exports.UserInputRequestCompletedEvent = exports.UserInputRequestedEvent = exports.BreakEvent = exports.TestStepChangedEvent = exports.SettingsChangedEvent = exports.HeartbeatEvent = exports.SessionStateChangedEvent = exports.TestPlanReferenceChangedEvent = exports.TestPlanChangedEvent = exports.StoppedEvent = exports.StoppingEvent = exports.StartedEvent = exports.StartingEvent = exports.SessionTimeoutEvent = exports.TestPlanSettingsChangedEvent = exports.TypeCacheInvalidatedEvent = exports.SessionEvent = exports.SessionEventName = exports.MetricValue = exports.MetricsConfiguration = void 0;
+exports.PasswordControl = exports.MultiSelectControl = exports.DropdownControl = exports.EnabledControl = exports.DirectoryPathControl = exports.FilePathControl = exports.ComboBoxControl = exports.TextBoxControl = exports.DataGridControl = exports.DataGridReferenceControl = exports.CheckBoxControl = exports.AvailableValue = exports.ButtonsControl = exports.ButtonControl = exports.ExternalParameter = exports.MetaData = exports.DisplayAttribute = exports.VisualStatus = exports.UnitAttribute = exports.Icon = exports.ColumnDisplayName = exports.LayoutMode = exports.Layout = exports.Setting = exports.ComponentSettingsListItem = exports.AnnotatedObject = exports.ComponentSettingsList = exports.DisplayMode = exports.ComponentSettingsIdentifier = exports.ComponentSettingsBase = exports.Links = exports.SessionConfigurationFailed = exports.SessionConfigurationSucceeded = exports.SessionConfigurationStarted = exports.SessionConfigurationProgress = exports.SessionConfigurationProgressEvent = exports.SessionConfiguration = exports.EmptyTestPlanProvision = exports.TestPlanReferenceProvision = exports.SettingsProvision = exports.AdditionalPackagesProvision = exports.ExactProvision = exports.SessionProvision = exports.Session = exports.LifecyclePolicy = exports.ImageResolveErrorResponse = exports.NoResponderError = exports.ErrorResponse = exports.PackageSpecifier = exports.Image = void 0;
+exports.ResultColumn = exports.Result = exports.LogEvent = exports.TestStepRun = exports.WatchDog = exports.Parameter = exports.BreakPoints = exports.InstalledFile = exports.Interaction = exports.CommonContext = exports.CommonSettings = exports.ValidationError = exports.TestStepValidationError = exports.TestStepCopy = exports.TestStepType = exports.TestStep = exports.TestPlan = exports.SessionState = exports.Verdict = exports.EditStatus = exports.RunStatus = exports.MissingLicenseResponse = exports.LogEntry = exports.LogList = exports.ApiException = exports.ImageCreationFailed = exports.ImageCreated = exports.ImageCreating = exports.ImageEventArgs = exports.SessionInactivityLimitHit = exports.SessionShutdownFailed = exports.SessionShutdown = exports.SessionShutdownInitiated = exports.SessionStartFailed = exports.SessionStarted = exports.SessionStartInitiated = exports.SessionEventArgs = exports.SettingsTapPackage = exports.SaveTestPlanToRepositoryResponse = exports.GetTestPlanReferenceResponse = exports.RepositorySettingsPackageDefinition = exports.RepositoryPackageDefinition = exports.RepositoryPackageReference = exports.ProfileGroup = exports.ListItemType = exports.ComponentSettings = exports.FileDescriptor = exports.Resource = exports.PluginTypeSelectorControl = exports.PictureControl = void 0;
+exports.AssetDiscoveryResponse = exports.AssetDiscoveryResult = exports.DiscoveredAsset = exports.EnableMetricsPollingResponse = exports.GetLocalTestPlansResponse = exports.RunnerStatus = exports.StreamInfoStatus = exports.RemoteConnection = exports.SaveDefaultSettings = exports.AssetUpdatedEvent = exports.MetadataUpdatedEvent = exports.RunnerDeletedEvent = exports.RunnerUpdatedEvent = exports.RunnerRegisteredEvent = exports.RunnerEvent = exports.TestPlanRunCompletedEvent = exports.TestPlanRunStartEvent = exports.TestPlanRunEvent = exports.OnTestStepRun = exports.OnTestPlanRun = exports.RestartCompletedEvent = exports.RestartInitiatedEvent = exports.UserInputChangedEvent = exports.UserInputRequestCompletedEvent = exports.UserInputRequestedEvent = exports.BreakEvent = exports.TestStepChangedEvent = exports.SettingsChangedEvent = exports.HeartbeatEvent = exports.SessionStateChangedEvent = exports.TestPlanReferenceChangedEvent = exports.TestPlanChangedEvent = exports.StoppedEvent = exports.StoppingEvent = exports.StartedEvent = exports.StartingEvent = exports.SessionTimeoutEvent = exports.TestPlanSettingsChangedEvent = exports.TypeCacheInvalidatedEvent = exports.SessionEvent = exports.SessionEventName = exports.MetricValue = exports.MetricsConfiguration = exports.SessionMetricInfo = exports.MetricsPollRate = exports.SessionMetricType = exports.SessionMetricKind = void 0;
 var Image = /** @class */ (function () {
     function Image(data) {
         this.packages = [];
@@ -256,6 +256,7 @@ exports.Session = Session;
 /**
  * Where a session's image comes from. The concrete type is named by the `ProvisionType` property on the wire.
  * Each type replaces one part of the session's image; the other parts stay what the session has.
+ * An image that is not the one the session has is installed into the session, which is restarted on it.
  */
 var SessionProvision = /** @class */ (function () {
     function SessionProvision() {
@@ -285,6 +286,11 @@ var SessionProvision = /** @class */ (function () {
             result.init(data);
             return result;
         }
+        if (data['ProvisionType'] === 'EmptyTestPlanProvision') {
+            var result = new EmptyTestPlanProvision();
+            result.init(data);
+            return result;
+        }
         throw new Error("The abstract class 'SessionProvision' cannot be instantiated.");
     };
     SessionProvision.prototype.toJSON = function (data) {
@@ -295,7 +301,10 @@ var SessionProvision = /** @class */ (function () {
     return SessionProvision;
 }());
 exports.SessionProvision = SessionProvision;
-/** Uses `image` on top of the Runner's default image. The session keeps its test plan and settings. */
+/**
+ * Uses `image` on top of the Runner's default image. The session keeps its test plan and settings, but their
+ * dependencies are not added to the image.
+ */
 var ExactProvision = /** @class */ (function (_super) {
     __extends(ExactProvision, _super);
     function ExactProvision(data) {
@@ -452,6 +461,32 @@ var TestPlanReferenceProvision = /** @class */ (function (_super) {
     return TestPlanReferenceProvision;
 }(SessionProvision));
 exports.TestPlanReferenceProvision = TestPlanReferenceProvision;
+/**
+ * Replaces the session's test plan with an empty one. The session has no test plan reference afterwards, and the
+ * dependencies of its previous test plan are no longer part of the image.
+ */
+var EmptyTestPlanProvision = /** @class */ (function (_super) {
+    __extends(EmptyTestPlanProvision, _super);
+    function EmptyTestPlanProvision(data) {
+        var _this = _super.call(this) || this;
+        if (data) {
+            for (var property in data) {
+                if (Object.prototype.hasOwnProperty.call(data, property))
+                    _this[property] = data[property];
+            }
+        }
+        _this._discriminator = 'EmptyTestPlanProvision';
+        return _this;
+    }
+    EmptyTestPlanProvision.fromJS = function (data) {
+        data = typeof data === 'object' ? data : {};
+        var result = new EmptyTestPlanProvision();
+        result.init(data);
+        return result;
+    };
+    return EmptyTestPlanProvision;
+}(SessionProvision));
+exports.EmptyTestPlanProvision = EmptyTestPlanProvision;
 /** Configuration of an existing session, sent to ConfigureSession. A property that is undefined keeps the session's current value. */
 var SessionConfiguration = /** @class */ (function () {
     function SessionConfiguration(data) {
@@ -487,9 +522,9 @@ var SessionConfiguration = /** @class */ (function () {
     return SessionConfiguration;
 }());
 exports.SessionConfiguration = SessionConfiguration;
-/** Published by the Runner after every successful ConfigureSession request. */
-var SessionConfigurationChangedEvent = /** @class */ (function () {
-    function SessionConfigurationChangedEvent(data) {
+/** Published by the Runner as a ConfigureSession request progresses. */
+var SessionConfigurationProgressEvent = /** @class */ (function () {
+    function SessionConfigurationProgressEvent(data) {
         if (data) {
             for (var property in data) {
                 if (Object.prototype.hasOwnProperty.call(data, property))
@@ -497,56 +532,154 @@ var SessionConfigurationChangedEvent = /** @class */ (function () {
             }
         }
     }
-    SessionConfigurationChangedEvent.prototype.init = function (_data) {
+    SessionConfigurationProgressEvent.prototype.init = function (_data) {
+        if (_data) {
+            this.sessionId = _data['SessionId'];
+            this.progress = _data['Progress'] ? SessionConfigurationProgress.fromJS(_data['Progress']) : undefined;
+        }
+    };
+    SessionConfigurationProgressEvent.fromJS = function (data) {
+        data = typeof data === 'object' ? data : {};
+        var result = new SessionConfigurationProgressEvent();
+        result.init(data);
+        return result;
+    };
+    SessionConfigurationProgressEvent.prototype.toJSON = function (data) {
+        data = typeof data === 'object' ? data : {};
+        data['SessionId'] = this.sessionId;
+        data['Progress'] = this.progress ? this.progress.toJSON() : undefined;
+        return data;
+    };
+    return SessionConfigurationProgressEvent;
+}());
+exports.SessionConfigurationProgressEvent = SessionConfigurationProgressEvent;
+/** What happened to a ConfigureSession request. The concrete type is named by the `ProgressType` property on the wire. */
+var SessionConfigurationProgress = /** @class */ (function () {
+    function SessionConfigurationProgress() {
+        this._discriminator = 'SessionConfigurationProgress';
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    SessionConfigurationProgress.prototype.init = function (_data) { };
+    SessionConfigurationProgress.fromJS = function (data) {
+        data = typeof data === 'object' ? data : {};
+        if (data['ProgressType'] === 'Started') {
+            var result = new SessionConfigurationStarted();
+            result.init(data);
+            return result;
+        }
+        if (data['ProgressType'] === 'Succeeded') {
+            var result = new SessionConfigurationSucceeded();
+            result.init(data);
+            return result;
+        }
+        if (data['ProgressType'] === 'Failed') {
+            var result = new SessionConfigurationFailed();
+            result.init(data);
+            return result;
+        }
+        throw new Error("The abstract class 'SessionConfigurationProgress' cannot be instantiated.");
+    };
+    SessionConfigurationProgress.prototype.toJSON = function (data) {
+        data = typeof data === 'object' ? data : {};
+        data['ProgressType'] = this._discriminator;
+        return data;
+    };
+    return SessionConfigurationProgress;
+}());
+exports.SessionConfigurationProgress = SessionConfigurationProgress;
+/** The Runner accepted the request and is applying it. */
+var SessionConfigurationStarted = /** @class */ (function (_super) {
+    __extends(SessionConfigurationStarted, _super);
+    function SessionConfigurationStarted(data) {
+        var _this = _super.call(this) || this;
+        if (data) {
+            for (var property in data) {
+                if (Object.prototype.hasOwnProperty.call(data, property))
+                    _this[property] = data[property];
+            }
+        }
+        _this._discriminator = 'Started';
+        return _this;
+    }
+    SessionConfigurationStarted.fromJS = function (data) {
+        data = typeof data === 'object' ? data : {};
+        var result = new SessionConfigurationStarted();
+        result.init(data);
+        return result;
+    };
+    return SessionConfigurationStarted;
+}(SessionConfigurationProgress));
+exports.SessionConfigurationStarted = SessionConfigurationStarted;
+/** The session is configured. */
+var SessionConfigurationSucceeded = /** @class */ (function (_super) {
+    __extends(SessionConfigurationSucceeded, _super);
+    function SessionConfigurationSucceeded(data) {
+        var _this = _super.call(this) || this;
+        if (data) {
+            for (var property in data) {
+                if (Object.prototype.hasOwnProperty.call(data, property))
+                    _this[property] = data[property];
+            }
+        }
+        _this._discriminator = 'Succeeded';
+        return _this;
+    }
+    SessionConfigurationSucceeded.prototype.init = function (_data) {
+        _super.prototype.init.call(this, _data);
         if (_data) {
             this.session = _data['Session'] ? Session.fromJS(_data['Session']) : undefined;
         }
     };
-    SessionConfigurationChangedEvent.fromJS = function (data) {
+    SessionConfigurationSucceeded.fromJS = function (data) {
         data = typeof data === 'object' ? data : {};
-        var result = new SessionConfigurationChangedEvent();
+        var result = new SessionConfigurationSucceeded();
         result.init(data);
         return result;
     };
-    SessionConfigurationChangedEvent.prototype.toJSON = function (data) {
+    SessionConfigurationSucceeded.prototype.toJSON = function (data) {
         data = typeof data === 'object' ? data : {};
+        _super.prototype.toJSON.call(this, data);
         data['Session'] = this.session ? this.session.toJSON() : undefined;
         return data;
     };
-    return SessionConfigurationChangedEvent;
-}());
-exports.SessionConfigurationChangedEvent = SessionConfigurationChangedEvent;
-/** Published by the Runner when it accepted a ConfigureSession request with a `provision`, and could not complete it. */
-var SessionConfigurationFailedEvent = /** @class */ (function () {
-    function SessionConfigurationFailedEvent(data) {
+    return SessionConfigurationSucceeded;
+}(SessionConfigurationProgress));
+exports.SessionConfigurationSucceeded = SessionConfigurationSucceeded;
+/** The Runner accepted the request, and could not complete it. */
+var SessionConfigurationFailed = /** @class */ (function (_super) {
+    __extends(SessionConfigurationFailed, _super);
+    function SessionConfigurationFailed(data) {
+        var _this = _super.call(this) || this;
         if (data) {
             for (var property in data) {
                 if (Object.prototype.hasOwnProperty.call(data, property))
-                    this[property] = data[property];
+                    _this[property] = data[property];
             }
         }
+        _this._discriminator = 'Failed';
+        return _this;
     }
-    SessionConfigurationFailedEvent.prototype.init = function (_data) {
+    SessionConfigurationFailed.prototype.init = function (_data) {
+        _super.prototype.init.call(this, _data);
         if (_data) {
-            this.sessionId = _data['SessionId'];
             this.message = _data['Message'];
         }
     };
-    SessionConfigurationFailedEvent.fromJS = function (data) {
+    SessionConfigurationFailed.fromJS = function (data) {
         data = typeof data === 'object' ? data : {};
-        var result = new SessionConfigurationFailedEvent();
+        var result = new SessionConfigurationFailed();
         result.init(data);
         return result;
     };
-    SessionConfigurationFailedEvent.prototype.toJSON = function (data) {
+    SessionConfigurationFailed.prototype.toJSON = function (data) {
         data = typeof data === 'object' ? data : {};
-        data['SessionId'] = this.sessionId;
+        _super.prototype.toJSON.call(this, data);
         data['Message'] = this.message;
         return data;
     };
-    return SessionConfigurationFailedEvent;
-}());
-exports.SessionConfigurationFailedEvent = SessionConfigurationFailedEvent;
+    return SessionConfigurationFailed;
+}(SessionConfigurationProgress));
+exports.SessionConfigurationFailed = SessionConfigurationFailed;
 var Links = /** @class */ (function () {
     function Links(data) {
         if (data) {

package/dist/cjs/RunnerClient.d.ts

@@ -1,6 +1,6 @@
 import { ConnectionOptions, Consumer, NatsError, Subscription, SubscriptionOptions } from 'nats.ws';
 import { AddLocalTestPlanRequest, ConfigureSessionRequest, DeleteSessionRequest, NewSessionRequest, RemoveLocalTestPlanRequest, ResumeSessionRequest, RunnerUpdateRequest } from './requestDTOs';
-import { ISession, ISessionMetricInfo, Image, MetadataUpdatedEvent, RepositoryPackageReference, RunnerStatus, SaveDefaultSettings, Session, SessionConfigurationChangedEvent, SessionConfigurationFailedEvent } from './DTOs';
+import { ISession, ISessionMetricInfo, Image, MetadataUpdatedEvent, RepositoryPackageReference, RunnerStatus, SaveDefaultSettings, Session, SessionConfigurationProgressEvent } from './DTOs';
 import { BaseClient } from './BaseClient';
 export declare class RunnerClient extends BaseClient {
     private runnerId;
@@ -44,12 +44,15 @@ export declare class RunnerClient extends BaseClient {
     /**
      * Changes the configuration of an existing session, running or stopped. A configuration property that is
      * undefined keeps the session's current value. Requires Runner v2.9 or later.
-     * With a `provision`, the session must be idle and the Runner responds once it accepted the request. It then publishes
-     * SessionConfigurationChanged or SessionConfigurationFailed; subscribe to both before sending the request.
+     * With a `provision`, the session must be idle and the Runner responds once it accepted the request. If the provision gives
+     * another image than the session has, the Runner installs it and restarts the session (OpenTAP 9.31 or newer on the Runner).
+     * The Runner reports what happened with SessionConfigurationProgress events: Started, then Succeeded or Failed, which for a
+     * provision can take minutes. Only a request for an unknown session, with an unknown value, or for a busy session gets an
+     * error response and no events. Subscribe before sending the request.
      * @param {ConfigureSessionRequest} configureSessionRequest
      * @returns {{Promise<void>}}
      */
-    configureSession(configureSessionRequest: ConfigureSessionRequest): Promise<void>;
+    configureSession(configureSessionRequest: ConfigureSessionRequest, timeout?: number): Promise<void>;
     /**
      * Create a OpenTAP package configuration image from a list image inputs consisting of user specified packages and repositories.
      * @param {Image[]} images List of images
@@ -105,7 +108,7 @@ export declare class RunnerClient extends BaseClient {
      * @param {NewSessionRequest} sessionRequest
      * @returns {{Promise<Session>}}
      */
-    newSession(sessionRequest?: NewSessionRequest): Promise<Session>;
+    newSession(sessionRequest?: NewSessionRequest, timeout?: number): Promise<Session>;
     /**
      * Resumes a stopped session as it is. A session that is not stopped is an error; change a session with {@link configureSession}.
      * @param {ResumeSessionRequest} resumeSessionRequest
@@ -116,7 +119,7 @@ export declare class RunnerClient extends BaseClient {
      * Start a session
      * @returns {{Promise<Session>}}
      */
-    startSession(): Promise<Session>;
+    startSession(timeout?: number): Promise<Session>;
     /**
      * Get the session manager image.
      * @returns {{Promise<Image>}}
@@ -127,7 +130,7 @@ export declare class RunnerClient extends BaseClient {
      * @param imageId
      * @returns {{Promise<Session>}}
      */
-    startImageSession(image: Image): Promise<Session>;
+    startImageSession(image: Image, timeout?: number): Promise<Session>;
     /**
      * Update the `Runner` plugin to the given version
      * @param runnerUpdateRequest
@@ -142,19 +145,13 @@ export declare class RunnerClient extends BaseClient {
      */
     connectMetadataUpdatedEvents(handler: (event: MetadataUpdatedEvent | undefined, err: NatsError | Error | null) => void, options?: SubscriptionOptions): Subscription;
     /**
-     * Subscribe to the SessionConfigurationChanged event, published after every successful ConfigureSession request
-     * @param  {(event:SessionConfigurationChangedEvent|undefined,err:NatsError|Error|null)=>void} handler
+     * Subscribe to the SessionConfigurationProgress event, published as a ConfigureSession request progresses:
+     * Started, then Succeeded with the session as it is after the change, or Failed with the reason
+     * @param  {(event:SessionConfigurationProgressEvent|undefined,err:NatsError|Error|null)=>void} handler
      * @param  {SubscriptionOptions} options?
      * @returns Subscription
      */
-    connectSessionConfigurationChangedEvents(handler: (event: SessionConfigurationChangedEvent | undefined, err: NatsError | Error | null) => void, options?: SubscriptionOptions): Subscription;
-    /**
-     * Subscribe to the SessionConfigurationFailed event, published when a ConfigureSession request with a `provision` was accepted but could not be completed
-     * @param  {(event:SessionConfigurationFailedEvent|undefined,err:NatsError|Error|null)=>void} handler
-     * @param  {SubscriptionOptions} options?
-     * @returns Subscription
-     */
-    connectSessionConfigurationFailedEvents(handler: (event: SessionConfigurationFailedEvent | undefined, err: NatsError | Error | null) => void, options?: SubscriptionOptions): Subscription;
+    connectSessionConfigurationProgressEvents(handler: (event: SessionConfigurationProgressEvent | undefined, err: NatsError | Error | null) => void, options?: SubscriptionOptions): Subscription;
     /**
      * Connect to metrics published for the given SessionMetricInfo from the idle session
      * @param  {ISessionMetricInfo} metricInfo

package/dist/cjs/RunnerClient.js

@@ -197,18 +197,21 @@ var RunnerClient = /** @class */ (function (_super) {
     /**
      * Changes the configuration of an existing session, running or stopped. A configuration property that is
      * undefined keeps the session's current value. Requires Runner v2.9 or later.
-     * With a `provision`, the session must be idle and the Runner responds once it accepted the request. It then publishes
-     * SessionConfigurationChanged or SessionConfigurationFailed; subscribe to both before sending the request.
+     * With a `provision`, the session must be idle and the Runner responds once it accepted the request. If the provision gives
+     * another image than the session has, the Runner installs it and restarts the session (OpenTAP 9.31 or newer on the Runner).
+     * The Runner reports what happened with SessionConfigurationProgress events: Started, then Succeeded or Failed, which for a
+     * provision can take minutes. Only a request for an unknown session, with an unknown value, or for a busy session gets an
+     * error response and no events. Subscribe before sending the request.
      * @param {ConfigureSessionRequest} configureSessionRequest
      * @returns {{Promise<void>}}
      */
-    RunnerClient.prototype.configureSession = function (configureSessionRequest) {
+    RunnerClient.prototype.configureSession = function (configureSessionRequest, timeout) {
         var sessionId = configureSessionRequest.sessionId, sessionConfiguration = configureSessionRequest.sessionConfiguration;
         return (sessionId === null || sessionId === void 0 ? void 0 : sessionId.length) > 0
             ? this.request('ConfigureSession', {
                 SessionId: sessionId,
                 SessionConfiguration: sessionConfiguration ? new DTOs_1.SessionConfiguration(sessionConfiguration) : undefined,
-            })
+            }, { timeout: timeout })
                 .then(this.success())
                 .catch(this.error())
             : Promise.reject('sessionId is not defined');
@@ -314,8 +317,8 @@ var RunnerClient = /** @class */ (function (_super) {
      * @param {NewSessionRequest} sessionRequest
      * @returns {{Promise<Session>}}
      */
-    RunnerClient.prototype.newSession = function (sessionRequest) {
-        return this.request('NewSession', sessionRequest)
+    RunnerClient.prototype.newSession = function (sessionRequest, timeout) {
+        return this.request('NewSession', sessionRequest, { timeout: timeout })
             .then(function (response) { return DTOs_1.Session.fromJS(response.Session); })
             .then(this.success())
             .catch(this.error());
@@ -338,8 +341,8 @@ var RunnerClient = /** @class */ (function (_super) {
      * Start a session
      * @returns {{Promise<Session>}}
      */
-    RunnerClient.prototype.startSession = function () {
-        return this.request('StartSession')
+    RunnerClient.prototype.startSession = function (timeout) {
+        return this.request('StartSession', undefined, { timeout: timeout })
             .then(function (sessionJs) { return DTOs_1.Session.fromJS(sessionJs); })
             .then(this.success())
             .catch(this.error());
@@ -359,9 +362,9 @@ var RunnerClient = /** @class */ (function (_super) {
      * @param imageId
      * @returns {{Promise<Session>}}
      */
-    RunnerClient.prototype.startImageSession = function (image) {
+    RunnerClient.prototype.startImageSession = function (image, timeout) {
         return image
-            ? this.request('StartImageSession', image)
+            ? this.request('StartImageSession', image, { timeout: timeout })
                 .then(function (sessionJs) { return DTOs_1.Session.fromJS(sessionJs); })
                 .then(this.success())
                 .catch(this.error())
@@ -399,41 +402,21 @@ var RunnerClient = /** @class */ (function (_super) {
             } }));
     };
     /**
-     * Subscribe to the SessionConfigurationChanged event, published after every successful ConfigureSession request
-     * @param  {(event:SessionConfigurationChangedEvent|undefined,err:NatsError|Error|null)=>void} handler
+     * Subscribe to the SessionConfigurationProgress event, published as a ConfigureSession request progresses:
+     * Started, then Succeeded with the session as it is after the change, or Failed with the reason
+     * @param  {(event:SessionConfigurationProgressEvent|undefined,err:NatsError|Error|null)=>void} handler
      * @param  {SubscriptionOptions} options?
      * @returns Subscription
      */
-    RunnerClient.prototype.connectSessionConfigurationChangedEvents = function (handler, options) {
-        return this.subscribe('Events.SessionConfigurationChanged', __assign(__assign({}, options), { callback: function (error, encodedMessage) {
+    RunnerClient.prototype.connectSessionConfigurationProgressEvents = function (handler, options) {
+        return this.subscribe('Events.SessionConfigurationProgress', __assign(__assign({}, options), { callback: function (error, encodedMessage) {
                 if (error) {
                     handler(undefined, error);
                     return;
                 }
                 try {
                     var eventJson = (0, nats_ws_1.JSONCodec)().decode(encodedMessage === null || encodedMessage === void 0 ? void 0 : encodedMessage.data);
-                    handler(DTOs_1.SessionConfigurationChangedEvent.fromJS(eventJson), error);
-                }
-                catch (error) {
-                    handler(undefined, error);
-                }
-            } }));
-    };
-    /**
-     * Subscribe to the SessionConfigurationFailed event, published when a ConfigureSession request with a `provision` was accepted but could not be completed
-     * @param  {(event:SessionConfigurationFailedEvent|undefined,err:NatsError|Error|null)=>void} handler
-     * @param  {SubscriptionOptions} options?
-     * @returns Subscription
-     */
-    RunnerClient.prototype.connectSessionConfigurationFailedEvents = function (handler, options) {
-        return this.subscribe('Events.SessionConfigurationFailed', __assign(__assign({}, options), { callback: function (error, encodedMessage) {
-                if (error) {
-                    handler(undefined, error);
-                    return;
-                }
-                try {
-                    var eventJson = (0, nats_ws_1.JSONCodec)().decode(encodedMessage === null || encodedMessage === void 0 ? void 0 : encodedMessage.data);
-                    handler(DTOs_1.SessionConfigurationFailedEvent.fromJS(eventJson), error);
+                    handler(DTOs_1.SessionConfigurationProgressEvent.fromJS(eventJson), error);
                 }
                 catch (error) {
                     handler(undefined, error);

package/dist/mjs/DTOs.d.ts

@@ -107,6 +107,7 @@ export interface ISession {
 /**
  * Where a session's image comes from. The concrete type is named by the `ProvisionType` property on the wire.
  * Each type replaces one part of the session's image; the other parts stay what the session has.
+ * An image that is not the one the session has is installed into the session, which is restarted on it.
  */
 export declare abstract class SessionProvision {
     protected _discriminator: string;
@@ -115,7 +116,10 @@ export declare abstract class SessionProvision {
     static fromJS(data: any): SessionProvision;
     toJSON(data?: any): any;
 }
-/** Uses `image` on top of the Runner's default image. The session keeps its test plan and settings. */
+/**
+ * Uses `image` on top of the Runner's default image. The session keeps its test plan and settings, but their
+ * dependencies are not added to the image.
+ */
 export declare class ExactProvision extends SessionProvision implements IExactProvision {
     /** Packages that replace the session's packages, combined with the Runner's default image. */
     image?: Image | undefined;
@@ -163,9 +167,22 @@ export declare class TestPlanReferenceProvision extends SessionProvision impleme
 export interface ITestPlanReferenceProvision {
     testPlanReference?: RepositoryPackageReference | undefined;
 }
+/**
+ * Replaces the session's test plan with an empty one. The session has no test plan reference afterwards, and the
+ * dependencies of its previous test plan are no longer part of the image.
+ */
+export declare class EmptyTestPlanProvision extends SessionProvision implements IEmptyTestPlanProvision {
+    constructor(data?: IEmptyTestPlanProvision);
+    static fromJS(data: any): EmptyTestPlanProvision;
+}
+export interface IEmptyTestPlanProvision {
+}
 /** Configuration of an existing session, sent to ConfigureSession. A property that is undefined keeps the session's current value. */
 export declare class SessionConfiguration implements ISessionConfiguration {
-    /** The image the session asks for. The session must be idle. */
+    /**
+     * The image the session asks for. The session must be idle. If it is not the image the session has, the Runner installs it
+     * into the session and restarts the session on it before it loads anything. That needs OpenTAP 9.31 or newer on the Runner.
+     */
     provision?: SessionProvision | undefined;
     /** An empty title removes the title. */
     title?: string | undefined;
@@ -188,30 +205,56 @@ export interface ISessionConfiguration {
         [key: string]: string;
     } | undefined;
 }
-/** Published by the Runner after every successful ConfigureSession request. */
-export declare class SessionConfigurationChangedEvent implements ISessionConfigurationChangedEvent {
+/** Published by the Runner as a ConfigureSession request progresses. */
+export declare class SessionConfigurationProgressEvent implements ISessionConfigurationProgressEvent {
+    sessionId?: string | undefined;
+    progress?: SessionConfigurationProgress | undefined;
+    constructor(data?: ISessionConfigurationProgressEvent);
+    init(_data?: any): void;
+    static fromJS(data: any): SessionConfigurationProgressEvent;
+    toJSON(data?: any): any;
+}
+export interface ISessionConfigurationProgressEvent {
+    sessionId?: string | undefined;
+    progress?: SessionConfigurationProgress | undefined;
+}
+/** What happened to a ConfigureSession request. The concrete type is named by the `ProgressType` property on the wire. */
+export declare abstract class SessionConfigurationProgress {
+    protected _discriminator: string;
+    constructor();
+    init(_data?: any): void;
+    static fromJS(data: any): SessionConfigurationProgress;
+    toJSON(data?: any): any;
+}
+/** The Runner accepted the request and is applying it. */
+export declare class SessionConfigurationStarted extends SessionConfigurationProgress implements ISessionConfigurationStarted {
+    constructor(data?: ISessionConfigurationStarted);
+    static fromJS(data: any): SessionConfigurationStarted;
+}
+export interface ISessionConfigurationStarted {
+}
+/** The session is configured. */
+export declare class SessionConfigurationSucceeded extends SessionConfigurationProgress implements ISessionConfigurationSucceeded {
     /** The session after the change, as GetSessions reports it. */
     session?: Session | undefined;
-    constructor(data?: ISessionConfigurationChangedEvent);
+    constructor(data?: ISessionConfigurationSucceeded);
     init(_data?: any): void;
-    static fromJS(data: any): SessionConfigurationChangedEvent;
+    static fromJS(data: any): SessionConfigurationSucceeded;
     toJSON(data?: any): any;
 }
-export interface ISessionConfigurationChangedEvent {
+export interface ISessionConfigurationSucceeded {
     session?: Session | undefined;
 }
-/** Published by the Runner when it accepted a ConfigureSession request with a `provision`, and could not complete it. */
-export declare class SessionConfigurationFailedEvent implements ISessionConfigurationFailedEvent {
-    sessionId?: string | undefined;
+/** The Runner accepted the request, and could not complete it. */
+export declare class SessionConfigurationFailed extends SessionConfigurationProgress implements ISessionConfigurationFailed {
     /** Why the configuration failed. For people to read; do not parse it. */
     message?: string | undefined;
-    constructor(data?: ISessionConfigurationFailedEvent);
+    constructor(data?: ISessionConfigurationFailed);
     init(_data?: any): void;
-    static fromJS(data: any): SessionConfigurationFailedEvent;
+    static fromJS(data: any): SessionConfigurationFailed;
     toJSON(data?: any): any;
 }
-export interface ISessionConfigurationFailedEvent {
-    sessionId?: string | undefined;
+export interface ISessionConfigurationFailed {
     message?: string | undefined;
 }
 export declare class Links implements ILinks {

package/dist/mjs/DTOs.js

@@ -214,6 +214,7 @@ export class Session {
 /**
  * Where a session's image comes from. The concrete type is named by the `ProvisionType` property on the wire.
  * Each type replaces one part of the session's image; the other parts stay what the session has.
+ * An image that is not the one the session has is installed into the session, which is restarted on it.
  */
 export class SessionProvision {
     constructor() {
@@ -243,6 +244,11 @@ export class SessionProvision {
             result.init(data);
             return result;
         }
+        if (data['ProvisionType'] === 'EmptyTestPlanProvision') {
+            const result = new EmptyTestPlanProvision();
+            result.init(data);
+            return result;
+        }
         throw new Error("The abstract class 'SessionProvision' cannot be instantiated.");
     }
     toJSON(data) {
@@ -251,7 +257,10 @@ export class SessionProvision {
         return data;
     }
 }
-/** Uses `image` on top of the Runner's default image. The session keeps its test plan and settings. */
+/**
+ * Uses `image` on top of the Runner's default image. The session keeps its test plan and settings, but their
+ * dependencies are not added to the image.
+ */
 export class ExactProvision extends SessionProvision {
     constructor(data) {
         super();
@@ -388,6 +397,28 @@ export class TestPlanReferenceProvision extends SessionProvision {
         return data;
     }
 }
+/**
+ * Replaces the session's test plan with an empty one. The session has no test plan reference afterwards, and the
+ * dependencies of its previous test plan are no longer part of the image.
+ */
+export class EmptyTestPlanProvision extends SessionProvision {
+    constructor(data) {
+        super();
+        if (data) {
+            for (const property in data) {
+                if (Object.prototype.hasOwnProperty.call(data, property))
+                    this[property] = data[property];
+            }
+        }
+        this._discriminator = 'EmptyTestPlanProvision';
+    }
+    static fromJS(data) {
+        data = typeof data === 'object' ? data : {};
+        const result = new EmptyTestPlanProvision();
+        result.init(data);
+        return result;
+    }
+}
 /** Configuration of an existing session, sent to ConfigureSession. A property that is undefined keeps the session's current value. */
 export class SessionConfiguration {
     constructor(data) {
@@ -421,58 +452,144 @@ export class SessionConfiguration {
         return data;
     }
 }
-/** Published by the Runner after every successful ConfigureSession request. */
-export class SessionConfigurationChangedEvent {
+/** Published by the Runner as a ConfigureSession request progresses. */
+export class SessionConfigurationProgressEvent {
+    constructor(data) {
+        if (data) {
+            for (const property in data) {
+                if (Object.prototype.hasOwnProperty.call(data, property))
+                    this[property] = data[property];
+            }
+        }
+    }
+    init(_data) {
+        if (_data) {
+            this.sessionId = _data['SessionId'];
+            this.progress = _data['Progress'] ? SessionConfigurationProgress.fromJS(_data['Progress']) : undefined;
+        }
+    }
+    static fromJS(data) {
+        data = typeof data === 'object' ? data : {};
+        const result = new SessionConfigurationProgressEvent();
+        result.init(data);
+        return result;
+    }
+    toJSON(data) {
+        data = typeof data === 'object' ? data : {};
+        data['SessionId'] = this.sessionId;
+        data['Progress'] = this.progress ? this.progress.toJSON() : undefined;
+        return data;
+    }
+}
+/** What happened to a ConfigureSession request. The concrete type is named by the `ProgressType` property on the wire. */
+export class SessionConfigurationProgress {
+    constructor() {
+        this._discriminator = 'SessionConfigurationProgress';
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    init(_data) { }
+    static fromJS(data) {
+        data = typeof data === 'object' ? data : {};
+        if (data['ProgressType'] === 'Started') {
+            const result = new SessionConfigurationStarted();
+            result.init(data);
+            return result;
+        }
+        if (data['ProgressType'] === 'Succeeded') {
+            const result = new SessionConfigurationSucceeded();
+            result.init(data);
+            return result;
+        }
+        if (data['ProgressType'] === 'Failed') {
+            const result = new SessionConfigurationFailed();
+            result.init(data);
+            return result;
+        }
+        throw new Error("The abstract class 'SessionConfigurationProgress' cannot be instantiated.");
+    }
+    toJSON(data) {
+        data = typeof data === 'object' ? data : {};
+        data['ProgressType'] = this._discriminator;
+        return data;
+    }
+}
+/** The Runner accepted the request and is applying it. */
+export class SessionConfigurationStarted extends SessionConfigurationProgress {
     constructor(data) {
+        super();
         if (data) {
             for (const property in data) {
                 if (Object.prototype.hasOwnProperty.call(data, property))
                     this[property] = data[property];
             }
         }
+        this._discriminator = 'Started';
+    }
+    static fromJS(data) {
+        data = typeof data === 'object' ? data : {};
+        const result = new SessionConfigurationStarted();
+        result.init(data);
+        return result;
+    }
+}
+/** The session is configured. */
+export class SessionConfigurationSucceeded extends SessionConfigurationProgress {
+    constructor(data) {
+        super();
+        if (data) {
+            for (const property in data) {
+                if (Object.prototype.hasOwnProperty.call(data, property))
+                    this[property] = data[property];
+            }
+        }
+        this._discriminator = 'Succeeded';
     }
     init(_data) {
+        super.init(_data);
         if (_data) {
             this.session = _data['Session'] ? Session.fromJS(_data['Session']) : undefined;
         }
     }
     static fromJS(data) {
         data = typeof data === 'object' ? data : {};
-        const result = new SessionConfigurationChangedEvent();
+        const result = new SessionConfigurationSucceeded();
         result.init(data);
         return result;
     }
     toJSON(data) {
         data = typeof data === 'object' ? data : {};
+        super.toJSON(data);
         data['Session'] = this.session ? this.session.toJSON() : undefined;
         return data;
     }
 }
-/** Published by the Runner when it accepted a ConfigureSession request with a `provision`, and could not complete it. */
-export class SessionConfigurationFailedEvent {
+/** The Runner accepted the request, and could not complete it. */
+export class SessionConfigurationFailed extends SessionConfigurationProgress {
     constructor(data) {
+        super();
         if (data) {
             for (const property in data) {
                 if (Object.prototype.hasOwnProperty.call(data, property))
                     this[property] = data[property];
             }
         }
+        this._discriminator = 'Failed';
     }
     init(_data) {
+        super.init(_data);
         if (_data) {
-            this.sessionId = _data['SessionId'];
             this.message = _data['Message'];
         }
     }
     static fromJS(data) {
         data = typeof data === 'object' ? data : {};
-        const result = new SessionConfigurationFailedEvent();
+        const result = new SessionConfigurationFailed();
         result.init(data);
         return result;
     }
     toJSON(data) {
         data = typeof data === 'object' ? data : {};
-        data['SessionId'] = this.sessionId;
+        super.toJSON(data);
         data['Message'] = this.message;
         return data;
     }

package/dist/mjs/RunnerClient.d.ts

@@ -1,6 +1,6 @@
 import { ConnectionOptions, Consumer, NatsError, Subscription, SubscriptionOptions } from 'nats.ws';
 import { AddLocalTestPlanRequest, ConfigureSessionRequest, DeleteSessionRequest, NewSessionRequest, RemoveLocalTestPlanRequest, ResumeSessionRequest, RunnerUpdateRequest } from './requestDTOs';
-import { ISession, ISessionMetricInfo, Image, MetadataUpdatedEvent, RepositoryPackageReference, RunnerStatus, SaveDefaultSettings, Session, SessionConfigurationChangedEvent, SessionConfigurationFailedEvent } from './DTOs';
+import { ISession, ISessionMetricInfo, Image, MetadataUpdatedEvent, RepositoryPackageReference, RunnerStatus, SaveDefaultSettings, Session, SessionConfigurationProgressEvent } from './DTOs';
 import { BaseClient } from './BaseClient';
 export declare class RunnerClient extends BaseClient {
     private runnerId;
@@ -44,12 +44,15 @@ export declare class RunnerClient extends BaseClient {
     /**
      * Changes the configuration of an existing session, running or stopped. A configuration property that is
      * undefined keeps the session's current value. Requires Runner v2.9 or later.
-     * With a `provision`, the session must be idle and the Runner responds once it accepted the request. It then publishes
-     * SessionConfigurationChanged or SessionConfigurationFailed; subscribe to both before sending the request.
+     * With a `provision`, the session must be idle and the Runner responds once it accepted the request. If the provision gives
+     * another image than the session has, the Runner installs it and restarts the session (OpenTAP 9.31 or newer on the Runner).
+     * The Runner reports what happened with SessionConfigurationProgress events: Started, then Succeeded or Failed, which for a
+     * provision can take minutes. Only a request for an unknown session, with an unknown value, or for a busy session gets an
+     * error response and no events. Subscribe before sending the request.
      * @param {ConfigureSessionRequest} configureSessionRequest
      * @returns {{Promise<void>}}
      */
-    configureSession(configureSessionRequest: ConfigureSessionRequest): Promise<void>;
+    configureSession(configureSessionRequest: ConfigureSessionRequest, timeout?: number): Promise<void>;
     /**
      * Create a OpenTAP package configuration image from a list image inputs consisting of user specified packages and repositories.
      * @param {Image[]} images List of images
@@ -105,7 +108,7 @@ export declare class RunnerClient extends BaseClient {
      * @param {NewSessionRequest} sessionRequest
      * @returns {{Promise<Session>}}
      */
-    newSession(sessionRequest?: NewSessionRequest): Promise<Session>;
+    newSession(sessionRequest?: NewSessionRequest, timeout?: number): Promise<Session>;
     /**
      * Resumes a stopped session as it is. A session that is not stopped is an error; change a session with {@link configureSession}.
      * @param {ResumeSessionRequest} resumeSessionRequest
@@ -116,7 +119,7 @@ export declare class RunnerClient extends BaseClient {
      * Start a session
      * @returns {{Promise<Session>}}
      */
-    startSession(): Promise<Session>;
+    startSession(timeout?: number): Promise<Session>;
     /**
      * Get the session manager image.
      * @returns {{Promise<Image>}}
@@ -127,7 +130,7 @@ export declare class RunnerClient extends BaseClient {
      * @param imageId
      * @returns {{Promise<Session>}}
      */
-    startImageSession(image: Image): Promise<Session>;
+    startImageSession(image: Image, timeout?: number): Promise<Session>;
     /**
      * Update the `Runner` plugin to the given version
      * @param runnerUpdateRequest
@@ -142,19 +145,13 @@ export declare class RunnerClient extends BaseClient {
      */
     connectMetadataUpdatedEvents(handler: (event: MetadataUpdatedEvent | undefined, err: NatsError | Error | null) => void, options?: SubscriptionOptions): Subscription;
     /**
-     * Subscribe to the SessionConfigurationChanged event, published after every successful ConfigureSession request
-     * @param  {(event:SessionConfigurationChangedEvent|undefined,err:NatsError|Error|null)=>void} handler
+     * Subscribe to the SessionConfigurationProgress event, published as a ConfigureSession request progresses:
+     * Started, then Succeeded with the session as it is after the change, or Failed with the reason
+     * @param  {(event:SessionConfigurationProgressEvent|undefined,err:NatsError|Error|null)=>void} handler
      * @param  {SubscriptionOptions} options?
      * @returns Subscription
      */
-    connectSessionConfigurationChangedEvents(handler: (event: SessionConfigurationChangedEvent | undefined, err: NatsError | Error | null) => void, options?: SubscriptionOptions): Subscription;
-    /**
-     * Subscribe to the SessionConfigurationFailed event, published when a ConfigureSession request with a `provision` was accepted but could not be completed
-     * @param  {(event:SessionConfigurationFailedEvent|undefined,err:NatsError|Error|null)=>void} handler
-     * @param  {SubscriptionOptions} options?
-     * @returns Subscription
-     */
-    connectSessionConfigurationFailedEvents(handler: (event: SessionConfigurationFailedEvent | undefined, err: NatsError | Error | null) => void, options?: SubscriptionOptions): Subscription;
+    connectSessionConfigurationProgressEvents(handler: (event: SessionConfigurationProgressEvent | undefined, err: NatsError | Error | null) => void, options?: SubscriptionOptions): Subscription;
     /**
      * Connect to metrics published for the given SessionMetricInfo from the idle session
      * @param  {ISessionMetricInfo} metricInfo

package/dist/mjs/RunnerClient.js

@@ -15,7 +15,7 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
     function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
 };
 import { JSONCodec, nanos } from 'nats.ws';
-import { GetLocalTestPlansResponse, Image, MetadataUpdatedEvent, RepositoryPackageReference, RunnerStatus, Session, SessionConfiguration, SessionConfigurationChangedEvent, SessionConfigurationFailedEvent, } from './DTOs';
+import { GetLocalTestPlansResponse, Image, MetadataUpdatedEvent, RepositoryPackageReference, RunnerStatus, Session, SessionConfiguration, SessionConfigurationProgressEvent, } from './DTOs';
 import { BaseClient } from './BaseClient';
 import { getSubjectParts } from './utils';
 export class RunnerClient extends BaseClient {
@@ -137,18 +137,21 @@ export class RunnerClient extends BaseClient {
     /**
      * Changes the configuration of an existing session, running or stopped. A configuration property that is
      * undefined keeps the session's current value. Requires Runner v2.9 or later.
-     * With a `provision`, the session must be idle and the Runner responds once it accepted the request. It then publishes
-     * SessionConfigurationChanged or SessionConfigurationFailed; subscribe to both before sending the request.
+     * With a `provision`, the session must be idle and the Runner responds once it accepted the request. If the provision gives
+     * another image than the session has, the Runner installs it and restarts the session (OpenTAP 9.31 or newer on the Runner).
+     * The Runner reports what happened with SessionConfigurationProgress events: Started, then Succeeded or Failed, which for a
+     * provision can take minutes. Only a request for an unknown session, with an unknown value, or for a busy session gets an
+     * error response and no events. Subscribe before sending the request.
      * @param {ConfigureSessionRequest} configureSessionRequest
      * @returns {{Promise<void>}}
      */
-    configureSession(configureSessionRequest) {
+    configureSession(configureSessionRequest, timeout) {
         const { sessionId, sessionConfiguration } = configureSessionRequest;
         return (sessionId === null || sessionId === void 0 ? void 0 : sessionId.length) > 0
             ? this.request('ConfigureSession', {
                 SessionId: sessionId,
                 SessionConfiguration: sessionConfiguration ? new SessionConfiguration(sessionConfiguration) : undefined,
-            })
+            }, { timeout })
                 .then(this.success())
                 .catch(this.error())
             : Promise.reject('sessionId is not defined');
@@ -175,7 +178,7 @@ export class RunnerClient extends BaseClient {
      */
     resolveImageDryRun(images, timeout) {
         return (images === null || images === void 0 ? void 0 : images.length) > 0
-            ? this.request('ResolveImageDryRun', images, { timeout: timeout })
+            ? this.request('ResolveImageDryRun', images, { timeout })
                 .then(imageJs => Image.fromJS(imageJs))
                 .then(this.success())
                 .catch(this.error())
@@ -253,8 +256,8 @@ export class RunnerClient extends BaseClient {
      * @param {NewSessionRequest} sessionRequest
      * @returns {{Promise<Session>}}
      */
-    newSession(sessionRequest) {
-        return this.request('NewSession', sessionRequest)
+    newSession(sessionRequest, timeout) {
+        return this.request('NewSession', sessionRequest, { timeout })
             .then(response => Session.fromJS(response.Session))
             .then(this.success())
             .catch(this.error());
@@ -277,8 +280,8 @@ export class RunnerClient extends BaseClient {
      * Start a session
      * @returns {{Promise<Session>}}
      */
-    startSession() {
-        return this.request('StartSession')
+    startSession(timeout) {
+        return this.request('StartSession', undefined, { timeout })
             .then(sessionJs => Session.fromJS(sessionJs))
             .then(this.success())
             .catch(this.error());
@@ -298,9 +301,9 @@ export class RunnerClient extends BaseClient {
      * @param imageId
      * @returns {{Promise<Session>}}
      */
-    startImageSession(image) {
+    startImageSession(image, timeout) {
         return image
-            ? this.request('StartImageSession', image)
+            ? this.request('StartImageSession', image, { timeout })
                 .then(sessionJs => Session.fromJS(sessionJs))
                 .then(this.success())
                 .catch(this.error())
@@ -338,41 +341,21 @@ export class RunnerClient extends BaseClient {
             } }));
     }
     /**
-     * Subscribe to the SessionConfigurationChanged event, published after every successful ConfigureSession request
-     * @param  {(event:SessionConfigurationChangedEvent|undefined,err:NatsError|Error|null)=>void} handler
+     * Subscribe to the SessionConfigurationProgress event, published as a ConfigureSession request progresses:
+     * Started, then Succeeded with the session as it is after the change, or Failed with the reason
+     * @param  {(event:SessionConfigurationProgressEvent|undefined,err:NatsError|Error|null)=>void} handler
      * @param  {SubscriptionOptions} options?
      * @returns Subscription
      */
-    connectSessionConfigurationChangedEvents(handler, options) {
-        return this.subscribe('Events.SessionConfigurationChanged', Object.assign(Object.assign({}, options), { callback(error, encodedMessage) {
+    connectSessionConfigurationProgressEvents(handler, options) {
+        return this.subscribe('Events.SessionConfigurationProgress', Object.assign(Object.assign({}, options), { callback(error, encodedMessage) {
                 if (error) {
                     handler(undefined, error);
                     return;
                 }
                 try {
                     const eventJson = JSONCodec().decode(encodedMessage === null || encodedMessage === void 0 ? void 0 : encodedMessage.data);
-                    handler(SessionConfigurationChangedEvent.fromJS(eventJson), error);
-                }
-                catch (error) {
-                    handler(undefined, error);
-                }
-            } }));
-    }
-    /**
-     * Subscribe to the SessionConfigurationFailed event, published when a ConfigureSession request with a `provision` was accepted but could not be completed
-     * @param  {(event:SessionConfigurationFailedEvent|undefined,err:NatsError|Error|null)=>void} handler
-     * @param  {SubscriptionOptions} options?
-     * @returns Subscription
-     */
-    connectSessionConfigurationFailedEvents(handler, options) {
-        return this.subscribe('Events.SessionConfigurationFailed', Object.assign(Object.assign({}, options), { callback(error, encodedMessage) {
-                if (error) {
-                    handler(undefined, error);
-                    return;
-                }
-                try {
-                    const eventJson = JSONCodec().decode(encodedMessage === null || encodedMessage === void 0 ? void 0 : encodedMessage.data);
-                    handler(SessionConfigurationFailedEvent.fromJS(eventJson), error);
+                    handler(SessionConfigurationProgressEvent.fromJS(eventJson), error);
                 }
                 catch (error) {
                     handler(undefined, error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentap/runner-client",
-  "version": "4.9.0-beta.1.40294477159",
+  "version": "4.9.0-beta.3.41598982309",
   "description": "This is the web client for the OpenTAP Runner.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/mjs/index.js",