@struktoai/mirage-core/dist/core/chroma/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 { ListingCheckStore } from "../../cache/index/ram.js";
import { FileStat, FileType } from "../../types.js";
import { parent } from "../../utils/path.js";
import { treeStat } from "../slug_tree/stat.js";
import { treeKey } from "../slug_tree/tree.js";
import { ensureDirSizes } from "./sizes.js";
import { CHROMA_TREE } from "./tree.js";
import { rstripSlash, stripSlash } from "../../utils/slash.js";
/**
 * The row the collection's tree names at `path` now, null for none, kept with
 * its folder's rows in the check's own store, where a page is sized. Mirrors
 * Python's `_checked_row`.
 */
async function checkedRow(accessor, path, index) {
    const key = treeKey(path);
    const cut = key.lastIndexOf('/');
    const name = key.slice(cut + 1);
    const rows = (await CHROMA_TREE.load(accessor)).get(key.slice(0, cut) || '/') ?? [];
    await index.setDir(parent(rstripSlash(path.virtual)), rows.map((row) => [row.name, row]));
    return rows.find((row) => row.name === name) ?? null;
}
/**
 * Stat a path, sizing a page its listing left unsized. A fresh check is
 * handed no row, so it reads the path's row from the tree.
 */
export async function stat(accessor, path, entry = null, index) {
    if (entry === null && index instanceof ListingCheckStore && stripSlash(path.mountPath) !== '') {
        entry = await checkedRow(accessor, path, index);
    }
    const row = treeStat(path, entry);
    if (row.type !== FileType.FILE || row.size !== null || index === undefined)
        return row;
    // One scan for the whole directory, paid the first time anything in it is
    // stat'd; later stats of its siblings are already sized.
    const key = rstripSlash(path.virtual);
    await ensureDirSizes(accessor, parent(key), index);
    const sized = (await index.get(key)).entry;
    return sized instanceof FileStat ? sized : row;
}
//# sourceMappingURL=stat.js.map