KSLCore/ksl.app.session/KSLRuntimeError

KSLRuntimeError

Typed representation of errors that can occur during a simulation run.

Runner translates caught exceptions into one of these variants and emits RunEvent.RunFailed so that a GUI or downstream consumer can respond to the specific failure kind without inspecting raw exception types.

Inheritors

Constructors

KSLRuntimeError

protected constructor()

Types

ConfigurationError

data class ConfigurationError(val message: String, val validationResult: ValidationResult? = null, val cause: Throwable? = null) : KSLRuntimeError

The run could not proceed due to an invalid or inconsistent configuration. Used by Phase 3 pre-flight validation and future RunConfiguration-backed runner entry points.

ExecutiveError

data class ExecutiveError(val simTime: Double, val replicationNumber: Int, val cause: Throwable) : KSLRuntimeError

An unexpected exception was thrown during replication execution.

JarLoadError

data class JarLoadError(val jarPath: String, val builderClassName: String?, val message: String, val cause: Throwable? = null) : KSLRuntimeError

Failure while loading or building a model from an external JAR.

ModelBuildError

data class ModelBuildError(val message: String, val cause: Throwable) : KSLRuntimeError

Failure during model construction or initial setup — before any replications execute. Primarily used in Phase 3+ when Runner builds the model from a RunConfiguration; in Phase 1 the caller provides a pre-built model, so this is unlikely but kept for completeness.