Struct SessionWorkspace 

pub struct SessionWorkspace {

    pub id: WorkspaceId,
    pub session_id: SessionId,
    pub repo_id: RepoId,
    pub agent_id: AgentId,
    pub agent_name: String,
    pub changeset_id: Uuid,
    pub intent: String,
    pub base_commit: String,
    pub overlay: FileOverlay,
    pub graph: SessionGraph,
    pub mode: WorkspaceMode,
    pub state: WorkspaceState,
    pub created_at: Instant,
    pub last_active: Instant,
}

An isolated workspace for a single agent session.

Reads resolve overlay-first, then fall through to the Git tree at base_commit. Writes go exclusively to the overlay.

Fields

id: WorkspaceId

session_id: SessionId

repo_id: RepoId

agent_id: AgentId

agent_name: String

changeset_id: Uuid

intent: String

base_commit: String

overlay: FileOverlay

graph: SessionGraph

mode: WorkspaceMode

state: WorkspaceState

created_at: Instant

last_active: Instant

Implementations

impl SessionWorkspace

pub async fn new( session_id: SessionId, repo_id: RepoId, agent_id: AgentId, changeset_id: Uuid, intent: String, base_commit: String, mode: WorkspaceMode, agent_name: String, db: PgPool, ) -> Result<Self>

Create a new workspace and persist metadata to the database.

pub fn read_file( &self, path: &str, git_repo: &GitRepository, ) -> Result<FileReadResult>

Read a file through the overlay-first layer.

1. If the overlay has a Modified or Added entry, return that content.
2. If the overlay has a Deleted entry, return a “not found” error.
3. Otherwise, read from the Git tree at base_commit.

pub async fn write_file( &self, path: &str, content: Vec<u8>, git_repo: &GitRepository, ) -> Result<String>

Write a file through the overlay.

Determines whether the file is new (not in base tree) or modified.

pub async fn delete_file(&self, path: &str) -> Result<()>

Delete a file in the overlay.

pub fn list_files( &self, git_repo: &GitRepository, only_modified: bool, prefix: Option<&str>, ) -> Result<Vec<String>>

List files visible in this workspace.

If only_modified is true, return only overlay entries. Otherwise, return the full base tree merged with overlay changes.

When prefix is Some, only paths starting with the given prefix are included. The filter is applied early in the pipeline so that building the HashSet only contains relevant entries rather than the entire tree (which can be 100k+ files in large repos).

pub fn touch(&mut self)

Touch the workspace to update last-active timestamp.

pub fn overlay_for_tree(&self) -> Vec<(String, Option<Vec<u8>>)>

Build the overlay vector for commit_tree_overlay.

Returns (path, Some(content)) for modified/added files and (path, None) for deleted files.