@struktoai/mirage-core/dist/core/dev/stat.js

A Unified Virtual Filesystem For AI Agents

// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
import { lookupError } from "../ram/dest.js";
import { keyStat as ramKeyStat } from "../ram/stat.js";
import { gnuBasename, norm } from "../../utils/path.js";
import { DEVICE_NUMBERS_KEY, FileStat, FileType } from "../../types.js";
import { FIFO_MODE } from "../../utils/stat_view.js";
import { DEV_RDEV } from "./constants.js";
import { activeDevice, activePipe } from "./device.js";
/**
 * What `stat` answers for the normalized key `key`, null when nothing is
 * there. Mirrors Python's `key_stat`.
 */
export function keyStat(accessor, key) {
    const attrs = accessor.store.attrs.get(key) ?? {};
    if (activePipe(accessor, key) !== null) {
        return new FileStat({
            name: gnuBasename(key),
            size: null,
            modified: accessor.store.modified.get(key) ?? null,
            type: FileType.FIFO,
            mode: attrs.mode ?? FIFO_MODE & 0o7777,
            uid: attrs.uid ?? null,
            gid: attrs.gid ?? null,
            atime: attrs.atime ?? null,
        });
    }
    const device = activeDevice(accessor, key);
    const numbers = device === null ? undefined : DEV_RDEV[device];
    if (numbers === undefined)
        return ramKeyStat(accessor.store, key);
    return new FileStat({
        name: gnuBasename(key),
        size: null,
        modified: accessor.store.modified.get(key) ?? null,
        type: FileType.CHAR_DEVICE,
        mode: attrs.mode ?? null,
        uid: attrs.uid ?? null,
        gid: attrs.gid ?? null,
        atime: attrs.atime ?? null,
        extra: { [DEVICE_NUMBERS_KEY]: numbers },
    });
}
/**
 * Stat a /dev path: a FIFO for a live descriptor, a char device for an
 * active synthetic name, otherwise the ordinary RAM stat (a recreated real
 * file, or a dir). Neither has rendered content, so the size is null; a
 * device's identity is the [major, minor] under DEVICE_NUMBERS_KEY. Both
 * carry the stored mode, owner and times; a FIFO without a mode is
 * rw-------. Mirrors Python's dev stat.
 */
export function stat(accessor, path) {
    const key = norm(path.mountPath);
    const found = keyStat(accessor, key);
    if (found === null)
        throw lookupError(accessor, path, key);
    return Promise.resolve(found);
}
//# sourceMappingURL=stat.js.map