diff --git a/codex-rs/utils/path-uri/src/api_path_string.rs b/codex-rs/utils/path-uri/src/api_path_string.rs
index 369d59fb0e..8ffdf6c795 100644
--- a/codex-rs/utils/path-uri/src/api_path_string.rs
+++ b/codex-rs/utils/path-uri/src/api_path_string.rs
@@ -83,9 +83,10 @@ impl LegacyAppPathString {
 
     /// Parses this API string as an absolute path native to the current host.
     ///
-    /// Use this for legacy app or wire path text that must be validated as
-    /// native to the current host. Constructing [`AbsolutePathBuf`] directly
-    /// can misclassify foreign-platform spelling as a local path.
+    /// Use this when legacy app or wire path text denotes a file on the
+    /// coordinator host and a host-only filesystem API needs an
+    /// [`AbsolutePathBuf`]. Constructing [`AbsolutePathBuf`] directly can
+    /// misclassify foreign-platform spelling as a local path.
     ///
     /// Host-specific path namespaces are normalized. Relative and
     /// foreign-platform paths are rejected.