Skip to content

fix(sandbox): reject apply_patch create_file on an existing file - #4893

Open
ayaangazali wants to merge 7 commits into
openai:mainfrom
ayaangazali:fix/apply-patch-create-existing
Open

fix(sandbox): reject apply_patch create_file on an existing file#4893
ayaangazali wants to merge 7 commits into
openai:mainfrom
ayaangazali:fix/apply-patch-create-existing

Conversation

@ayaangazali

Copy link
Copy Markdown
Contributor

Summary

*** Add File: is described to the model as creating a new file:

*** Add File: <path> - create a new file. Every following line is a + line (the initial contents).
*** Delete File: <path> - remove an existing file. Nothing follows.
*** Update File: <path> - patch an existing file in place (optionally with a rename).

The other two operations enforce the precondition that sentence implies. delete_file calls _ensure_exists, and update_file fails through _read_text with ApplyPatchFileNotFoundError. create_file enforced nothing. It went straight to _write_text, which writes unconditionally.

So an Add File aimed at a path that already exists silently destroys that file. The grammar cannot prevent it, since filename is /(.+)/ and no CFG can express a filesystem precondition, and a model re-creating a file it wrote in an earlier turn is an ordinary thing to see.

What made me want to fix it rather than leave it is the reported output. Driving a real patch through the tool boundary on current main:

session.files[Path("/workspace/notes.txt")] = b"important existing user content\n"

tool = SandboxApplyPatchTool(session=session)
await tool._on_invoke_tool(ctx, """*** Begin Patch
*** Add File: notes.txt
+clobbered
*** End Patch""")
TOOL OUTPUT TO MODEL: 'Created notes.txt'
FILE CONTENT NOW:     b'clobbered'

The model is told a new file was created. Nothing raises, nothing warns, and the previous contents are unrecoverable, so neither the model nor the caller has any signal that would prompt recovery.

The fix checks that the destination is absent before writing, mirroring the _ensure_exists precondition already used by delete_file. It reuses ApplyPatchDiffError, which is the general apply_patch validation error in this module already (it covers unknown operation types and unsupported patch formats, not only diff content), so no new error class, ErrorCode, or exported symbol is added. The message names the operation that does work on an existing file:

apply_patch cannot create notes.txt because it already exists. Use an update_file operation to change an existing file.

This is independent of #4890, which fixes the case-only rename in the update_file branch. Different operation, no textual overlap.

One existing test changed. test_editor_runs_file_operations_as_bound_user asserts that every file operation runs as the bound user by recording the user of each call. The new absence probe is a third read, and it correctly runs as the bound user, so the expected list goes from two entries to three. The property under test is unchanged.

No docs/ change: the model-facing description already says Add File creates a new file, and this makes the runtime agree with it.

Test plan

tests/sandbox/test_apply_patch.py::test_apply_patch_create_rejects_an_existing_file asserts both halves of the outcome: the operation raises, and the original bytes are still there afterwards. Reverting only src/agents/sandbox/apply_patch.py and rerunning gives Failed: DID NOT RAISE <class 'agents.sandbox.errors.ApplyPatchDiffError'>, so it fails on the unfixed code.

.agents/skills/code-change-verification/scripts/run.sh passes: format clean, lint clean, typecheck clean, tests pass. tests/sandbox/ is 1448 passed, 2 skipped.

Issue number

None. Found while reading the apply_patch precondition handling.

Checks

  • I've added new tests, if relevant
  • I've run .agents/skills/code-change-verification/scripts/run.sh
  • I've confirmed all verification steps pass
  • If using Codex, I've run /review before submitting this PR

I should be upfront that I work on these with heavy AI assistance. I read the code, reproduced the behavior and checked the reasoning myself before sending it, but if I have misread the intent here I would rather you close it than spend review time on it.

Copilot AI lite review requested due to automatic review settings September 6, 2026 19:19

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f36d84ba6b

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread src/agents/sandbox/apply_patch.py Outdated
Comment thread src/agents/sandbox/apply_patch.py Outdated

@seratch seratch left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The data-loss case is worth fixing, and the expected-error tracing change is correct. The remaining problem is that the absence check and write are separate operations. A concurrent sandbox command can create the file after the read, and the unconditional write then destroys that content. Reading also does not establish that a dangling symlink entry is absent. Please enforce create-if-absent at the backend write boundary, preserving the bound user and path policy, and cover an intervening creator whose contents must survive. Existing files should continue to use update_file.

@ayaangazali

Copy link
Copy Markdown
Contributor Author

The two tests-windows failures were mine, and they are fixed in d68c465.

Root cause: the span assertion test I added needs FilesystemTestSandboxSession, which is typed to UnixLocalSandboxSessionState, and importing agents.sandbox.sandboxes.unix_local raises ImportError on Windows by design. tests/conftest.py already collect-ignores the other files that depend on it, including sandbox/test_session_sinks.py where I took the harness from, but sandbox/test_apply_patch.py should stay collectible on Windows because its other 25 tests are platform independent. So the narrow fix is a skipif on that one test, matching what test_posix_tool_paths.py and test_run_cwd.py already do with the same reason string.

The unix-only imports stay inside the test body on purpose. At module scope the skipif would not help, because collection itself would fail to import unix_local and take the whole file down on Windows.

Nothing in src/ changed for this, so the behaviour under review is the same as the commit you may have already looked at.

One thing I cannot confirm from my side: the workflow run for d68c465 is sitting at action_required, so it is waiting on maintainer approval rather than reporting. I am not going to push again to try to trigger it. Locally .agents/skills/code-change-verification/scripts/run.sh is clean and tests/sandbox/test_apply_patch.py is 25 passed.

@ayaangazali
ayaangazali force-pushed the fix/apply-patch-create-existing branch from d68c465 to 6ecc682 Compare September 7, 2026 16:23
@ayaangazali

Copy link
Copy Markdown
Contributor Author

Done in 6ecc682. You were right that the probe was not good enough, and the dangling symlink half turned out to be sharper than I gave it credit for.

Where the enforcement moved. New BaseSandboxSession.write_new_file() claims the target name before the payload is written and raises FileExistsError when the name is already taken. The shared implementation runs a shell noclobber redirection, so set -C makes the redirect itself the O_EXCL attempt. UnixLocalSandboxSession overrides it with os.open(O_CREAT | O_EXCL) for its direct path and delegates to the shared version when a user is bound. apply_patch create_file calls it and no longer probes, which also removes the tracing workaround from the earlier commit since there is no probe read left to mark as expected.

Why a method rather than a flag on write(). All nine backends override write(). A new keyword there would need each one updated to honour it, and any backend that was not, including third-party ones, would silently accept exclusive=True and keep clobbering. With a base method that has a working shared implementation, a backend that does nothing inherits correct behaviour, and a backend with a cheaper native primitive can override. If you would rather have the flag, say so and I will convert it.

The symlink case was worse than a missing check. UnixLocalSandboxSession.normalize_path resolves symlinks, so validating the whole path turned a dangling link.txt into its absent target and the write landed on the target. My first attempt still had this, and the test caught it:

normalize_path(link.txt) -> /.../missing.txt
missing.txt exists now: True
missing.txt content:    b'clobbered'

Both paths now validate the parent through the normal policy, so grants, symlinked parents and the bound user are unchanged, and leave the final component unresolved. O_EXCL fails with EEXIST on a name held by a symlink, including a dangling one, so the link is rejected instead of followed.

Coverage. In tests/sandbox/test_unix_local.py: an intervening creator's content survives and the create is rejected, a dangling symlink is rejected without its target being created, parents are created for a nested path, the bound-user path maps exit 13 to FileExistsError without writing, and the bound-user path dispatches the unresolved link name rather than the resolved target. In tests/sandbox/test_apply_patch.py, a session that reports every path as missing on read() while still holding the file is still rejected, which pins the check to the write boundary rather than a probe. Six of the seven fail without the change.

I checked the shell recipe directly rather than assuming it: sh, bash and dash all return exit 13 for both an existing file and a dangling symlink, and 0 with parents created for a fresh nested path, with existing content untouched in the rejection cases.

Existing files still have to go through update_file. The branch is rebased onto current main and force pushed, so the earlier commits are the same work replayed.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6ecc68255e

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread src/agents/sandbox/session/base_sandbox_session.py Outdated
Comment thread src/agents/sandbox/session/base_sandbox_session.py
Comment thread src/agents/sandbox/sandboxes/unix_local.py Outdated
@ayaangazali

Copy link
Copy Markdown
Contributor Author

All three are fixed in 72ede53, and two of them were real.

The wrapper bypass was the important one. SandboxSession did not forward write_new_file, so a session built by SandboxClient fell back to the shared implementation and never reached the UnixLocal os.open override. It forwards now.

The split write is gone. Instead of creating an empty file and then writing the payload, the payload goes to a staging name first and ln claims the target. ln fails when the name is already taken, so the content is complete before the name exists, and a failed or cancelled upload leaves only the staging entry, which is removed in a finally that cannot replace the outcome of the create.

The dash point was correct, and I had actually mis-tested it. I validated the recipe with cat > "$target" || exit 13, which returns 13 on dash because cat is a regular command, and then shipped : > "$target", which is a special builtin. Measured on this machine:

':' redirect    sh rc=13   bash rc=13   dash rc=2
'cat' redirect  sh rc=13   bash rc=13   dash rc=13

So a collision on dash surfaced as WorkspaceArchiveWriteError and WorkspaceEditor could not convert it into the actionable ApplyPatchDiffError. My unit tests could not catch this because they stub _exec_internal and never run a shell. There is now a test that runs the shipped script constant through sh, dash and bash and asserts 13 for both an existing file and a dangling symlink and 0 with the full payload for a fresh nested path. I confirmed it fails if the : version is restored.

The umask point is right too. os.open(..., 0o644) narrowed the mode compared with Path.open("wb"), which creates 0o666 & ~umask. Under a collaborative umask that would have made Add File produce 0644 where the ordinary write path produces 0664. It passes 0o666 now and lets the umask decide.

Full stack is clean locally.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 72ede535aa

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread src/agents/sandbox/session/base_sandbox_session.py
Comment thread src/agents/sandbox/apply_patch.py Outdated
Comment thread src/agents/sandbox/sandboxes/unix_local.py Outdated
Comment thread src/agents/sandbox/session/base_sandbox_session.py Outdated
Comment thread src/agents/sandbox/session/base_sandbox_session.py
Comment thread src/agents/sandbox/session/base_sandbox_session.py
@ayaangazali

Copy link
Copy Markdown
Contributor Author

Fixed in 3356606. The leaf-resolution one was the real defect and it was live through the actual tool path, not just theoretical.

Preserving the leaf name. WorkspaceEditor.apply_operation normalizes destination before dispatching, and UnixLocalSandboxSession.normalize_path resolves leaf symlinks, so my primitive was handed the link target. Reproduced through session.apply_patch() on main plus my previous commit:

RESULT: 'Done!'
missing.txt created: True
dir listing: ['link.txt', 'missing.txt']

The create path now passes the unresolved path. My earlier symlink test called write_new_file directly, which is exactly why it passed while the real path was broken, so the new tests drive session.apply_patch() instead. Reverting only the apply_patch.py change makes the dangling-symlink test fail again.

The directory case. Bare ln treats an existing directory as a target directory and links the staging file inside it, so the create reported success and left a hidden payload. The script now rejects a name held by a directory before linking. Locally this was already correct, but the shared path serves the remote backends, so it mattered there.

Local staging. The Unix-local override claimed the name with os.open and then copied, so a write that failed partway left an empty file holding the name and a retry got FileExistsError. It stages the payload and then os.links it into place, matching the shared path. os.link fails with EEXIST for a file, a directory or a dangling symlink, which also let me drop the O_NOFOLLOW and ELOOP special-casing.

Staging cleanup and parent ownership. The staging write moved inside the cleanup scope so a failed or cancelled upload cannot leak .name.create-<uuid> into the workspace or a later snapshot. The parent is now created as the bound user before staging, so a fresh nested path is owned the way the previous _write_text path owned it.

The : comment appears to be a repost of the earlier finding; that redirection is gone, and ln is a regular command. The parametrized test that runs the shipped script through sh, dash and bash now also covers the existing-directory case.

Full stack clean locally. I am conscious this diff has grown well past where it started. If you would rather have the primitive landed on its own, or scoped to UnixLocal only with the remote backends following separately, say the word and I will split it.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3356606ee8

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread src/agents/sandbox/sandboxes/unix_local.py Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Security Review

Here are some automated security review suggestions for this pull request.

Reviewed commit: 3356606ee8

ℹ️ About Codex security reviews in GitHub

This is an experimental Codex feature. Security reviews are triggered when:

  • You comment "@codex security review"
  • A regular code review gets triggered (for example, "@codex review" or when a PR is opened), and you’re opted in so security review runs alongside code review

Once complete, Codex will leave suggestions, or a comment if no findings are found.

Comment on lines +1004 to +1007
result = await self.exec(
"sh",
"-lc",
_EXCLUSIVE_CREATE_SCRIPT,

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Security: Avoid login shells in filesystem-only creation

When an application exposes Filesystem() without Shell(), on a backend inheriting this method whose $HOME is workspace-writable (Runloop defaults the workspace to its effective home), an attacker-steered patch can Add a seed, Update/Move it to .profile, then Add another file. This new sh -lc loads the profile before _EXCLUSIVE_CREATE_SCRIPT, turning patch-only authority into arbitrary command execution as the sandbox user and exposing whatever environment secrets or network access that identity has. needs_approval defaults false. Use a non-login, sanitized primitive that cannot load workspace startup files.


Dismiss this finding: Reply with @codex security dismiss <reason> [context]. Codex will resolve this conversation automatically; GitHub may require a page refresh to show the result.

Valid reasons: false-positive, duplicate, out-of-scope, compensating-control, risk-accepted, or other. Example: @codex security dismiss duplicate Already flagged by another review

What each reason means
  • false-positive — Not a vulnerability
  • duplicate — Already tracked elsewhere
  • out-of-scope — Outside this review's scope
  • compensating-control — Mitigated by another control
  • risk-accepted — Risk intentionally accepted
  • other — Another reason; context required

Useful? React with 👍 / 👎.

@ayaangazali

Copy link
Copy Markdown
Contributor Author

Two of these were live and are fixed in 4ebc93c. Three are reposts of findings already addressed in 3356606. One is a blocker I do not think I should decide alone.

Fixed: the login shell. I had used sh -lc. This path runs for a filesystem-only capability set, so sourcing shell startup files that live in the workspace being edited is the wrong default for a primitive whose whole job is a single guarded create. It is sh -c now.

Fixed: collision classification. A parent that is a regular file makes mkdir raise FileExistsError, and my broad handler reported that as a collision on the requested name, so the model would be told to use update_file for a target that does not exist. Only the os.link call can report a collision now, and parent or staging failures are wrapped as write errors. Covered by a test through session.apply_patch().

Already addressed in the previous commit: the : redirection is gone, the script rejects a name held by a directory before linking (if [ -e "$target" ] || [ -L "$target" ]; then exit 13; fi, covered for sh, dash and bash including the directory case), and the parent is created with await self.mkdir(parent_path, parents=True, user=user) before staging.

The blocker: hard links. The object-storage mount point is correct and it breaks the shared implementation rather than needing another condition. A writable rclone, Mountpoint or Blobfuse destination does not provide POSIX hard links, so ln fails, cleanup removes the staging file, and Add File on a fresh mounted path returns a write error where the previous direct write() succeeded. That is a regression of working behaviour, not an edge case.

I do not think I can fix that generically. exec() has no stdin, so the shared implementation cannot stream a payload through the shell in one step. That leaves two shapes, and both are already ruled out: create empty then write, which you and Codex correctly rejected because a concurrent writer is overwritten and a failed upload leaves an empty file holding the name; or link a staged file, which needs hard links. A generic exclusive create that works on every supported mount really does need a per-backend primitive.

So the honest position is that the shared shell implementation should go, and enforcement should be backend-native. UnixLocal has one that works. The other seven backends need their own, and I cannot write or meaningfully test those.

How would you like to proceed?

  1. Scope this PR to UnixLocal: keep the native os.link primitive and the apply_patch wiring, drop the shared shell implementation, and let each remaining backend adopt the primitive in its own change. The data loss you called worth fixing is fixed where it can be verified, and nothing regresses.
  2. Close this and take the design in-house, the way you did with fix(sandbox): terminate UnixLocal execs on cancellation #4723. The reproduction, the caller-path tests and the reasoning above are all here to reuse.

I am happy either way, and I would rather close it than keep adding conditions to a shape that cannot hold. Four review rounds is past the point where I should be choosing the scope myself.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4ebc93ca86

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

parent_path = await self._validate_path_access(requested.parent, for_write=True)
workspace_path = parent_path / requested.name
path_arg = sandbox_path_str(workspace_path)
staging_path = parent_path / f".{requested.name}.create-{uuid.uuid4().hex}"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Keep the staging basename within filesystem limits

On a filesystem with the common 255-byte component limit, a valid destination leaf such as a 220-byte filename becomes a 261-byte staging name after adding the dot, .create-, and UUID. The staging write therefore fails with ENAMETOOLONG even though the requested file could be created directly, regressing Add File for valid paths in both this shared implementation and the Unix-local override. Use a fixed-size staging basename that does not embed the entire destination name.

Useful? React with 👍 / 👎.

# Create the parent as the bound user so a fresh nested path is owned the same
# way the ordinary write path owned it.
await self.mkdir(parent_path, parents=True, user=user)
await self.write(staging_path, data, user=user)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Check an existing target before staging the payload

When the target already exists inside an executable but non-writable parent directory, such as a workspace directory changed to mode 0555, this staging write fails with a permission error before the link script can classify the existing destination. Add File consequently surfaces WorkspaceArchiveWriteError rather than the promised ApplyPatchDiffError directing the caller to update_file; the Unix-local override has the same ordering. Short-circuit an already-observable leaf collision before staging while retaining the atomic link check for intervening creators.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown

Rumbo follow-up: PR #4930 hardens this implementation for two current P2 findings — fixed-length staging basenames and early observable-target collision classification, while retaining the atomic claim for races. #4930 is intentionally based on this PR rather than presenting the work as unrelated.

Add File is documented to the model as creating a new file, and the
delete and update operations both enforce their existing-file
precondition. create_file enforced nothing, so an Add File operation
aimed at a path that already existed overwrote it and reported
"Created <path>", losing the previous contents with no error.

Check that the destination is absent before writing, mirroring the
existing _ensure_exists precondition used by delete_file.
…pans

The absence check reached SandboxSession.read(), which records a failed
sandbox.read child span when the file is missing. Missing is the success
case for a create, so every successful Add File looked like it contained
a failed sandbox operation.

Use the existing _read_with_expected_span_errors helper, the same path
the skills capability already uses for an existence probe.
The span assertion needs FilesystemTestSandboxSession, which is typed to
UnixLocalSandboxSessionState, and importing agents.sandbox.sandboxes.unix_local
raises ImportError on Windows by design. tests/conftest.py already
collect-ignores the other files that depend on it, but test_apply_patch.py
must stay collectible because its remaining tests are platform independent.

The unix-only imports stay inside the test body so collection does not
touch unix_local on Windows.
The previous read-then-write check left a window: a concurrent sandbox
command could create the file after the probe, and the unconditional
write then destroyed that content. Reading also did not establish that a
dangling symlink entry was absent, because the unix_local path policy
resolves symlinks and the write landed on the link target.

Add BaseSandboxSession.write_new_file(), which claims the target name
before the payload is written and raises FileExistsError when the name is
already taken. The shared implementation uses a shell noclobber
redirection, so the redirect itself is the O_EXCL attempt; UnixLocal
overrides it with os.open(O_CREAT|O_EXCL) for its direct path. Both
validate the parent through the normal policy, preserving grants and the
bound user, and leave the final component unresolved so a symlink at that
name is rejected rather than followed.

apply_patch create_file now uses it and drops the probe, so the tracing
workaround for the probe read is no longer needed. Existing files still
have to go through update_file.
Three problems with the previous commit.

SandboxSession did not forward write_new_file, so a session built by
SandboxClient fell back to the shared implementation and never reached
the UnixLocal os.open override. Forward it.

The shared implementation created an empty file and then wrote the
payload in a separate step, so a concurrent writer could be overwritten
and a failed upload left an empty file holding the name. Write the
payload under a staging name first, then claim the target with ln, which
fails when the name is taken. The content is complete before the name
exists, and a failed create leaves only the staging entry, which is
removed.

The script used ':' for the noclobber redirection. ':' is a POSIX special
builtin, so on dash a redirection failure ended the shell before the exit
mapping ran and a collision surfaced as a generic write error instead of
FileExistsError. ln is a regular command, and a test now runs the script
through sh, dash and bash so this cannot regress silently.

Also create local files with 0o666 so the process umask decides the final
mode, matching Path.open("wb") on the ordinary write path.
WorkspaceEditor normalizes the destination before dispatching, and
UnixLocal resolves leaf symlinks, so create_file handed the primitive the
link target. Add File on a dangling link.txt created missing.txt and
reported success. Pass the unresolved path for create.

Stage the payload locally too, then os.link it into place. os.link fails
with EEXIST for a file, a directory or a dangling symlink, and a write
that fails partway now leaves only the staging entry instead of a file
holding the name.

Reject a name held by a directory in the shared script. Bare ln treats an
existing directory as a target directory and would have linked the
staging file inside it while reporting the directory as created.

Move the staging write inside the cleanup scope so a failed upload cannot
leak the staging entry, and create the parent as the bound user so a
fresh nested path is owned the way the previous write path owned it.

The new tests drive session.apply_patch() rather than the primitive, which
is the path that was actually broken.
Use sh -c instead of sh -lc for the exclusive create. This path runs for a
filesystem-only capability set, so it must not source shell startup files
that live in the workspace it is editing.

A parent that is a regular file makes mkdir raise FileExistsError, and the
broad handler reported that as a collision on the requested name, telling
the model to use update_file for a target that does not exist. Only the
os.link call can report a collision now; parent and staging failures are
wrapped as write errors.
@ayaangazali
ayaangazali force-pushed the fix/apply-patch-create-existing branch from 4ebc93c to 9820c3f Compare September 8, 2026 16:53
@ayaangazali

Copy link
Copy Markdown
Contributor Author

Thanks for flagging #4930, and for basing it on this branch openly instead of presenting the work as unrelated.

On the two findings:

Fixed-length staging basename is real, and it is my regression. The staging name is .{name}.create-{uuid4().hex}, which adds 41 characters, so a destination that is valid under a 255 byte component limit can push the staging name past it. Reproduced on my current head: a 254 character filename that a plain write accepts fails create_file with WorkspaceArchiveWriteError, and the same name worked before this PR because the old path wrote straight to the destination. Agreed, and it needs fixing.

Early collision classification I read as an improvement rather than a correctness bug. Today the payload is staged before the collision is detected, so Add File onto an existing name uploads bytes that are then discarded, which is wasteful on remote backends. That seems right to do, as long as the preflight stays additive and the atomic claim is still what decides races, which is what your description says.

One practical note: #4930 shows as closed, opened 11:49:38Z and closed 11:54:17Z, so as things stand neither fix has a home. I would rather not absorb your work. If you reopen it or push a replacement, I will leave both to you and keep this branch as the base. If you would rather not carry it, say so and I will fold the staging-name fix in here with credit to you.

For whoever picks this up: there is an open question further up this thread about whether the shared shell implementation should exist at all, because hard links are not available on writable object-storage mounts. Both of these findings apply to that shared path, so the answer to that one probably decides where they land.

The branch is rebased onto current main and the full local stack is clean.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants