docs(files): describe overwrite as an exact-path match

Author: TheodoreSpeaks

apps/docs/content/docs/integrations/file.mdx

@@ -127,7 +127,7 @@ Create a new workspace file, either from text content or from an existing file.
 | `content` | string | No | The text content to write to the file. Provide exactly one of content or fileInput. |
 | `fileInput` | file | No | An existing file to store in the workspace, such as one produced by an earlier tool. Use this for anything that is not text — PDFs, images, audio, archives. Provide exactly one of content or fileInput. |
 | `contentType` | string | No | MIME type for new files \(e.g., "text/plain"\). Auto-detected from the file extension, or taken from the stored file, if omitted. |
-| `overwrite` | boolean | No | Replace the contents of an existing file with the same name instead of creating a suffixed copy. Creates the file when it does not exist yet. |
+| `overwrite` | boolean | No | Replace the contents of an existing file at the exact target path \(folder and name\) instead of creating a suffixed copy. Creates the file when that path does not exist yet. |
 
 #### Output
 

apps/sim/blocks/blocks/file.ts

@@ -911,7 +911,7 @@ export const FileV5Block: BlockConfig<FileParserV3Output> = {
   - Search finds literal text across all active workspace files and returns structured results with fileId, lineNumber, and text. Lowercase queries are case-insensitive; adding any uppercase letter makes the search case-sensitive.
   - Search is eventually consistent. Check "complete" and "indexStatus" when pending, failed, skipped, or partially indexed files matter to the task.
   - Use Fetch for external file URLs. Add headers for authenticated downloads, for example Slack private file URLs require an Authorization Bearer token.
-  - Use Write to create a new workspace file and Append to add content to an existing one. Write adds a numeric suffix when the name is taken; turn on "Overwrite Existing File" to replace that file's contents instead.
+  - Use Write to create a new workspace file and Append to add content to an existing one. Write adds a numeric suffix when the name is taken; turn on "Overwrite Existing File" to replace the contents of the file at that exact path (folder and name) instead — a same-named file in another folder is left alone.
   - Use Compress to bundle one or more files into a single .zip archive stored in the workspace. The new archive is returned in the "files" output.
   - Use Decompress to extract a .zip archive back into the workspace; the extracted files are returned in the "files" output, ready to chain into Get Content or downstream blocks.
   `,

apps/sim/tools/file/write.ts

@@ -50,7 +50,7 @@ export const fileWriteTool: InternalToolConfig<FileWriteParams, ToolResponse> =
       required: false,
       visibility: 'user-only',
       description:
-        'Replace the contents of an existing file with the same name instead of creating a suffixed copy. Creates the file when it does not exist yet.',
+        'Replace the contents of an existing file at the exact target path (folder and name) instead of creating a suffixed copy. Creates the file when that path does not exist yet.',
     },
   },