SandboxException
public class SandboxException extends RuntimeExceptionio/agentscope/harness/agent/sandbox/SandboxException.java:28–329沙箱异常，表示执行过程中的错误。位于 io.agentscope.harness.agent.sandbox 包，继承自 RuntimeException。核心成员包括 getErrorCode、getOp、SandboxException。
Base exception for all sandbox operations.
Specialized subclasses are provided as static nested classes for common failure modes:
SandboxConfigurationException, SandboxRuntimeException,
WorkspaceStartException, WorkspaceStopException,
ExecException, ExecTimeoutException, SnapshotException.
嵌套类摘要Nested Class Summary
| 类Class | 类型Kind | 说明Description |
|---|---|---|
SandboxConfigurationException | 类class | 沙箱配置异常，表示执行过程中的错误。 Thrown when sandbox configuration is invalid or missing (e.g. |
SandboxRuntimeException | 类class | 沙箱运行时异常，表示执行过程中的错误。 Thrown for general sandbox runtime failures not covered by a more specific subclass. |
WorkspaceStartException | 类class | 工作区启动异常，表示执行过程中的错误。 Thrown when the workspace backend fails to start. |
WorkspaceStopException | 类class | 工作区停止异常，表示执行过程中的错误。 Thrown when the workspace backend fails to stop. |
ExecException | 类class | Exec 异常，表示执行过程中的错误。 Thrown when a sandbox command exits with a non-zero exit code. |
ExecTimeoutException | 类class | Exec 超时异常，表示执行过程中的错误。 Thrown when a sandbox command times out. |
SnapshotException | 类class | 快照异常，表示执行过程中的错误。 Thrown when a snapshot operation (persist or restore) fails. |
构造器摘要Constructor Summary
| 构造器Constructor | 说明Description |
|---|---|
public SandboxException(SandboxErrorCode errorCode, String message) | 初始化 `SandboxException` 实例。 Creates a sandbox exception with an error code and message. |
public SandboxException(SandboxErrorCode errorCode, String message, Throwable cause) | 初始化 `SandboxException` 实例。 Creates a sandbox exception with an error code, message, and cause. |
public SandboxException(SandboxErrorCode errorCode, String op, String message, Throwable cause) | 初始化 `SandboxException` 实例。 Creates a sandbox exception with an error code, operation name, message, and cause. |
方法摘要Method Summary
| 方法Method | 说明Description |
|---|---|
public SandboxErrorCode getErrorCode() | 获取 `getErrorCode`。 Returns the error code classifying this failure. |
public String getOp() | 获取Op。 Returns the operation name that failed, or `null` if not specified. |
构造器详情Constructor Detail
SandboxException
public SandboxException(SandboxErrorCode errorCode, String message)初始化 SandboxException 实例。
Creates a sandbox exception with an error code and message.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
errorCode | SandboxErrorCode | 错误 Code（类型 `SandboxErrorCode`）。the error code classifying the failure |
message | String | 消息（类型 `String`）。human-readable description |
io/agentscope/harness/agent/sandbox/SandboxException.java:39–43SandboxException
public SandboxException(SandboxErrorCode errorCode, String message, Throwable cause)初始化 SandboxException 实例。
Creates a sandbox exception with an error code, message, and cause.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
errorCode | SandboxErrorCode | 错误 Code（类型 `SandboxErrorCode`）。the error code classifying the failure |
message | String | 消息（类型 `String`）。human-readable description |
cause | Throwable | cause（类型 `Throwable`）。the underlying cause |
io/agentscope/harness/agent/sandbox/SandboxException.java:52–56SandboxException
public SandboxException(SandboxErrorCode errorCode, String op, String message, Throwable cause)初始化 SandboxException 实例。
Creates a sandbox exception with an error code, operation name, message, and cause.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
errorCode | SandboxErrorCode | 错误 Code（类型 `SandboxErrorCode`）。the error code classifying the failure |
op | String | op（类型 `String`）。the operation that failed (e.g. "start", "exec", "persist") |
message | String | 消息（类型 `String`）。human-readable description |
cause | Throwable | cause（类型 `Throwable`）。the underlying cause |
io/agentscope/harness/agent/sandbox/SandboxException.java:66–71方法详情Method Detail
getErrorCode
public SandboxErrorCode getErrorCode()获取 getErrorCode。
Returns the error code classifying this failure.
SandboxErrorCodeio/agentscope/harness/agent/sandbox/SandboxException.java:78–80getOp
public String getOp()获取Op。
Returns the operation name that failed, or null if not specified.
Stringio/agentscope/harness/agent/sandbox/SandboxException.java:87–89嵌套类详情Nested Class Detail
SandboxConfigurationException
public static class SandboxConfigurationException extends SandboxException沙箱配置异常，表示执行过程中的错误。位于 io.agentscope.harness.agent.sandbox 包，继承自 SandboxException。核心成员包括 SandboxConfigurationException。
Thrown when sandbox configuration is invalid or missing (e.g. no client configured).
SandboxRuntimeException
public static class SandboxRuntimeException extends SandboxException沙箱运行时异常，表示执行过程中的错误。位于 io.agentscope.harness.agent.sandbox 包，继承自 SandboxException。核心成员包括 SandboxRuntimeException。
Thrown for general sandbox runtime failures not covered by a more specific subclass.
WorkspaceStartException
public static class WorkspaceStartException extends SandboxException工作区启动异常，表示执行过程中的错误。位于 io.agentscope.harness.agent.sandbox 包，继承自 SandboxException。核心成员包括 getPath、WorkspaceStartException。
Thrown when the workspace backend fails to start.
WorkspaceStopException
public static class WorkspaceStopException extends SandboxException工作区停止异常，表示执行过程中的错误。位于 io.agentscope.harness.agent.sandbox 包，继承自 SandboxException。核心成员包括 getPath、WorkspaceStopException。
Thrown when the workspace backend fails to stop.
ExecException
public static class ExecException extends SandboxExceptionExec 异常，表示执行过程中的错误。位于 io.agentscope.harness.agent.sandbox 包，继承自 SandboxException。核心成员包括 getExitCode、getStdout、getStderr、ExecException。
Thrown when a sandbox command exits with a non-zero exit code.
ExecTimeoutException
public static class ExecTimeoutException extends SandboxExceptionExec 超时异常，表示执行过程中的错误。位于 io.agentscope.harness.agent.sandbox 包，继承自 SandboxException。核心成员包括 ExecTimeoutException。
Thrown when a sandbox command times out.
SnapshotException
public static class SnapshotException extends SandboxException快照异常，表示执行过程中的错误。位于 io.agentscope.harness.agent.sandbox 包，继承自 SandboxException。核心成员包括 getSnapshotId、SnapshotException。
Thrown when a snapshot operation (persist or restore) fails.