From ef74b76953acb622fa116a9e6e06617c18a4742a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Arnaud=20H=C3=A9ritier?= Date: Fri, 11 Sep 2026 04:03:17 +0000 Subject: [PATCH] docs: update for PR #4222 - revert foreign-OS path rejection from filesystem tool PR #4222 reverted the foreign-OS absolute-path rejection and the resolved-path error hint that were added by an earlier filesystem change. The filesystem tool docs still described both behaviors as current, which is no longer accurate: - Absolute paths are once again used as-is instead of being validated against the host OS and rejected when they look foreign. - "Not found" errors no longer include the resolved absolute path. Source PR: https://github.com/docker/docker-agent/pull/4222 --- docs/tools/filesystem/index.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/docs/tools/filesystem/index.md b/docs/tools/filesystem/index.md index 6439a06ab..d0c439b23 100644 --- a/docs/tools/filesystem/index.md +++ b/docs/tools/filesystem/index.md @@ -18,15 +18,12 @@ The filesystem tool gives agents the ability to explore codebases, read and edit Paths are resolved relative to the **working directory** (the directory where the agent session started, or the directory specified with `--working-dir`): - **Relative paths** (e.g., `src/main.go`, `../README.md`) are joined with the working directory. -- **Absolute paths** must match the host operating system: +- **Absolute paths** are used as-is, in the host operating system's own syntax: - Unix/Linux/macOS: `/home/user/project/file.txt` - Windows: `C:\Users\user\project\file.txt` or `C:/Users/user/project/file.txt` - **Home directory expansion**: paths starting with `~` or `~/` expand to the user's home directory. -When a file is not found, error messages include the resolved absolute path to help diagnose incorrect base directories or path formats. - -> [!IMPORTANT] -> Agents must use paths appropriate for the host OS. A Windows absolute path like `C:\file.txt` on a Unix system (or vice versa) is rejected with a clear error message. +When a file is not found, the tool reports "not found" without further detail. ### Empty directory detection