act-test-runner 2.0.0

package/dist/ActRunner.js

@@ -0,0 +1,304 @@
+/**
+ * Copyright (c) 2026 original authors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { spawn } from 'node:child_process';
+import { CompositeActOutputListener, StdStreamOutputListener, } from './ActOutputListener.js';
+import { ActExecStatus, ActRunnerError } from './ActRunnerResult.js';
+import { ActCliParams, INTERNAL_ACT_PARAMS, MANAGED_ACT_PARAMS, } from './internal/ActCliParams.js';
+import { ActExecListener } from './internal/ActExecListener.js';
+import { checkExists, checkOneDefined } from './utils/checks.js';
+import { cleanupDir, createTempDir, createTempEventPayloadFile, createTempWorkflowFile, } from './utils/fsutils.js';
+import { firstDefined } from './utils/objects.js';
+/**
+ * Invokes `act`, allowing end-to-end testing of custom GitHub actions and
+ * workflows.
+ *
+ * Typically, the test code will provide a workflow file or workflow body to
+ * run, as well as required workflow inputs, such as environment variables or
+ * secrets.
+ *
+ * Assertions can then be made on the outcome of the `run()` method invocation,
+ * such as the jobs run, workflow output, or artifacts persisted in the artifact
+ * server or action cache.
+ *
+ * The runner cannot be used concurrently due to limitations on the `act` side.
+ *
+ * Each instance is single-use: calling `run()` more than once on the same
+ * instance rejects with an `ActRunnerError`. Create a new instance for each
+ * run.
+ */
+export class ActRunner {
+    actExecutable;
+    workingDir;
+    workflowSource;
+    eventType;
+    eventPayloadFileOrBody;
+    envSource;
+    inputsSource;
+    secretsSource;
+    variablesSource;
+    matrixValues;
+    cacheServer;
+    artifactServer;
+    additionalArgs = [];
+    outputListener;
+    hasRun = false;
+    /**
+     * Sets the path to the `act` executable (default: `act` binary on the
+     * `PATH`). Useful in the CI environments, where the executable is provisioned
+     * on demand in a controlled location.
+     *
+     * @param actExecutable - Path to the `act` executable.
+     */
+    withActExecutable(actExecutable) {
+        this.actExecutable = actExecutable;
+        return this;
+    }
+    /**
+     * Sets the directory to use for the runner's storage needs (default:
+     * directory in user's temp folder).
+     *
+     * @param {string} workingDir - The runner's working directory
+     */
+    withWorkingDir(workingDir) {
+        this.workingDir = workingDir;
+        return this;
+    }
+    /**
+     * Specifies the GitHub workflow to run, either as a file path or an inline
+     * body.
+     *
+     * @param source - The workflow source
+     */
+    withWorkflow(source) {
+        this.workflowSource = source;
+        return this;
+    }
+    /**
+     * Configures the event that triggers the workflow run (e.g., `push`). If
+     * unspecified, the first event type specified in the workflow definition will
+     * be used.
+     *
+     * @param type - Type of the event to trigger the workflow
+     * @param payloadFileOrBody - Event payload as plain JS object or path to the
+     *   JSON file
+     */
+    withEvent(type, payloadFileOrBody) {
+        this.eventType = type;
+        this.eventPayloadFileOrBody = payloadFileOrBody;
+        return this;
+    }
+    /**
+     * Specifies environment variables to use when invoking the given workflow,
+     * provided via a file, inline values, or both. Replaces any environment
+     * variables set by a previous call to this method.
+     *
+     * @param source - Environment variables source
+     */
+    withEnv(source) {
+        this.envSource = source;
+        return this;
+    }
+    /**
+     * Specifies inputs values to use when invoking the given workflow, provided
+     * via a file, inline values, or both. Replaces any inputs values set by a
+     * previous call to this method.
+     *
+     * @param source - Inputs values source
+     */
+    withInputs(source) {
+        this.inputsSource = source;
+        return this;
+    }
+    /**
+     * Specifies secrets values to use when invoking the given workflow, provided
+     * via a file, inline values, or both. Replaces any secrets values set by a
+     * previous call to this method.
+     *
+     * @param source - Secrets values source
+     */
+    withSecrets(source) {
+        this.secretsSource = source;
+        return this;
+    }
+    /**
+     * Specifies workflow variables values to use when invoking the given
+     * workflow, provided via a file, inline values, or both. Replaces any
+     * variables values set by a previous call to this method.
+     *
+     * @param source - Variables values source
+     */
+    withVariables(source) {
+        this.variablesSource = source;
+        return this;
+    }
+    /**
+     * Set matrix values to run the workflow with. If undefined, all combinations
+     * specified in the workflow definition will be invoked. Replaces any matrix
+     * values set by a previous call to this method.
+     *
+     * @param matrixValues - Matrix values to run the workflow with
+     */
+    withMatrix(matrixValues) {
+        this.matrixValues = matrixValues;
+        return this;
+    }
+    /**
+     * Configures the cache server to be used by the given workflow.
+     *
+     * @param spec - Cache server configuration
+     */
+    withCacheServer(spec) {
+        this.cacheServer = spec;
+        return this;
+    }
+    /**
+     * Configures the artifact server to be used by the given workflow.
+     *
+     * @param spec - Artifact server configuration
+     */
+    withArtifactServer(spec) {
+        this.artifactServer = spec;
+        return this;
+    }
+    /**
+     * Arbitrary additional arguments to pass to the `act` execution.
+     *
+     * @param {...string} args - Additional arguments to invoke `act` with
+     */
+    withAdditionalArgs(...args) {
+        args.forEach((arg) => this.additionalArgs.push(arg));
+        return this;
+    }
+    /**
+     * Forwards the act output to the supplied listeners. When no listener is
+     * specified, forwards the output to the console.
+     *
+     * @param listeners - Output consumers.
+     */
+    forwardOutput(...listeners) {
+        this.outputListener =
+            listeners.length === 0
+                ? new StdStreamOutputListener()
+                : new CompositeActOutputListener(listeners);
+        return this;
+    }
+    /**
+     * Invokes `act` with specified options.
+     *
+     * @param options - Options controlling this run, such as an abort signal
+     * @returns Workflow execution result for inspection
+     */
+    run(options) {
+        return new Promise((resolve, reject) => {
+            try {
+                if (this.hasRun) {
+                    throw new ActRunnerError('ActRunner instances cannot be reused; create a new instance for each run()');
+                }
+                this.hasRun = true;
+                const signal = options?.signal;
+                if (signal?.aborted) {
+                    throw new ActRunnerError('act execution was aborted');
+                }
+                const params = this.validateRunnerParams();
+                const executionListener = new ActExecListener(this.outputListener);
+                // apply user arguments + additional internal arguments specific to test execution
+                const args = [...params.asCliArgs(), '--rm', '--json'];
+                const child = spawn(this.actExecutable ?? 'act', args);
+                const onAbort = () => {
+                    child.kill();
+                };
+                signal?.addEventListener('abort', onAbort, { once: true });
+                child.stdout.on('data', (data) => executionListener.onRawOutput(data.toString().trimEnd()));
+                child.stderr.on('data', (data) => executionListener.onRawOutput(data.toString().trimEnd()));
+                child.on('close', (code) => {
+                    signal?.removeEventListener('abort', onAbort);
+                    cleanupDir(this.workingDir);
+                    if (signal?.aborted) {
+                        reject(new ActRunnerError('act execution was aborted'));
+                        return;
+                    }
+                    resolve({
+                        status: code === 0 ? ActExecStatus.SUCCESS : ActExecStatus.FAILED,
+                        output: executionListener.getOutput(),
+                        jobs: executionListener.getJobs(),
+                    });
+                });
+                child.on('error', (err) => {
+                    signal?.removeEventListener('abort', onAbort);
+                    reject(new ActRunnerError(`Failed to launch act: ${err.message}`));
+                });
+            }
+            catch (err) {
+                if (err instanceof ActRunnerError) {
+                    reject(err);
+                    return;
+                }
+                reject(new ActRunnerError(`Unexpected error occurred when executing act: ${err}`));
+            }
+        });
+    }
+    validateRunnerParams() {
+        if (this.actExecutable) {
+            checkExists('act executable', this.actExecutable);
+        }
+        const workingDir = checkExists('working directory', firstDefined(() => this.workingDir, createTempDir));
+        this.workingDir = workingDir;
+        const workflowFile = this.workflowSource && 'file' in this.workflowSource
+            ? this.workflowSource.file
+            : undefined;
+        const workflowBody = this.workflowSource && 'body' in this.workflowSource
+            ? this.workflowSource.body
+            : undefined;
+        checkOneDefined(workflowFile, workflowBody);
+        const workflowFilePath = checkExists('workflow path', workflowFile ||
+            (workflowBody !== undefined
+                ? createTempWorkflowFile(workingDir, workflowBody)
+                : undefined));
+        const eventPayloadFileOrBody = this.eventPayloadFileOrBody;
+        const eventPayloadFilePath = typeof eventPayloadFileOrBody === 'object'
+            ? createTempEventPayloadFile(workingDir, eventPayloadFileOrBody)
+            : typeof eventPayloadFileOrBody === 'string'
+                ? eventPayloadFileOrBody
+                : undefined;
+        const overwrittenManagedParams = this.additionalArgs.filter((it) => MANAGED_ACT_PARAMS.has(it));
+        if (overwrittenManagedParams.length > 0) {
+            throw new ActRunnerError(`The following act arguments must be set via dedicated ActRunner methods, and not via 'withAdditionalArguments': ${overwrittenManagedParams}`);
+        }
+        const overwrittenInternalParams = this.additionalArgs.filter((it) => INTERNAL_ACT_PARAMS.has(it));
+        if (overwrittenInternalParams.length > 0) {
+            throw new ActRunnerError(`The following act arguments must not be set via 'withAdditionalArguments', as they are managed by the ActRunner: ${overwrittenInternalParams}`);
+        }
+        return new ActCliParams({
+            workflowsPath: workflowFilePath,
+            eventPayloadFilePath,
+            eventType: this.eventType,
+            envSource: this.envSource,
+            inputsSource: this.inputsSource,
+            secretsSource: this.secretsSource,
+            variablesSource: this.variablesSource,
+            matrixValues: this.matrixValues,
+            cacheServer: this.cacheServer,
+            artifactServer: this.artifactServer,
+            additionalArgs: this.additionalArgs,
+        });
+    }
+}

package/dist/ActRunnerError.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) 2025 original authors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+/**
+ * Error thrown if the `ActRunner` is mis-configured or if the runner encounters an unexpected error.
+ */
+export declare class ActRunnerError extends Error {
+}

package/dist/ActRunnerError.js

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) 2025 original authors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+/**
+ * Error thrown if the `ActRunner` is mis-configured or if the runner encounters an unexpected error.
+ */
+export class ActRunnerError extends Error {
+}

package/dist/ActRunnerOptions.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Copyright (c) 2026 original authors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+/** Options controlling a single `run()` invocation. */
+export type ActProcessOptions = {
+    /**
+     * Signal used to abort a running act invocation. On abort, the underlying act
+     * process is killed and the returned promise rejects with an ActRunnerError.
+     */
+    signal?: AbortSignal;
+};
+/**
+ * Source of key/value pairs (environment variables, inputs, secrets, or
+ * variables), provided via a file, inline values, or both.
+ */
+export type ActValueSource = {
+    /** Path to a file containing the values. */
+    file?: string;
+    /** Inline values. */
+    values?: Record<string, string>;
+};
+/**
+ * Source of the GitHub workflow to run, provided either as a file path or
+ * inline body.
+ */
+export type ActWorkflowSource = {
+    file: string;
+} | {
+    body: string;
+};
+/** Configuration for the cache or artifact server used by a workflow run. */
+export type ActResourceServerSpec = {
+    /** The path where the server's data will be stored. */
+    path: string;
+    /** The address to which the server binds. */
+    host?: string;
+    /** The port on which the server listens. */
+    port?: number;
+};

package/dist/ActRunnerOptions.js

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2026 original authors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+export {};

package/dist/ActRunnerResult.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) 2026 original authors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+/** Matrix values a job ran with. */
+export type ActMatrixValues = Record<string, string | number | boolean>;
+/** Result of the workflow execution. */
+export type ActWorkflowExecResult = {
+    /** Outcome of the workflow run. */
+    readonly status: ActExecStatus;
+    /** Workflow's console output. */
+    readonly output: string;
+    /** Jobs executed by the workflow, keyed by job name. */
+    readonly jobs: Record<string, ActJobExecResult>;
+};
+/** Outcome of the workflow or job execution. */
+export declare const ActExecStatus: {
+    readonly SUCCESS: 'SUCCESS';
+    readonly FAILED: 'FAILED';
+    readonly SKIPPED: 'SKIPPED';
+};
+/** Outcome of the workflow or job execution. */
+export type ActExecStatus = (typeof ActExecStatus)[keyof typeof ActExecStatus];
+/** Job execution result for inspection. */
+export type ActJobExecResult = {
+    /** Name of the job run. */
+    readonly name: string;
+    /** Result of the job execution. */
+    readonly status: ActExecStatus;
+    /** Job's console output. */
+    readonly output: string;
+    /** Matrix values the job ran with. */
+    readonly matrix: ActMatrixValues;
+    /** Steps executed by the job, in the order they ran. */
+    readonly steps: ActStepExecResult[];
+};
+/** Step execution result for inspection. */
+export type ActStepExecResult = {
+    /** Name of the step run. */
+    readonly name: string;
+    /** Result of the step execution. */
+    readonly status: ActExecStatus;
+    /** Step's console output. */
+    readonly output: string;
+};
+/**
+ * Error thrown if the `ActRunner` is mis-configured or if the runner encounters
+ * an unexpected error.
+ */
+export declare class ActRunnerError extends Error {
+}

package/dist/ActRunnerResult.js

@@ -0,0 +1,33 @@
+/**
+ * Copyright (c) 2026 original authors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+/** Outcome of the workflow or job execution. */
+export const ActExecStatus = {
+    SUCCESS: 'SUCCESS',
+    FAILED: 'FAILED',
+    SKIPPED: 'SKIPPED',
+};
+/**
+ * Error thrown if the `ActRunner` is mis-configured or if the runner encounters
+ * an unexpected error.
+ */
+export class ActRunnerError extends Error {
+}

package/dist/ActWorkflowExecResult.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Copyright (c) 2025 original authors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+import { ActExecStatus } from './ActExecStatus.js';
+import { ActJobExecResult } from './ActJobExecResult.js';
+/**
+ * Result of the workflow execution.
+ */
+export declare class ActWorkflowExecResult {
+    /**
+     * Outcome of the workflow run.
+     */
+    readonly status: ActExecStatus;
+    /**
+     * Workflow's console output.
+     */
+    readonly output: string;
+    /**
+     * Jobs executed by the workflow.
+     */
+    readonly jobs: Map<String, ActJobExecResult>;
+    constructor(status: ActExecStatus, output: string, jobs: Map<String, ActJobExecResult>);
+    /**
+     * @param name - name of the job executed by the given workflow.
+     * @returns job - result of executing the given job in the context of the current workflow.
+     */
+    job(name: string): ActJobExecResult | undefined;
+}

package/dist/ActWorkflowExecResult.js

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2025 original authors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+/**
+ * Result of the workflow execution.
+ */
+export class ActWorkflowExecResult {
+    /**
+     * Outcome of the workflow run.
+     */
+    status;
+    /**
+     * Workflow's console output.
+     */
+    output;
+    /**
+     * Jobs executed by the workflow.
+     */
+    jobs;
+    constructor(status, output, jobs) {
+        this.status = status;
+        this.output = output;
+        this.jobs = jobs;
+    }
+    /**
+     * @param name - name of the job executed by the given workflow.
+     * @returns job - result of executing the given job in the context of the current workflow.
+     */
+    job(name) {
+        return this.jobs.get(name);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright (c) 2026 original authors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+export { ActRunner } from './ActRunner.js';
+export type { ActProcessOptions, ActValueSource, ActWorkflowSource, ActResourceServerSpec, } from './ActRunnerOptions.js';
+export type { ActJobOrStepDescriptor as ActOutputOwner, ActOutputListener, ActOutput, } from './ActOutputListener.js';
+export { ActOutputLevel, StdStreamOutputListener, } from './ActOutputListener.js';
+export { ActExecStatus, ActRunnerError } from './ActRunnerResult.js';
+export type { ActJobExecResult, ActMatrixValues, ActStepExecResult, ActWorkflowExecResult, } from './ActRunnerResult.js';