WorkspaceMode

Controls how a declared subagent's runtime workspace root is determined.

The five-row decision table:

workspacePath mode runtime-workspace-root
─────────────────────────────────────────────────────────────────────────────
set ISOLATED workspacePath (definition dir is also the runtime root)
set SHARED mainWorkspace (definition skills/knowledge ignored)
null ISOLATED mainWorkspace/agents/<name>/workspace/ (auto-created)
null SHARED mainWorkspace
(general-purpose, always SHARED) mainWorkspace (fully mirrors main agent)

Phase B-0 — persisted session bucketing: ISOLATED-mode subagents bucket their persisted state by parent (userId, parentSessionId) when the spawn-time io.agentscope.core.agent.RuntimeContext carries those fields. The composed key has form {declarationName}[@{parentSessionId}][#{userId}] and is applied uniformly across io.agentscope.core.state.AgentStateStore stores (Workspace, Redis, InMemory, custom), because all of them already partition state by (userId, sessionId). SHARED-mode is unchanged — those subagents intentionally use the parent's bucket and do not multi-tenant.