1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
// Session path normalization: the `/workspace` display alias ⇄ the canonical
// leading-slash session path (`/src/lib.rs`).
//
// These are host-agnostic *string* helpers shared by the VFS-backed stores, the
// `file_system` capability, and the `SessionFileSystem` display defaults. They
// carry no host-filesystem knowledge. Mapping the virtual namespace onto a real
// host directory (containment, symlink rejection, worktree-root switches) is a
// backend concern and lives with the host-backed store
// (`everruns_runtime::RealDiskFileStore`), not here — `/workspace` is just the
// model-facing view, resolved into mounts by `MountFs`.
/// The display alias shown to models and UIs for the workspace root.
///
/// `/workspace` is a common cloud-agent convention (DevContainers, Codespaces).
/// It is purely a *view*; addressing is done by [`crate::mount_fs::MountFs`].
pub const WORKSPACE_PREFIX: &str = "/workspace";
/// Canonical leading-slash session path from any accepted spelling: collapses
/// repeated slashes, strips the `/workspace` alias, ensures a single leading
/// slash, and trims a trailing slash.
///
/// This is the single normalizer for every session-path surface — the agent
/// (via `MountFs`/the VFS backends) and the control-plane HTTP FS API both route
/// through it, so a path resolves to the same key regardless of entry point.
///
/// Examples: `/workspace` → `/`, `/workspace/a.txt` → `/a.txt`,
/// `/workspacefoo` → `/workspacefoo`, `a.txt` → `/a.txt`, `/sub/dir/` → `/sub/dir`,
/// `/a//b/` → `/a/b`.
pub fn to_session_path(input: &str) -> String {
let collapsed = collapse_slashes(input.trim());
let stripped = strip_workspace_alias(&collapsed);
if stripped.is_empty() || stripped == "/" {
return "/".to_string();
}
let mut normalized = if stripped.starts_with('/') {
stripped.to_string()
} else {
format!("/{stripped}")
};
while normalized.len() > 1 && normalized.ends_with('/') {
normalized.pop();
}
normalized
}
/// Collapse runs of `/` into a single `/` (`a//b` → `a/b`). Leaves the rest of
/// the string untouched.
fn collapse_slashes(s: &str) -> String {
let mut out = String::with_capacity(s.len());
let mut prev_slash = false;
for ch in s.chars() {
if ch == '/' {
if !prev_slash {
out.push(ch);
}
prev_slash = true;
} else {
out.push(ch);
prev_slash = false;
}
}
out
}
/// Model-facing display for a canonical session path: the `/workspace` alias.
///
/// `/` → `/workspace`, `/a.txt` → `/workspace/a.txt`. This is the default
/// rendering for VFS stores; backends with a different notion of "where files
/// live" (e.g. a host directory) override `display_path`/`display_root`.
pub fn to_display_path(session_path: &str) -> String {
let canonical = to_session_path(session_path);
if canonical == "/" {
WORKSPACE_PREFIX.to_string()
} else {
format!("{WORKSPACE_PREFIX}{canonical}")
}
}
/// Strip the canonical `/workspace` alias only (exact match or `/workspace/`
/// prefix). Returns the remainder, which may or may not have a leading slash.
fn strip_workspace_alias(s: &str) -> &str {
if s == WORKSPACE_PREFIX {
return "";
}
if let Some(rest) = s.strip_prefix(&format!("{WORKSPACE_PREFIX}/")) {
return rest;
}
s
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn to_session_path_normalizes_alias_and_slashes() {
assert_eq!(to_session_path("/workspace"), "/");
assert_eq!(to_session_path("/workspace/test.txt"), "/test.txt");
assert_eq!(
to_session_path("/workspace/foo/bar/test.txt"),
"/foo/bar/test.txt"
);
assert_eq!(to_session_path("/test.txt"), "/test.txt");
// `/workspacefoo` is not the `/workspace` segment.
assert_eq!(to_session_path("/workspacefoo"), "/workspacefoo");
assert_eq!(to_session_path("foo.txt"), "/foo.txt");
assert_eq!(to_session_path("/sub/dir/"), "/sub/dir");
assert_eq!(to_session_path(" /workspace/x "), "/x");
}
#[test]
fn to_session_path_collapses_repeated_slashes() {
assert_eq!(to_session_path("/a//b"), "/a/b");
assert_eq!(to_session_path("//a///b//"), "/a/b");
assert_eq!(to_session_path("//workspace//x"), "/x");
assert_eq!(to_session_path("///"), "/");
}
#[test]
fn to_display_path_adds_alias() {
assert_eq!(to_display_path("/"), "/workspace");
assert_eq!(to_display_path("/src/lib.rs"), "/workspace/src/lib.rs");
// Idempotent over an already-aliased path.
assert_eq!(
to_display_path("/workspace/src/lib.rs"),
"/workspace/src/lib.rs"
);
}
}