ae-workspace

Use ae-cli workspace for AgentSpace operations. Here, workspace_id and --workspace-id always mean AgentSpace.id; they never mean the legacy sandbox Workspace.id or a filesystem directory name.

Before composing a workspace command, read references/commands.md. It contains the command matrix, mutation prerequisites, and file-transfer rules.

Targeting

1. Prefer an explicit --workspace-id supplied by the user or returned by workspace list.
2. Inside a run, the CLI may use TE_AGENT_CURRENT_AGENT_SPACE_ID, derive the ID from the canonical /spaces/actived/<id>/.conversations/... runtime directory, or ask the server to resolve TE_AGENT_CONVERSATION_ID.
3. When both workspace and conversation are available, send both so the server can reject a scope mismatch.
4. Outside a run, if the target is unknown, run workspace list and select from real IDs. Never fall back to an account default.

Use workspace current to verify the resolved ID, space type, role, and capabilities before a multi-step mutation.

Safety