Package io.agentscope.harness.agent.sandbox

Class SandboxException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.agentscope.harness.agent.sandbox.SandboxException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

SandboxException.ExecException, SandboxException.ExecTimeoutException, SandboxException.SandboxConfigurationException, SandboxException.SandboxRuntimeException, SandboxException.SnapshotException, SandboxException.WorkspaceStartException, SandboxException.WorkspaceStopException

public class SandboxException
extends RuntimeException

Base exception for all sandbox operations.

Specialized subclasses are provided as static nested classes for common failure modes: SandboxException.SandboxConfigurationException, SandboxException.SandboxRuntimeException, SandboxException.WorkspaceStartException, SandboxException.WorkspaceStopException, SandboxException.ExecException, SandboxException.ExecTimeoutException, SandboxException.SnapshotException.

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SandboxException.ExecException	Thrown when a sandbox command exits with a non-zero exit code.
static class	SandboxException.ExecTimeoutException	Thrown when a sandbox command times out.
static class	SandboxException.SandboxConfigurationException	Thrown when sandbox configuration is invalid or missing (e.g. no client configured).
static class	SandboxException.SandboxRuntimeException	Thrown for general sandbox runtime failures not covered by a more specific subclass.
static class	SandboxException.SnapshotException	Thrown when a snapshot operation (persist or restore) fails.
static class	SandboxException.WorkspaceStartException	Thrown when the workspace backend fails to start.
static class	SandboxException.WorkspaceStopException	Thrown when the workspace backend fails to stop.

Constructor Summary

Constructors

Constructor	Description
SandboxException(SandboxErrorCode errorCode, String message)	Creates a sandbox exception with an error code and message.
SandboxException(SandboxErrorCode errorCode, String op, String message, Throwable cause)	Creates a sandbox exception with an error code, operation name, message, and cause.
SandboxException(SandboxErrorCode errorCode, String message, Throwable cause)	Creates a sandbox exception with an error code, message, and cause.

Method Summary

Modifier and Type	Method	Description
SandboxErrorCode	getErrorCode()	Returns the error code classifying this failure.
String	getOp()	Returns the operation name that failed, or null if not specified.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

SandboxException

public SandboxException(SandboxErrorCode errorCode,
 String message)

Creates a sandbox exception with an error code and message.

Parameters:

errorCode - the error code classifying the failure

message - human-readable description

SandboxException

public SandboxException(SandboxErrorCode errorCode,
 String message,
 Throwable cause)

Creates a sandbox exception with an error code, message, and cause.

Parameters:

errorCode - the error code classifying the failure

message - human-readable description

cause - the underlying cause

SandboxException

public SandboxException(SandboxErrorCode errorCode,
 String op,
 String message,
 Throwable cause)

Creates a sandbox exception with an error code, operation name, message, and cause.

Parameters:

errorCode - the error code classifying the failure

op - the operation that failed (e.g. "start", "exec", "persist")

message - human-readable description

cause - the underlying cause

Method Details

getErrorCode

public SandboxErrorCode getErrorCode()

Returns the error code classifying this failure.

Returns:

the error code

getOp

public String getOp()

Returns the operation name that failed, or null if not specified.

Returns:

operation name, may be null