Struct Workspace 

pub struct Workspace {

    pub version: u32,
    pub working_dir: PathBuf,
    pub split_layout: SerializedSplitNode,
    pub active_split_id: usize,
    pub split_states: HashMap<usize, SerializedSplitViewState>,
    pub config_overrides: WorkspaceConfigOverrides,
    pub file_explorer: FileExplorerState,
    pub histories: WorkspaceHistories,
    pub search_options: SearchOptions,
    pub bookmarks: HashMap<char, SerializedBookmark>,
    pub terminals: Vec<SerializedTerminalWorkspace>,
    pub external_files: Vec<PathBuf>,
    pub unnamed_buffers: Vec<UnnamedBufferRef>,
    pub plugin_global_state: HashMap<String, HashMap<String, Value>>,
    pub saved_at: u64,
}

Persisted workspace state for a working directory

Fields

version: u32

Schema version for future migrations

working_dir: PathBuf

Working directory this workspace belongs to (for validation)

split_layout: SerializedSplitNode

Split layout tree

active_split_id: usize

Active split ID

split_states: HashMap<usize, SerializedSplitViewState>

Per-split view states (keyed by split_id)

config_overrides: WorkspaceConfigOverrides

Editor config overrides (toggles that differ from defaults)

file_explorer: FileExplorerState

File explorer state

histories: WorkspaceHistories

Input histories (search, replace, command palette, etc.)

search_options: SearchOptions

Search options (persist across searches within workspace)

bookmarks: HashMap<char, SerializedBookmark>

Bookmarks (character key -> file position)

terminals: Vec<SerializedTerminalWorkspace>

Open terminal workspaces (for restoration)

external_files: Vec<PathBuf>

External files open in the workspace (files outside working_dir) These are stored as absolute paths since they can’t be made relative

unnamed_buffers: Vec<UnnamedBufferRef>

Unnamed buffers that should be restored from recovery files

plugin_global_state: HashMap<String, HashMap<String, Value>>

Plugin-managed global state, isolated per plugin name. Persisted across sessions so plugins can store non-buffer-specific state. TODO: Need to think about plugin isolation / namespacing strategy for these APIs.

saved_at: u64

Timestamp when workspace was saved (Unix epoch seconds)

Implementations

impl Workspace

pub fn load(working_dir: &Path) -> Result<Option<Workspace>, WorkspaceError>

Load workspace for a working directory (if exists)

pub fn save(&self) -> Result<(), WorkspaceError>

Save workspace to file using atomic write (temp file + rename)

This ensures the workspace file is never left in a corrupted state:

1. Write to a temporary file in the same directory
2. Sync to disk (fsync)
3. Atomically rename to the final path

pub fn load_session( session_name: &str, working_dir: &Path, ) -> Result<Option<Workspace>, WorkspaceError>

Load workspace for a named session (if exists)

pub fn save_session(&self, session_name: &str) -> Result<(), WorkspaceError>

Save workspace for a named session using atomic write

pub fn delete(working_dir: &Path) -> Result<(), WorkspaceError>

Delete workspace for a working directory

pub fn new(working_dir: PathBuf) -> Self

Create a new workspace with current timestamp

pub fn touch(&mut self)

Update the saved_at timestamp to now

Trait Implementations

impl Clone for Workspace

fn clone(&self) -> Workspace

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Workspace

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Workspace

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Workspace

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.