feat(files): add anchor-based file edits

Author: icecrasher321

apps/docs/content/docs/cli/files.mdx

@@ -174,10 +174,10 @@ sim files delete <fileId> [options]
 
 </CommandTable>
 
-## Edit file content
+## Apply one exact or anchor-based edit to a text file
 
 ```bash
-sim files content update <fileId> [options]
+sim files edit <fileId> [options]
 ```
 
 **Arguments**
@@ -196,7 +196,7 @@ sim files content update <fileId> [options]
 
 | Option | Required | Description |
 | --- | --- | --- |
-| `--edit <json\|@file>` | Yes | The change to apply. (JSON, or @path / @- to read a file or stdin). |
+| `--edit <json\|@file>` | Yes | One edit object: &#123;"mode":"search_replace","search":"old","content":"new","replaceAll":false&#125;, &#123;"mode":"replace_between","beforeAnchor":"start line","afterAnchor":"end line","content":"new"&#125;, &#123;"mode":"insert_after","anchor":"line","content":"new"&#125;, or &#123;"mode":"delete_between","startAnchor":"first line deleted","endAnchor":"ending line kept"&#125;. Anchored modes also accept occurrence starting at 1 (JSON, or @path / @- to read a file or stdin). |
 
 </CommandTable>
 

apps/docs/content/docs/cli/reference.mdx

@@ -860,12 +860,12 @@ sim files delete <fileId> [options]
 
 </CommandTable>
 
-### sim files content update
+### sim files edit
 
-Edit File Content
+Apply one exact or anchor-based edit to a text file
 
 ```bash
-sim files content update <fileId> [options]
+sim files edit <fileId> [options]
 ```
 
 **Arguments**
@@ -884,7 +884,7 @@ sim files content update <fileId> [options]
 
 | Option | Required | Description |
 | --- | --- | --- |
-| `--edit <json\|@file>` | Yes | The change to apply. (JSON, or @path / @- to read a file or stdin). |
+| `--edit <json\|@file>` | Yes | One edit object: &#123;"mode":"search_replace","search":"old","content":"new","replaceAll":false&#125;, &#123;"mode":"replace_between","beforeAnchor":"start line","afterAnchor":"end line","content":"new"&#125;, &#123;"mode":"insert_after","anchor":"line","content":"new"&#125;, or &#123;"mode":"delete_between","startAnchor":"first line deleted","endAnchor":"ending line kept"&#125;. Anchored modes also accept occurrence starting at 1 (JSON, or @path / @- to read a file or stdin). |
 
 </CommandTable>
 

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

@@ -172,9 +172,9 @@ Append content to an existing workspace file. The file must already exist. Conte
 | `size` | number | File size in bytes |
 | `url` | string | URL to access the file |
 
-### File Edit
+### Apply File Edit
 
-Replace one exact piece of text in an existing workspace file, leaving the rest untouched. Use this to correct a fact in place instead of rewriting the whole file. The search text must match exactly once: if it appears several times the edit is refused and the matching line numbers are returned, so include enough surrounding text to be unique. Only plain-text files can be edited.
+Apply one precise edit to an existing text file without rewriting it. Use search_replace for verbatim replacement, optionally with replaceAll. Use replace_between, insert_after, or delete_between for complete trimmed-line anchors that stay stable when line numbers move. Folder scope can disambiguate a name or constrain a file ID.
 
 #### Input
 
@@ -183,33 +183,17 @@ Replace one exact piece of text in an existing workspace file, leaving the rest
 | `fileName` | string | Yes | Name or ID of the workspace file to edit. |
 | `folderPath` | string | No | Single folder in which to resolve the file name or validate the file ID. Canonical folder path, percent-encoded, e.g. "/memory/user-a/people". The workspace root is "/". Use folderPaths for multiple folders; do not provide both fields. |
 | `folderPaths` | array | No | Folders to search for the named file or validate the file ID against. The name must resolve to exactly one file across the selected scopes. Do not provide folderPath as well. |
-| `includeSubfolders` | boolean | No | Whether the folder is searched for the file recursively. Defaults to true; set false to match only its direct contents, which is how a name shared with a file in a nested folder is disambiguated. |
-| `oldString` | string | Yes | The exact text to replace, matched verbatim including whitespace and line breaks. It must appear exactly once in the file. |
-| `newString` | string | Yes | The text to put in its place. Pass an empty string to delete the old text. |
-
-#### Output
-
-| Parameter | Type | Description |
-| --------- | ---- | ----------- |
-| `id` | string | File ID |
-| `name` | string | File name |
-| `size` | number | File size in bytes |
-| `lineCount` | number | Lines in the file after the edit |
-
-### File Insert
-
-Insert new lines into an existing workspace file at a given line, leaving the rest untouched. Use this to add an entry under a heading without rewriting the file. Line numbers are the ones returned by search and by a ranged read. Only plain-text files can be edited.
-
-#### Input
-
-| Parameter | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `fileName` | string | Yes | Name or ID of the workspace file to insert into. |
-| `folderPath` | string | No | Single folder in which to resolve the file name or validate the file ID. Canonical folder path, percent-encoded, e.g. "/memory/user-a/people". The workspace root is "/". Use folderPaths for multiple folders; do not provide both fields. |
-| `folderPaths` | array | No | Folders to search for the named file or validate the file ID against. The name must resolve to exactly one file across the selected scopes. Do not provide folderPath as well. |
-| `includeSubfolders` | boolean | No | Whether the folder is searched for the file recursively. Defaults to true; set false to match only its direct contents, which is how a name shared with a file in a nested folder is disambiguated. |
-| `afterLine` | number | Yes | The 1-based line to insert after. Use 0 to insert at the top of the file. A line past the end of the file is refused rather than appended, so read or search first if you are not sure how long the file is. |
-| `content` | string | Yes | The text to insert. Multiple lines are inserted as multiple lines; no trailing newline is needed. |
+| `includeSubfolders` | boolean | No | Whether selected folders are searched recursively. Defaults to true; false matches only their direct contents. |
+| `mode` | string | Yes | Edit type: search_replace, replace_between, insert_after, or delete_between. |
+| `search` | string | No | For search_replace, the exact text to replace, including whitespace and line breaks. It must be unique unless replaceAll is true. |
+| `content` | string | No | Replacement or inserted text. Pass an empty string to delete a search match or clear the text between anchors. Omit only for delete_between. |
+| `replaceAll` | boolean | No | For search_replace, replace every non-overlapping match. Defaults to false, which refuses an ambiguous match. |
+| `beforeAnchor` | string | No | For replace_between, the complete line before the content to replace. Leading and trailing whitespace is ignored. |
+| `afterAnchor` | string | No | For replace_between, the complete line after the content to replace. The anchor lines remain in the file. |
+| `anchor` | string | No | For insert_after, the complete line after which content is inserted. |
+| `startAnchor` | string | No | For delete_between, the complete first line to delete. The start anchor is removed. |
+| `endAnchor` | string | No | For delete_between, the complete ending boundary line. The end anchor remains in the file. |
+| `occurrence` | number | No | For anchored edits, which matching anchor occurrence to use, starting at 1. Defaults to 1. |
 
 #### Output
 

apps/docs/openapi-v2-files-audit.json

@@ -1950,7 +1950,7 @@
       "patch": {
         "operationId": "editFileContent",
         "summary": "Edit File Content",
-        "description": "Change part of a text file in place, leaving the rest untouched. `PUT` on this path replaces the whole file; this is the partial counterpart, so one line can be corrected without regenerating everything around it. `replace_string` requires `oldString` to match **exactly once** — several matches answer `400` naming the lines they sit on, because replacing an arbitrary one of them would be a silent write to a line the caller never chose. `insert_lines` inserts after a 1-based line, with `0` meaning the top; a line past the end of the file answers `400` rather than appending. Line numbers are the ones `GET /api/v2/files/{fileId}/text` and file search report. Only files whose stored bytes are UTF-8 text can be edited: editing works on the bytes, never on parsed text, so a PDF or DOCX answers `400`. A concurrent write answers `409`, and retrying means re-reading first.",
+        "description": "Change part of a text file in place, leaving the rest untouched. `PUT` on this path replaces the whole file; this is the partial counterpart. `search_replace` matches exact text and requires one match unless `replaceAll` is true. `replace_between`, `insert_after`, and `delete_between` match complete lines after trimming surrounding whitespace, so edits remain stable when unrelated changes move the target to another line. Anchored replacement preserves both boundary lines; insertion preserves its anchor; deletion removes the start anchor and preserves the end anchor. Use `occurrence` when an anchor line repeats. Only files whose stored bytes are UTF-8 text can be edited: a PDF or DOCX answers `400`. A concurrent write answers `409`, and retrying means re-reading first.",
         "tags": ["Files"],
         "parameters": [
           {
@@ -4600,46 +4600,116 @@
                 "properties": {
                   "mode": {
                     "type": "string",
-                    "const": "replace_string",
-                    "description": "Replace one exact piece of text with another."
+                    "const": "search_replace",
+                    "description": "Replace exact text."
                   },
-                  "oldString": {
+                  "search": {
                     "type": "string",
                     "minLength": 1,
-                    "description": "Exact text to replace, matched verbatim. It must appear exactly once: several matches are refused with `400` naming the lines they sit on, so include enough surrounding text to be unique."
+                    "description": "Exact text to replace, matched verbatim. It must appear once unless replaceAll is true."
                   },
-                  "newString": {
+                  "content": {
                     "type": "string",
                     "description": "Text to put in its place. An empty string deletes the matched text."
+                  },
+                  "replaceAll": {
+                    "description": "Replace every non-overlapping match. Defaults to false.",
+                    "type": "boolean"
                   }
                 },
-                "required": ["mode", "oldString", "newString"],
+                "required": ["mode", "search", "content"],
                 "additionalProperties": false
               },
               {
                 "type": "object",
                 "properties": {
                   "mode": {
                     "type": "string",
-                    "const": "insert_lines",
-                    "description": "Insert new lines at a given line."
+                    "const": "replace_between",
+                    "description": "Replace content between two complete-line anchors."
+                  },
+                  "beforeAnchor": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Boundary line before the replaced content. This line remains."
+                  },
+                  "afterAnchor": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Boundary line after the replaced content. This line remains."
+                  },
+                  "content": {
+                    "type": "string",
+                    "description": "Replacement text. An empty string clears the interior."
                   },
-                  "afterLine": {
+                  "occurrence": {
+                    "description": "Matching anchor occurrence, starting at 1. Defaults to 1.",
                     "type": "integer",
-                    "minimum": 0,
-                    "maximum": 9007199254740991,
-                    "description": "The 1-based line to insert after; 0 inserts at the top. A line past the end is refused rather than appended."
+                    "minimum": 1,
+                    "maximum": 9007199254740991
+                  }
+                },
+                "required": ["mode", "beforeAnchor", "afterAnchor", "content"],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "mode": {
+                    "type": "string",
+                    "const": "insert_after",
+                    "description": "Insert content after a complete-line anchor."
+                  },
+                  "anchor": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Complete line after which content is inserted."
                   },
                   "content": {
                     "type": "string",
-                    "description": "Text to insert. Multiple lines insert as multiple lines."
+                    "minLength": 1,
+                    "description": "Text to insert."
+                  },
+                  "occurrence": {
+                    "description": "Matching anchor occurrence, starting at 1. Defaults to 1.",
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 9007199254740991
+                  }
+                },
+                "required": ["mode", "anchor", "content"],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "mode": {
+                    "type": "string",
+                    "const": "delete_between",
+                    "description": "Delete from one complete-line anchor to another."
+                  },
+                  "startAnchor": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "First line to delete. This start anchor is removed."
+                  },
+                  "endAnchor": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Ending boundary line. This end anchor remains."
+                  },
+                  "occurrence": {
+                    "description": "Matching anchor occurrence, starting at 1. Defaults to 1.",
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 9007199254740991
                   }
                 },
-                "required": ["mode", "afterLine", "content"],
+                "required": ["mode", "startAnchor", "endAnchor"],
                 "additionalProperties": false
               }
             ],
-            "description": "The change to apply."
+            "description": "One exact or anchor-based edit: search_replace, replace_between, insert_after, or delete_between."
           }
         },
         "required": ["workspaceId", "edit"],
@@ -4650,16 +4720,16 @@
           {
             "workspaceId": "a91c4b2e-6d3f-4e8a-b5c7-0d9e2f1a8c64",
             "edit": {
-              "mode": "replace_string",
-              "oldString": "- based in NYC",
-              "newString": "- based in SF"
+              "mode": "search_replace",
+              "search": "- based in NYC",
+              "content": "- based in SF"
             }
           },
           {
             "workspaceId": "a91c4b2e-6d3f-4e8a-b5c7-0d9e2f1a8c64",
             "edit": {
-              "mode": "insert_lines",
-              "afterLine": 4,
+              "mode": "insert_after",
+              "anchor": "## Preferences",
               "content": "- prefers async updates"
             }
           }

apps/sim/app/api/v2/files/[fileId]/content/route.ts

@@ -48,9 +48,9 @@ export const PUT = defineV2JsonRoute({
  * Correcting one line without regenerating everything around it is the point:
  * a whole-file rewrite of a long document both costs more and drifts.
  *
- * A string replacement must match exactly once. Several matches are refused
- * with `400` naming the lines, because replacing an arbitrary one of them is a
- * silent write to a line the caller never chose.
+ * Exact replacement refuses ambiguity unless `replaceAll` is explicit.
+ * Anchored edits match complete trimmed lines, so they remain stable when
+ * unrelated changes move the target to a different line number.
  */
 export const PATCH = defineV2JsonRoute({
   contract: v2EditFileContentContract,

apps/sim/blocks/blocks.test.ts

@@ -176,7 +176,6 @@ describe.concurrent('Blocks Module', () => {
         'file_write',
         'file_append',
         'file_edit',
-        'file_insert',
         'file_compress',
         'file_decompress',
         'file_manage_sharing',