@openclaw/openshell-sandbox 2026.9.4 → 2026.9.6

package/node_modules/@openclaw/fs-safe/dist/path-suffix-aliases.js

@@ -0,0 +1,394 @@
+import { randomInt } from "node:crypto";
+import fs, {} from "node:fs";
+import path from "node:path";
+import { assertDirectoryIdentitySync, inspectDirectoryIdentitySync } from "./directory-guard.js";
+import { isWindowsReservedDeviceName } from "./device-path.js";
+import { FsSafeError } from "./errors.js";
+import { sameFileIdentityForCleanup } from "./file-identity.js";
+import { hasNodeErrorCode } from "./path.js";
+import { realpathSync } from "./realpath.js";
+import { inspectFileIdentitySync } from "./strict-file-identity.js";
+import { pathForWindowsFilesystem, resolvePathPreservingWindowsRoot, } from "./windows-path-alias.js";
+const MAX_SUFFIX_LENGTH = 8_192;
+const MAX_PATH_LENGTH = 32_768;
+const MAX_SUFFIX_DEPTH = 32;
+const MAX_MKDIR_ATTEMPTS = 128;
+const MAX_CREATED_DIRECTORIES = 64;
+const MAX_FORWARD_OBSERVATIONS = 4_096;
+const MAX_SCALED_FORWARD_OBSERVATIONS = 32_768;
+const PROBE_NAME_LENGTH = 6;
+const PROBE_ALPHABET = "abcdefghijklmnopqrstuvwxyz0123456789";
+const PROBE_FIRST_ALPHABET = "bdefghijkmoqrstuvwxyz";
+function unavailable() {
+    throw new Error("path suffix probe resources or cleanup authority are unavailable");
+}
+function assertMutationPath(value) {
+    if (value.length > MAX_PATH_LENGTH)
+        unavailable();
+}
+function suffixSegments(value, maxDepth) {
+    if (typeof value !== "string")
+        throw new TypeError("suffix must be a string");
+    if (value.length > MAX_SUFFIX_LENGTH)
+        throw new RangeError("suffix exceeds 8192 code units");
+    if (value.includes("\0") || path.isAbsolute(value)) {
+        throw new TypeError("suffix must be a relative path without NUL bytes");
+    }
+    const windows = process.platform === "win32";
+    const segments = (windows ? value.replaceAll("/", "\\") : value).split(path.sep);
+    if (segments.length > maxDepth)
+        throw new RangeError(`suffix exceeds ${maxDepth} components`);
+    if (segments.some(segment => !segment || segment === "." || segment === ".." ||
+        (windows && (segment.includes(":") || /^[ .]+$/u.test(segment) ||
+            isWindowsReservedDeviceName(segment))))) {
+        throw new TypeError("suffix must contain ordinary relative path components");
+    }
+    return segments;
+}
+function areAsciiCaseVariants(left, right) {
+    const fold = (value) => value.replace(/[A-Z]/gu, letter => String.fromCharCode(letter.charCodeAt(0) + 0x20));
+    return fold(left) === fold(right);
+}
+function forbiddenNames(leftNfc, rightNfc) {
+    const lower = new Set([leftNfc.toLowerCase(), rightNfc.toLowerCase()]);
+    const upper = new Set([leftNfc.toUpperCase(), rightNfc.toUpperCase()]);
+    // These conservative exclusions never classify filesystem aliases.
+    return candidate => {
+        const normalized = candidate.normalize("NFC");
+        return lower.has(normalized.toLowerCase()) || upper.has(normalized.toUpperCase());
+    };
+}
+function* normalizationProbePairs(left, right, forbidden, availableNameLength) {
+    const seen = new Set();
+    const replaceAscii = (value, replacements) => value.replace(/[A-Za-z]/gu, character => {
+        const lower = character.toLowerCase();
+        const replacement = replacements.get(lower);
+        return replacement ? character === lower ? replacement : replacement.toUpperCase() : character;
+    });
+    const presentAscii = [...new Set(`${left}${right}`.toLowerCase().match(/[a-z]/gu) ?? [])];
+    const mutableAscii = presentAscii.filter(source => {
+        const replacements = new Map([[source, source === "z" ? "y" : "z"]]);
+        return areAsciiCaseVariants(replaceAscii(left, replacements).normalize("NFC"), replaceAscii(right, replacements).normalize("NFC"));
+    });
+    for (let attempt = 0; attempt < 24 && mutableAscii.length > 0; attempt++) {
+        const replacements = new Map(mutableAscii.map(source => [
+            source, String.fromCharCode("a".charCodeAt(0) + randomInt(26)),
+        ]));
+        const first = replaceAscii(left, replacements);
+        const second = replaceAscii(right, replacements);
+        if (first.length > availableNameLength || second.length > availableNameLength ||
+            !areAsciiCaseVariants(first.normalize("NFC"), second.normalize("NFC")) ||
+            isWindowsReservedDeviceName(first) || isWindowsReservedDeviceName(second) ||
+            forbidden(first) || forbidden(second))
+            continue;
+        const key = `${first}\0${second}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            yield [first, second];
+        }
+    }
+}
+function createPrivateProbeName(nameLength) {
+    let name = "";
+    for (let index = 0; index < nameLength; index++) {
+        const alphabet = index === 0 ? PROBE_FIRST_ALPHABET : PROBE_ALPHABET;
+        name += alphabet[randomInt(alphabet.length)];
+    }
+    return name;
+}
+function* asciiCaseProbePairs(nameLength, forbidden) {
+    for (const first of privateProbeNames(nameLength, forbidden)) {
+        yield [first, `${first[0].toUpperCase()}${first.slice(1)}`];
+    }
+}
+function* privateProbeNames(nameLength, forbidden) {
+    let count = 0;
+    for (let attempt = 0; attempt < 96 && count < 24; attempt++) {
+        const name = createPrivateProbeName(nameLength);
+        if (!forbidden(name)) {
+            count++;
+            yield name;
+        }
+    }
+}
+function* prependPair(first, remaining) {
+    yield first;
+    yield* remaining;
+}
+class ProbeDirectories {
+    requestedDirectory;
+    root;
+    created = [];
+    cleanupComplete = true;
+    observations = 0;
+    mkdirAttempts = 0;
+    creations = 0;
+    maxObservations;
+    maxMkdirAttempts;
+    maxCreations;
+    constructor(requestedDirectory, depth) {
+        this.requestedDirectory = requestedDirectory;
+        // The suffix-length limit bounds actual depth, so these products remain safe integers.
+        const scale = Math.max(1, depth / MAX_SUFFIX_DEPTH);
+        this.maxObservations = Math.min(MAX_SCALED_FORWARD_OBSERVATIONS, MAX_FORWARD_OBSERVATIONS * scale * scale);
+        this.maxMkdirAttempts = MAX_MKDIR_ATTEMPTS * scale;
+        this.maxCreations = MAX_CREATED_DIRECTORIES * scale;
+        this.observe(1);
+        const canonical = realpathSync.native(pathForWindowsFilesystem(requestedDirectory));
+        assertMutationPath(canonical);
+        this.observe(2);
+        this.root = { path: canonical, identity: inspectDirectoryIdentitySync(canonical) };
+        this.assert(this.root);
+    }
+    reserveObservations(units) {
+        if (units > this.maxObservations - this.observations)
+            unavailable();
+    }
+    observe(units, cleanup = false) {
+        if (cleanup)
+            return;
+        this.reserveObservations(units);
+        this.observations += units;
+    }
+    assert(directory, cleanup = false) {
+        this.observe(1, cleanup);
+        if (realpathSync.native(pathForWindowsFilesystem(this.requestedDirectory)) !== this.root.path) {
+            throw new FsSafeError("path-mismatch", "probe directory changed");
+        }
+        for (let current = directory; current; current = current.parent) {
+            // Each strict identity helper can perform two observations on Windows.
+            this.observe(2, cleanup);
+            assertDirectoryIdentitySync(current.path, current.identity);
+        }
+    }
+    create(parent, name) {
+        if (this.mkdirAttempts >= this.maxMkdirAttempts || this.creations >= this.maxCreations)
+            unavailable();
+        const probePath = path.join(parent.path, name);
+        assertMutationPath(probePath);
+        this.assert(parent);
+        // Exhaustion must not itself create an entry whose first identity cannot be read.
+        this.reserveObservations(2);
+        this.mkdirAttempts++;
+        try {
+            fs.mkdirSync(probePath);
+        }
+        catch (error) {
+            if (hasNodeErrorCode(error, "EEXIST"))
+                return undefined;
+            throw error;
+        }
+        this.creations++;
+        this.observe(2);
+        // A failed initial observation can still leave an entry: mkdir returns no descriptor.
+        const created = { path: probePath, identity: inspectDirectoryIdentitySync(probePath), parent };
+        this.created.push(created);
+        this.assert(created);
+        return created;
+    }
+    remove(created, cleanup = false) {
+        try {
+            this.assert(created, cleanup);
+            assertMutationPath(created.path);
+            // Never recurse: unexpected children and replacements must remain.
+            fs.rmdirSync(created.path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    probe(parent, pairs) {
+        for (const [first, alternate] of pairs) {
+            const alternatePath = path.join(parent.path, alternate);
+            assertMutationPath(alternatePath);
+            const created = this.create(parent, first);
+            if (!created)
+                continue;
+            let alias;
+            this.observe(2);
+            try {
+                alias = inspectFileIdentitySync(() => fs.lstatSync(alternatePath, { bigint: true }));
+            }
+            catch (error) {
+                if (!hasNodeErrorCode(error, "ENOENT"))
+                    throw error;
+            }
+            this.assert(created);
+            if (!alias)
+                return { aliases: false, directory: created };
+            if (alias.isDirectory() && !alias.isSymbolicLink() && sameFileIdentityForCleanup(created.identity, alias)) {
+                return { aliases: true, directory: created };
+            }
+            // A different alternate entry is a collision. Lost cleanup authority ends probing.
+            if (!this.remove(created)) {
+                this.cleanupComplete = false;
+                unavailable();
+            }
+            this.created.splice(this.created.indexOf(created), 1);
+        }
+        return undefined;
+    }
+    neutral(parent, nameLength, forbidden) {
+        for (const name of privateProbeNames(nameLength, forbidden)) {
+            const created = this.create(parent, name);
+            if (created)
+                return created;
+        }
+        return undefined;
+    }
+    cleanup() {
+        // Cleanup bypasses the forward budget; creation and depth caps bound its work.
+        for (let index = this.created.length - 1; index >= 0; index--) {
+            if (!this.remove(this.created[index], true))
+                this.cleanupComplete = false;
+        }
+        try {
+            this.assert(this.root, true);
+        }
+        catch {
+            this.cleanupComplete = false;
+        }
+        return this.cleanupComplete;
+    }
+}
+function observeSuffixes(getOwner, leftSegments, rightSegments, shouldProbeCaseVariants) {
+    let maxProbePathLength;
+    let probeParent;
+    for (let index = 0; index < leftSegments.length; index++) {
+        const left = leftSegments[index];
+        const right = rightSegments[index];
+        const normalizedLeft = left.normalize("NFC");
+        const normalizedRight = right.normalize("NFC");
+        const asciiCaseVariants = areAsciiCaseVariants(normalizedLeft, normalizedRight);
+        if (normalizedLeft !== normalizedRight && !asciiCaseVariants &&
+            !shouldProbeCaseVariants(normalizedLeft, normalizedRight))
+            return false;
+        const needsNormalization = left !== normalizedLeft || right !== normalizedRight;
+        if (normalizedLeft === normalizedRight && !needsNormalization && index === leftSegments.length - 1)
+            continue;
+        const owner = getOwner();
+        probeParent ??= owner.root;
+        maxProbePathLength ??= Math.max(path.join(owner.root.path, leftSegments.join(path.sep)).length, path.join(owner.root.path, rightSegments.join(path.sep)).length);
+        const availableNameLength = maxProbePathLength - probeParent.path.length -
+            (probeParent.path.endsWith(path.sep) ? 0 : 1);
+        const nameLength = Math.max(1, Math.min(PROBE_NAME_LENGTH, left.length, right.length));
+        const forbidden = forbiddenNames(normalizedLeft, normalizedRight);
+        let next;
+        if (normalizedLeft !== normalizedRight) {
+            let caseParent = probeParent;
+            let pairs;
+            if (asciiCaseVariants) {
+                pairs = asciiCaseProbePairs(nameLength, forbidden);
+            }
+            else {
+                const neutral = owner.neutral(probeParent, nameLength, forbidden);
+                if (!neutral)
+                    return undefined;
+                caseParent = neutral;
+                pairs = [[left, right]];
+            }
+            const observed = owner.probe(caseParent, pairs);
+            if (!observed)
+                return undefined;
+            if (!observed.aliases)
+                return false;
+            next = observed.directory;
+        }
+        if (needsNormalization) {
+            const generated = normalizationProbePairs(left, right, forbidden, availableNameLength);
+            const first = generated.next();
+            let pairs;
+            let normalizationParent = probeParent;
+            // Fallback only when no generated pair exists, not when generated names collide.
+            if (first.done) {
+                const neutral = owner.neutral(probeParent, nameLength, forbidden);
+                if (!neutral)
+                    return undefined;
+                normalizationParent = neutral;
+                pairs = [[left, right]];
+            }
+            else {
+                pairs = prependPair(first.value, generated);
+            }
+            const observed = owner.probe(normalizationParent, pairs);
+            if (!observed)
+                return undefined;
+            if (!observed.aliases)
+                return false;
+            next ??= observed.directory;
+        }
+        if (index < leftSegments.length - 1) {
+            next ??= owner.neutral(probeParent, nameLength, forbidden);
+            if (!next)
+                return undefined;
+            probeParent = next;
+        }
+    }
+    return true;
+}
+/** Observe bounded missing suffix aliases; the caller owns caching and ambiguity policy. */
+export function probePathSuffixAliasesSync(options) {
+    const requestedDirectory = options.directory;
+    if (typeof requestedDirectory !== "string")
+        throw new TypeError("directory must be a string");
+    if (requestedDirectory.length > MAX_PATH_LENGTH)
+        throw new RangeError("directory exceeds 32768 code units");
+    if (requestedDirectory.includes("\0"))
+        throw new TypeError("directory must be a path without NUL bytes");
+    // Preserve one-argument Windows drive-relative resolution before reentrant option getters.
+    const directory = resolvePathPreservingWindowsRoot(requestedDirectory);
+    if (directory.length > MAX_PATH_LENGTH)
+        throw new RangeError("resolved directory exceeds 32768 code units");
+    const requestedMaxDepth = options.maxDepth;
+    const maxDepth = requestedMaxDepth === undefined ? MAX_SUFFIX_DEPTH : requestedMaxDepth;
+    if (!Number.isSafeInteger(maxDepth) || maxDepth < 0) {
+        throw new RangeError("maxDepth must be a non-negative safe integer");
+    }
+    const leftInput = options.left;
+    const rightInput = options.right;
+    const predicate = options.shouldProbeCaseVariants;
+    const left = suffixSegments(leftInput, maxDepth);
+    const right = suffixSegments(rightInput, maxDepth);
+    if (left.length !== right.length)
+        throw new TypeError("suffixes must have the same component count");
+    if (predicate !== undefined && typeof predicate !== "function") {
+        throw new TypeError("shouldProbeCaseVariants must be a function");
+    }
+    if (leftInput === rightInput)
+        return true;
+    let callbackFailure;
+    const shouldProbe = (first, second) => {
+        if (!predicate)
+            return true;
+        try {
+            const result = predicate(first, second);
+            if (typeof result !== "boolean") {
+                void Promise.resolve(result).catch(() => undefined);
+                throw new TypeError("shouldProbeCaseVariants must return a boolean synchronously");
+            }
+            return result;
+        }
+        catch (error) {
+            callbackFailure = { error };
+            throw error;
+        }
+    };
+    let owner;
+    let observed;
+    let cleaned = true;
+    try {
+        observed = observeSuffixes(() => owner ??= new ProbeDirectories(directory, left.length), left, right, shouldProbe);
+        owner?.assert(owner.root);
+    }
+    catch {
+        observed = undefined;
+        if (callbackFailure)
+            throw callbackFailure.error;
+    }
+    finally {
+        if (owner)
+            cleaned = owner.cleanup();
+    }
+    return cleaned ? observed : undefined;
+}

package/node_modules/@openclaw/fs-safe/dist/path.d.ts

@@ -18,4 +18,3 @@ export declare function isPathInsideWithRealpath(basePath: string, candidatePath
 export declare function safeStatSync(targetPath: string): fs.Stats | null;
 export declare function splitSafeRelativePath(relativePath: string): string[];
 export declare function resolveSafeRelativePath(rootDir: string, relativePath: string): string;
-//# sourceMappingURL=path.d.ts.map

package/node_modules/@openclaw/fs-safe/dist/path.js

@@ -1,7 +1,9 @@
 import fs from "node:fs";
 import path from "node:path";
 import { FsSafeError } from "./errors.js";
+import { realpathSync } from "./realpath.js";
 import { isDriveRelativePath } from "./safe-path-segment.js";
+import { assertNoWindowsPathAlias, hasWindowsPathAlias, pathForWindowsFilesystem, resolvePathFromBasePreservingWindowsRoot, resolvePathPreservingWindowsRoot, } from "./windows-path-alias.js";
 export { assertNoUnsafeDeviceReadPath, isUnsafeDeviceReadPath, matchUnsafeDeviceReadPath, } from "./device-path.js";
 const NOT_FOUND_CODES = new Set(["ENOENT", "ENOTDIR"]);
 const SYMLINK_OPEN_CODES = new Set(["ELOOP", "EINVAL", "ENOTSUP"]);
@@ -18,6 +20,14 @@ export function normalizeWindowsPathForComparison(input) {
     // whitespace is part of the path and must not be trimmed away.
     return normalized.replaceAll("/", "\\").toLowerCase();
 }
+function resolveWindowsPathForComparison(input) {
+    const resolved = path.win32.resolve(input);
+    // Ordinary drive paths are already normalized by resolve. Namespace paths
+    // retain Node's additional normalization rules before comparison.
+    return resolved[1] === ":" && path.win32.isAbsolute(resolved)
+        ? resolved.toLowerCase()
+        : normalizeWindowsPathForComparison(resolved.length === 6 ? resolvePathPreservingWindowsRoot(input) : resolved);
+}
 export function isNodeError(value) {
     return Boolean(value && typeof value === "object" && "code" in value);
 }
@@ -37,8 +47,18 @@ export function isSymlinkOpenError(value) {
 }
 export function isPathInside(root, target) {
     if (process.platform === "win32") {
-        const rootForCompare = normalizeWindowsPathForComparison(path.win32.resolve(root));
-        const targetForCompare = normalizeWindowsPathForComparison(path.win32.resolve(target));
+        const rootForCompare = resolveWindowsPathForComparison(root);
+        const targetForCompare = resolveWindowsPathForComparison(target);
+        // Resolved drive paths already have canonical separators and case. A full
+        // segment prefix needs no second resolution through path.relative.
+        // Colon-bearing components keep Node's relative-path interpretation.
+        if (rootForCompare[1] === ":" && path.win32.isAbsolute(rootForCompare) &&
+            !targetForCompare.includes(":", 2) &&
+            (targetForCompare === rootForCompare ||
+                (targetForCompare.startsWith(rootForCompare) &&
+                    (rootForCompare.endsWith("\\") || targetForCompare[rootForCompare.length] === "\\")))) {
+            return true;
+        }
         const relative = path.win32.relative(rootForCompare, targetForCompare);
         const firstSegment = relative.split(path.win32.sep)[0];
         return (relative === "" || (firstSegment !== ".." && !path.win32.isAbsolute(relative)));
@@ -49,7 +69,9 @@ export function isPathInside(root, target) {
         target.charCodeAt(0) === POSIX_SEPARATOR_CHAR_CODE &&
         !target.includes("/..") &&
         (target === root ||
-            (target.startsWith(root) && target.charCodeAt(root.length) === POSIX_SEPARATOR_CHAR_CODE))) {
+            (target.startsWith(root) &&
+                (root.charCodeAt(root.length - 1) === POSIX_SEPARATOR_CHAR_CODE ||
+                    target.charCodeAt(root.length) === POSIX_SEPARATOR_CHAR_CODE)))) {
         return true;
     }
     const resolvedRoot = path.resolve(root);
@@ -74,7 +96,7 @@ export function safeRealpathSync(targetPath, cache) {
         return cached;
     }
     try {
-        const resolved = fs.realpathSync(targetPath);
+        const resolved = realpathSync(pathForWindowsFilesystem(targetPath));
         cache?.set(targetPath, resolved);
         cache?.set(resolved, resolved);
         return resolved;
@@ -84,11 +106,19 @@ export function safeRealpathSync(targetPath, cache) {
     }
 }
 export function isPathInsideWithRealpath(basePath, candidatePath, opts) {
+    if (hasWindowsPathAlias(basePath, "filesystem") ||
+        hasWindowsPathAlias(candidatePath, "filesystem")) {
+        return false;
+    }
     if (!isPathInside(basePath, candidatePath)) {
         return false;
     }
     const baseReal = safeRealpathSync(basePath, opts?.cache);
     const candidateReal = safeRealpathSync(candidatePath, opts?.cache);
+    if ((baseReal !== null && hasWindowsPathAlias(baseReal, "filesystem")) ||
+        (candidateReal !== null && hasWindowsPathAlias(candidateReal, "filesystem"))) {
+        return false;
+    }
     if (!baseReal || !candidateReal) {
         return opts?.requireRealpath === false;
     }
@@ -96,7 +126,7 @@ export function isPathInsideWithRealpath(basePath, candidatePath, opts) {
 }
 export function safeStatSync(targetPath) {
     try {
-        return fs.statSync(targetPath);
+        return fs.statSync(pathForWindowsFilesystem(targetPath));
     }
     catch {
         return null;
@@ -124,11 +154,14 @@ export function splitSafeRelativePath(relativePath) {
             throw new FsSafeError("invalid-path", "relative path must not contain a drive letter");
         }
     }
+    assertNoWindowsPathAlias(relativePath, "relative", "relative path uses a Windows filesystem namespace alias");
     return segments;
 }
 export function resolveSafeRelativePath(rootDir, relativePath) {
-    const root = path.resolve(rootDir);
-    const target = path.resolve(root, ...splitSafeRelativePath(relativePath));
+    assertNoWindowsPathAlias(rootDir, "filesystem", "root dir uses a Windows filesystem namespace alias");
+    const root = resolvePathPreservingWindowsRoot(rootDir);
+    splitSafeRelativePath(relativePath);
+    const target = resolvePathFromBasePreservingWindowsRoot(root, relativePath);
     if (!isPathInside(root, target)) {
         throw new FsSafeError("outside-workspace", "relative path escapes root");
     }

package/node_modules/@openclaw/fs-safe/dist/permission-exec.d.ts

@@ -8,6 +8,8 @@ export type PermissionCommandFailure = {
     stderr: string;
 };
 export declare function formatPermissionErrorDetail(value: string): string;
+/** Formats only caught permission-query failures without invoking user code. */
+export declare function formatCaughtPermissionFailure(error: unknown): string;
 export declare class PermissionCommandError extends Error implements PermissionCommandFailure {
     readonly command: string;
     readonly durationMs: number;
@@ -22,4 +24,3 @@ export declare function executePermissionCommand(command: string, args: string[]
     stdout: string;
     stderr: string;
 }>;
-//# sourceMappingURL=permission-exec.d.ts.map