包package io.agentscope.harness.agent.sandbox

io.agentscope.harness.agent.sandbox

package io.agentscope.harness.agent.sandbox

io.agentscope.harness.agent.sandbox 属于运行时与部署，服务化、调度、控制面与 Web 应用。该包共收录 33 个公开类型。

io.agentscope.harness.agent.sandbox belongs to the Runtime & deployment layer and contains 33 public types.

所属构件Artifacts agentscope-harness

接口Interfaces

类型Type	种类Kind	说明Description
`Sandbox`	接口interface	定义沙箱契约的接口。 An active sandbox with a fully isolated workspace.
`SandboxAware`	接口interface	定义沙箱 Aware契约的接口。 Marks a filesystem that can have its backing `Sandbox` injected at runtime.
`SandboxClient`	接口interface	定义沙箱客户端契约的接口。 Factory for creating and resuming `Sandbox` instances.
`SandboxExecutionGuard`	接口interface	定义沙箱执行守卫契约的接口。 Pluggable concurrency guard for sandbox execution slots.
`SandboxFileTransfer`	接口interface	定义沙箱文件 Transfer契约的接口。 Optional capability for `Sandbox` backends that support native (non-exec) file transfer, e.g.
`SandboxLease`	接口interface	定义沙箱 Lease契约的接口。 A handle that represents a held execution right on a sandbox isolation slot.

类Classes

类型Type	种类Kind	说明Description
`AbstractBaseSandbox`	类class	抽象基类沙箱，承载智能体的部署、调度与服务化运行。 Abstract base implementation of `Sandbox` with the 4-branch workspace start logic.
`SandboxAcquireResult`	类class	沙箱 Acquire 结果，承载智能体的部署、调度与服务化运行。 Result of acquiring a `Sandbox` from `SandboxManager`.
`SandboxClientOptions`	类class	沙箱客户端配置选项的基类。 Base class for sandbox client configuration options.
`SandboxContext`	类class	用于沙箱行为的不可变配置。 Immutable configuration for sandbox behavior.
`SandboxException`	类class	沙箱异常，表示执行过程中的错误。 Base exception for all sandbox operations.
`SandboxIsolationKey`	类class	沙箱隔离键，承载智能体的部署、调度与服务化运行。 Immutable key that uniquely identifies a sandbox state slot for a given `IsolationScope`.
`SandboxManager`	类class	沙箱管理器，承载智能体的部署、调度与服务化运行。 Manages the lifecycle of `Sandbox` instances for the current call.
`SandboxState`	类class	沙箱状态，承载智能体的部署、调度与服务化运行。 Serializable state of a sandbox, persisted by `SessionSandboxStateStore` so a sandbox can be resumed across calls.
`SessionSandboxStateStore`	类class	会话沙箱状态存储，负责持久化与读取数据。 Sandbox state store backed by the generic AgentScope `AgentStateStore` abstraction.
`WorkspaceArchiveExtractor`	类class	工作区归档 Extractor，承载智能体的部署、调度与服务化运行。 Securely extracts tar archives into a target directory.
`WorkspaceMountSupport`	类class	工作区 Mount Support，承载智能体的部署、调度与服务化运行。 Helpers for `io.agentscope.harness.agent.sandbox.layout.BindMountEntry` handling.
`WorkspaceProjectionApplier`	类class	工作区 Projection Applier，承载智能体的部署、调度与服务化运行。 Builds a deterministic archive payload for workspace projection entries.
`WorkspaceSpec`	类class	工作区规格，承载智能体的部署、调度与服务化运行。 Describes the desired initial state of a sandbox workspace: root path, materialized file/directory entries, and per-exec environment variables.
`WorkspaceSpecApplier`	类class	工作区规格 Applier，承载智能体的部署、调度与服务化运行。 Applies a `WorkspaceSpec` to a target directory by materializing declared entries (files, directories, local copies).

枚举Enums

类型Type	种类Kind	说明Description
`SandboxErrorCode`	枚举enum	定义沙箱错误 Code相关取值的枚举。 Error codes for sandbox operations, used in `SandboxException` and its subclasses.

记录Records

类型Type	种类Kind	说明Description
`ExecResult`	记录record	沙箱命令执行的结果。 Result of a sandbox command execution.