IsolationScope

Controls how agent state is isolated and shared across calls.

This enum is the canonical isolation-scope definition used by both the sandbox filesystem backend (io.agentscope.harness.agent.sandbox.SandboxContext) and the remote filesystem backend (RemoteFilesystemSpec).

Sandbox semantics: the scope determines which key is used when persisting and loading _sandbox.json state. Calls that resolve to the same scope key will sequentially reuse the same sandbox (each call resumes the persisted state from the previous one).

Store namespace semantics: the scope determines the namespace prefix used by RemoteFilesystem when routing files to the shared key-value store. Different scopes produce different namespace prefixes, controlling which calls share the same view of stored files.

Scope selection:

• #USER – shared across all sessions of the same user; the default. When userId is absent, falls back to #SESSION.

• #SESSION – isolated per session.

• #AGENT – shared across all users and sessions of the same agent.

• #GLOBAL – globally shared within the same workspace/store instance.

Concurrency note: for sandbox mode this is sequential-reuse sharing, not live-instance sharing. Concurrent calls at the same scope each get their own running container; they converge on the last persisted snapshot at the end of the call.