@struktoai/mirage-core/dist/core/hierarchy/probe.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 { DirListing, FileType, PathSpec } from "../../types.js";
import { eisdir, enoent } from "../../errors/fs.js";
import { mountKey, mountPrefixOf, mountedPath } from "../../utils/key_prefix.js";
import { rstripSlash, stripSlash } from "../../utils/slash.js";
/** The PathSpec of the directory holding `path`, on the same mount. */
export function parentSpec(path) {
    const prefix = mountPrefixOf(path.virtual, path.vfsPath);
    const virtual = rstripSlash(path.virtual);
    const parentVirtual = virtual.slice(0, virtual.lastIndexOf('/')) || '/';
    return new PathSpec({
        virtual: parentVirtual,
        directory: parentVirtual,
        resolved: false,
        vfsPath: mountKey(parentVirtual, prefix),
    });
}
/** The listed directory's own children, whichever shape listed them. */
export function rowsOf(listed) {
    return listed instanceof DirListing ? listed.entries : listed;
}
/**
 * What is at the file `path`, as its parent's listing named it. Throws ENOENT
 * when nothing is there and EISDIR when a folder is. Mirrors Python's
 * `file_entry`.
 */
export function fileEntry(path, entry) {
    if (stripSlash(path.mountPath) === '')
        throw eisdir(path.virtual);
    if (entry === null || entry === undefined)
        throw enoent(path.virtual);
    if (entry.type === FileType.DIRECTORY)
        throw eisdir(path.virtual);
    return entry;
}
/**
 * What is at `path` and at its parent, as each level's listing names it,
 * listed from the mount root down: a walk that starts below the root hands
 * its first directory these. The mount root is no listing's child, so it
 * answers nothing; a name a level does not list answers no row at `path`.
 * Mirrors Python's `row_at`.
 */
export async function rowAt(readdir, accessor, path) {
    const key = stripSlash(path.mountPath);
    let entry = null;
    let parent = null;
    let current = mountedPath(path, '/');
    for (const name of key !== '' ? key.split('/') : []) {
        const listed = rowsOf(await readdir(accessor, current, entry, parent));
        const row = listed.find((one) => one.name === name) ?? null;
        if (row === null)
            return [null, entry];
        parent = entry;
        entry = row;
        current = mountedPath(path, `${rstripSlash(current.mountPath)}/${name}`);
    }
    return [entry, parent];
}
//# sourceMappingURL=probe.js.map