@lousy-agents/agent-shell 5.21.3 → 5.21.5

package/dist/index.js

@@ -2,7 +2,7 @@
 import { createRequire as __rspack_createRequire } from "node:module";
 const __rspack_createRequire_require = __rspack_createRequire(import.meta.url);
 var __webpack_modules__ = ({
-699(__unused_rspack_module, __unused_rspack___webpack_exports__, __webpack_require__) {
+461(__unused_rspack_module, __unused_rspack___webpack_exports__, __webpack_require__) {
 
 ;// CONCATENATED MODULE: external "node:child_process"
 const external_node_child_process_namespaceObject = __rspack_createRequire_require("node:child_process");
@@ -154,6 +154,85 @@ function sameFileIdentityForCleanup(left, right, platform = process.platform) {
     return sameStatValue(left.dev, right.dev) && sameStatValue(left.ino, right.ino);
 }
 
+;// CONCATENATED MODULE: external "node:async_hooks"
+const external_node_async_hooks_namespaceObject = __rspack_createRequire_require("node:async_hooks");
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/file-observation.js
+
+const active = new external_node_async_hooks_namespaceObject.AsyncLocalStorage();
+function recordFileObservationFailure(error, kind) {
+    const failures = active.getStore();
+    if (!failures)
+        return;
+    let kinds = failures.get(error);
+    if (!kinds)
+        failures.set(error, kinds = new Set());
+    kinds.add(kind);
+}
+function isFileObservationFailure(error, kind) {
+    return active.getStore()?.get(error)?.has(kind) === true;
+}
+// Each Root observation owns its receipts, including nested and concurrent reads.
+function fileObservation() {
+    const failures = new Map();
+    return {
+        run(operation) { return active.run(failures, operation); },
+        has(error, kind) { return failures.get(error)?.has(kind) === true; },
+    };
+}
+
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/strict-file-identity.js
+
+
+function identityMismatch() {
+    const error = new errors_FsSafeError("path-mismatch", "file identity changed or could not be verified");
+    recordFileObservationFailure(error, "identity");
+    return error;
+}
+function identityCheck(expected, platform) {
+    const known = {};
+    const check = (stat) => {
+        let complete = true;
+        for (const field of ["dev", "ino"]) {
+            const value = stat[field];
+            // Numeric receipts cannot recover identity bits already lost to rounding.
+            if (typeof value !== "bigint")
+                throw identityMismatch();
+            if (platform === "win32" && value === 0n) {
+                complete = false;
+            }
+            else {
+                if (known[field] !== undefined && known[field] !== value)
+                    throw identityMismatch();
+                known[field] = value;
+            }
+        }
+        return complete;
+    };
+    if (expected && !check(expected))
+        throw identityMismatch();
+    return check;
+}
+// Retry only unknown Windows identities, retaining every known component so a
+// later observation cannot erase a definite mismatch. Never reopen the file.
+async function inspectFileIdentity(inspect, expected, platform = process.platform) {
+    const check = identityCheck(expected, platform);
+    for (let attempt = 0; attempt < 2; attempt++) {
+        const stat = await inspect();
+        if (check(stat))
+            return stat;
+    }
+    throw identityMismatch();
+}
+function inspectFileIdentitySync(inspect, expected, platform = process.platform) {
+    const check = identityCheck(expected, platform);
+    for (let attempt = 0; attempt < 2; attempt++) {
+        const stat = inspect();
+        if (check(stat))
+            return stat;
+    }
+    throw identityMismatch();
+}
+
 ;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/path.js
 
 
@@ -368,6 +447,7 @@ function normalizeRemovePathError(error) {
 
 
 
+
 async function directory_guard_createAsyncDirectoryGuard(dir) {
     const stat = await promises_namespaceObject.lstat(dir);
     if (stat.isSymbolicLink() || !stat.isDirectory()) {
@@ -432,6 +512,15 @@ function directory_guard_createNearestExistingSyncDirectoryGuard(rootReal, targe
     }
     return directory_guard_createSyncDirectoryGuard(root);
 }
+// Recovery receipts must retain every identity bit, including on Windows.
+async function inspectDirectoryIdentity(dir, expected) {
+    return await inspectFileIdentity(async () => {
+        const stat = await promises_namespaceObject.lstat(dir, { bigint: true });
+        if (stat.isSymbolicLink() || !stat.isDirectory())
+            throw root_errors_directoryComponentNotDirectoryError();
+        return stat;
+    }, expected);
+}
 
 ;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/directory-durability.js
 
@@ -873,6 +962,8 @@ async function guardedRename(params) {
         ? await createNearestExistingDirectoryGuard(params.targetRoot, path.dirname(params.to))
         : await createAsyncDirectoryGuard(path.dirname(params.to));
     await withAsyncDirectoryGuards([sourceGuard, targetGuard], async () => {
+        // Authority must survive all awaited guards; do not yield before rename dispatch.
+        params.assertBeforeRename?.();
         await fs.rename(params.from, params.to);
     }, { verifyAfter: params.verifyAfter });
 }
@@ -1042,6 +1133,49 @@ function mergeDenyMutationPolicies(defaultPolicy, callPolicy) {
     };
 }
 
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/opened-file-failure.js
+
+
+
+function recordFileOpenFailure(error, filePath) {
+    recordFileObservationFailure(error, `open:${filePath}`);
+    throw error;
+}
+function openedPathResolutionError(error = new errors_FsSafeError("path-mismatch", "unable to resolve opened file path")) {
+    recordFileObservationFailure(error, "resolution");
+    return error;
+}
+async function recordPreOpenFileChange(error, handle, filePath, before, opened) {
+    if (!isFileObservationFailure(error, "identity") || !before?.isFile() || !opened?.isFile() ||
+        ![0n, 1n].includes(before.nlink) || ![0n, 1n].includes(opened.nlink))
+        return;
+    try {
+        await inspectFileIdentity(async () => before);
+        const current = await inspectFileIdentity(() => handle.stat({ bigint: true }), opened);
+        if (current.isFile() && [0n, 1n].includes(current.nlink) &&
+            (before.dev !== current.dev || before.ino !== current.ino)) {
+            // A stale pathname sample is not proof that its former inode was unlinked.
+            recordFileObservationFailure(error, `changed:${filePath}`);
+        }
+    }
+    catch {
+        // Unknown, changed, or closed descriptor evidence never permits a discard.
+    }
+}
+async function recordOpenedFileFailure(error, handle, filePath, identity) {
+    if ((!isFileObservationFailure(error, "resolution") && !isFileObservationFailure(error, "identity")) ||
+        !identity.isFile() || identity.nlink > 1n)
+        return;
+    try {
+        const current = await inspectFileIdentity(() => handle.stat({ bigint: true }), identity);
+        if (current.isFile() && current.nlink === 0n)
+            recordFileObservationFailure(error, `unlinked:${filePath}`);
+    }
+    catch {
+        // A closed, changed, or unknown descriptor provides no retry evidence.
+    }
+}
+
 ;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/opened-realpath.js
 
 
@@ -1081,6 +1215,12 @@ async function resolveOpenedFileRealPathForFd(fd, handleStat, ioPath) {
     }
     catch (err) {
         if (!path_isNotFoundPathError(err)) {
+            // Windows can fail here on a deleted-but-open file. Brand only this
+            // resolver operation; the caller must still prove unlink on the same fd.
+            if (process.platform === "win32" && err instanceof Error &&
+                ["EPERM", "EBADF"].includes(err.code ?? "")) {
+                throw openedPathResolutionError(err);
+            }
             throw err;
         }
     }
@@ -1088,7 +1228,7 @@ async function resolveOpenedFileRealPathForFd(fd, handleStat, ioPath) {
     if (parentResolved) {
         return parentResolved;
     }
-    throw new errors_FsSafeError("path-mismatch", "unable to resolve opened file path");
+    throw openedPathResolutionError();
 }
 async function resolveOpenedFileRealPathFromParent(handleStat, ioPath, statOptions) {
     let parentReal;
@@ -1582,7 +1722,7 @@ async function runPinnedWriteWindows(binding, params, root, parentFd, parentGuar
     let renamed = false;
     let completed = false;
     try {
-        tempName = `.${params.basename}.${(0,external_node_crypto_namespaceObject.randomUUID)()}.native.tmp`;
+        tempName = `.fs-safe-${(0,external_node_crypto_namespaceObject.randomUUID)()}.tmp`;
         tempFd = binding.openBeneath(parentFd, tempName, nativeOpenFlags(external_node_fs_namespaceObject.constants.O_WRONLY | external_node_fs_namespaceObject.constants.O_CREAT | external_node_fs_namespaceObject.constants.O_EXCL)).fd;
         tempIdentity = external_node_fs_namespaceObject.fstatSync(tempFd);
         const verificationIdentity = external_node_fs_namespaceObject.fstatSync(tempFd, { bigint: true });
@@ -1792,7 +1932,7 @@ const UNCOMMITTED_RENAME_ERRORS = new Set([
     "ENAMETOOLONG", "ENOENT", "ENOSPC", "ENOSYS", "ENOTDIR", "ENOTEMPTY", "ENOTSUP",
     "EPERM", "EROFS", "ETXTBSY", "EXDEV",
 ]);
-function failure(error, details) {
+function native_staged_file_failure(error, details) {
     const code = error instanceof errors_FsSafeError
         ? error.code
         : error?.code === "EEXIST" ? "already-exists" : "helper-failed";
@@ -1924,10 +2064,10 @@ class NativeStagedFile {
         catch (error) {
             const { receipt: cleanup, error: cleanupError } = this.#finalize();
             if (cleanupError) {
-                throw failure(new AggregateError([error, cleanupError], "preparation and cleanup failed"), { phase: "prepare", publication: cleanup.publication, cleanup });
+                throw native_staged_file_failure(new AggregateError([error, cleanupError], "preparation and cleanup failed"), { phase: "prepare", publication: cleanup.publication, cleanup });
             }
             if (cleanup.status === "preserved") {
-                throw failure(error, { phase: "prepare", publication: cleanup.publication, cleanup });
+                throw native_staged_file_failure(error, { phase: "prepare", publication: cleanup.publication, cleanup });
             }
             throw error;
         }
@@ -1986,7 +2126,7 @@ class NativeStagedFile {
             const publication = this.#state.status === "closed"
                 ? this.#state.receipt.publication
                 : this.#state.publication;
-            throw failure(error, { phase: "publish", publication });
+            throw native_staged_file_failure(error, { phase: "publish", publication });
         }
     }
     #finalize() {
@@ -2027,7 +2167,7 @@ class NativeStagedFile {
             status: outcome,
             resources,
         });
-        const error = errors.length ? failure(errors.length === 1 ? errors[0] : new AggregateError(errors, "staged cleanup failed"), { phase: "cleanup", publication: state.publication, cleanup: receipt }) : undefined;
+        const error = errors.length ? native_staged_file_failure(errors.length === 1 ? errors[0] : new AggregateError(errors, "staged cleanup failed"), { phase: "cleanup", publication: state.publication, cleanup: receipt }) : undefined;
         this.#state = { status: "closed", receipt, error };
         return this.#state;
     }
@@ -2336,974 +2476,756 @@ function bounded_read_readFileDescriptorBoundedSync(fd, maxBytes) {
     }
 }
 
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/test-hooks.js
-let test_hooks_fsSafeTestHooks;
-function allowFsSafeTestHooks() {
-    return  false || process.env.VITEST === "true";
-}
-function getFsSafeTestHooks() {
-    return test_hooks_fsSafeTestHooks;
-}
-function __setFsSafeTestHooksForTest(hooks) {
-    if (hooks && !allowFsSafeTestHooks()) {
-        throw new Error("__setFsSafeTestHooksForTest is only available in tests");
-    }
-    test_hooks_fsSafeTestHooks = hooks;
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/error-detail.js
+const UNSAFE_ERROR_DETAIL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f\u2028\u2029]/gu;
+function formatErrorDetail(value) {
+    return value.replace(UNSAFE_ERROR_DETAIL_CHARACTERS, (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}`);
 }
 
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/sidecar-lock-reclaim.js
-
-
-
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/root-path-symlink.js
 
 
 
 
 
 
-const MAX_LOCK_PAYLOAD_BYTES = 1024 * 1024;
-const SIDECAR_LOCK_OWNERSHIP_TOKEN_BYTES = 16;
-const SIDECAR_LOCK_OWNERSHIP_TOKEN_BITS = SIDECAR_LOCK_OWNERSHIP_TOKEN_BYTES * 8;
-const SIDECAR_LOCK_OWNERSHIP_TOKEN_PREFIX = "\t".repeat(8);
-const SIDECAR_LOCK_OWNERSHIP_TOKEN_PATTERN = new RegExp(`\\n(${SIDECAR_LOCK_OWNERSHIP_TOKEN_PREFIX}[ \\t]{${SIDECAR_LOCK_OWNERSHIP_TOKEN_BITS}})\\n$`);
-function createSidecarLockOwnershipToken() {
-    let token = SIDECAR_LOCK_OWNERSHIP_TOKEN_PREFIX;
-    for (const byte of (0,external_node_crypto_namespaceObject.randomBytes)(SIDECAR_LOCK_OWNERSHIP_TOKEN_BYTES)) {
-        for (let bit = 7; bit >= 0; bit -= 1) {
-            token += byte & (1 << bit) ? "\t" : " ";
-        }
-    }
-    return token;
-}
-function readSidecarLockOwnershipToken(raw) {
-    return SIDECAR_LOCK_OWNERSHIP_TOKEN_PATTERN.exec(raw)?.[1];
-}
-function serializeSidecarLockPayload(payload) {
-    const ownershipToken = createSidecarLockOwnershipToken();
-    return {
-        raw: `${JSON.stringify(payload, null, 2)}\n${ownershipToken}\n`,
-        ownershipToken,
-    };
-}
-function relativeSidecarLockPath(lockRoot, lockPath) {
-    const resolved = external_node_path_namespaceObject.resolve(lockPath);
-    const lexicalRelative = external_node_path_namespaceObject.relative(lockRoot.rootDir, resolved);
-    const relative = lexicalRelative !== ".." &&
-        !lexicalRelative.startsWith(`..${external_node_path_namespaceObject.sep}`) &&
-        !external_node_path_namespaceObject.isAbsolute(lexicalRelative)
-        ? lexicalRelative
-        : external_node_path_namespaceObject.relative(lockRoot.rootReal, resolved);
-    if (!relative || relative === ".." || relative.startsWith(`..${external_node_path_namespaceObject.sep}`) || external_node_path_namespaceObject.isAbsolute(relative)) {
-        throw new errors_FsSafeError("outside-workspace", "sidecar lock path is outside lockRoot");
+function normalizeSymlinkResolutionError(error) {
+    if (isSymlinkOpenError(error)) {
+        throw new errors_FsSafeError("symlink", "symlink path could not be resolved", {
+            cause: error instanceof Error ? error : undefined,
+        });
     }
-    return relative.split(external_node_path_namespaceObject.sep).join(external_node_path_namespaceObject.posix.sep);
+    if (!path_isNotFoundPathError(error))
+        throw error;
 }
-function parseSidecarLockPayload(raw, parser) {
-    if (parser) {
-        return parser(raw);
-    }
+async function resolveSymlinkHopPath(symlinkPath) {
     try {
-        const parsed = JSON.parse(raw);
-        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+        return external_node_path_namespaceObject.resolve(await promises_namespaceObject.realpath(symlinkPath));
     }
-    catch {
-        return null;
+    catch (error) {
+        normalizeSymlinkResolutionError(error);
+        const linkTarget = await promises_namespaceObject.readlink(symlinkPath);
+        return resolvePathViaExistingAncestor(external_node_path_namespaceObject.resolve(external_node_path_namespaceObject.dirname(symlinkPath), linkTarget));
     }
 }
-async function readSidecarLockSnapshot(lockPath, options = {}) {
-    let handle;
+function root_path_symlink_resolveSymlinkHopPathSync(symlinkPath) {
     try {
-        if (options.lockRoot) {
-            const lockRoot = options.lockRoot;
-            const relative = relativeSidecarLockPath(lockRoot, lockPath);
-            const opened = await lockRoot.open(relative).catch(async (error) => {
-                if (error instanceof errors_FsSafeError && error.code === "path-mismatch") {
-                    // An owner can unlink after open. Prove absence through the same root;
-                    // acquisition retries create-only, so a later replacement stays guarded.
-                    try {
-                        await lockRoot.stat(relative);
-                    }
-                    catch (probeError) {
-                        if (probeError instanceof errors_FsSafeError && probeError.code === "not-found") {
-                            return null;
-                        }
-                    }
-                }
-                throw error;
-            });
-            if (!opened)
-                return null;
-            try {
-                const raw = (await readFileHandleBounded(opened.handle, MAX_LOCK_PAYLOAD_BYTES)).toString("utf8");
-                return {
-                    raw,
-                    payload: parseSidecarLockPayload(raw, options.parsePayload),
-                    stat: opened.stat,
-                };
-            }
-            finally {
-                await opened.handle.close().catch(() => undefined);
-            }
-        }
-        const before = await promises_namespaceObject.lstat(lockPath);
-        if (!before.isFile() || before.isSymbolicLink()) {
-            if (options.rejectNonFile) {
-                throw new errors_FsSafeError("not-file", `sidecar lock is not a regular file: ${lockPath}`);
-            }
-            return null;
-        }
-        await getFsSafeTestHooks()?.beforeSidecarLockSnapshotOpen?.(lockPath);
-        const noFollow = process.platform !== "win32" && typeof external_node_fs_namespaceObject.constants.O_NOFOLLOW === "number"
-            ? external_node_fs_namespaceObject.constants.O_NOFOLLOW
-            : 0;
-        try {
-            handle = await promises_namespaceObject.open(lockPath, external_node_fs_namespaceObject.constants.O_RDONLY |
-                noFollow |
-                (typeof external_node_fs_namespaceObject.constants.O_NONBLOCK === "number" ? external_node_fs_namespaceObject.constants.O_NONBLOCK : 0));
-        }
-        catch (error) {
-            if (options.rejectNonFile && error.code === "ELOOP") {
-                throw new errors_FsSafeError("not-file", `sidecar lock is not a regular file: ${lockPath}`, {
-                    cause: error,
-                });
-            }
-            throw error;
-        }
-        const opened = await handle.stat();
-        if (!opened.isFile()) {
-            if (options.rejectNonFile) {
-                throw new errors_FsSafeError("not-file", `sidecar lock is not a regular file: ${lockPath}`);
-            }
-            return null;
-        }
-        if (!options.allowDescriptorIdentityDrift && !file_identity_sameFileIdentity(before, opened))
-            return null;
-        const raw = (await readFileHandleBounded(handle, MAX_LOCK_PAYLOAD_BYTES)).toString("utf8");
-        const after = await promises_namespaceObject.lstat(lockPath);
-        if (!after.isFile() || !file_identity_sameFileIdentity(before, after))
-            return null;
-        return { raw, payload: parseSidecarLockPayload(raw, options.parsePayload), stat: after };
+        return path.resolve(fs.realpathSync(symlinkPath));
     }
-    catch (err) {
-        if (err.code === "ENOENT" ||
-            (err instanceof errors_FsSafeError && err.code === "not-found")) {
-            return null;
-        }
-        throw err;
+    catch (error) {
+        normalizeSymlinkResolutionError(error);
+        const linkTarget = fs.readlinkSync(symlinkPath);
+        return resolvePathViaExistingAncestorSync(path.resolve(path.dirname(symlinkPath), linkTarget));
     }
-    finally {
-        await handle?.close().catch(() => undefined);
+}
+
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/safe-path-segment.js
+
+const SAFE_PATH_SEGMENT_PATTERN = /^[A-Za-z0-9_-][A-Za-z0-9._-]*$/;
+const SAFE_DOT_PREFIX_PATH_SEGMENT_PATTERN = /^[A-Za-z0-9._-]+$/;
+// Windows treats "C:name" as relative to the drive's current directory even
+// though path.win32.isAbsolute() reports false.
+const DRIVE_RELATIVE_PREFIX = /^[A-Za-z]:(?![\\/])/;
+const HYPHEN_CHAR_CODE = 0x2d;
+function safe_path_segment_isDriveRelativePath(value) {
+    return DRIVE_RELATIVE_PREFIX.test(value);
+}
+function assertNoDriveRelativePathSegments(value, label) {
+    if (value.split("/").some(safe_path_segment_isDriveRelativePath)) {
+        throw new errors_FsSafeError("invalid-path", `${label} must not contain a drive letter`);
     }
+    return value;
 }
-function readSidecarLockSnapshotSync(lockPath, parsePayload, options = {}) {
-    let fd;
-    try {
-        const before = fsSync.lstatSync(lockPath);
-        if (!before.isFile() || before.isSymbolicLink()) {
-            if (options.rejectNonFile) {
-                throw new FsSafeError("not-file", `sidecar lock is not a regular file: ${lockPath}`);
-            }
-            return null;
-        }
-        fd = fsSync.openSync(lockPath, resolveReadOpenFlags());
-        const opened = fsSync.fstatSync(fd);
-        if (!opened.isFile()) {
-            if (options.rejectNonFile) {
-                throw new FsSafeError("not-file", `sidecar lock is not a regular file: ${lockPath}`);
-            }
-            return null;
-        }
-        const raw = readFileDescriptorBoundedSync(fd, MAX_LOCK_PAYLOAD_BYTES).toString("utf8");
-        const after = fsSync.lstatSync(lockPath);
-        if (!sameFileIdentity(before, opened) || !sameFileIdentity(opened, after))
-            return null;
-        return {
-            raw,
-            payload: parseSidecarLockPayload(raw, parsePayload),
-            stat: after,
-            ownershipToken: readSidecarLockOwnershipToken(raw),
-        };
-    }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return null;
-        throw error;
+function trimHyphenEdges(value) {
+    let start = 0;
+    let end = value.length;
+    while (start < end && value.charCodeAt(start) === HYPHEN_CHAR_CODE) {
+        start += 1;
     }
-    finally {
-        if (fd !== undefined)
-            fsSync.closeSync(fd);
+    while (end > start && value.charCodeAt(end - 1) === HYPHEN_CHAR_CODE) {
+        end -= 1;
     }
+    return start === 0 && end === value.length ? value : value.slice(start, end);
 }
-function removeSidecarLockIfUnchangedSync(lockPath, observed) {
-    const current = readSidecarLockSnapshotSync(lockPath);
-    if (!current || !sidecarLockSnapshotMatches(current, observed))
-        return false;
-    fsSync.rmSync(lockPath);
-    return true;
+function isSafePathSegment(segment, options = {}) {
+    return (segment !== "" &&
+        segment !== "." &&
+        segment !== ".." &&
+        !segment.includes("/") &&
+        !segment.includes("\\") &&
+        !segment.includes("\0") &&
+        (options.allowDotPrefix === true || !segment.startsWith(".")) &&
+        (options.allowDotPrefix === true
+            ? SAFE_DOT_PREFIX_PATH_SEGMENT_PATTERN.test(segment)
+            : SAFE_PATH_SEGMENT_PATTERN.test(segment)));
 }
-function sidecarLockSnapshotMatches(current, observed) {
-    if (observed.ownershipToken !== undefined) {
-        return (current.stat?.isFile() === true &&
-            current.raw !== undefined &&
-            observed.raw !== undefined &&
-            readSidecarLockOwnershipToken(current.raw) === observed.ownershipToken &&
-            readSidecarLockOwnershipToken(observed.raw) === observed.ownershipToken &&
-            current.raw === observed.raw);
-    }
-    if (observed.stat && current.stat && !file_identity_sameFileIdentity(observed.stat, current.stat)) {
-        return false;
+function assertSafePathSegment(segment, options = {}) {
+    // Validate the exact value callers will later join into paths; trimming here
+    // would let whitespace-padded ids pass and then be used verbatim.
+    if (!isSafePathSegment(segment, options)) {
+        throw new FsSafeError("invalid-path", `${options.label ?? "path segment"} must be a safe path segment`);
     }
-    if (observed.raw !== undefined) {
-        return current.raw === observed.raw;
+    return segment;
+}
+function sanitizeSafePathSegment(value, fallback, options = {}) {
+    const sanitized = value
+        .trim()
+        .replace(/[\\/]+/g, "-")
+        .replace(/\0/g, "")
+        .replace(/[^A-Za-z0-9._-]+/g, "-");
+    const trimmed = trimHyphenEdges(sanitized);
+    if (isSafePathSegment(trimmed, options)) {
+        return trimmed;
     }
-    return observed.stat !== undefined && current.stat !== undefined;
+    return assertSafePathSegment(fallback, { ...options, label: "fallback path segment" });
 }
-async function removeSidecarLockIfUnchanged(lockPath, observed, options = {}) {
-    const current = await readSidecarLockSnapshot(lockPath, {
+function assertSafePathPrefix(prefix, options = {}) {
+    // Prefixes are often derived from safe filenames. Normalize harmless
+    // filename characters first, but still reject real path-control bytes.
+    if (prefix.includes("/") || prefix.includes("\\") || prefix.includes("\0")) {
+        return assertSafePathSegment(prefix, {
+            allowDotPrefix: true,
+            ...options,
+            label: options.label ?? "path prefix",
+        });
+    }
+    return assertSafePathSegment(prefix.replace(/[^A-Za-z0-9._-]+/g, "-"), {
+        allowDotPrefix: true,
         ...options,
-        allowDescriptorIdentityDrift: observed?.ownershipToken !== undefined,
+        label: options.label ?? "path prefix",
     });
-    if (!current || !observed || !sidecarLockSnapshotMatches(current, observed)) {
-        return false;
-    }
-    if (options.lockRoot) {
-        await options.lockRoot.remove(relativeSidecarLockPath(options.lockRoot, lockPath));
+}
+
+;// CONCATENATED MODULE: external "node:os"
+const external_node_os_namespaceObject = __rspack_createRequire_require("node:os");
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/short-path.js
+
+
+function shortPath(value) {
+    const home = external_node_os_namespaceObject.homedir();
+    const shortened = value.startsWith(home) ? `~${value.slice(home.length)}` : value;
+    return formatErrorDetail(shortened);
+}
+
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/root-path.js
+
+
+
+
+
+
+
+
+
+
+
+const ROOT_PATH_ALIAS_POLICIES = {
+    strict: Object.freeze({
+        allowFinalSymlinkForUnlink: false,
+        allowFinalHardlinkForUnlink: false,
+    }),
+    unlinkTarget: Object.freeze({
+        allowFinalSymlinkForUnlink: true,
+        allowFinalHardlinkForUnlink: true,
+    }),
+};
+async function resolveRootPath(params) {
+    try {
+        return await resolveRootPathInternal(params);
     }
-    else {
-        await promises_namespaceObject.rm(lockPath, { force: true });
+    catch (error) {
+        throw sanitizeRootPathError(error);
     }
-    return true;
 }
-async function sidecarLockSnapshotStillPresent(lockPath, observed, options = {}) {
-    const current = await readSidecarLockSnapshot(lockPath, {
-        ...options,
-        allowDescriptorIdentityDrift: observed?.ownershipToken !== undefined,
+async function resolveRootPathInternal(params) {
+    assertValidRootPathInputs(params);
+    const rootPath = external_node_path_namespaceObject.resolve(params.rootPath);
+    const absolutePath = external_node_path_namespaceObject.resolve(params.absolutePath);
+    const rootCanonicalPath = params.rootCanonicalPath
+        ? external_node_path_namespaceObject.resolve(params.rootCanonicalPath)
+        : await resolvePathViaExistingAncestor(rootPath);
+    const context = createBoundaryResolutionContext({
+        resolveParams: params,
+        rootPath,
+        absolutePath,
+        rootCanonicalPath,
+        outsideLexicalCanonicalPath: await resolveOutsideLexicalCanonicalPathAsync({
+            rootPath,
+            absolutePath,
+        }),
+    });
+    const outsideResult = await resolveOutsideRootPathAsync({
+        boundaryLabel: params.boundaryLabel,
+        context,
+    });
+    if (outsideResult) {
+        return outsideResult;
+    }
+    return resolveRootPathLexicalAsync({
+        params,
+        absolutePath: context.absolutePath,
+        rootPath: context.rootPath,
+        rootCanonicalPath: context.rootCanonicalPath,
     });
-    return !!current && !!observed && sidecarLockSnapshotMatches(current, observed);
 }
-async function sidecarReclaimGuardExists(pathname) {
+function resolveRootPathSync(params) {
     try {
-        await promises_namespaceObject.lstat(pathname);
-        return true;
+        return resolveRootPathSyncInternal(params);
     }
-    catch (err) {
-        if (err.code === "ENOENT") {
-            return false;
-        }
-        throw err;
+    catch (error) {
+        throw sanitizeRootPathError(error);
     }
 }
-async function tryAcquireSidecarReclaimGuard(reclaimGuards, reclaimGuardPath) {
-    try {
-        await promises_namespaceObject.mkdir(reclaimGuardPath);
-        reclaimGuards.add(reclaimGuardPath);
-        return true;
+function resolveRootPathSyncInternal(params) {
+    assertValidRootPathInputs(params);
+    const rootPath = path.resolve(params.rootPath);
+    const absolutePath = path.resolve(params.absolutePath);
+    const rootCanonicalPath = params.rootCanonicalPath
+        ? path.resolve(params.rootCanonicalPath)
+        : resolvePathViaExistingAncestorSync(rootPath);
+    const context = createBoundaryResolutionContext({
+        resolveParams: params,
+        rootPath,
+        absolutePath,
+        rootCanonicalPath,
+        outsideLexicalCanonicalPath: resolveOutsideLexicalCanonicalPathSync({
+            rootPath,
+            absolutePath,
+        }),
+    });
+    const outsideResult = resolveOutsideRootPathSync({
+        boundaryLabel: params.boundaryLabel,
+        context,
+    });
+    if (outsideResult) {
+        return outsideResult;
     }
-    catch (err) {
-        if (err.code === "EEXIST") {
-            return false;
-        }
-        throw err;
+    return resolveRootPathLexicalSync({
+        params,
+        absolutePath: context.absolutePath,
+        rootPath: context.rootPath,
+        rootCanonicalPath: context.rootCanonicalPath,
+    });
+}
+function sanitizeRootPathError(error) {
+    if (error instanceof Error) {
+        error.message = formatErrorDetail(error.message);
     }
+    return error;
 }
-async function releaseSidecarReclaimGuard(reclaimGuards, reclaimGuardPath) {
-    await promises_namespaceObject.rmdir(reclaimGuardPath);
-    reclaimGuards.delete(reclaimGuardPath);
+function assertValidRootPathInputs(params) {
+    path_assertNoNulPathInput(params.rootPath, "root path contains a NUL byte");
+    path_assertNoNulPathInput(params.absolutePath, "absolute path contains a NUL byte");
+    assertNoEmbeddedDriveRelativeSegment(params.rootPath, "root path");
+    assertNoEmbeddedDriveRelativeSegment(params.absolutePath, "absolute path");
+    if (params.rootCanonicalPath !== undefined) {
+        path_assertNoNulPathInput(params.rootCanonicalPath, "canonical root path contains a NUL byte");
+        assertNoEmbeddedDriveRelativeSegment(params.rootCanonicalPath, "canonical root path");
+    }
 }
-async function removeStaleSidecarLockIfAllowed(params) {
-    if (!params.shouldRemoveStaleLock || params.snapshot.raw === undefined) {
-        return "not-approved";
+function assertNoEmbeddedDriveRelativeSegment(filePath, label) {
+    if (process.platform !== "win32") {
+        return;
     }
-    const ioOptions = { lockRoot: params.lockRoot, parsePayload: params.parsePayload };
-    if (!(await sidecarLockSnapshotStillPresent(params.lockPath, params.snapshot, ioOptions))) {
-        return "changed";
-    }
-    if (!(await params.shouldRemoveStaleLock({
-        lockPath: params.lockPath,
-        normalizedTargetPath: params.normalizedTargetPath,
-        raw: params.snapshot.raw,
-        payload: params.snapshot.payload,
-    }))) {
-        return "not-approved";
-    }
-    if (!(await sidecarLockSnapshotStillPresent(params.lockPath, params.snapshot, ioOptions))) {
-        return "changed";
+    const root = external_node_path_namespaceObject.parse(filePath).root;
+    assertNoDriveRelativePathSegments(filePath.slice(root.length).replaceAll("\\", "/"), label);
+}
+function isPromiseLike(value) {
+    return Boolean(value &&
+        (typeof value === "object" || typeof value === "function") &&
+        "then" in value &&
+        typeof value.then === "function");
+}
+function createLexicalTraversalState(params) {
+    const rawAbsolutePath = params.params.absolutePath;
+    const rawRelativePath = rawPathRelativeToRoot(params.rootPath, rawAbsolutePath);
+    const relative = rawRelativePath ?? external_node_path_namespaceObject.relative(params.rootPath, params.absolutePath);
+    return {
+        segments: splitTraversalSegments(relative),
+        allowFinalSymlink: params.params.policy?.allowFinalSymlinkForUnlink === true,
+        canonicalCursor: params.rootCanonicalPath,
+        lexicalCursor: params.rootPath,
+        preserveFinalSymlink: false,
+    };
+}
+function createLexicalTraversalContext(params) {
+    return {
+        state: createLexicalTraversalState(params),
+        resolveParams: params.params,
+        rootPath: params.rootPath,
+        rootCanonicalPath: params.rootCanonicalPath,
+        absolutePath: params.absolutePath,
+    };
+}
+function splitTraversalSegments(value) {
+    return value
+        .split(process.platform === "win32" ? /[\\/]+/ : /\/+/)
+        .filter((segment) => Boolean(segment) && segment !== ".");
+}
+function rawPathRelativeToRoot(rootPath, candidatePath) {
+    if (!external_node_path_namespaceObject.isAbsolute(candidatePath)) {
+        return undefined;
     }
-    try {
-        if (params.lockRoot) {
-            await params.lockRoot.remove(relativeSidecarLockPath(params.lockRoot, params.lockPath));
-        }
-        else {
-            await promises_namespaceObject.rm(params.lockPath);
-        }
-        return "removed";
+    const root = external_node_path_namespaceObject.resolve(rootPath);
+    const candidate = process.platform === "win32"
+        ? candidatePath.replaceAll("/", external_node_path_namespaceObject.sep)
+        : candidatePath;
+    if (candidate === root) {
+        return "";
     }
-    catch (err) {
-        if (err.code === "ENOENT") {
-            return "changed";
-        }
-        throw err;
+    const rootWithSep = root.endsWith(external_node_path_namespaceObject.sep) ? root : `${root}${external_node_path_namespaceObject.sep}`;
+    const candidatePrefix = candidate.slice(0, rootWithSep.length);
+    const prefixMatches = process.platform === "win32"
+        ? candidatePrefix.toLowerCase() === rootWithSep.toLowerCase()
+        : candidatePrefix === rootWithSep;
+    return prefixMatches ? candidate.slice(rootWithSep.length) : undefined;
+}
+function assertLexicalCursorInsideBoundary(context, candidatePath) {
+    assertInsideBoundary({
+        boundaryLabel: context.resolveParams.boundaryLabel,
+        rootCanonicalPath: context.rootCanonicalPath,
+        candidatePath,
+        absolutePath: context.absolutePath,
+    });
+}
+function applyMissingSuffixToCanonicalCursor(context, missingFromIndex) {
+    const missingSuffix = context.state.segments.slice(missingFromIndex);
+    for (const segment of missingSuffix) {
+        advanceCanonicalCursorForSegment(context, segment);
     }
 }
-
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/sidecar-lock-policy.js
-
-function assertFiniteNonNegative(value, label) {
-    if (!Number.isFinite(value) || value < 0) {
-        throw new RangeError(`${label} must be a finite non-negative number`);
+function advanceCanonicalCursorForSegment(context, segment) {
+    context.state.canonicalCursor = external_node_path_namespaceObject.resolve(context.state.canonicalCursor, segment);
+    assertLexicalCursorInsideBoundary(context, context.state.canonicalCursor);
+}
+function finalizeLexicalResolution(context, kind) {
+    assertLexicalCursorInsideBoundary(context, context.state.canonicalCursor);
+    return buildResolvedRootPath({
+        absolutePath: context.absolutePath,
+        canonicalPath: context.state.canonicalCursor,
+        rootPath: context.rootPath,
+        rootCanonicalPath: context.rootCanonicalPath,
+        kind,
+    });
+}
+function handleLexicalLstatFailure(context, error, missingFromIndex) {
+    if (!path_isNotFoundPathError(error)) {
+        return false;
     }
+    applyMissingSuffixToCanonicalCursor(context, missingFromIndex);
+    return true;
 }
-function validateSidecarLockRetryOptions(retry) {
-    if (retry.retries !== undefined && (!Number.isSafeInteger(retry.retries) || retry.retries < 0)) {
-        throw new RangeError("lock retry.retries must be a non-negative safe integer");
+function handleLexicalStatReadFailure(context, error, missingFromIndex) {
+    if (handleLexicalLstatFailure(context, error, missingFromIndex)) {
+        return null;
     }
-    if (retry.factor !== undefined)
-        assertFiniteNonNegative(retry.factor, "lock retry.factor");
-    if (retry.minTimeout !== undefined) {
-        assertFiniteNonNegative(retry.minTimeout, "lock retry.minTimeout");
+    throw error;
+}
+function handleLexicalStatDisposition(context, params) {
+    if (!params.isSymbolicLink) {
+        advanceCanonicalCursorForSegment(context, params.segment);
+        return "continue";
     }
-    if (retry.maxTimeout !== undefined) {
-        assertFiniteNonNegative(retry.maxTimeout, "lock retry.maxTimeout");
+    if (context.resolveParams.rejectSymlinks === true && params.isLast) {
+        throw new errors_FsSafeError("symlink", "symlink path component not allowed");
     }
-    if (retry.minTimeout !== undefined &&
-        retry.maxTimeout !== undefined &&
-        retry.minTimeout > retry.maxTimeout) {
-        throw new RangeError("lock retry.minTimeout must not exceed retry.maxTimeout");
+    if (context.state.allowFinalSymlink && params.isLast) {
+        context.state.preserveFinalSymlink = true;
+        advanceCanonicalCursorForSegment(context, params.segment);
+        return "break";
     }
+    return "resolve-link";
 }
-function validateSidecarLockTimeoutMs(timeoutMs) {
-    if (timeoutMs === undefined || timeoutMs === Number.POSITIVE_INFINITY)
-        return;
-    assertFiniteNonNegative(timeoutMs, "lock timeoutMs");
-}
-function computeSidecarLockDelayMs(retry, attempt) {
-    validateSidecarLockRetryOptions(retry);
-    const minTimeout = retry.minTimeout ?? 50;
-    const maxTimeout = retry.maxTimeout ?? 1000;
-    const factor = retry.factor ?? 1;
-    const base = Math.min(maxTimeout, Math.max(minTimeout, minTimeout * factor ** attempt));
-    const jitter = retry.randomize ? 1 + Math.random() : 1;
-    return Math.min(maxTimeout, Math.round(base * jitter));
-}
-// Windows denies access to a lock file while a just-unlinked directory entry
-// is still being torn down, so a contended acquire sees EPERM on a name that is
-// already gone -- both when creating it exclusively and when reading the
-// holder's snapshot. The next attempt succeeds, so this is contention rather
-// than a permission failure. The error must name the lock file itself: the
-// exclusive-create helper opens the parent directory first, and a denial from
-// that setup step carries no teardown evidence and has to reach the caller.
-const maxTransientLockDenials = 8;
-function isTransientLockFileDenial(error, lockPath) {
-    const denial = error;
-    return process.platform === "win32" && denial?.code === "EPERM" && denial.path === lockPath;
-}
-function sidecarLockPayloadIsStale(payload, staleMs, nowMs) {
-    const createdAtMs = sidecarLockPayloadCreatedAtMs(payload);
-    return createdAtMs !== null && nowMs - createdAtMs > staleMs;
-}
-function sidecarLockPayloadCreatedAtMs(payload) {
-    const createdAt = payload &&
-        typeof payload === "object" &&
-        "createdAt" in payload &&
-        typeof payload.createdAt === "string"
-        ? payload.createdAt
-        : "";
-    const createdAtMs = Date.parse(createdAt);
-    return Number.isFinite(createdAtMs) ? createdAtMs : null;
+function applyResolvedSymlinkHop(context, linkCanonical) {
+    if (!path_isPathInside(context.rootCanonicalPath, linkCanonical)) {
+        throw symlinkEscapeError({
+            boundaryLabel: context.resolveParams.boundaryLabel,
+            rootCanonicalPath: context.rootCanonicalPath,
+            symlinkPath: context.state.lexicalCursor,
+        });
+    }
+    context.state.canonicalCursor = linkCanonical;
+    context.state.lexicalCursor = linkCanonical;
 }
-async function defaultSidecarLockShouldReclaim(params) {
-    const createdAtMs = sidecarLockPayloadCreatedAtMs(params.payload);
-    if (createdAtMs !== null)
-        return params.nowMs - createdAtMs > params.staleMs;
+function readLexicalStat(context, params) {
     try {
-        return params.nowMs - (await promises_namespaceObject.stat(params.lockPath)).mtimeMs > params.staleMs;
+        const stat = params.read(context.state.lexicalCursor);
+        if (isPromiseLike(stat)) {
+            return Promise.resolve(stat).catch((error) => handleLexicalStatReadFailure(context, error, params.missingFromIndex));
+        }
+        return stat;
     }
-    catch {
-        return true;
+    catch (error) {
+        return handleLexicalStatReadFailure(context, error, params.missingFromIndex);
     }
 }
-
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/suppressed-error.js
-function createSuppressedError(error, suppressed, message) {
-    const constructor = globalThis.SuppressedError;
-    if (constructor) {
-        return new constructor(error, suppressed, message);
+function resolveAndApplySymlinkHop(context, params) {
+    const linkCanonical = params.resolveLinkCanonical(context.state.lexicalCursor);
+    if (isPromiseLike(linkCanonical)) {
+        return Promise.resolve(linkCanonical).then((value) => {
+            applyResolvedSymlinkHop(context, value);
+        });
     }
-    const combined = new Error(message, {
-        cause: error instanceof Error ? error : undefined,
-    });
-    combined.name = "SuppressedError";
-    Object.defineProperties(combined, {
-        error: { configurable: true, value: error },
-        suppressed: { configurable: true, value: suppressed },
-    });
-    return combined;
+    applyResolvedSymlinkHop(context, linkCanonical);
 }
-
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/sidecar-lock-acquire.js
-
-
-
-
-
-
-
-async function resolveNormalizedTargetPath(targetPath) {
-    const resolved = external_node_path_namespaceObject.resolve(targetPath);
-    const dir = external_node_path_namespaceObject.dirname(resolved);
-    await promises_namespaceObject.mkdir(dir, { recursive: true });
-    try {
-        return external_node_path_namespaceObject.join(await promises_namespaceObject.realpath(dir), external_node_path_namespaceObject.basename(resolved));
-    }
-    catch {
-        return resolved;
+function applyParentTraversalStep(context) {
+    context.state.lexicalCursor = external_node_path_namespaceObject.resolve(context.state.lexicalCursor, "..");
+    advanceCanonicalCursorForSegment(context, "..");
+}
+function* iterateLexicalTraversal(state) {
+    for (let idx = 0; idx < state.segments.length; idx += 1) {
+        const segment = state.segments[idx] ?? "";
+        const isLast = idx === state.segments.length - 1;
+        yield { idx, segment, isLast };
     }
 }
-async function acquireSidecarLock(options, context) {
-    const retry = options.retry ?? {};
-    validateSidecarLockRetryOptions(retry);
-    validateSidecarLockTimeoutMs(options.timeoutMs);
-    context.ensureExitCleanupRegistered();
-    const normalizedTargetPath = await resolveNormalizedTargetPath(options.targetPath);
-    const lockPath = options.lockPath ?? `${normalizedTargetPath}.lock`;
-    let held = context.held.get(normalizedTargetPath);
-    if (held &&
-        options.reentrantOwner !== undefined &&
-        held.reentrantOwner !== undefined &&
-        options.reentrantOwner === held.reentrantOwner) {
-        // A final release may already have decremented the count to zero and be
-        // removing the sidecar. Do not admit a new reentrant handle until that
-        // cleanup settles: successful cleanup requires a fresh acquisition, while
-        // failed cleanup leaves the existing sidecar held for a retry.
-        if (held.releasePromise) {
-            await held.releasePromise.catch(() => undefined);
-            held = context.held.get(normalizedTargetPath);
-        }
-        if (held &&
-            options.reentrantOwner !== undefined &&
-            held.reentrantOwner !== undefined &&
-            options.reentrantOwner === held.reentrantOwner) {
-            held.refCount += 1;
-            return context.handleForHeldLock(normalizedTargetPath, held);
-        }
-    }
-    const startedAt = Date.now();
-    const maxRetries = options.timeoutMs === Number.POSITIVE_INFINITY ? undefined : retry.retries;
-    const reclaimGuardPath = `${lockPath}.reclaim`;
-    let ownsReclaimGuard = false;
-    let attempt = 0;
-    // Bounded so a genuine denial still surfaces as EPERM, not a lock timeout.
-    let transientDenials = 0;
-    const withinDenialBudget = () => ++transientDenials <= (/* inlined export .maxTransientLockDenials */8);
-    const waitForRetry = async () => {
-        const elapsed = Date.now() - startedAt;
-        if ((options.timeoutMs !== undefined &&
-            options.timeoutMs !== Number.POSITIVE_INFINITY &&
-            elapsed >= options.timeoutMs) ||
-            (maxRetries !== undefined && attempt >= maxRetries)) {
-            throw Object.assign(new Error(`file lock timeout for ${normalizedTargetPath}`), {
-                code: "file_lock_timeout",
-                lockPath,
-                normalizedTargetPath,
-            });
-        }
-        const remaining = options.timeoutMs === undefined || options.timeoutMs === Number.POSITIVE_INFINITY
-            ? Number.POSITIVE_INFINITY
-            : Math.max(0, options.timeoutMs - elapsed);
-        const delay = Math.min(computeSidecarLockDelayMs(retry, attempt), remaining);
-        attempt += 1;
-        await new Promise((resolve) => setTimeout(resolve, delay));
-    };
-    // Waiting can fail on the caller's own retry or deadline limits. Classifying
-    // a denial as contention must not cost them the original diagnosis, so hand
-    // the denial back when no further attempt can be scheduled.
-    const retryOrRethrowDenial = async (denial) => {
-        try {
-            await waitForRetry();
-        }
-        catch (waitError) {
-            if (waitError.code === "file_lock_timeout")
-                throw denial;
-            throw waitError;
-        }
-    };
-    try {
-        while (true) {
-            if (!ownsReclaimGuard && (await sidecarReclaimGuardExists(reclaimGuardPath))) {
-                await waitForRetry();
-                continue;
-            }
-            let handle = null;
-            let createdSnapshot = null;
-            let lockFileCreateDenied = false;
-            try {
-                const payload = await options.payload();
-                const { raw, ownershipToken } = serializeSidecarLockPayload(payload);
-                if (options.lockRoot) {
-                    const relativeLockPath = relativeSidecarLockPath(options.lockRoot, lockPath);
-                    try {
-                        await options.lockRoot.create(relativeLockPath, raw, { mkdir: true, mode: 0o600 });
-                    }
-                    catch (error) {
-                        if (error instanceof errors_FsSafeError && error.code === "already-exists") {
-                            throw Object.assign(new Error("sidecar lock exists"), { code: "EEXIST" });
-                        }
-                        throw error;
-                    }
-                    createdSnapshot = { raw, payload, ownershipToken };
-                    handle = (await options.lockRoot.open(relativeLockPath)).handle;
-                }
-                else {
-                    try {
-                        handle =
-                            (await createNativeExclusiveFile(lockPath, 0o600)) ??
-                                (await promises_namespaceObject.open(lockPath, "wx"));
-                    }
-                    catch (createError) {
-                        lockFileCreateDenied = isTransientLockFileDenial(createError, lockPath);
-                        throw createError;
-                    }
-                    await handle.writeFile(raw, "utf8");
-                }
-                const snapshot = { raw, payload, stat: await handle.stat(), ownershipToken };
-                const createdHeld = {
-                    refCount: 1,
-                    reentrantOwner: options.reentrantOwner,
-                    handle,
-                    lockPath,
-                    snapshot,
-                    acquiredAt: Date.now(),
-                    metadata: options.metadata ?? {},
-                    lockRoot: options.lockRoot,
-                    parsePayload: options.parsePayload,
-                };
-                context.held.set(normalizedTargetPath, createdHeld);
-                if (ownsReclaimGuard) {
-                    try {
-                        await releaseSidecarReclaimGuard(context.reclaimGuards, reclaimGuardPath);
-                        ownsReclaimGuard = false;
-                    }
-                    catch (err) {
-                        await context.releaseHeldLock(normalizedTargetPath, createdHeld, { force: true });
-                        throw err;
-                    }
-                }
-                const returnedHandle = context.handleForHeldLock(normalizedTargetPath, createdHeld);
-                const interval = options.compromiseCheckIntervalMs;
-                if (options.onCompromised && interval !== undefined && interval > 0) {
-                    createdHeld.compromiseTimer = setInterval(() => {
-                        void returnedHandle
-                            .verifyStillHeld()
-                            .catch(() => false)
-                            .then((stillHeld) => {
-                            if (!stillHeld && createdHeld.compromiseTimer) {
-                                clearInterval(createdHeld.compromiseTimer);
-                                createdHeld.compromiseTimer = undefined;
-                                options.onCompromised?.({ lockPath, normalizedTargetPath });
-                            }
-                        });
-                    }, interval);
-                    createdHeld.compromiseTimer.unref();
-                }
-                return returnedHandle;
-            }
-            catch (err) {
-                try {
-                    if (handle) {
-                        const failedSnapshot = { payload: null };
-                        try {
-                            failedSnapshot.stat = await handle.stat();
-                        }
-                        catch {
-                            // Best-effort cleanup of a failed exclusive create.
-                        }
-                        const current = context.held.get(normalizedTargetPath);
-                        if (current?.handle === handle) {
-                            context.held.delete(normalizedTargetPath);
-                        }
-                        await handle.close().catch(() => undefined);
-                        // The file may be empty or partial JSON, so remove by the identity
-                        // captured from our exclusive handle rather than by pathname alone.
-                        await removeSidecarLockIfUnchanged(lockPath, failedSnapshot, {
-                            lockRoot: options.lockRoot,
-                            parsePayload: options.parsePayload,
-                        });
-                    }
-                    else if (createdSnapshot) {
-                        await removeSidecarLockIfUnchanged(lockPath, createdSnapshot, {
-                            lockRoot: options.lockRoot,
-                            parsePayload: options.parsePayload,
-                        });
-                    }
-                }
-                catch (cleanupError) {
-                    throw createSuppressedError(cleanupError, err, "file lock acquisition and cleanup both failed");
-                }
-                if (lockFileCreateDenied && withinDenialBudget()) {
-                    await retryOrRethrowDenial(err);
-                    continue;
-                }
-                if (err.code !== "EEXIST") {
-                    throw err;
-                }
-                if (ownsReclaimGuard) {
-                    await releaseSidecarReclaimGuard(context.reclaimGuards, reclaimGuardPath);
-                    ownsReclaimGuard = false;
-                    continue;
-                }
-                const nowMs = Date.now();
-                let snapshot;
-                try {
-                    snapshot = await readSidecarLockSnapshot(lockPath, {
-                        lockRoot: options.lockRoot,
-                        parsePayload: options.parsePayload,
-                        rejectNonFile: true,
-                    });
-                }
-                catch (readErr) {
-                    if (!isTransientLockFileDenial(readErr, lockPath) || !withinDenialBudget())
-                        throw readErr;
-                    await retryOrRethrowDenial(readErr);
-                    continue;
-                }
-                if (!snapshot) {
-                    continue;
-                }
-                if (context.held.has(normalizedTargetPath)) {
-                    await waitForRetry();
-                    continue;
-                }
-                const shouldReclaim = options.shouldReclaim ?? defaultSidecarLockShouldReclaim;
-                if (await shouldReclaim({
-                    lockPath,
-                    normalizedTargetPath,
-                    payload: snapshot?.payload ?? null,
-                    staleMs: options.staleMs,
-                    nowMs,
-                    heldByThisProcess: context.held.has(normalizedTargetPath),
-                })) {
-                    if (!(await sidecarLockSnapshotStillPresent(lockPath, snapshot, {
-                        lockRoot: options.lockRoot,
-                        parsePayload: options.parsePayload,
-                    }))) {
-                        continue;
-                    }
-                    const staleRecovery = options.staleRecovery ?? "fail-closed";
-                    if (staleRecovery === "remove-if-unchanged") {
-                        if (!(await tryAcquireSidecarReclaimGuard(context.reclaimGuards, reclaimGuardPath))) {
-                            await waitForRetry();
-                            continue;
-                        }
-                        ownsReclaimGuard = true;
-                        const removal = await removeStaleSidecarLockIfAllowed({
-                            lockPath,
-                            normalizedTargetPath,
-                            snapshot,
-                            shouldRemoveStaleLock: options.shouldRemoveStaleLock,
-                            lockRoot: options.lockRoot,
-                            parsePayload: options.parsePayload,
-                        });
-                        if (removal === "removed" || removal === "changed") {
-                            continue;
-                        }
-                        await releaseSidecarReclaimGuard(context.reclaimGuards, reclaimGuardPath);
-                        ownsReclaimGuard = false;
-                    }
-                    throw Object.assign(new Error(`file lock stale for ${normalizedTargetPath}`), {
-                        code: "file_lock_stale",
-                        lockPath,
-                        normalizedTargetPath,
-                    });
-                }
-                await waitForRetry();
-            }
-        }
-    }
-    finally {
-        if (ownsReclaimGuard) {
-            await releaseSidecarReclaimGuard(context.reclaimGuards, reclaimGuardPath).catch(() => undefined);
-        }
-    }
-}
-
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/sidecar-lock-handle.js
-
-function createSidecarLockHandle(params) {
-    let released = false;
-    let releasePromise;
-    let releaseStarted = false;
-    const release = async () => {
-        if (released)
-            return;
-        if (!releasePromise) {
-            const retry = releaseStarted;
-            releaseStarted = true;
-            releasePromise = (async () => {
-                await params.release({ retry });
-                released = true;
-            })();
-        }
-        try {
-            await releasePromise;
-        }
-        finally {
-            releasePromise = undefined;
-        }
-    };
-    return {
-        lockPath: params.lockPath,
-        normalizedTargetPath: params.normalizedTargetPath,
-        verifyStillHeld: params.verifyStillHeld,
-        release,
-        [Symbol.asyncDispose]: release,
-    };
-}
-function createHeldSidecarLockHandle(params) {
-    return createSidecarLockHandle({
-        lockPath: params.held.lockPath,
-        normalizedTargetPath: params.normalizedTargetPath,
-        verifyStillHeld: async () => await sidecarLockSnapshotStillPresent(params.held.lockPath, params.held.snapshot, {
-            lockRoot: params.held.lockRoot,
-            parsePayload: params.held.parsePayload,
-        }),
-        release: (options) => params.release(options),
-    });
-}
-
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/sidecar-lock.js
-
-
-
-
-
-
-const GLOBAL_STATE_KEY = Symbol.for("fsSafe.sidecarLockManagers");
-const GLOBAL_CLEANUP_KEY = Symbol.for("fsSafe.sidecarLockCleanupRegistered");
-const GLOBAL_CLEANUP_HANDLER_KEY = Symbol.for("fsSafe.sidecarLockCleanupHandler");
-function getGlobalManagers() {
-    const globalWithState = globalThis;
-    if (!globalWithState[GLOBAL_STATE_KEY]) {
-        globalWithState[GLOBAL_STATE_KEY] = new Map();
-    }
-    return globalWithState[GLOBAL_STATE_KEY];
-}
-function resolveManagerState(key) {
-    const managers = getGlobalManagers();
-    let state = managers.get(key);
-    if (!state) {
-        state = {
-            cleanupRegistered: false,
-            held: new Map(),
-            reclaimCleanupRegistered: false,
-            reclaimGuards: new Set(),
-        };
-        managers.set(key, state);
-    }
-    else {
-        // The global manager symbol is shared across package copies and hot reloads.
-        // Backfill state created by fs-safe versions that predate reclaim guards.
-        state.reclaimCleanupRegistered ??= false;
-        state.reclaimGuards ??= new Set();
-        for (const held of state.held.values()) {
-            held.refCount ??= 1;
-        }
-    }
-    return state;
-}
-function snapshotMatchesSync(lockPath, observed) {
-    let fd;
-    try {
-        const beforeStat = external_node_fs_namespaceObject.lstatSync(lockPath);
-        if (!beforeStat.isFile()) {
-            return false;
+async function resolveRootPathLexicalAsync(params) {
+    const context = createLexicalTraversalContext(params);
+    const { state } = context;
+    for (const { idx, segment, isLast } of iterateLexicalTraversal(state)) {
+        if (segment === "..") {
+            applyParentTraversalStep(context);
+            continue;
         }
-        const openFlags = external_node_fs_namespaceObject.constants.O_RDONLY |
-            (process.platform !== "win32" && typeof external_node_fs_namespaceObject.constants.O_NOFOLLOW === "number"
-                ? external_node_fs_namespaceObject.constants.O_NOFOLLOW
-                : 0) |
-            (typeof external_node_fs_namespaceObject.constants.O_NONBLOCK === "number" ? external_node_fs_namespaceObject.constants.O_NONBLOCK : 0);
-        fd = external_node_fs_namespaceObject.openSync(lockPath, openFlags);
-        const openedStat = external_node_fs_namespaceObject.fstatSync(fd);
-        if (!openedStat.isFile()) {
-            return false;
+        state.lexicalCursor = external_node_path_namespaceObject.join(state.lexicalCursor, segment);
+        const stat = await readLexicalStat(context, {
+            missingFromIndex: idx,
+            read: (cursor) => promises_namespaceObject.lstat(cursor),
+        });
+        if (!stat) {
+            break;
         }
-        if (observed.raw !== undefined && openedStat.size !== Buffer.byteLength(observed.raw)) {
-            return false;
+        const disposition = handleLexicalStatDisposition(context, {
+            isSymbolicLink: stat.isSymbolicLink(),
+            segment,
+            isLast,
+        });
+        if (disposition === "continue") {
+            continue;
         }
-        const raw = external_node_fs_namespaceObject.readFileSync(fd, "utf8");
-        const afterStat = external_node_fs_namespaceObject.lstatSync(lockPath);
-        if (!afterStat.isFile() || !file_identity_sameFileIdentity(beforeStat, afterStat)) {
-            return false;
+        if (disposition === "break") {
+            break;
         }
-        return sidecarLockSnapshotMatches({ raw, payload: null, stat: afterStat }, observed);
-    }
-    catch {
-        return false;
-    }
-    finally {
-        if (fd !== undefined) {
-            try {
-                external_node_fs_namespaceObject.closeSync(fd);
-            }
-            catch {
-                // Best-effort process-exit cleanup.
-            }
+        await resolveAndApplySymlinkHop(context, {
+            resolveLinkCanonical: (cursor) => resolveSymlinkHopPath(cursor),
+        });
+        if (context.resolveParams.rejectSymlinks === true) {
+            throw new errors_FsSafeError("symlink", "symlink path component not allowed");
         }
     }
+    const kind = await getPathKind(state.canonicalCursor, state.preserveFinalSymlink);
+    return finalizeLexicalResolution(context, kind);
 }
-function releaseAllReclaimGuardsSync(state) {
-    for (const reclaimGuardPath of state.reclaimGuards) {
-        try {
-            external_node_fs_namespaceObject.rmdirSync(reclaimGuardPath);
-            state.reclaimGuards.delete(reclaimGuardPath);
+function resolveRootPathLexicalSync(params) {
+    const context = createLexicalTraversalContext(params);
+    const { state } = context;
+    for (let idx = 0; idx < state.segments.length; idx += 1) {
+        const segment = state.segments[idx] ?? "";
+        const isLast = idx === state.segments.length - 1;
+        if (segment === "..") {
+            applyParentTraversalStep(context);
+            continue;
         }
-        catch {
-            // Best-effort process-exit cleanup. A surviving guard fails closed.
+        state.lexicalCursor = path.join(state.lexicalCursor, segment);
+        const maybeStat = readLexicalStat(context, {
+            missingFromIndex: idx,
+            read: (cursor) => fs.lstatSync(cursor),
+        });
+        if (isPromiseLike(maybeStat)) {
+            throw new Error("Unexpected async lexical stat");
         }
-    }
-}
-function releaseAllLocksSync(state) {
-    for (const [normalizedTargetPath, held] of state.held) {
-        void held.handle.close().catch(() => undefined);
-        try {
-            if (!held.lockRoot && snapshotMatchesSync(held.lockPath, held.snapshot)) {
-                external_node_fs_namespaceObject.rmSync(held.lockPath, { force: true });
-            }
+        const stat = maybeStat;
+        if (!stat) {
+            break;
         }
-        catch {
-            // Best-effort process-exit cleanup.
+        const disposition = handleLexicalStatDisposition(context, {
+            isSymbolicLink: stat.isSymbolicLink(),
+            segment,
+            isLast,
+        });
+        if (disposition === "continue") {
+            continue;
+        }
+        if (disposition === "break") {
+            break;
+        }
+        const maybeApplied = resolveAndApplySymlinkHop(context, {
+            resolveLinkCanonical: (cursor) => resolveSymlinkHopPathSync(cursor),
+        });
+        if (isPromiseLike(maybeApplied)) {
+            throw new Error("Unexpected async symlink resolution");
+        }
+        if (context.resolveParams.rejectSymlinks === true) {
+            throw new FsSafeError("symlink", "symlink path component not allowed");
         }
-        state.held.delete(normalizedTargetPath);
     }
-    releaseAllReclaimGuardsSync(state);
+    const kind = getPathKindSync(state.canonicalCursor, state.preserveFinalSymlink);
+    return finalizeLexicalResolution(context, kind);
 }
-function ensureGlobalExitCleanupRegistered() {
-    const globalWithCleanup = globalThis;
-    if (globalWithCleanup[GLOBAL_CLEANUP_KEY])
-        return;
-    globalWithCleanup[GLOBAL_CLEANUP_KEY] = true;
-    const cleanup = () => {
-        for (const state of getGlobalManagers().values()) {
-            releaseAllLocksSync(state);
-        }
+function resolveCanonicalOutsideLexicalPath(params) {
+    return params.outsideLexicalCanonicalPath ?? params.absolutePath;
+}
+function createBoundaryResolutionContext(params) {
+    const lexicalInside = path_isPathInside(params.rootPath, params.absolutePath);
+    const canonicalOutsideLexicalPath = resolveCanonicalOutsideLexicalPath({
+        absolutePath: params.absolutePath,
+        outsideLexicalCanonicalPath: params.outsideLexicalCanonicalPath,
+    });
+    assertLexicalBoundaryOrCanonicalAlias({
+        skipLexicalRootCheck: params.resolveParams.skipLexicalRootCheck,
+        lexicalInside,
+        canonicalOutsideLexicalPath,
+        rootCanonicalPath: params.rootCanonicalPath,
+        boundaryLabel: params.resolveParams.boundaryLabel,
+        rootPath: params.rootPath,
+        absolutePath: params.absolutePath,
+    });
+    return {
+        rootPath: params.rootPath,
+        absolutePath: params.absolutePath,
+        rootCanonicalPath: params.rootCanonicalPath,
+        lexicalInside,
+        canonicalOutsideLexicalPath,
     };
-    globalWithCleanup[GLOBAL_CLEANUP_HANDLER_KEY] = cleanup;
-    process.on("exit", cleanup);
 }
-async function releaseHeldLock(state, normalizedTargetPath, held, options = {}) {
-    const current = state.held.get(normalizedTargetPath);
-    if (current !== held) {
-        return false;
+async function resolveOutsideRootPathAsync(params) {
+    if (params.context.lexicalInside) {
+        return null;
     }
-    if (held.releasePromise) {
-        await held.releasePromise;
-        return true;
+    const kind = await getPathKind(params.context.absolutePath, false);
+    return buildOutsideRootPathFromContext({
+        boundaryLabel: params.boundaryLabel,
+        context: params.context,
+        kind,
+    });
+}
+function resolveOutsideRootPathSync(params) {
+    if (params.context.lexicalInside) {
+        return null;
     }
-    if (options.force) {
-        held.refCount = 0;
+    const kind = getPathKindSync(params.context.absolutePath, false);
+    return buildOutsideRootPathFromContext({
+        boundaryLabel: params.boundaryLabel,
+        context: params.context,
+        kind,
+    });
+}
+function buildOutsideRootPathFromContext(params) {
+    return buildOutsideLexicalRootPath({
+        boundaryLabel: params.boundaryLabel,
+        rootCanonicalPath: params.context.rootCanonicalPath,
+        absolutePath: params.context.absolutePath,
+        canonicalOutsideLexicalPath: params.context.canonicalOutsideLexicalPath,
+        rootPath: params.context.rootPath,
+        kind: params.kind,
+    });
+}
+async function resolveOutsideLexicalCanonicalPathAsync(params) {
+    if (path_isPathInside(params.rootPath, params.absolutePath)) {
+        return undefined;
     }
-    else if (!options.retry && held.refCount > 0) {
-        held.refCount -= 1;
+    return await resolvePathViaExistingAncestor(params.absolutePath);
+}
+function resolveOutsideLexicalCanonicalPathSync(params) {
+    if (isPathInside(params.rootPath, params.absolutePath)) {
+        return undefined;
     }
-    if (held.refCount > 0) {
-        return false;
+    return resolvePathViaExistingAncestorSync(params.absolutePath);
+}
+function buildOutsideLexicalRootPath(params) {
+    assertInsideBoundary({
+        boundaryLabel: params.boundaryLabel,
+        rootCanonicalPath: params.rootCanonicalPath,
+        candidatePath: params.canonicalOutsideLexicalPath,
+        absolutePath: params.absolutePath,
+    });
+    return buildResolvedRootPath({
+        absolutePath: params.absolutePath,
+        canonicalPath: params.canonicalOutsideLexicalPath,
+        rootPath: params.rootPath,
+        rootCanonicalPath: params.rootCanonicalPath,
+        kind: params.kind,
+    });
+}
+function assertLexicalBoundaryOrCanonicalAlias(params) {
+    if (params.skipLexicalRootCheck || params.lexicalInside) {
+        return;
+    }
+    if (path_isPathInside(params.rootCanonicalPath, params.canonicalOutsideLexicalPath)) {
+        return;
+    }
+    throw pathEscapeError({
+        boundaryLabel: params.boundaryLabel,
+        rootPath: params.rootPath,
+        absolutePath: params.absolutePath,
+    });
+}
+function buildResolvedRootPath(params) {
+    return {
+        absolutePath: params.absolutePath,
+        canonicalPath: params.canonicalPath,
+        rootPath: params.rootPath,
+        rootCanonicalPath: params.rootCanonicalPath,
+        relativePath: relativeInsideRoot(params.rootCanonicalPath, params.canonicalPath),
+        exists: params.kind.exists,
+        kind: params.kind.kind,
+    };
+}
+async function getPathKind(absolutePath, preserveFinalSymlink) {
+    try {
+        const stat = preserveFinalSymlink
+            ? await promises_namespaceObject.lstat(absolutePath)
+            : await promises_namespaceObject.stat(absolutePath);
+        return { exists: true, kind: toResolvedKind(stat) };
     }
-    held.releasePromise = (async () => {
-        await held.handle.close().catch(() => undefined);
-        await removeSidecarLockIfUnchanged(held.lockPath, held.snapshot, {
-            lockRoot: held.lockRoot,
-            parsePayload: held.parsePayload,
-        });
-        if (state.held.get(normalizedTargetPath) === held) {
-            state.held.delete(normalizedTargetPath);
-        }
-        if (held.compromiseTimer) {
-            clearInterval(held.compromiseTimer);
-            held.compromiseTimer = undefined;
+    catch (error) {
+        if (path_isNotFoundPathError(error)) {
+            return { exists: false, kind: "missing" };
         }
-    })();
+        throw error;
+    }
+}
+function getPathKindSync(absolutePath, preserveFinalSymlink) {
     try {
-        await held.releasePromise;
-        return true;
+        const stat = preserveFinalSymlink ? fs.lstatSync(absolutePath) : fs.statSync(absolutePath);
+        return { exists: true, kind: toResolvedKind(stat) };
     }
-    finally {
-        held.releasePromise = undefined;
+    catch (error) {
+        if (isNotFoundPathError(error)) {
+            return { exists: false, kind: "missing" };
+        }
+        throw error;
     }
 }
-function handleForHeldLock(state, normalizedTargetPath, held) {
-    return createHeldSidecarLockHandle({
-        normalizedTargetPath,
-        held,
-        release: async (options) => await releaseHeldLock(state, normalizedTargetPath, held, { retry: options?.retry }),
-    });
-}
-function createSidecarLockManager(key) {
-    const state = resolveManagerState(key);
-    function ensureExitCleanupRegistered() {
-        state.cleanupRegistered = true;
-        state.reclaimCleanupRegistered = true;
-        ensureGlobalExitCleanupRegistered();
+function toResolvedKind(stat) {
+    if (stat.isFile()) {
+        return "file";
     }
-    async function acquire(options) {
-        return await acquireSidecarLock(options, {
-            held: state.held,
-            reclaimGuards: state.reclaimGuards,
-            ensureExitCleanupRegistered,
-            handleForHeldLock: (normalizedTargetPath, held) => handleForHeldLock(state, normalizedTargetPath, held),
-            releaseHeldLock: async (normalizedTargetPath, held, releaseOptions) => await releaseHeldLock(state, normalizedTargetPath, held, releaseOptions),
-        });
+    if (stat.isDirectory()) {
+        return "directory";
     }
-    async function withLock(options, fn) {
-        const lock = await acquire(options);
-        let result;
-        try {
-            result = await fn();
-        }
-        catch (bodyError) {
-            try {
-                await lock.release();
-            }
-            catch (releaseError) {
-                throw createSuppressedError(releaseError, bodyError, "file lock callback and release both failed");
-            }
-            throw bodyError;
-        }
-        await lock.release();
-        return result;
+    if (stat.isSymbolicLink()) {
+        return "symlink";
     }
-    async function drain() {
-        for (const [normalizedTargetPath, held] of Array.from(state.held.entries())) {
-            await releaseHeldLock(state, normalizedTargetPath, held, { force: true }).catch(() => undefined);
-        }
+    return "other";
+}
+function relativeInsideRoot(rootPath, targetPath) {
+    const relative = external_node_path_namespaceObject.relative(external_node_path_namespaceObject.resolve(rootPath), external_node_path_namespaceObject.resolve(targetPath));
+    if (!relative || relative === ".") {
+        return "";
     }
-    function reset() {
-        releaseAllLocksSync(state);
+    if (isPathRelativeEscape(relative)) {
+        return "";
     }
-    function heldEntries() {
-        return Array.from(state.held.entries()).map(([normalizedTargetPath, held]) => ({
-            normalizedTargetPath,
-            lockPath: held.lockPath,
-            acquiredAt: held.acquiredAt,
-            metadata: held.metadata,
-            forceRelease: () => releaseHeldLock(state, normalizedTargetPath, held, { force: true }),
-        }));
+    return relative;
+}
+function assertInsideBoundary(params) {
+    if (path_isPathInside(params.rootCanonicalPath, params.candidatePath)) {
+        return;
     }
-    return { acquire, withLock, drain, reset, heldEntries };
+    throw new Error(`Path resolves outside ${params.boundaryLabel} (${shortPath(params.rootCanonicalPath)}): ${shortPath(params.absolutePath)}`);
 }
-async function withSidecarLock(targetPath, options, fn) {
-    const manager = createSidecarLockManager(options.managerKey ?? `fs-safe.sidecar-lock:${targetPath}`);
-    const { managerKey: _managerKey, ...acquireOptions } = options;
-    return await manager.withLock({ ...acquireOptions, targetPath }, fn);
+function pathEscapeError(params) {
+    return new Error(`Path escapes ${params.boundaryLabel} (${shortPath(params.rootPath)}): ${shortPath(params.absolutePath)}`);
+}
+function symlinkEscapeError(params) {
+    return new Error(`Symlink escapes ${params.boundaryLabel} (${shortPath(params.rootCanonicalPath)}): ${shortPath(params.symlinkPath)}`);
 }
 
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/pinned-write.js
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/sidecar-lock-root.js
 
 
 
 
 
 
+async function openSidecarRoot(lockRoot, relative, discardObservation, onOpenFailure) {
+    const resolved = await lockRoot.resolve(relative);
+    const canonicalPath = async () => (await resolveRootPath({
+        absolutePath: resolved,
+        rootPath: lockRoot.rootReal,
+        rootCanonicalPath: lockRoot.rootReal,
+        boundaryLabel: "sidecar lock root",
+    })).canonicalPath;
+    const expectedRealPath = await canonicalPath();
+    if (expectedRealPath === lockRoot.rootReal)
+        throw new errors_FsSafeError("not-file", "sidecar lock is a directory");
+    const parents = [];
+    let completeParents = true;
+    if (discardObservation) {
+        // Follow permitted in-root aliases first; receipts cover canonical ancestry.
+        for (let dir = external_node_path_namespaceObject.dirname(expectedRealPath);; dir = external_node_path_namespaceObject.dirname(dir)) {
+            try {
+                parents.push({ dir, stat: await inspectDirectoryIdentity(dir) });
+            }
+            catch (error) {
+                if (!path_isNotFoundPathError(error))
+                    throw error;
+                completeParents = false;
+            }
+            if (dir === lockRoot.rootReal)
+                break;
+        }
+    }
+    const observation = fileObservation();
+    try {
+        const opened = await observation.run(() => lockRoot.open(relative));
+        if (opened.realPath !== expectedRealPath) {
+            await opened.handle.close().catch(() => undefined);
+            throw new errors_FsSafeError("path-mismatch", "sidecar lock path changed during open");
+        }
+        return opened;
+    }
+    catch (error) {
+        const openFailed = observation.has(error, `open:${resolved}`);
+        if (openFailed)
+            onOpenFailure?.(error);
+        const missing = openFailed && error instanceof errors_FsSafeError && error.code === "not-found";
+        if (missing && !discardObservation)
+            return null;
+        const discardable = observation.has(error, `unlinked:${resolved}`) ||
+            (discardObservation === "changed" && observation.has(error, `changed:${resolved}`));
+        if (!discardObservation || (!missing && (!completeParents || !discardable)))
+            throw error;
+        try {
+            try {
+                const current = await lockRoot.stat(relative);
+                if (!current.isFile || current.isSymbolicLink || current.nlink !== 1)
+                    throw error;
+            }
+            catch (probeError) {
+                if (!(probeError instanceof errors_FsSafeError && probeError.code === "not-found"))
+                    throw probeError;
+            }
+            for (const { dir, stat } of parents)
+                await inspectDirectoryIdentity(dir, stat);
+            await lockRoot.resolve(relative);
+            if (await canonicalPath() === expectedRealPath)
+                return null;
+        }
+        catch {
+            // Keep the original failure when directory or confinement proof fails.
+        }
+        throw error;
+    }
+}
+
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/test-hooks.js
+let test_hooks_fsSafeTestHooks;
+function allowFsSafeTestHooks() {
+    return  false || process.env.VITEST === "true";
+}
+function getFsSafeTestHooks() {
+    return test_hooks_fsSafeTestHooks;
+}
+function __setFsSafeTestHooksForTest(hooks) {
+    if (hooks && !allowFsSafeTestHooks()) {
+        throw new Error("__setFsSafeTestHooksForTest is only available in tests");
+    }
+    test_hooks_fsSafeTestHooks = hooks;
+}
 
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/sidecar-lock-reclaim.js
 
 
 
@@ -3314,361 +3236,395 @@ async function withSidecarLock(targetPath, options, fn) {
 
 
 
-function byteLength(input, encoding) {
-    return typeof input === "string"
-        ? Buffer.byteLength(input, encoding ?? "utf8")
-        : input.byteLength;
+const MAX_LOCK_PAYLOAD_BYTES = 1024 * 1024;
+const SIDECAR_LOCK_OWNERSHIP_TOKEN_BYTES = 16;
+const SIDECAR_LOCK_OWNERSHIP_TOKEN_BITS = SIDECAR_LOCK_OWNERSHIP_TOKEN_BYTES * 8;
+const SIDECAR_LOCK_OWNERSHIP_TOKEN_PREFIX = "\t".repeat(8);
+const SIDECAR_LOCK_OWNERSHIP_TOKEN_PATTERN = new RegExp(`\\n(${SIDECAR_LOCK_OWNERSHIP_TOKEN_PREFIX}[ \\t]{${SIDECAR_LOCK_OWNERSHIP_TOKEN_BITS}})\\n$`);
+function parseSidecarLockSnapshot(snapshot, parser) {
+    return snapshot && { ...snapshot, payload: parseSidecarLockPayload(snapshot.raw, parser) };
 }
-function assertSafeBasename(basename) {
-    if (!basename ||
-        basename === "." ||
-        basename === ".." ||
-        basename.includes("/") ||
-        basename.includes("\0")) {
-        throw new errors_FsSafeError("invalid-path", "invalid target path");
+function createSidecarLockOwnershipToken() {
+    let token = SIDECAR_LOCK_OWNERSHIP_TOKEN_PREFIX;
+    for (const byte of (0,external_node_crypto_namespaceObject.randomBytes)(SIDECAR_LOCK_OWNERSHIP_TOKEN_BYTES)) {
+        for (let bit = 7; bit >= 0; bit -= 1) {
+            token += byte & (1 << bit) ? "\t" : " ";
+        }
     }
+    return token;
 }
-function assertWithinMaxBytes(bytes, maxBytes) {
-    if (maxBytes !== undefined && bytes > maxBytes) {
-        throw new errors_FsSafeError("too-large", `file exceeds limit of ${maxBytes} bytes (got at least ${bytes})`);
+function readSidecarLockOwnershipToken(raw) {
+    return SIDECAR_LOCK_OWNERSHIP_TOKEN_PATTERN.exec(raw)?.[1];
+}
+function serializeSidecarLockPayload(payload) {
+    const ownershipToken = createSidecarLockOwnershipToken();
+    return {
+        raw: `${JSON.stringify(payload, null, 2)}\n${ownershipToken}\n`,
+        ownershipToken,
+    };
+}
+function relativeSidecarLockPath(lockRoot, lockPath) {
+    const resolved = external_node_path_namespaceObject.resolve(lockPath);
+    const lexicalRelative = external_node_path_namespaceObject.relative(lockRoot.rootDir, resolved);
+    const relative = lexicalRelative !== ".." &&
+        !lexicalRelative.startsWith(`..${external_node_path_namespaceObject.sep}`) &&
+        !external_node_path_namespaceObject.isAbsolute(lexicalRelative)
+        ? lexicalRelative
+        : external_node_path_namespaceObject.relative(lockRoot.rootReal, resolved);
+    if (!relative || relative === ".." || relative.startsWith(`..${external_node_path_namespaceObject.sep}`) || external_node_path_namespaceObject.isAbsolute(relative)) {
+        throw new errors_FsSafeError("outside-workspace", "sidecar lock path is outside lockRoot");
     }
+    return relative.split(external_node_path_namespaceObject.sep).join(external_node_path_namespaceObject.posix.sep);
 }
-async function syncFileBestEffort(handle) {
+function parseSidecarLockPayload(raw, parser) {
+    if (parser) {
+        return parser(raw);
+    }
     try {
-        await handle.sync();
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
     }
-    catch (error) {
-        if (error?.code !== "EPERM") {
+    catch {
+        return null;
+    }
+}
+function missingSnapshotPath(error) {
+    if (error.code === "ENOENT")
+        return null;
+    throw error;
+}
+async function readSidecarLockSnapshot(lockPath, options = {}) {
+    return parseSidecarLockSnapshot(await readSidecarLockRawSnapshot(lockPath, options), options.parsePayload);
+}
+async function readSidecarLockRawSnapshot(lockPath, options = {}) {
+    let handle;
+    try {
+        if (options.lockRoot) {
+            const lockRoot = options.lockRoot;
+            const relative = relativeSidecarLockPath(lockRoot, lockPath);
+            const opened = await openSidecarRoot(lockRoot, relative, options.discardObservation, options.onOpenFailure);
+            if (!opened)
+                return null;
+            try {
+                const raw = (await readFileHandleBounded(opened.handle, MAX_LOCK_PAYLOAD_BYTES)).toString("utf8");
+                return {
+                    raw,
+                    stat: opened.stat,
+                };
+            }
+            finally {
+                await opened.handle.close().catch(() => undefined);
+            }
+        }
+        const before = await promises_namespaceObject.lstat(lockPath).catch(missingSnapshotPath);
+        if (!before)
+            return null;
+        if (!before.isFile() || before.isSymbolicLink()) {
+            if (options.rejectNonFile) {
+                throw new errors_FsSafeError("not-file", `sidecar lock is not a regular file: ${lockPath}`);
+            }
+            return null;
+        }
+        await getFsSafeTestHooks()?.beforeSidecarLockSnapshotOpen?.(lockPath);
+        const noFollow = process.platform !== "win32" && typeof external_node_fs_namespaceObject.constants.O_NOFOLLOW === "number"
+            ? external_node_fs_namespaceObject.constants.O_NOFOLLOW
+            : 0;
+        try {
+            handle = await promises_namespaceObject.open(lockPath, external_node_fs_namespaceObject.constants.O_RDONLY |
+                noFollow |
+                (typeof external_node_fs_namespaceObject.constants.O_NONBLOCK === "number" ? external_node_fs_namespaceObject.constants.O_NONBLOCK : 0));
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return null;
+            if (options.rejectNonFile && error.code === "ELOOP") {
+                throw new errors_FsSafeError("not-file", `sidecar lock is not a regular file: ${lockPath}`, {
+                    cause: error,
+                });
+            }
+            options.onOpenFailure?.(error);
             throw error;
         }
-    }
-}
-async function writeStreamToHandle(stream, handle, maxBytes) {
-    let bytes = 0;
-    for await (const chunk of stream) {
-        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
-        bytes += buffer.byteLength;
-        assertWithinMaxBytes(bytes, maxBytes);
-        let offset = 0;
-        while (offset < buffer.byteLength) {
-            const { bytesWritten } = await handle.write(buffer, offset, buffer.byteLength - offset);
-            if (bytesWritten <= 0) {
-                throw new errors_FsSafeError("helper-failed", "fallback stream write made no progress");
+        const opened = await handle.stat();
+        if (!opened.isFile()) {
+            if (options.rejectNonFile) {
+                throw new errors_FsSafeError("not-file", `sidecar lock is not a regular file: ${lockPath}`);
             }
-            offset += bytesWritten;
+            return null;
         }
+        if (!options.allowDescriptorIdentityDrift && !file_identity_sameFileIdentity(before, opened))
+            return null;
+        const raw = (await readFileHandleBounded(handle, MAX_LOCK_PAYLOAD_BYTES)).toString("utf8");
+        const after = await promises_namespaceObject.lstat(lockPath).catch(missingSnapshotPath);
+        if (!after || !after.isFile() || !file_identity_sameFileIdentity(before, after))
+            return null;
+        return { raw, stat: after };
+    }
+    finally {
+        await handle?.close().catch(() => undefined);
     }
 }
-async function runPinnedWriteHelper(params) {
-    const normalizedParams = { ...params, maxBytes: byte_budget_normalizeMaxBytes(params.maxBytes) };
-    assertSafeBasename(params.basename);
-    validatePinnedOperationPayload({
-        relativeParentPath: params.relativeParentPath,
-    });
-    // The explicit compatibility policy uses the guarded Node fallback, where
-    // content verification can replace the strict post-rename inode check.
-    if (normalizedParams.onRenameIdentityMismatch === "verify-content") {
-        return await runPinnedWriteFallback(normalizedParams);
+function lstatSidecarLockSync(lockPath) {
+    try {
+        return fsSync.lstatSync(lockPath);
     }
-    const native = getNativeBinding();
-    if (native) {
-        return await runPinnedWriteNative(native, normalizedParams);
+    catch (error) {
+        return missingSnapshotPath(error);
     }
-    return await runPinnedWriteFallback(normalizedParams);
 }
-async function runPinnedWriteWithRenamePolicy(params) {
-    const { targetPath, renameIdentity, ...writeParams } = params;
-    if (renameIdentity !== "verify-content-with-lock") {
-        return await runPinnedWriteHelper(writeParams);
-    }
-    const relativeTargetPath = writeParams.relativeParentPath
-        ? `${writeParams.relativeParentPath}/${writeParams.basename}`
-        : writeParams.basename;
-    const lockPath = external_node_path_namespaceObject.join(writeParams.rootPath, `.fs-safe-write-${sha256Hex(relativeTargetPath)}.lock`);
-    return await withSidecarLock(writeParams.rootPath, {
-        managerKey: `fs-safe.write:${targetPath}`,
-        lockPath,
-        staleMs: 30_000,
-        timeoutMs: 5_000,
-        payload: () => ({ pid: process.pid, createdAt: new Date().toISOString() }),
-        retry: { retries: 5, minTimeout: 100, maxTimeout: 2_000, factor: 2 },
-    }, async () => await runPinnedWriteHelper({
-        ...writeParams,
-        onRenameIdentityMismatch: "verify-content",
-    }));
+function readSidecarLockSnapshotSync(lockPath, parsePayload, options = {}) {
+    return parseSidecarLockSnapshot(readSidecarLockRawSnapshotSync(lockPath, options), parsePayload);
 }
-async function runPinnedWriteFallback(params) {
-    let parentPath = params.relativeParentPath
-        ? external_node_path_namespaceObject.join(params.rootPath, ...params.relativeParentPath.split("/"))
-        : params.rootPath;
-    if (params.mkdir) {
-        // mkdirPathComponentsWithGuards may resolve the final component through
-        // an in-root symlink (e.g. a skill-bank layout). Use its returned real
-        // path for the subsequent guard and target path so we don't re-check the
-        // original, possibly-symlinked, lexical path and reject it outright.
-        parentPath = await mkdirPathComponentsWithGuards({
-            rootReal: params.rootPath,
-            targetPath: parentPath,
-            beforeComponent: async (componentPath) => await getFsSafeTestHooks()?.beforeRootFallbackMutation?.("mkdir", componentPath),
-        });
-    }
-    const parentGuard = params.mkdir
-        ? await directory_guard_createAsyncDirectoryGuard(parentPath)
-        : await directory_guard_createNearestExistingDirectoryGuard(params.rootPath, parentPath);
-    const targetPath = external_node_path_namespaceObject.join(parentPath, params.basename);
-    if (params.overwrite === false) {
-        const handle = await withAsyncDirectoryGuards([parentGuard], async () => await promises_namespaceObject.open(targetPath, external_node_fs_namespaceObject.constants.O_WRONLY | external_node_fs_namespaceObject.constants.O_CREAT | external_node_fs_namespaceObject.constants.O_EXCL, params.mode), {
-            onPostGuardFailure: async (openedHandle) => {
-                // The parent failed verification, so targetPath may now resolve
-                // somewhere else. Close the fd, but do not clean up by path.
-                await openedHandle.close().catch(() => undefined);
-            },
-        });
-        let created = true;
-        try {
-            const verificationIdentity = await handle.stat({ bigint: true });
-            await handle.chmod(params.mode);
-            if (params.input.kind === "buffer") {
-                assertWithinMaxBytes(byteLength(params.input.data, params.input.encoding), params.maxBytes);
-                if (typeof params.input.data === "string") {
-                    await handle.writeFile(params.input.data, params.input.encoding ?? "utf8");
-                }
-                else {
-                    await handle.writeFile(params.input.data);
-                }
-            }
-            else {
-                await writeStreamToHandle(params.input.stream, handle, params.maxBytes);
-            }
-            await syncFileBestEffort(handle);
-            const stat = await handle.stat();
-            await syncDirectoryBestEffort(parentPath);
-            // Publication is complete. A failed outer check must not remove its target.
-            created = false;
-            await params.verifyPublished?.(handle.fd, verificationIdentity, parentGuard);
-            return { dev: stat.dev, ino: stat.ino };
-        }
-        finally {
-            await handle.close().catch(() => undefined);
-            if (created) {
-                await promises_namespaceObject.rm(targetPath, { force: true }).catch(() => undefined);
-            }
-        }
-    }
-    const tempPath = external_node_path_namespaceObject.join(parentPath, `.${params.basename}.${(0,external_node_crypto_namespaceObject.randomUUID)()}.fallback.tmp`);
-    const tempFlags = external_node_fs_namespaceObject.constants.O_WRONLY |
-        external_node_fs_namespaceObject.constants.O_CREAT |
-        external_node_fs_namespaceObject.constants.O_EXCL |
-        (process.platform !== "win32" && "O_NOFOLLOW" in external_node_fs_namespaceObject.constants
-            ? external_node_fs_namespaceObject.constants.O_NOFOLLOW
-            : 0);
-    let handle;
-    let tempStat;
-    let readHandle;
-    let renamed = false;
+function readSidecarLockRawSnapshotSync(lockPath, options = {}) {
+    let fd;
     try {
-        handle = await promises_namespaceObject.open(tempPath, tempFlags, params.mode);
-        let verificationIdentity = await handle.stat({ bigint: true });
-        await handle.chmod(params.mode);
-        if (params.input.kind === "buffer") {
-            assertWithinMaxBytes(byteLength(params.input.data, params.input.encoding), params.maxBytes);
-            if (typeof params.input.data === "string") {
-                await handle.writeFile(params.input.data, params.input.encoding ?? "utf8");
-            }
-            else {
-                await handle.writeFile(params.input.data);
+        const before = lstatSidecarLockSync(lockPath);
+        if (!before)
+            return null;
+        if (!before.isFile() || before.isSymbolicLink()) {
+            if (options.rejectNonFile) {
+                throw new FsSafeError("not-file", `sidecar lock is not a regular file: ${lockPath}`);
             }
+            return null;
         }
-        else {
-            await writeStreamToHandle(params.input.stream, handle, params.maxBytes);
+        try {
+            fd = fsSync.openSync(lockPath, resolveReadOpenFlags());
         }
-        tempStat = await handle.stat();
-        const tempPathStat = await promises_namespaceObject.lstat(tempPath);
-        if (tempPathStat.isSymbolicLink() || !file_identity_sameFileIdentity(tempPathStat, tempStat)) {
-            throw new errors_FsSafeError("path-mismatch", "fallback temp path changed during write");
+        catch (error) {
+            if (error.code === "ENOENT")
+                return null;
+            options.onOpenFailure?.(error);
+            throw error;
         }
-        const expectedTempStat = tempStat;
-        await syncFileBestEffort(handle);
-        let verifiedIdentity = expectedTempStat;
-        await withAsyncDirectoryGuards([parentGuard], async () => {
-            await promises_namespaceObject.rename(tempPath, targetPath);
-            renamed = true;
-            await getFsSafeTestHooks()?.afterPinnedWriteFallbackRename?.(targetPath);
-            await syncDirectoryBestEffort(parentPath);
-            const targetStat = await promises_namespaceObject.lstat(targetPath);
-            if (targetStat.isSymbolicLink()) {
-                throw new errors_FsSafeError("path-mismatch", "fallback target changed during write");
-            }
-            if (!file_identity_sameFileIdentity(targetStat, expectedTempStat)) {
-                // On filesystems like rclone FUSE, rename(2) can give the destination a
-                // different inode from the source temp fd even with zero concurrency. The
-                // caller must ensure mutual exclusion before passing "verify-content";
-                // fall back to a content hash for this rename-boundary check only.
-                if (params.onRenameIdentityMismatch !== "verify-content") {
-                    throw new errors_FsSafeError("path-mismatch", "fallback target changed during write");
-                }
-                if (params.input.kind !== "buffer") {
-                    throw new errors_FsSafeError("path-mismatch", "fallback target changed during write");
-                }
-                const expectedHash = sha256Hex(params.input.data, params.input.encoding);
-                readHandle = await promises_namespaceObject.open(targetPath, read_open_flags_resolveReadOpenFlags());
-                const readHandleStat = await readHandle.stat({ bigint: true });
-                const actualHash = sha256Hex(await readHandle.readFile());
-                if (actualHash !== expectedHash) {
-                    throw new errors_FsSafeError("path-mismatch", "fallback target changed during write");
-                }
-                // The content-verified destination, not the old temp inode, is now pinned.
-                verificationIdentity = readHandleStat;
-                // Preserve the helper's legacy numeric return facts, not the private proof.
-                verifiedIdentity = { dev: Number(readHandleStat.dev), ino: Number(readHandleStat.ino) };
+        const opened = fsSync.fstatSync(fd);
+        if (!opened.isFile()) {
+            if (options.rejectNonFile) {
+                throw new FsSafeError("not-file", `sidecar lock is not a regular file: ${lockPath}`);
             }
-        });
-        await params.verifyPublished?.((readHandle ?? handle).fd, verificationIdentity, parentGuard);
-        return { dev: verifiedIdentity.dev, ino: verifiedIdentity.ino };
+            return null;
+        }
+        const raw = readFileDescriptorBoundedSync(fd, MAX_LOCK_PAYLOAD_BYTES).toString("utf8");
+        const after = lstatSidecarLockSync(lockPath);
+        if (!after || !sameFileIdentity(before, opened) || !sameFileIdentity(opened, after))
+            return null;
+        return {
+            raw,
+            stat: after,
+            ownershipToken: readSidecarLockOwnershipToken(raw),
+        };
     }
     finally {
-        await readHandle?.close().catch(() => undefined);
-        await handle?.close().catch(() => undefined);
-        if (!renamed) {
-            await promises_namespaceObject.rm(tempPath, { force: true }).catch(() => undefined);
-        }
+        if (fd !== undefined)
+            fsSync.closeSync(fd);
+    }
+}
+function removeSidecarLockIfUnchangedSync(lockPath, observed) {
+    const current = readSidecarLockSnapshotSync(lockPath);
+    if (!current || !sidecarLockSnapshotMatches(current, observed))
+        return false;
+    fsSync.rmSync(lockPath);
+    return true;
+}
+function sidecarLockSnapshotMatches(current, observed) {
+    if (observed.ownershipToken !== undefined) {
+        return (current.stat?.isFile() === true &&
+            current.raw !== undefined &&
+            observed.raw !== undefined &&
+            readSidecarLockOwnershipToken(current.raw) === observed.ownershipToken &&
+            readSidecarLockOwnershipToken(observed.raw) === observed.ownershipToken &&
+            current.raw === observed.raw);
+    }
+    if (observed.stat && current.stat && !file_identity_sameFileIdentity(observed.stat, current.stat)) {
+        return false;
+    }
+    if (observed.raw !== undefined) {
+        return current.raw === observed.raw;
+    }
+    return observed.stat !== undefined && current.stat !== undefined;
+}
+async function removeSidecarLockIfUnchanged(lockPath, observed, options = {}) {
+    const current = await readSidecarLockSnapshot(lockPath, {
+        ...options,
+        allowDescriptorIdentityDrift: observed?.ownershipToken !== undefined,
+    });
+    if (!current || !observed || !sidecarLockSnapshotMatches(current, observed)) {
+        return false;
     }
+    if (options.lockRoot) {
+        await options.lockRoot.remove(relativeSidecarLockPath(options.lockRoot, lockPath));
+    }
+    else {
+        await promises_namespaceObject.rm(lockPath, { force: true });
+    }
+    return true;
 }
-
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/error-detail.js
-const UNSAFE_ERROR_DETAIL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f\u2028\u2029]/gu;
-function formatErrorDetail(value) {
-    return value.replace(UNSAFE_ERROR_DETAIL_CHARACTERS, (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}`);
+async function sidecarLockSnapshotStillPresent(lockPath, observed, options = {}) {
+    const current = await readSidecarLockSnapshot(lockPath, {
+        ...options,
+        allowDescriptorIdentityDrift: observed?.ownershipToken !== undefined,
+    });
+    return !!current && !!observed && sidecarLockSnapshotMatches(current, observed);
 }
-
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/root-path-symlink.js
-
-
-
-
-
-
-function normalizeSymlinkResolutionError(error) {
-    if (isSymlinkOpenError(error)) {
-        throw new errors_FsSafeError("symlink", "symlink path could not be resolved", {
-            cause: error instanceof Error ? error : undefined,
-        });
+async function sidecarReclaimGuardExists(pathname) {
+    try {
+        await promises_namespaceObject.lstat(pathname);
+        return true;
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return false;
+        }
+        throw err;
     }
-    if (!path_isNotFoundPathError(error))
-        throw error;
 }
-async function resolveSymlinkHopPath(symlinkPath) {
+async function tryAcquireSidecarReclaimGuard(reclaimGuards, reclaimGuardPath) {
     try {
-        return external_node_path_namespaceObject.resolve(await promises_namespaceObject.realpath(symlinkPath));
+        await promises_namespaceObject.mkdir(reclaimGuardPath);
+        reclaimGuards.add(reclaimGuardPath);
+        return true;
     }
-    catch (error) {
-        normalizeSymlinkResolutionError(error);
-        const linkTarget = await promises_namespaceObject.readlink(symlinkPath);
-        return resolvePathViaExistingAncestor(external_node_path_namespaceObject.resolve(external_node_path_namespaceObject.dirname(symlinkPath), linkTarget));
+    catch (err) {
+        if (err.code === "EEXIST") {
+            return false;
+        }
+        throw err;
     }
 }
-function root_path_symlink_resolveSymlinkHopPathSync(symlinkPath) {
+async function releaseSidecarReclaimGuard(reclaimGuards, reclaimGuardPath) {
+    await promises_namespaceObject.rmdir(reclaimGuardPath);
+    reclaimGuards.delete(reclaimGuardPath);
+}
+async function removeStaleSidecarLockIfAllowed(params) {
+    if (!params.shouldRemoveStaleLock || params.snapshot.raw === undefined) {
+        return "not-approved";
+    }
+    const ioOptions = { lockRoot: params.lockRoot, parsePayload: params.parsePayload };
+    if (!(await sidecarLockSnapshotStillPresent(params.lockPath, params.snapshot, ioOptions))) {
+        return "changed";
+    }
+    if (!(await params.shouldRemoveStaleLock({
+        lockPath: params.lockPath,
+        normalizedTargetPath: params.normalizedTargetPath,
+        raw: params.snapshot.raw,
+        payload: params.snapshot.payload,
+    }))) {
+        return "not-approved";
+    }
+    if (!(await sidecarLockSnapshotStillPresent(params.lockPath, params.snapshot, ioOptions))) {
+        return "changed";
+    }
     try {
-        return path.resolve(fs.realpathSync(symlinkPath));
+        if (params.lockRoot) {
+            await params.lockRoot.remove(relativeSidecarLockPath(params.lockRoot, params.lockPath));
+        }
+        else {
+            await promises_namespaceObject.rm(params.lockPath);
+        }
+        return "removed";
     }
-    catch (error) {
-        normalizeSymlinkResolutionError(error);
-        const linkTarget = fs.readlinkSync(symlinkPath);
-        return resolvePathViaExistingAncestorSync(path.resolve(path.dirname(symlinkPath), linkTarget));
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return "changed";
+        }
+        throw err;
     }
 }
 
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/safe-path-segment.js
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/sidecar-lock-policy.js
 
-const SAFE_PATH_SEGMENT_PATTERN = /^[A-Za-z0-9_-][A-Za-z0-9._-]*$/;
-const SAFE_DOT_PREFIX_PATH_SEGMENT_PATTERN = /^[A-Za-z0-9._-]+$/;
-// Windows treats "C:name" as relative to the drive's current directory even
-// though path.win32.isAbsolute() reports false.
-const DRIVE_RELATIVE_PREFIX = /^[A-Za-z]:(?![\\/])/;
-const HYPHEN_CHAR_CODE = 0x2d;
-function safe_path_segment_isDriveRelativePath(value) {
-    return DRIVE_RELATIVE_PREFIX.test(value);
-}
-function assertNoDriveRelativePathSegments(value, label) {
-    if (value.split("/").some(safe_path_segment_isDriveRelativePath)) {
-        throw new errors_FsSafeError("invalid-path", `${label} must not contain a drive letter`);
+function assertFiniteNonNegative(value, label) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new RangeError(`${label} must be a finite non-negative number`);
     }
-    return value;
 }
-function trimHyphenEdges(value) {
-    let start = 0;
-    let end = value.length;
-    while (start < end && value.charCodeAt(start) === HYPHEN_CHAR_CODE) {
-        start += 1;
+function validateSidecarLockRetryOptions(retry) {
+    if (retry.retries !== undefined && (!Number.isSafeInteger(retry.retries) || retry.retries < 0)) {
+        throw new RangeError("lock retry.retries must be a non-negative safe integer");
     }
-    while (end > start && value.charCodeAt(end - 1) === HYPHEN_CHAR_CODE) {
-        end -= 1;
+    if (retry.factor !== undefined)
+        assertFiniteNonNegative(retry.factor, "lock retry.factor");
+    if (retry.minTimeout !== undefined) {
+        assertFiniteNonNegative(retry.minTimeout, "lock retry.minTimeout");
+    }
+    if (retry.maxTimeout !== undefined) {
+        assertFiniteNonNegative(retry.maxTimeout, "lock retry.maxTimeout");
+    }
+    if (retry.minTimeout !== undefined &&
+        retry.maxTimeout !== undefined &&
+        retry.minTimeout > retry.maxTimeout) {
+        throw new RangeError("lock retry.minTimeout must not exceed retry.maxTimeout");
     }
-    return start === 0 && end === value.length ? value : value.slice(start, end);
 }
-function isSafePathSegment(segment, options = {}) {
-    return (segment !== "" &&
-        segment !== "." &&
-        segment !== ".." &&
-        !segment.includes("/") &&
-        !segment.includes("\\") &&
-        !segment.includes("\0") &&
-        (options.allowDotPrefix === true || !segment.startsWith(".")) &&
-        (options.allowDotPrefix === true
-            ? SAFE_DOT_PREFIX_PATH_SEGMENT_PATTERN.test(segment)
-            : SAFE_PATH_SEGMENT_PATTERN.test(segment)));
+function validateSidecarLockTimeoutMs(timeoutMs) {
+    if (timeoutMs === undefined || timeoutMs === Number.POSITIVE_INFINITY)
+        return;
+    assertFiniteNonNegative(timeoutMs, "lock timeoutMs");
 }
-function assertSafePathSegment(segment, options = {}) {
-    // Validate the exact value callers will later join into paths; trimming here
-    // would let whitespace-padded ids pass and then be used verbatim.
-    if (!isSafePathSegment(segment, options)) {
-        throw new FsSafeError("invalid-path", `${options.label ?? "path segment"} must be a safe path segment`);
-    }
-    return segment;
+function computeSidecarLockDelayMs(retry, attempt) {
+    validateSidecarLockRetryOptions(retry);
+    const minTimeout = retry.minTimeout ?? 50;
+    const maxTimeout = retry.maxTimeout ?? 1000;
+    const factor = retry.factor ?? 1;
+    const base = Math.min(maxTimeout, Math.max(minTimeout, minTimeout * factor ** attempt));
+    const jitter = retry.randomize ? 1 + Math.random() : 1;
+    return Math.min(maxTimeout, Math.round(base * jitter));
 }
-function sanitizeSafePathSegment(value, fallback, options = {}) {
-    const sanitized = value
-        .trim()
-        .replace(/[\\/]+/g, "-")
-        .replace(/\0/g, "")
-        .replace(/[^A-Za-z0-9._-]+/g, "-");
-    const trimmed = trimHyphenEdges(sanitized);
-    if (isSafePathSegment(trimmed, options)) {
-        return trimmed;
-    }
-    return assertSafePathSegment(fallback, { ...options, label: "fallback path segment" });
+// Windows denies access to a lock file while a just-unlinked directory entry
+// is still being torn down, so a contended acquire sees EPERM on a name that is
+// already gone -- both when creating it exclusively and when reading the
+// holder's snapshot. The next attempt succeeds, so this is contention rather
+// than a permission failure. The error must name the lock file itself: the
+// exclusive-create helper opens the parent directory first, and a denial from
+// that setup step carries no teardown evidence and has to reach the caller.
+const maxTransientLockDenials = 8;
+function isTransientLockFileDenial(error, lockPath) {
+    const denial = error;
+    return process.platform === "win32" && denial?.code === "EPERM" && denial.path === lockPath;
 }
-function assertSafePathPrefix(prefix, options = {}) {
-    // Prefixes are often derived from safe filenames. Normalize harmless
-    // filename characters first, but still reject real path-control bytes.
-    if (prefix.includes("/") || prefix.includes("\\") || prefix.includes("\0")) {
-        return assertSafePathSegment(prefix, {
-            allowDotPrefix: true,
-            ...options,
-            label: options.label ?? "path prefix",
-        });
+function sidecarLockPayloadIsStale(payload, staleMs, nowMs) {
+    const createdAtMs = sidecarLockPayloadCreatedAtMs(payload);
+    return createdAtMs !== null && nowMs - createdAtMs > staleMs;
+}
+function sidecarLockPayloadCreatedAtMs(payload) {
+    const createdAt = payload &&
+        typeof payload === "object" &&
+        "createdAt" in payload &&
+        typeof payload.createdAt === "string"
+        ? payload.createdAt
+        : "";
+    const createdAtMs = Date.parse(createdAt);
+    return Number.isFinite(createdAtMs) ? createdAtMs : null;
+}
+async function defaultSidecarLockShouldReclaim(params) {
+    const createdAtMs = sidecarLockPayloadCreatedAtMs(params.payload);
+    if (createdAtMs !== null)
+        return params.nowMs - createdAtMs > params.staleMs;
+    try {
+        return params.nowMs - (await promises_namespaceObject.stat(params.lockPath)).mtimeMs > params.staleMs;
+    }
+    catch {
+        return true;
     }
-    return assertSafePathSegment(prefix.replace(/[^A-Za-z0-9._-]+/g, "-"), {
-        allowDotPrefix: true,
-        ...options,
-        label: options.label ?? "path prefix",
-    });
 }
 
-;// CONCATENATED MODULE: external "node:os"
-const external_node_os_namespaceObject = __rspack_createRequire_require("node:os");
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/short-path.js
-
-
-function shortPath(value) {
-    const home = external_node_os_namespaceObject.homedir();
-    const shortened = value.startsWith(home) ? `~${value.slice(home.length)}` : value;
-    return formatErrorDetail(shortened);
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/suppressed-error.js
+function createSuppressedError(error, suppressed, message) {
+    const constructor = globalThis.SuppressedError;
+    if (constructor) {
+        return new constructor(error, suppressed, message);
+    }
+    const combined = new Error(message, {
+        cause: error instanceof Error ? error : undefined,
+    });
+    combined.name = "SuppressedError";
+    Object.defineProperties(combined, {
+        error: { configurable: true, value: error },
+        suppressed: { configurable: true, value: suppressed },
+    });
+    return combined;
 }
 
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/root-path.js
-
-
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/sidecar-lock-acquire.js
 
 
 
@@ -3678,517 +3634,823 @@ function shortPath(value) {
 
 
 
-const ROOT_PATH_ALIAS_POLICIES = {
-    strict: Object.freeze({
-        allowFinalSymlinkForUnlink: false,
-        allowFinalHardlinkForUnlink: false,
-    }),
-    unlinkTarget: Object.freeze({
-        allowFinalSymlinkForUnlink: true,
-        allowFinalHardlinkForUnlink: true,
-    }),
-};
-async function resolveRootPath(params) {
+async function resolveNormalizedTargetPath(targetPath) {
+    const resolved = external_node_path_namespaceObject.resolve(targetPath);
+    const dir = external_node_path_namespaceObject.dirname(resolved);
+    await promises_namespaceObject.mkdir(dir, { recursive: true });
     try {
-        return await resolveRootPathInternal(params);
+        return external_node_path_namespaceObject.join(await promises_namespaceObject.realpath(dir), external_node_path_namespaceObject.basename(resolved));
     }
-    catch (error) {
-        throw sanitizeRootPathError(error);
+    catch {
+        return resolved;
     }
 }
-async function resolveRootPathInternal(params) {
-    assertValidRootPathInputs(params);
-    const rootPath = external_node_path_namespaceObject.resolve(params.rootPath);
-    const absolutePath = external_node_path_namespaceObject.resolve(params.absolutePath);
-    const rootCanonicalPath = params.rootCanonicalPath
-        ? external_node_path_namespaceObject.resolve(params.rootCanonicalPath)
-        : await resolvePathViaExistingAncestor(rootPath);
-    const context = createBoundaryResolutionContext({
-        resolveParams: params,
-        rootPath,
-        absolutePath,
-        rootCanonicalPath,
-        outsideLexicalCanonicalPath: await resolveOutsideLexicalCanonicalPathAsync({
-            rootPath,
-            absolutePath,
-        }),
-    });
-    const outsideResult = await resolveOutsideRootPathAsync({
-        boundaryLabel: params.boundaryLabel,
-        context,
-    });
-    if (outsideResult) {
-        return outsideResult;
+async function acquireSidecarLock(options, context) {
+    const retry = options.retry ?? {};
+    validateSidecarLockRetryOptions(retry);
+    validateSidecarLockTimeoutMs(options.timeoutMs);
+    context.ensureExitCleanupRegistered();
+    const normalizedTargetPath = await resolveNormalizedTargetPath(options.targetPath);
+    const lockPath = options.lockPath ?? `${normalizedTargetPath}.lock`;
+    let held = context.held.get(normalizedTargetPath);
+    if (held &&
+        options.reentrantOwner !== undefined &&
+        held.reentrantOwner !== undefined &&
+        options.reentrantOwner === held.reentrantOwner) {
+        // A final release may already have decremented the count to zero and be
+        // removing the sidecar. Do not admit a new reentrant handle until that
+        // cleanup settles: successful cleanup requires a fresh acquisition, while
+        // failed cleanup leaves the existing sidecar held for a retry.
+        if (held.releasePromise) {
+            await held.releasePromise.catch(() => undefined);
+            held = context.held.get(normalizedTargetPath);
+        }
+        if (held &&
+            options.reentrantOwner !== undefined &&
+            held.reentrantOwner !== undefined &&
+            options.reentrantOwner === held.reentrantOwner) {
+            held.refCount += 1;
+            return context.handleForHeldLock(normalizedTargetPath, held);
+        }
     }
-    return resolveRootPathLexicalAsync({
-        params,
-        absolutePath: context.absolutePath,
-        rootPath: context.rootPath,
-        rootCanonicalPath: context.rootCanonicalPath,
-    });
-}
-function resolveRootPathSync(params) {
+    const startedAt = Date.now();
+    const maxRetries = options.timeoutMs === Number.POSITIVE_INFINITY ? undefined : retry.retries;
+    const reclaimGuardPath = `${lockPath}.reclaim`;
+    let ownsReclaimGuard = false;
+    let attempt = 0;
+    // Bounded so a genuine denial still surfaces as EPERM, not a lock timeout.
+    let transientDenials = 0;
+    const withinDenialBudget = () => ++transientDenials <= (/* inlined export .maxTransientLockDenials */8);
+    const waitForRetry = async () => {
+        const elapsed = Date.now() - startedAt;
+        if ((options.timeoutMs !== undefined &&
+            options.timeoutMs !== Number.POSITIVE_INFINITY &&
+            elapsed >= options.timeoutMs) ||
+            (maxRetries !== undefined && attempt >= maxRetries)) {
+            throw Object.assign(new Error(`file lock timeout for ${normalizedTargetPath}`), {
+                code: "file_lock_timeout",
+                lockPath,
+                normalizedTargetPath,
+            });
+        }
+        const remaining = options.timeoutMs === undefined || options.timeoutMs === Number.POSITIVE_INFINITY
+            ? Number.POSITIVE_INFINITY
+            : Math.max(0, options.timeoutMs - elapsed);
+        const delay = Math.min(computeSidecarLockDelayMs(retry, attempt), remaining);
+        attempt += 1;
+        await new Promise((resolve) => setTimeout(resolve, delay));
+    };
+    // Waiting can fail on the caller's own retry or deadline limits. Classifying
+    // a denial as contention must not cost them the original diagnosis, so hand
+    // the denial back when no further attempt can be scheduled.
+    const retryOrRethrowDenial = async (denial) => {
+        try {
+            await waitForRetry();
+        }
+        catch (waitError) {
+            if (waitError.code === "file_lock_timeout")
+                throw denial;
+            throw waitError;
+        }
+    };
     try {
-        return resolveRootPathSyncInternal(params);
-    }
-    catch (error) {
-        throw sanitizeRootPathError(error);
-    }
-}
-function resolveRootPathSyncInternal(params) {
-    assertValidRootPathInputs(params);
-    const rootPath = path.resolve(params.rootPath);
-    const absolutePath = path.resolve(params.absolutePath);
-    const rootCanonicalPath = params.rootCanonicalPath
-        ? path.resolve(params.rootCanonicalPath)
-        : resolvePathViaExistingAncestorSync(rootPath);
-    const context = createBoundaryResolutionContext({
-        resolveParams: params,
-        rootPath,
-        absolutePath,
-        rootCanonicalPath,
-        outsideLexicalCanonicalPath: resolveOutsideLexicalCanonicalPathSync({
-            rootPath,
-            absolutePath,
-        }),
-    });
-    const outsideResult = resolveOutsideRootPathSync({
-        boundaryLabel: params.boundaryLabel,
-        context,
-    });
-    if (outsideResult) {
-        return outsideResult;
-    }
-    return resolveRootPathLexicalSync({
-        params,
-        absolutePath: context.absolutePath,
-        rootPath: context.rootPath,
-        rootCanonicalPath: context.rootCanonicalPath,
-    });
-}
-function sanitizeRootPathError(error) {
-    if (error instanceof Error) {
-        error.message = formatErrorDetail(error.message);
-    }
-    return error;
-}
-function assertValidRootPathInputs(params) {
-    path_assertNoNulPathInput(params.rootPath, "root path contains a NUL byte");
-    path_assertNoNulPathInput(params.absolutePath, "absolute path contains a NUL byte");
-    assertNoEmbeddedDriveRelativeSegment(params.rootPath, "root path");
-    assertNoEmbeddedDriveRelativeSegment(params.absolutePath, "absolute path");
-    if (params.rootCanonicalPath !== undefined) {
-        path_assertNoNulPathInput(params.rootCanonicalPath, "canonical root path contains a NUL byte");
-        assertNoEmbeddedDriveRelativeSegment(params.rootCanonicalPath, "canonical root path");
+        while (true) {
+            if (!ownsReclaimGuard && (await sidecarReclaimGuardExists(reclaimGuardPath))) {
+                await waitForRetry();
+                continue;
+            }
+            let handle = null;
+            let createdSnapshot = null;
+            let lockFileCreateDenied = false;
+            const payload = await options.payload();
+            const { raw, ownershipToken } = serializeSidecarLockPayload(payload);
+            try {
+                if (options.lockRoot) {
+                    const lockRoot = options.lockRoot;
+                    const relativeLockPath = relativeSidecarLockPath(lockRoot, lockPath);
+                    try {
+                        await lockRoot.create(relativeLockPath, raw, { mkdir: true, mode: 0o600 });
+                    }
+                    catch (error) {
+                        if (error instanceof errors_FsSafeError && error.code === "already-exists") {
+                            throw Object.assign(new Error("sidecar lock exists"), { code: "EEXIST" });
+                        }
+                        throw error;
+                    }
+                    createdSnapshot = { raw, payload, ownershipToken };
+                    const opened = await openSidecarRoot(lockRoot, relativeLockPath, "unlinked");
+                    if (!opened) {
+                        await waitForRetry();
+                        continue;
+                    }
+                    try {
+                        // Root.open admits the current file, not necessarily the one we created.
+                        const currentRaw = await readFileHandleBounded(opened.handle, Buffer.byteLength(raw));
+                        if (!currentRaw.equals(Buffer.from(raw))) {
+                            throw new errors_FsSafeError("path-mismatch", "created sidecar lock changed before admission");
+                        }
+                    }
+                    catch (error) {
+                        await opened.handle.close().catch(() => undefined);
+                        throw error;
+                    }
+                    handle = opened.handle;
+                }
+                else {
+                    try {
+                        handle =
+                            (await createNativeExclusiveFile(lockPath, 0o600)) ??
+                                (await promises_namespaceObject.open(lockPath, "wx"));
+                    }
+                    catch (createError) {
+                        lockFileCreateDenied = isTransientLockFileDenial(createError, lockPath);
+                        throw createError;
+                    }
+                    await handle.writeFile(raw, "utf8");
+                }
+                const snapshot = { raw, payload, stat: await handle.stat(), ownershipToken };
+                if (snapshot.stat.nlink === 0) {
+                    await handle.close();
+                    handle = null;
+                    await waitForRetry();
+                    continue;
+                }
+                const createdHeld = {
+                    refCount: 1,
+                    reentrantOwner: options.reentrantOwner,
+                    handle,
+                    lockPath,
+                    snapshot,
+                    acquiredAt: Date.now(),
+                    metadata: options.metadata ?? {},
+                    lockRoot: options.lockRoot,
+                    parsePayload: options.parsePayload,
+                };
+                context.held.set(normalizedTargetPath, createdHeld);
+                if (ownsReclaimGuard) {
+                    try {
+                        await releaseSidecarReclaimGuard(context.reclaimGuards, reclaimGuardPath);
+                        ownsReclaimGuard = false;
+                    }
+                    catch (err) {
+                        await context.releaseHeldLock(normalizedTargetPath, createdHeld, { force: true });
+                        throw err;
+                    }
+                }
+                const returnedHandle = context.handleForHeldLock(normalizedTargetPath, createdHeld);
+                const interval = options.compromiseCheckIntervalMs;
+                if (options.onCompromised && interval !== undefined && interval > 0) {
+                    createdHeld.compromiseTimer = setInterval(() => {
+                        void returnedHandle
+                            .verifyStillHeld()
+                            .catch(() => false)
+                            .then((stillHeld) => {
+                            if (!stillHeld && createdHeld.compromiseTimer) {
+                                clearInterval(createdHeld.compromiseTimer);
+                                createdHeld.compromiseTimer = undefined;
+                                options.onCompromised?.({ lockPath, normalizedTargetPath });
+                            }
+                        });
+                    }, interval);
+                    createdHeld.compromiseTimer.unref();
+                }
+                return returnedHandle;
+            }
+            catch (err) {
+                try {
+                    if (handle) {
+                        const failedSnapshot = createdSnapshot ?? { payload: null };
+                        try {
+                            failedSnapshot.stat = await handle.stat();
+                        }
+                        catch {
+                            // Best-effort cleanup of a failed exclusive create.
+                        }
+                        const current = context.held.get(normalizedTargetPath);
+                        if (current?.handle === handle) {
+                            context.held.delete(normalizedTargetPath);
+                        }
+                        await handle.close().catch(() => undefined);
+                        // Root-created records retain the creator's byte/token receipt;
+                        // partial direct writes use the exclusive descriptor's identity.
+                        await removeSidecarLockIfUnchanged(lockPath, failedSnapshot, {
+                            lockRoot: options.lockRoot,
+                            parsePayload: options.parsePayload,
+                        });
+                    }
+                    else if (createdSnapshot) {
+                        await removeSidecarLockIfUnchanged(lockPath, createdSnapshot, {
+                            lockRoot: options.lockRoot,
+                            parsePayload: options.parsePayload,
+                        });
+                    }
+                }
+                catch (cleanupError) {
+                    throw createSuppressedError(cleanupError, err, "file lock acquisition and cleanup both failed");
+                }
+                if (lockFileCreateDenied && withinDenialBudget()) {
+                    await retryOrRethrowDenial(err);
+                    continue;
+                }
+                if (err.code !== "EEXIST") {
+                    throw err;
+                }
+                if (ownsReclaimGuard) {
+                    await releaseSidecarReclaimGuard(context.reclaimGuards, reclaimGuardPath);
+                    ownsReclaimGuard = false;
+                    await waitForRetry();
+                    continue;
+                }
+                const nowMs = Date.now();
+                let rawSnapshot;
+                let lockFileOpenDenied = false;
+                try {
+                    rawSnapshot = await readSidecarLockRawSnapshot(lockPath, {
+                        lockRoot: options.lockRoot,
+                        rejectNonFile: true,
+                        discardObservation: "changed",
+                        onOpenFailure: (error) => { lockFileOpenDenied = isTransientLockFileDenial(error, lockPath); },
+                    });
+                }
+                catch (readErr) {
+                    if (!lockFileOpenDenied || !withinDenialBudget())
+                        throw readErr;
+                    await retryOrRethrowDenial(readErr);
+                    continue;
+                }
+                const snapshot = parseSidecarLockSnapshot(rawSnapshot, options.parsePayload);
+                if (!snapshot) {
+                    await waitForRetry();
+                    continue;
+                }
+                if (context.held.has(normalizedTargetPath)) {
+                    await waitForRetry();
+                    continue;
+                }
+                const shouldReclaim = options.shouldReclaim ?? defaultSidecarLockShouldReclaim;
+                if (await shouldReclaim({
+                    lockPath,
+                    normalizedTargetPath,
+                    payload: snapshot?.payload ?? null,
+                    staleMs: options.staleMs,
+                    nowMs,
+                    heldByThisProcess: context.held.has(normalizedTargetPath),
+                })) {
+                    if (!(await sidecarLockSnapshotStillPresent(lockPath, snapshot, {
+                        lockRoot: options.lockRoot,
+                        parsePayload: options.parsePayload,
+                    }))) {
+                        await waitForRetry();
+                        continue;
+                    }
+                    const staleRecovery = options.staleRecovery ?? "fail-closed";
+                    if (staleRecovery === "remove-if-unchanged") {
+                        if (!(await tryAcquireSidecarReclaimGuard(context.reclaimGuards, reclaimGuardPath))) {
+                            await waitForRetry();
+                            continue;
+                        }
+                        ownsReclaimGuard = true;
+                        const removal = await removeStaleSidecarLockIfAllowed({
+                            lockPath,
+                            normalizedTargetPath,
+                            snapshot,
+                            shouldRemoveStaleLock: options.shouldRemoveStaleLock,
+                            lockRoot: options.lockRoot,
+                            parsePayload: options.parsePayload,
+                        });
+                        if (removal === "removed" || removal === "changed") {
+                            if (removal === "changed")
+                                await waitForRetry();
+                            continue;
+                        }
+                        await releaseSidecarReclaimGuard(context.reclaimGuards, reclaimGuardPath);
+                        ownsReclaimGuard = false;
+                    }
+                    throw Object.assign(new Error(`file lock stale for ${normalizedTargetPath}`), {
+                        code: "file_lock_stale",
+                        lockPath,
+                        normalizedTargetPath,
+                    });
+                }
+                await waitForRetry();
+            }
+        }
     }
-}
-function assertNoEmbeddedDriveRelativeSegment(filePath, label) {
-    if (process.platform !== "win32") {
-        return;
+    finally {
+        if (ownsReclaimGuard) {
+            await releaseSidecarReclaimGuard(context.reclaimGuards, reclaimGuardPath).catch(() => undefined);
+        }
     }
-    const root = external_node_path_namespaceObject.parse(filePath).root;
-    assertNoDriveRelativePathSegments(filePath.slice(root.length).replaceAll("\\", "/"), label);
-}
-function isPromiseLike(value) {
-    return Boolean(value &&
-        (typeof value === "object" || typeof value === "function") &&
-        "then" in value &&
-        typeof value.then === "function");
 }
-function createLexicalTraversalState(params) {
-    const rawAbsolutePath = params.params.absolutePath;
-    const rawRelativePath = rawPathRelativeToRoot(params.rootPath, rawAbsolutePath);
-    const relative = rawRelativePath ?? external_node_path_namespaceObject.relative(params.rootPath, params.absolutePath);
-    return {
-        segments: splitTraversalSegments(relative),
-        allowFinalSymlink: params.params.policy?.allowFinalSymlinkForUnlink === true,
-        canonicalCursor: params.rootCanonicalPath,
-        lexicalCursor: params.rootPath,
-        preserveFinalSymlink: false,
+
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/sidecar-lock-handle.js
+
+function createSidecarLockHandle(params) {
+    let released = false;
+    let releasePromise;
+    let releaseStarted = false;
+    const release = async () => {
+        if (released)
+            return;
+        if (!releasePromise) {
+            const retry = releaseStarted;
+            releaseStarted = true;
+            releasePromise = (async () => {
+                await params.release({ retry });
+                released = true;
+            })();
+        }
+        try {
+            await releasePromise;
+        }
+        finally {
+            releasePromise = undefined;
+        }
     };
-}
-function createLexicalTraversalContext(params) {
     return {
-        state: createLexicalTraversalState(params),
-        resolveParams: params.params,
-        rootPath: params.rootPath,
-        rootCanonicalPath: params.rootCanonicalPath,
-        absolutePath: params.absolutePath,
+        lockPath: params.lockPath,
+        normalizedTargetPath: params.normalizedTargetPath,
+        verifyStillHeld: params.verifyStillHeld,
+        release,
+        [Symbol.asyncDispose]: release,
     };
 }
-function splitTraversalSegments(value) {
-    return value
-        .split(process.platform === "win32" ? /[\\/]+/ : /\/+/)
-        .filter((segment) => Boolean(segment) && segment !== ".");
-}
-function rawPathRelativeToRoot(rootPath, candidatePath) {
-    if (!external_node_path_namespaceObject.isAbsolute(candidatePath)) {
-        return undefined;
-    }
-    const root = external_node_path_namespaceObject.resolve(rootPath);
-    const candidate = process.platform === "win32"
-        ? candidatePath.replaceAll("/", external_node_path_namespaceObject.sep)
-        : candidatePath;
-    if (candidate === root) {
-        return "";
-    }
-    const rootWithSep = root.endsWith(external_node_path_namespaceObject.sep) ? root : `${root}${external_node_path_namespaceObject.sep}`;
-    const candidatePrefix = candidate.slice(0, rootWithSep.length);
-    const prefixMatches = process.platform === "win32"
-        ? candidatePrefix.toLowerCase() === rootWithSep.toLowerCase()
-        : candidatePrefix === rootWithSep;
-    return prefixMatches ? candidate.slice(rootWithSep.length) : undefined;
-}
-function assertLexicalCursorInsideBoundary(context, candidatePath) {
-    assertInsideBoundary({
-        boundaryLabel: context.resolveParams.boundaryLabel,
-        rootCanonicalPath: context.rootCanonicalPath,
-        candidatePath,
-        absolutePath: context.absolutePath,
-    });
-}
-function applyMissingSuffixToCanonicalCursor(context, missingFromIndex) {
-    const missingSuffix = context.state.segments.slice(missingFromIndex);
-    for (const segment of missingSuffix) {
-        advanceCanonicalCursorForSegment(context, segment);
-    }
-}
-function advanceCanonicalCursorForSegment(context, segment) {
-    context.state.canonicalCursor = external_node_path_namespaceObject.resolve(context.state.canonicalCursor, segment);
-    assertLexicalCursorInsideBoundary(context, context.state.canonicalCursor);
-}
-function finalizeLexicalResolution(context, kind) {
-    assertLexicalCursorInsideBoundary(context, context.state.canonicalCursor);
-    return buildResolvedRootPath({
-        absolutePath: context.absolutePath,
-        canonicalPath: context.state.canonicalCursor,
-        rootPath: context.rootPath,
-        rootCanonicalPath: context.rootCanonicalPath,
-        kind,
+function createHeldSidecarLockHandle(params) {
+    return createSidecarLockHandle({
+        lockPath: params.held.lockPath,
+        normalizedTargetPath: params.normalizedTargetPath,
+        verifyStillHeld: async () => await sidecarLockSnapshotStillPresent(params.held.lockPath, params.held.snapshot, {
+            lockRoot: params.held.lockRoot,
+            parsePayload: params.held.parsePayload,
+        }),
+        release: (options) => params.release(options),
     });
 }
-function handleLexicalLstatFailure(context, error, missingFromIndex) {
-    if (!path_isNotFoundPathError(error)) {
-        return false;
-    }
-    applyMissingSuffixToCanonicalCursor(context, missingFromIndex);
-    return true;
-}
-function handleLexicalStatReadFailure(context, error, missingFromIndex) {
-    if (handleLexicalLstatFailure(context, error, missingFromIndex)) {
-        return null;
-    }
-    throw error;
-}
-function handleLexicalStatDisposition(context, params) {
-    if (!params.isSymbolicLink) {
-        advanceCanonicalCursorForSegment(context, params.segment);
-        return "continue";
-    }
-    if (context.resolveParams.rejectSymlinks === true && params.isLast) {
-        throw new errors_FsSafeError("symlink", "symlink path component not allowed");
-    }
-    if (context.state.allowFinalSymlink && params.isLast) {
-        context.state.preserveFinalSymlink = true;
-        advanceCanonicalCursorForSegment(context, params.segment);
-        return "break";
+
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/sidecar-lock.js
+
+
+
+
+
+
+const GLOBAL_STATE_KEY = Symbol.for("fsSafe.sidecarLockManagers");
+const GLOBAL_CLEANUP_KEY = Symbol.for("fsSafe.sidecarLockCleanupRegistered");
+const GLOBAL_CLEANUP_HANDLER_KEY = Symbol.for("fsSafe.sidecarLockCleanupHandler");
+function getGlobalManagers() {
+    const globalWithState = globalThis;
+    if (!globalWithState[GLOBAL_STATE_KEY]) {
+        globalWithState[GLOBAL_STATE_KEY] = new Map();
     }
-    return "resolve-link";
+    return globalWithState[GLOBAL_STATE_KEY];
 }
-function applyResolvedSymlinkHop(context, linkCanonical) {
-    if (!path_isPathInside(context.rootCanonicalPath, linkCanonical)) {
-        throw symlinkEscapeError({
-            boundaryLabel: context.resolveParams.boundaryLabel,
-            rootCanonicalPath: context.rootCanonicalPath,
-            symlinkPath: context.state.lexicalCursor,
-        });
+function resolveManagerState(key) {
+    const managers = getGlobalManagers();
+    let state = managers.get(key);
+    if (!state) {
+        state = {
+            cleanupRegistered: false,
+            held: new Map(),
+            reclaimCleanupRegistered: false,
+            reclaimGuards: new Set(),
+        };
+        managers.set(key, state);
     }
-    context.state.canonicalCursor = linkCanonical;
-    context.state.lexicalCursor = linkCanonical;
+    else {
+        // The global manager symbol is shared across package copies and hot reloads.
+        // Backfill state created by fs-safe versions that predate reclaim guards.
+        state.reclaimCleanupRegistered ??= false;
+        state.reclaimGuards ??= new Set();
+        for (const held of state.held.values()) {
+            held.refCount ??= 1;
+        }
+    }
+    return state;
 }
-function readLexicalStat(context, params) {
+function snapshotMatchesSync(lockPath, observed) {
+    let fd;
     try {
-        const stat = params.read(context.state.lexicalCursor);
-        if (isPromiseLike(stat)) {
-            return Promise.resolve(stat).catch((error) => handleLexicalStatReadFailure(context, error, params.missingFromIndex));
+        const beforeStat = external_node_fs_namespaceObject.lstatSync(lockPath);
+        if (!beforeStat.isFile()) {
+            return false;
         }
-        return stat;
-    }
-    catch (error) {
-        return handleLexicalStatReadFailure(context, error, params.missingFromIndex);
+        const openFlags = external_node_fs_namespaceObject.constants.O_RDONLY |
+            (process.platform !== "win32" && typeof external_node_fs_namespaceObject.constants.O_NOFOLLOW === "number"
+                ? external_node_fs_namespaceObject.constants.O_NOFOLLOW
+                : 0) |
+            (typeof external_node_fs_namespaceObject.constants.O_NONBLOCK === "number" ? external_node_fs_namespaceObject.constants.O_NONBLOCK : 0);
+        fd = external_node_fs_namespaceObject.openSync(lockPath, openFlags);
+        const openedStat = external_node_fs_namespaceObject.fstatSync(fd);
+        if (!openedStat.isFile()) {
+            return false;
+        }
+        if (observed.raw !== undefined && openedStat.size !== Buffer.byteLength(observed.raw)) {
+            return false;
+        }
+        const raw = external_node_fs_namespaceObject.readFileSync(fd, "utf8");
+        const afterStat = external_node_fs_namespaceObject.lstatSync(lockPath);
+        if (!afterStat.isFile() || !file_identity_sameFileIdentity(beforeStat, afterStat)) {
+            return false;
+        }
+        return sidecarLockSnapshotMatches({ raw, payload: null, stat: afterStat }, observed);
     }
-}
-function resolveAndApplySymlinkHop(context, params) {
-    const linkCanonical = params.resolveLinkCanonical(context.state.lexicalCursor);
-    if (isPromiseLike(linkCanonical)) {
-        return Promise.resolve(linkCanonical).then((value) => {
-            applyResolvedSymlinkHop(context, value);
-        });
+    catch {
+        return false;
     }
-    applyResolvedSymlinkHop(context, linkCanonical);
-}
-function applyParentTraversalStep(context) {
-    context.state.lexicalCursor = external_node_path_namespaceObject.resolve(context.state.lexicalCursor, "..");
-    advanceCanonicalCursorForSegment(context, "..");
-}
-function* iterateLexicalTraversal(state) {
-    for (let idx = 0; idx < state.segments.length; idx += 1) {
-        const segment = state.segments[idx] ?? "";
-        const isLast = idx === state.segments.length - 1;
-        yield { idx, segment, isLast };
+    finally {
+        if (fd !== undefined) {
+            try {
+                external_node_fs_namespaceObject.closeSync(fd);
+            }
+            catch {
+                // Best-effort process-exit cleanup.
+            }
+        }
     }
 }
-async function resolveRootPathLexicalAsync(params) {
-    const context = createLexicalTraversalContext(params);
-    const { state } = context;
-    for (const { idx, segment, isLast } of iterateLexicalTraversal(state)) {
-        if (segment === "..") {
-            applyParentTraversalStep(context);
-            continue;
-        }
-        state.lexicalCursor = external_node_path_namespaceObject.join(state.lexicalCursor, segment);
-        const stat = await readLexicalStat(context, {
-            missingFromIndex: idx,
-            read: (cursor) => promises_namespaceObject.lstat(cursor),
-        });
-        if (!stat) {
-            break;
+function releaseAllReclaimGuardsSync(state) {
+    for (const reclaimGuardPath of state.reclaimGuards) {
+        try {
+            external_node_fs_namespaceObject.rmdirSync(reclaimGuardPath);
+            state.reclaimGuards.delete(reclaimGuardPath);
         }
-        const disposition = handleLexicalStatDisposition(context, {
-            isSymbolicLink: stat.isSymbolicLink(),
-            segment,
-            isLast,
-        });
-        if (disposition === "continue") {
-            continue;
+        catch {
+            // Best-effort process-exit cleanup. A surviving guard fails closed.
         }
-        if (disposition === "break") {
-            break;
+    }
+}
+function releaseAllLocksSync(state) {
+    for (const [normalizedTargetPath, held] of state.held) {
+        void held.handle.close().catch(() => undefined);
+        try {
+            if (!held.lockRoot && snapshotMatchesSync(held.lockPath, held.snapshot)) {
+                external_node_fs_namespaceObject.rmSync(held.lockPath, { force: true });
+            }
         }
-        await resolveAndApplySymlinkHop(context, {
-            resolveLinkCanonical: (cursor) => resolveSymlinkHopPath(cursor),
-        });
-        if (context.resolveParams.rejectSymlinks === true) {
-            throw new errors_FsSafeError("symlink", "symlink path component not allowed");
+        catch {
+            // Best-effort process-exit cleanup.
         }
+        state.held.delete(normalizedTargetPath);
     }
-    const kind = await getPathKind(state.canonicalCursor, state.preserveFinalSymlink);
-    return finalizeLexicalResolution(context, kind);
+    releaseAllReclaimGuardsSync(state);
 }
-function resolveRootPathLexicalSync(params) {
-    const context = createLexicalTraversalContext(params);
-    const { state } = context;
-    for (let idx = 0; idx < state.segments.length; idx += 1) {
-        const segment = state.segments[idx] ?? "";
-        const isLast = idx === state.segments.length - 1;
-        if (segment === "..") {
-            applyParentTraversalStep(context);
-            continue;
+function ensureGlobalExitCleanupRegistered() {
+    const globalWithCleanup = globalThis;
+    if (globalWithCleanup[GLOBAL_CLEANUP_KEY])
+        return;
+    globalWithCleanup[GLOBAL_CLEANUP_KEY] = true;
+    const cleanup = () => {
+        for (const state of getGlobalManagers().values()) {
+            releaseAllLocksSync(state);
         }
-        state.lexicalCursor = path.join(state.lexicalCursor, segment);
-        const maybeStat = readLexicalStat(context, {
-            missingFromIndex: idx,
-            read: (cursor) => fs.lstatSync(cursor),
+    };
+    globalWithCleanup[GLOBAL_CLEANUP_HANDLER_KEY] = cleanup;
+    process.on("exit", cleanup);
+}
+async function releaseHeldLock(state, normalizedTargetPath, held, options = {}) {
+    const current = state.held.get(normalizedTargetPath);
+    if (current !== held) {
+        return false;
+    }
+    if (held.releasePromise) {
+        await held.releasePromise;
+        return true;
+    }
+    if (options.force) {
+        held.refCount = 0;
+    }
+    else if (!options.retry && held.refCount > 0) {
+        held.refCount -= 1;
+    }
+    if (held.refCount > 0) {
+        return false;
+    }
+    held.releasePromise = (async () => {
+        await held.handle.close().catch(() => undefined);
+        await removeSidecarLockIfUnchanged(held.lockPath, held.snapshot, {
+            lockRoot: held.lockRoot,
+            parsePayload: held.parsePayload,
         });
-        if (isPromiseLike(maybeStat)) {
-            throw new Error("Unexpected async lexical stat");
+        if (state.held.get(normalizedTargetPath) === held) {
+            state.held.delete(normalizedTargetPath);
         }
-        const stat = maybeStat;
-        if (!stat) {
-            break;
+        if (held.compromiseTimer) {
+            clearInterval(held.compromiseTimer);
+            held.compromiseTimer = undefined;
         }
-        const disposition = handleLexicalStatDisposition(context, {
-            isSymbolicLink: stat.isSymbolicLink(),
-            segment,
-            isLast,
+    })();
+    try {
+        await held.releasePromise;
+        return true;
+    }
+    finally {
+        held.releasePromise = undefined;
+    }
+}
+function handleForHeldLock(state, normalizedTargetPath, held) {
+    return createHeldSidecarLockHandle({
+        normalizedTargetPath,
+        held,
+        release: async (options) => await releaseHeldLock(state, normalizedTargetPath, held, { retry: options?.retry }),
+    });
+}
+function createSidecarLockManager(key) {
+    const state = resolveManagerState(key);
+    function ensureExitCleanupRegistered() {
+        state.cleanupRegistered = true;
+        state.reclaimCleanupRegistered = true;
+        ensureGlobalExitCleanupRegistered();
+    }
+    async function acquire(options) {
+        return await acquireSidecarLock(options, {
+            held: state.held,
+            reclaimGuards: state.reclaimGuards,
+            ensureExitCleanupRegistered,
+            handleForHeldLock: (normalizedTargetPath, held) => handleForHeldLock(state, normalizedTargetPath, held),
+            releaseHeldLock: async (normalizedTargetPath, held, releaseOptions) => await releaseHeldLock(state, normalizedTargetPath, held, releaseOptions),
         });
-        if (disposition === "continue") {
-            continue;
-        }
-        if (disposition === "break") {
-            break;
+    }
+    async function withLock(options, fn) {
+        const lock = await acquire(options);
+        let result;
+        try {
+            result = await fn();
         }
-        const maybeApplied = resolveAndApplySymlinkHop(context, {
-            resolveLinkCanonical: (cursor) => resolveSymlinkHopPathSync(cursor),
-        });
-        if (isPromiseLike(maybeApplied)) {
-            throw new Error("Unexpected async symlink resolution");
+        catch (bodyError) {
+            try {
+                await lock.release();
+            }
+            catch (releaseError) {
+                throw createSuppressedError(releaseError, bodyError, "file lock callback and release both failed");
+            }
+            throw bodyError;
         }
-        if (context.resolveParams.rejectSymlinks === true) {
-            throw new FsSafeError("symlink", "symlink path component not allowed");
+        await lock.release();
+        return result;
+    }
+    async function drain() {
+        for (const [normalizedTargetPath, held] of Array.from(state.held.entries())) {
+            await releaseHeldLock(state, normalizedTargetPath, held, { force: true }).catch(() => undefined);
         }
     }
-    const kind = getPathKindSync(state.canonicalCursor, state.preserveFinalSymlink);
-    return finalizeLexicalResolution(context, kind);
+    function reset() {
+        releaseAllLocksSync(state);
+    }
+    function heldEntries() {
+        return Array.from(state.held.entries()).map(([normalizedTargetPath, held]) => ({
+            normalizedTargetPath,
+            lockPath: held.lockPath,
+            acquiredAt: held.acquiredAt,
+            metadata: held.metadata,
+            forceRelease: () => releaseHeldLock(state, normalizedTargetPath, held, { force: true }),
+        }));
+    }
+    return { acquire, withLock, drain, reset, heldEntries };
 }
-function resolveCanonicalOutsideLexicalPath(params) {
-    return params.outsideLexicalCanonicalPath ?? params.absolutePath;
+async function withSidecarLock(targetPath, options, fn) {
+    const manager = createSidecarLockManager(options.managerKey ?? `fs-safe.sidecar-lock:${targetPath}`);
+    const { managerKey: _managerKey, ...acquireOptions } = options;
+    return await manager.withLock({ ...acquireOptions, targetPath }, fn);
 }
-function createBoundaryResolutionContext(params) {
-    const lexicalInside = path_isPathInside(params.rootPath, params.absolutePath);
-    const canonicalOutsideLexicalPath = resolveCanonicalOutsideLexicalPath({
-        absolutePath: params.absolutePath,
-        outsideLexicalCanonicalPath: params.outsideLexicalCanonicalPath,
-    });
-    assertLexicalBoundaryOrCanonicalAlias({
-        skipLexicalRootCheck: params.resolveParams.skipLexicalRootCheck,
-        lexicalInside,
-        canonicalOutsideLexicalPath,
-        rootCanonicalPath: params.rootCanonicalPath,
-        boundaryLabel: params.resolveParams.boundaryLabel,
-        rootPath: params.rootPath,
-        absolutePath: params.absolutePath,
-    });
-    return {
-        rootPath: params.rootPath,
-        absolutePath: params.absolutePath,
-        rootCanonicalPath: params.rootCanonicalPath,
-        lexicalInside,
-        canonicalOutsideLexicalPath,
-    };
+
+;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/pinned-write.js
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+function byteLength(input, encoding) {
+    return typeof input === "string"
+        ? Buffer.byteLength(input, encoding ?? "utf8")
+        : input.byteLength;
 }
-async function resolveOutsideRootPathAsync(params) {
-    if (params.context.lexicalInside) {
-        return null;
+function assertSafeBasename(basename) {
+    if (!basename ||
+        basename === "." ||
+        basename === ".." ||
+        basename.includes("/") ||
+        basename.includes("\0")) {
+        throw new errors_FsSafeError("invalid-path", "invalid target path");
     }
-    const kind = await getPathKind(params.context.absolutePath, false);
-    return buildOutsideRootPathFromContext({
-        boundaryLabel: params.boundaryLabel,
-        context: params.context,
-        kind,
-    });
 }
-function resolveOutsideRootPathSync(params) {
-    if (params.context.lexicalInside) {
-        return null;
+function assertWithinMaxBytes(bytes, maxBytes) {
+    if (maxBytes !== undefined && bytes > maxBytes) {
+        throw new errors_FsSafeError("too-large", `file exceeds limit of ${maxBytes} bytes (got at least ${bytes})`);
     }
-    const kind = getPathKindSync(params.context.absolutePath, false);
-    return buildOutsideRootPathFromContext({
-        boundaryLabel: params.boundaryLabel,
-        context: params.context,
-        kind,
-    });
-}
-function buildOutsideRootPathFromContext(params) {
-    return buildOutsideLexicalRootPath({
-        boundaryLabel: params.boundaryLabel,
-        rootCanonicalPath: params.context.rootCanonicalPath,
-        absolutePath: params.context.absolutePath,
-        canonicalOutsideLexicalPath: params.context.canonicalOutsideLexicalPath,
-        rootPath: params.context.rootPath,
-        kind: params.kind,
-    });
 }
-async function resolveOutsideLexicalCanonicalPathAsync(params) {
-    if (path_isPathInside(params.rootPath, params.absolutePath)) {
-        return undefined;
+async function syncFileBestEffort(handle) {
+    try {
+        await handle.sync();
+    }
+    catch (error) {
+        if (error?.code !== "EPERM") {
+            throw error;
+        }
     }
-    return await resolvePathViaExistingAncestor(params.absolutePath);
 }
-function resolveOutsideLexicalCanonicalPathSync(params) {
-    if (isPathInside(params.rootPath, params.absolutePath)) {
-        return undefined;
+async function writeStreamToHandle(stream, handle, maxBytes) {
+    let bytes = 0;
+    for await (const chunk of stream) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        bytes += buffer.byteLength;
+        assertWithinMaxBytes(bytes, maxBytes);
+        let offset = 0;
+        while (offset < buffer.byteLength) {
+            const { bytesWritten } = await handle.write(buffer, offset, buffer.byteLength - offset);
+            if (bytesWritten <= 0) {
+                throw new errors_FsSafeError("helper-failed", "fallback stream write made no progress");
+            }
+            offset += bytesWritten;
+        }
     }
-    return resolvePathViaExistingAncestorSync(params.absolutePath);
 }
-function buildOutsideLexicalRootPath(params) {
-    assertInsideBoundary({
-        boundaryLabel: params.boundaryLabel,
-        rootCanonicalPath: params.rootCanonicalPath,
-        candidatePath: params.canonicalOutsideLexicalPath,
-        absolutePath: params.absolutePath,
-    });
-    return buildResolvedRootPath({
-        absolutePath: params.absolutePath,
-        canonicalPath: params.canonicalOutsideLexicalPath,
-        rootPath: params.rootPath,
-        rootCanonicalPath: params.rootCanonicalPath,
-        kind: params.kind,
+async function runPinnedWriteHelper(params) {
+    const normalizedParams = { ...params, maxBytes: byte_budget_normalizeMaxBytes(params.maxBytes) };
+    assertSafeBasename(params.basename);
+    validatePinnedOperationPayload({
+        relativeParentPath: params.relativeParentPath,
     });
-}
-function assertLexicalBoundaryOrCanonicalAlias(params) {
-    if (params.skipLexicalRootCheck || params.lexicalInside) {
-        return;
+    // The explicit compatibility policy uses the guarded Node fallback, where
+    // content verification can replace the strict post-rename inode check.
+    if (normalizedParams.onRenameIdentityMismatch === "verify-content") {
+        return await runPinnedWriteFallback(normalizedParams);
     }
-    if (path_isPathInside(params.rootCanonicalPath, params.canonicalOutsideLexicalPath)) {
-        return;
+    const native = getNativeBinding();
+    if (native) {
+        return await runPinnedWriteNative(native, normalizedParams);
     }
-    throw pathEscapeError({
-        boundaryLabel: params.boundaryLabel,
-        rootPath: params.rootPath,
-        absolutePath: params.absolutePath,
-    });
+    return await runPinnedWriteFallback(normalizedParams);
 }
-function buildResolvedRootPath(params) {
-    return {
-        absolutePath: params.absolutePath,
-        canonicalPath: params.canonicalPath,
-        rootPath: params.rootPath,
-        rootCanonicalPath: params.rootCanonicalPath,
-        relativePath: relativeInsideRoot(params.rootCanonicalPath, params.canonicalPath),
-        exists: params.kind.exists,
-        kind: params.kind.kind,
-    };
+async function runPinnedWriteWithRenamePolicy(params) {
+    const { targetPath, renameIdentity, ...writeParams } = params;
+    if (renameIdentity !== "verify-content-with-lock") {
+        return await runPinnedWriteHelper(writeParams);
+    }
+    const relativeTargetPath = writeParams.relativeParentPath
+        ? `${writeParams.relativeParentPath}/${writeParams.basename}`
+        : writeParams.basename;
+    const lockPath = external_node_path_namespaceObject.join(writeParams.rootPath, `.fs-safe-write-${sha256Hex(relativeTargetPath)}.lock`);
+    return await withSidecarLock(writeParams.rootPath, {
+        managerKey: `fs-safe.write:${targetPath}`,
+        lockPath,
+        staleMs: 30_000,
+        timeoutMs: 5_000,
+        payload: () => ({ pid: process.pid, createdAt: new Date().toISOString() }),
+        retry: { retries: 5, minTimeout: 100, maxTimeout: 2_000, factor: 2 },
+    }, async () => await runPinnedWriteHelper({
+        ...writeParams,
+        onRenameIdentityMismatch: "verify-content",
+    }));
 }
-async function getPathKind(absolutePath, preserveFinalSymlink) {
-    try {
-        const stat = preserveFinalSymlink
-            ? await promises_namespaceObject.lstat(absolutePath)
-            : await promises_namespaceObject.stat(absolutePath);
-        return { exists: true, kind: toResolvedKind(stat) };
+async function runPinnedWriteFallback(params) {
+    let parentPath = params.relativeParentPath
+        ? external_node_path_namespaceObject.join(params.rootPath, ...params.relativeParentPath.split("/"))
+        : params.rootPath;
+    if (params.mkdir) {
+        // mkdirPathComponentsWithGuards may resolve the final component through
+        // an in-root symlink (e.g. a skill-bank layout). Use its returned real
+        // path for the subsequent guard and target path so we don't re-check the
+        // original, possibly-symlinked, lexical path and reject it outright.
+        parentPath = await mkdirPathComponentsWithGuards({
+            rootReal: params.rootPath,
+            targetPath: parentPath,
+            beforeComponent: async (componentPath) => await getFsSafeTestHooks()?.beforeRootFallbackMutation?.("mkdir", componentPath),
+        });
     }
-    catch (error) {
-        if (path_isNotFoundPathError(error)) {
-            return { exists: false, kind: "missing" };
+    const parentGuard = params.mkdir
+        ? await directory_guard_createAsyncDirectoryGuard(parentPath)
+        : await directory_guard_createNearestExistingDirectoryGuard(params.rootPath, parentPath);
+    const targetPath = external_node_path_namespaceObject.join(parentPath, params.basename);
+    if (params.overwrite === false) {
+        const handle = await withAsyncDirectoryGuards([parentGuard], async () => await promises_namespaceObject.open(targetPath, external_node_fs_namespaceObject.constants.O_WRONLY | external_node_fs_namespaceObject.constants.O_CREAT | external_node_fs_namespaceObject.constants.O_EXCL, params.mode), {
+            onPostGuardFailure: async (openedHandle) => {
+                // The parent failed verification, so targetPath may now resolve
+                // somewhere else. Close the fd, but do not clean up by path.
+                await openedHandle.close().catch(() => undefined);
+            },
+        });
+        let created = true;
+        try {
+            const verificationIdentity = await handle.stat({ bigint: true });
+            await handle.chmod(params.mode);
+            if (params.input.kind === "buffer") {
+                assertWithinMaxBytes(byteLength(params.input.data, params.input.encoding), params.maxBytes);
+                if (typeof params.input.data === "string") {
+                    await handle.writeFile(params.input.data, params.input.encoding ?? "utf8");
+                }
+                else {
+                    await handle.writeFile(params.input.data);
+                }
+            }
+            else {
+                await writeStreamToHandle(params.input.stream, handle, params.maxBytes);
+            }
+            await syncFileBestEffort(handle);
+            const stat = await handle.stat();
+            await syncDirectoryBestEffort(parentPath);
+            // Publication is complete. A failed outer check must not remove its target.
+            created = false;
+            await params.verifyPublished?.(handle.fd, verificationIdentity, parentGuard);
+            return { dev: stat.dev, ino: stat.ino };
+        }
+        finally {
+            await handle.close().catch(() => undefined);
+            if (created) {
+                await promises_namespaceObject.rm(targetPath, { force: true }).catch(() => undefined);
+            }
         }
-        throw error;
     }
-}
-function getPathKindSync(absolutePath, preserveFinalSymlink) {
+    // Private staging must not consume the destination basename's filename budget.
+    const tempPath = external_node_path_namespaceObject.join(parentPath, `.fs-safe-${(0,external_node_crypto_namespaceObject.randomUUID)()}.tmp`);
+    const tempFlags = external_node_fs_namespaceObject.constants.O_WRONLY |
+        external_node_fs_namespaceObject.constants.O_CREAT |
+        external_node_fs_namespaceObject.constants.O_EXCL |
+        (process.platform !== "win32" && "O_NOFOLLOW" in external_node_fs_namespaceObject.constants
+            ? external_node_fs_namespaceObject.constants.O_NOFOLLOW
+            : 0);
+    let handle;
+    let tempStat;
+    let readHandle;
+    let renamed = false;
     try {
-        const stat = preserveFinalSymlink ? fs.lstatSync(absolutePath) : fs.statSync(absolutePath);
-        return { exists: true, kind: toResolvedKind(stat) };
-    }
-    catch (error) {
-        if (isNotFoundPathError(error)) {
-            return { exists: false, kind: "missing" };
+        handle = await promises_namespaceObject.open(tempPath, tempFlags, params.mode);
+        let verificationIdentity = await handle.stat({ bigint: true });
+        await handle.chmod(params.mode);
+        if (params.input.kind === "buffer") {
+            assertWithinMaxBytes(byteLength(params.input.data, params.input.encoding), params.maxBytes);
+            if (typeof params.input.data === "string") {
+                await handle.writeFile(params.input.data, params.input.encoding ?? "utf8");
+            }
+            else {
+                await handle.writeFile(params.input.data);
+            }
         }
-        throw error;
-    }
-}
-function toResolvedKind(stat) {
-    if (stat.isFile()) {
-        return "file";
-    }
-    if (stat.isDirectory()) {
-        return "directory";
-    }
-    if (stat.isSymbolicLink()) {
-        return "symlink";
-    }
-    return "other";
-}
-function relativeInsideRoot(rootPath, targetPath) {
-    const relative = external_node_path_namespaceObject.relative(external_node_path_namespaceObject.resolve(rootPath), external_node_path_namespaceObject.resolve(targetPath));
-    if (!relative || relative === ".") {
-        return "";
-    }
-    if (isPathRelativeEscape(relative)) {
-        return "";
+        else {
+            await writeStreamToHandle(params.input.stream, handle, params.maxBytes);
+        }
+        tempStat = await handle.stat();
+        const tempPathStat = await promises_namespaceObject.lstat(tempPath);
+        if (tempPathStat.isSymbolicLink() || !file_identity_sameFileIdentity(tempPathStat, tempStat)) {
+            throw new errors_FsSafeError("path-mismatch", "fallback temp path changed during write");
+        }
+        const expectedTempStat = tempStat;
+        await syncFileBestEffort(handle);
+        let verifiedIdentity = expectedTempStat;
+        await withAsyncDirectoryGuards([parentGuard], async () => {
+            await promises_namespaceObject.rename(tempPath, targetPath);
+            renamed = true;
+            await getFsSafeTestHooks()?.afterPinnedWriteFallbackRename?.(targetPath);
+            await syncDirectoryBestEffort(parentPath);
+            const targetStat = await promises_namespaceObject.lstat(targetPath);
+            if (targetStat.isSymbolicLink()) {
+                throw new errors_FsSafeError("path-mismatch", "fallback target changed during write");
+            }
+            if (!file_identity_sameFileIdentity(targetStat, expectedTempStat)) {
+                // On filesystems like rclone FUSE, rename(2) can give the destination a
+                // different inode from the source temp fd even with zero concurrency. The
+                // caller must ensure mutual exclusion before passing "verify-content";
+                // fall back to a content hash for this rename-boundary check only.
+                if (params.onRenameIdentityMismatch !== "verify-content") {
+                    throw new errors_FsSafeError("path-mismatch", "fallback target changed during write");
+                }
+                if (params.input.kind !== "buffer") {
+                    throw new errors_FsSafeError("path-mismatch", "fallback target changed during write");
+                }
+                const expectedHash = sha256Hex(params.input.data, params.input.encoding);
+                readHandle = await promises_namespaceObject.open(targetPath, read_open_flags_resolveReadOpenFlags());
+                const readHandleStat = await readHandle.stat({ bigint: true });
+                const actualHash = sha256Hex(await readHandle.readFile());
+                if (actualHash !== expectedHash) {
+                    throw new errors_FsSafeError("path-mismatch", "fallback target changed during write");
+                }
+                // The content-verified destination, not the old temp inode, is now pinned.
+                verificationIdentity = readHandleStat;
+                // Preserve the helper's legacy numeric return facts, not the private proof.
+                verifiedIdentity = { dev: Number(readHandleStat.dev), ino: Number(readHandleStat.ino) };
+            }
+        });
+        await params.verifyPublished?.((readHandle ?? handle).fd, verificationIdentity, parentGuard);
+        return { dev: verifiedIdentity.dev, ino: verifiedIdentity.ino };
     }
-    return relative;
-}
-function assertInsideBoundary(params) {
-    if (path_isPathInside(params.rootCanonicalPath, params.candidatePath)) {
-        return;
+    finally {
+        await readHandle?.close().catch(() => undefined);
+        await handle?.close().catch(() => undefined);
+        if (!renamed) {
+            await promises_namespaceObject.rm(tempPath, { force: true }).catch(() => undefined);
+        }
     }
-    throw new Error(`Path resolves outside ${params.boundaryLabel} (${shortPath(params.rootCanonicalPath)}): ${shortPath(params.absolutePath)}`);
-}
-function pathEscapeError(params) {
-    return new Error(`Path escapes ${params.boundaryLabel} (${shortPath(params.rootPath)}): ${shortPath(params.absolutePath)}`);
-}
-function symlinkEscapeError(params) {
-    return new Error(`Symlink escapes ${params.boundaryLabel} (${shortPath(params.rootCanonicalPath)}): ${shortPath(params.symlinkPath)}`);
 }
 
 ;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/path-policy.js
@@ -5137,56 +5399,6 @@ async function verifyAtomicWriteResult(params) {
     }
 }
 
-;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/strict-file-identity.js
-
-function identityMismatch() {
-    return new errors_FsSafeError("path-mismatch", "file identity changed or could not be verified");
-}
-function identityCheck(expected, platform) {
-    const known = {};
-    const check = (stat) => {
-        let complete = true;
-        for (const field of ["dev", "ino"]) {
-            const value = stat[field];
-            // Numeric receipts cannot recover identity bits already lost to rounding.
-            if (typeof value !== "bigint")
-                throw identityMismatch();
-            if (platform === "win32" && value === 0n) {
-                complete = false;
-            }
-            else {
-                if (known[field] !== undefined && known[field] !== value)
-                    throw identityMismatch();
-                known[field] = value;
-            }
-        }
-        return complete;
-    };
-    if (expected && !check(expected))
-        throw identityMismatch();
-    return check;
-}
-// Retry only unknown Windows identities, retaining every known component so a
-// later observation cannot erase a definite mismatch. Never reopen the file.
-async function inspectFileIdentity(inspect, expected, platform = process.platform) {
-    const check = identityCheck(expected, platform);
-    for (let attempt = 0; attempt < 2; attempt++) {
-        const stat = await inspect();
-        if (check(stat))
-            return stat;
-    }
-    throw identityMismatch();
-}
-function inspectFileIdentitySync(inspect, expected, platform = process.platform) {
-    const check = identityCheck(expected, platform);
-    for (let attempt = 0; attempt < 2; attempt++) {
-        const stat = inspect();
-        if (check(stat))
-            return stat;
-    }
-    throw identityMismatch();
-}
-
 ;// CONCATENATED MODULE: ../../node_modules/@openclaw/fs-safe/dist/root-impl.js
 
 
@@ -5217,6 +5429,7 @@ function inspectFileIdentitySync(inspect, expected, platform = process.platform)
 
 
 
+
 
 
 function logWarn(message) {
@@ -5292,25 +5505,15 @@ async function openVerifiedLocalFile(filePath, options) {
     if (preOpenStat) {
         await fsSafeTestHooks?.afterPreOpenLstat?.(filePath);
     }
+    const openFlags = options?.symlinks === "follow-within-root"
+        ? OPEN_READ_FOLLOW_FLAGS
+        : OPEN_READ_FLAGS;
+    await fsSafeTestHooks?.beforeOpen?.(filePath, openFlags);
     let handle;
     try {
-        const openFlags = options?.symlinks === "follow-within-root"
-            ? OPEN_READ_FOLLOW_FLAGS
-            : OPEN_READ_FLAGS;
-        await fsSafeTestHooks?.beforeOpen?.(filePath, openFlags);
-        handle = await promises_namespaceObject.open(filePath, openFlags);
-        try {
-            await fsSafeTestHooks?.afterOpen?.(filePath, handle);
-        }
-        catch (err) {
-            await handle.close().catch(() => { });
-            throw err;
-        }
+        handle = await promises_namespaceObject.open(filePath, openFlags).catch((error) => recordFileOpenFailure(path_isNotFoundPathError(error) ? fileNotFoundError() : error, filePath));
     }
     catch (err) {
-        if (path_isNotFoundPathError(err)) {
-            throw fileNotFoundError();
-        }
         if (isSymlinkOpenError(err)) {
             throw new errors_FsSafeError("symlink", "symlink open blocked", { cause: err });
         }
@@ -5321,16 +5524,35 @@ async function openVerifiedLocalFile(filePath, options) {
         throw err;
     }
     try {
+        await fsSafeTestHooks?.afterOpen?.(filePath, handle);
         const stat = await handle.stat();
         if (!stat.isFile()) {
             throw new errors_FsSafeError("not-file", "not a file");
         }
         // Keep numeric Stats for the public receipt, never for identity verification.
-        const identity = await inspectFileIdentity(() => handle.stat({ bigint: true }), preOpenStat && !preOpenStat.isSymbolicLink() ? preOpenStat : undefined);
+        let openedIdentity;
+        const identity = await inspectFileIdentity(async () => (openedIdentity = await handle.stat({ bigint: true })), preOpenStat && !preOpenStat.isSymbolicLink() ? preOpenStat : undefined).catch(async (error) => {
+            if ([0, 1].includes(stat.nlink)) {
+                await recordPreOpenFileChange(error, handle, filePath, preOpenStat, openedIdentity);
+            }
+            throw error;
+        });
         if (options?.hardlinks === "reject" && stat.nlink > 1) {
             throw hardlinkedPathNotAllowedError();
         }
-        await inspectFileIdentity(async () => {
+        const inspectPathIdentity = async (inspect) => {
+            try {
+                return await inspectFileIdentity(inspect, identity);
+            }
+            catch (error) {
+                const failure = path_isNotFoundPathError(error) ? openedPathResolutionError(fileNotFoundError()) : error;
+                if (stat.nlink <= 1 && (!preOpenStat || preOpenStat.nlink <= 1n)) {
+                    await recordOpenedFileFailure(failure, handle, filePath, identity);
+                }
+                throw failure;
+            }
+        };
+        await inspectPathIdentity(async () => {
             const pathStat = options?.symlinks === "follow-within-root"
                 ? await promises_namespaceObject.stat(filePath, { bigint: true })
                 : await promises_namespaceObject.lstat(filePath, { bigint: true });
@@ -5338,26 +5560,26 @@ async function openVerifiedLocalFile(filePath, options) {
                 throw new errors_FsSafeError("symlink", "symlink not allowed");
             }
             return pathStat;
-        }, identity);
+        });
         await fsSafeTestHooks?.afterOpenedPathIdentityCheck?.(filePath, handle);
-        const realPath = await resolveOpenedFileRealPathForFd(handle.fd, identity, filePath);
-        await inspectFileIdentity(async () => {
+        const realPath = await resolveOpenedFileRealPathForFd(handle.fd, identity, filePath)
+            .catch(async (error) => {
+            if (stat.nlink <= 1 && (!preOpenStat || preOpenStat.nlink <= 1n)) {
+                await recordOpenedFileFailure(error, handle, filePath, identity);
+            }
+            throw error;
+        });
+        await inspectPathIdentity(async () => {
             const realStat = await promises_namespaceObject.stat(realPath, { bigint: true });
             if (options?.hardlinks === "reject" && realStat.nlink > 1n) {
                 throw hardlinkedPathNotAllowedError();
             }
             return realStat;
-        }, identity);
+        });
         return { opened: openResult({ handle, realPath, stat }), identity };
     }
     catch (err) {
         await handle.close().catch(() => { });
-        if (err instanceof errors_FsSafeError) {
-            throw err;
-        }
-        if (path_isNotFoundPathError(err)) {
-            throw fileNotFoundError();
-        }
         throw err;
     }
 }
@@ -5586,19 +5808,10 @@ async function openFileInRoot(root, params) {
         rejectUnsafeDeviceReads: true,
         rejectSymlinks: params.symlinks !== "follow-within-root",
     });
-    let opened;
-    try {
-        ({ opened } = await openVerifiedLocalFile(resolved, {
-            nonBlockingRead: params.nonBlockingRead,
-            symlinks: params.symlinks,
-        }));
-    }
-    catch (err) {
-        if (err instanceof errors_FsSafeError) {
-            throw err;
-        }
-        throw err;
-    }
+    const { opened } = await openVerifiedLocalFile(resolved, {
+        nonBlockingRead: params.nonBlockingRead,
+        symlinks: params.symlinks,
+    });
     if (params.hardlinks !== "allow" && opened.stat.nlink > 1) {
         await opened.handle.close().catch(() => { });
         throw hardlinkedPathNotAllowedError();
@@ -5650,9 +5863,7 @@ function emitWriteBoundaryWarning(reason) {
     logWarn(`security: fs-safe write boundary warning (${reason})`);
 }
 function buildAtomicWriteTempPath(targetPath) {
-    const dir = external_node_path_namespaceObject.dirname(targetPath);
-    const base = external_node_path_namespaceObject.basename(targetPath);
-    return external_node_path_namespaceObject.join(dir, `.${base}.${process.pid}.${(0,external_node_crypto_namespaceObject.randomUUID)()}.tmp`);
+    return external_node_path_namespaceObject.join(external_node_path_namespaceObject.dirname(targetPath), `.fs-safe-${(0,external_node_crypto_namespaceObject.randomUUID)()}.tmp`);
 }
 function rootWriteQueueKey(root, relativePath) {
     return `${root.rootReal}\0${relativePath}`;
@@ -5891,7 +6102,7 @@ async function writeFileInRoot(root, params) {
             await writeFileFallback(root, params);
             return;
         }
-        const pinned = await resolvePinnedWriteTargetInRoot(root, params.relativePath, params.mode, params.denyMutations);
+        const pinned = await resolvePinnedWriteTargetInRoot(root, params.relativePath, params.mode, params.denyMutations, params.overwrite);
         await serializePathWrite(pinned.targetPath, async () => {
             await commitPinnedWriteInRoot(root, pinned, params);
         });
@@ -6013,7 +6224,7 @@ async function removePathIfIdentityUnchanged(targetPath, identity) {
         await promises_namespaceObject.rm(targetPath);
     });
 }
-async function resolvePinnedWriteTargetInRoot(root, relativePath, requestedMode, denyMutations) {
+async function resolvePinnedWriteTargetInRoot(root, relativePath, requestedMode, denyMutations, overwrite = true) {
     const { rootReal, rootWithSep, resolved } = await resolveGuardedWritePathInRoot(root, {
         relativePath,
         denyMutations,
@@ -6031,22 +6242,40 @@ async function resolvePinnedWriteTargetInRoot(root, relativePath, requestedMode,
     if (!basename || basename === "." || basename === "/") {
         throw new errors_FsSafeError("invalid-path", "invalid target path");
     }
+    // Exclusive publication cannot inherit an existing file's mode. Keep type
+    // and alias checks, but never open a competing owner's record just to reject it.
+    if (!overwrite) {
+        try {
+            const existing = await promises_namespaceObject.stat(resolved);
+            if (!existing.isFile())
+                throw new errors_FsSafeError("not-file", "not a file");
+            if (existing.nlink > 1)
+                throw hardlinkedPathNotAllowedError();
+            throw new errors_FsSafeError("already-exists", "file already exists");
+        }
+        catch (error) {
+            if (!path_isNotFoundPathError(error))
+                throw error;
+        }
+    }
     let mode = requestedMode ?? 0o600;
     try {
-        const opened = await openFileInRoot(root, {
-            relativePath,
-            hardlinks: "reject",
-            nonBlockingRead: true,
-            symlinks: "follow-within-root",
-        });
-        try {
-            mode = requestedMode ?? (opened.stat.mode & 0o777);
-            if (!path_isPathInside(rootWithSep, opened.realPath)) {
-                throw outsideWorkspaceError();
+        if (overwrite) {
+            const opened = await openFileInRoot(root, {
+                relativePath,
+                hardlinks: "reject",
+                nonBlockingRead: true,
+                symlinks: "follow-within-root",
+            });
+            try {
+                mode = requestedMode ?? (opened.stat.mode & 0o777);
+                if (!path_isPathInside(rootWithSep, opened.realPath)) {
+                    throw outsideWorkspaceError();
+                }
+            }
+            finally {
+                await opened.handle.close().catch(() => { });
             }
-        }
-        finally {
-            await opened.handle.close().catch(() => { });
         }
     }
     catch (err) {
@@ -6980,7 +7209,7 @@ async function runShim(options) {
     });
 }
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/util.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/util.js
 
 // functions
 function assertEqual(val) {
@@ -7828,7 +8057,7 @@ function constantCatch(value) {
     return fn;
 }
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/core.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/core.js
 var core_a;
 
 /** A special constant with type `never` */
@@ -7971,7 +8200,7 @@ function core_config(newConfig) {
     return globalConfig;
 }
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/memoizer.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/memoizer.js
 class $ZodCyclicError extends Error {
     constructor() {
         super(`Cannot parse a reference cycle that closes through a transform`);
@@ -8161,7 +8390,7 @@ function isBackEdge(ctx, value) {
     return backEdges !== undefined && value !== null && typeof value === "object" && backEdges.has(value);
 }
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/regexes.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/regexes.js
 
 /**
  * @deprecated CUID v1 is deprecated by its authors due to information leakage
@@ -8313,7 +8542,7 @@ const sha512_hex = /^[0-9a-fA-F]{128}$/;
 const sha512_base64 = /*@__PURE__*/ (/* unused pure expression or super */ null && (fixedBase64(86, "==")));
 const sha512_base64url = /*@__PURE__*/ (/* unused pure expression or super */ null && (fixedBase64url(86)));
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/checks.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/checks.js
 // import { $ZodType } from "./schemas.js";
 
 
@@ -8896,7 +9125,7 @@ const $ZodCheckOverwrite = /*@__PURE__*/ $constructor("$ZodCheckOverwrite", (ins
     };
 });
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/doc.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/doc.js
 class Doc {
     constructor(args = [], closed = {}) {
         this.content = [];
@@ -8931,7 +9160,7 @@ class Doc {
     }
 }
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/errors.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/errors.js
 
 
 /* Computing the message eagerly is expensive (pretty-printed JSON of all
@@ -9203,7 +9432,7 @@ function prettifyError(error) {
     return lines.join("\n");
 }
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/parse.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/parse.js
 
 
 
@@ -9359,14 +9588,14 @@ const _safeDecodeAsync = (_Err) => async (schema, value, _ctx) => {
 };
 const safeDecodeAsync = /* @__PURE__*/ _safeDecodeAsync($ZodRealError);
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/versions.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/versions.js
 const versions_version = {
     major: 4,
     minor: 5,
     patch: 2,
 };
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/schemas.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/schemas.js
 
 
 
@@ -11808,7 +12037,7 @@ function handleRefineResult(result, payload, input, inst) {
     }
 }
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/registries.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/registries.js
 var registries_a;
 const $output = /*@__PURE__*/ (/* unused pure expression or super */ null && (Symbol("ZodOutput")));
 const $input = /*@__PURE__*/ (/* unused pure expression or super */ null && (Symbol("ZodInput")));
@@ -11861,7 +12090,7 @@ function registries_registry() {
 (registries_a = globalThis).__zod_globalRegistry ?? (registries_a.__zod_globalRegistry = registries_registry());
 const globalRegistry = globalThis.__zod_globalRegistry;
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/api.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/api.js
 
 
 
@@ -12963,7 +13192,7 @@ function _stringFormat(Class, format, fnOrRegex, _params = {}) {
     return inst;
 }
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/to-json-schema.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/to-json-schema.js
 
 
 function assignProps(target, ...sources) {
@@ -13612,7 +13841,7 @@ const createStandardJSONSchemaMethod = (schema, io, processors = {}) => (params)
     return to_json_schema_finalize(ctx, schema);
 };
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/core/json-schema-processors.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/core/json-schema-processors.js
 
 
 const formatMap = {
@@ -14272,7 +14501,7 @@ function toJSONSchema(input, params) {
     return finalize(ctx, input);
 }
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/locales/en.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/locales/en.js
 
 const en_error = () => {
     const Sizable = {
@@ -14397,7 +14626,7 @@ const en_error = () => {
     };
 }
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/classic/errors.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/classic/errors.js
 
 
 
@@ -14456,7 +14685,7 @@ const ZodRealError = /*@__PURE__*/ $constructor("ZodError", classic_errors_initi
 // /** @deprecated Use `z.core.$ZodErrorMapCtx` instead. */
 // export type ErrorMapCtx = core.$ZodErrorMapCtx;
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/classic/parse.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/classic/parse.js
 
 
 const classic_parse_parse = /* @__PURE__ */ parse_parse(ZodRealError);
@@ -14474,7 +14703,7 @@ const parse_safeDecode = /* @__PURE__ */ _safeDecode(ZodRealError);
 const parse_safeEncodeAsync = /* @__PURE__ */ _safeEncodeAsync(ZodRealError);
 const parse_safeDecodeAsync = /* @__PURE__ */ _safeDecodeAsync(ZodRealError);
 
-;// CONCATENATED MODULE: ../../node_modules/zod/v4/classic/schemas.js
+;// CONCATENATED MODULE: ./node_modules/zod/v4/classic/schemas.js
 
 
 
@@ -18836,4 +19065,4 @@ if (installedChunkData !== 0) { // 0 means "already installed".'
 // module factories are used so entry inlining is disabled
 // startup
 // Load entry module and return exports
-var __webpack_exports__ = __webpack_require__(699);
+var __webpack_exports__ = __webpack_require__(461);