everruns-runtime 0.17.3

// Mount-based workspace filesystem (EVE-660).
//
// Demonstrates `MountFs`: the agent sees ONE namespace where `/workspace` is a
// mount point and the default current working directory — not a magic prefix
// re-implemented in every store. The same resolver works over the in-memory VFS
// and over a real host directory, and a worktree switch repoints every surface
// at once while the model-facing `/workspace` stays stable.
//
// Run it:
//   cargo run -p everruns-runtime --example mount_fs_workspace
//
// See `specs/file-store.md` for the contract.

use everruns_core::{MountFs, SessionFileSystem, SessionId};
use everruns_runtime::{InMemorySessionFileStore, RealDiskFileStore};
use std::sync::Arc;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let session = SessionId::new();

    // ---------------------------------------------------------------------
    // 1. One namespace + cwd, over the in-memory VFS.
    // ---------------------------------------------------------------------
    let backend: Arc<dyn SessionFileSystem> = Arc::new(InMemorySessionFileStore::new());
    let fs = MountFs::wrap(backend);

    // Write the file using the `/workspace` mount view.
    fs.write_file(session, "/workspace/src/lib.rs", "fn main() {}", "text")
        .await?;

    // The same file is reachable three ways — all resolve to one backend key:
    //   * the /workspace mount view
    //   * the backend-native absolute path
    //   * a path relative to the cwd (which defaults to /workspace)
    for input in ["/workspace/src/lib.rs", "/src/lib.rs", "src/lib.rs"] {
        let file = fs.read_file(session, input).await?.expect("file exists");
        assert_eq!(file.content.as_deref(), Some("fn main() {}"));
        // The store keys it at /src/lib.rs; `/workspace` is never in the keyspace.
        assert_eq!(file.path, "/src/lib.rs");
        println!("read {input:<24} -> backend key {} ✓", file.path);
    }

    // Display renders the stable /workspace view for the model.
    assert_eq!(fs.display_root(), "/workspace");
    assert_eq!(fs.display_path("/src/lib.rs"), "/workspace/src/lib.rs");
    println!(
        "display_root = {}, display_path(/src/lib.rs) = {}",
        fs.display_root(),
        fs.display_path("/src/lib.rs")
    );

    // ---------------------------------------------------------------------
    // 2. The same resolver over a real host directory, across a worktree switch.
    // ---------------------------------------------------------------------
    let worktree_a = tempfile::tempdir()?;
    let worktree_b = tempfile::tempdir()?;

    let disk = Arc::new(RealDiskFileStore::new(worktree_a.path())?);
    let host_fs = MountFs::wrap(disk.clone());

    host_fs
        .write_file(session, "/workspace/notes.md", "from worktree A", "text")
        .await?;
    let on_disk_a = std::fs::read_to_string(disk.root().join("notes.md"))?;
    println!("\nworktree A root: {}", disk.root().display());
    println!("  /workspace/notes.md -> on disk: {on_disk_a:?}");
    assert_eq!(on_disk_a, "from worktree A");

    // The embedder switches worktrees: repoint the host root once.
    disk.set_host_root(worktree_b.path())?;
    host_fs
        .write_file(session, "/workspace/notes.md", "from worktree B", "text")
        .await?;
    let on_disk_b = std::fs::read_to_string(disk.root().join("notes.md"))?;
    println!("worktree B root: {}", disk.root().display());
    println!("  /workspace/notes.md -> on disk: {on_disk_b:?}");
    assert_eq!(on_disk_b, "from worktree B");

    // The model-facing namespace never changed, even though the disk root did.
    assert_eq!(host_fs.display_root(), "/workspace");
    println!(
        "\nmodel-facing root stayed `{}` across the switch ✓",
        host_fs.display_root()
    );

    println!("\nmount_fs_workspace example OK");
    Ok(())
}