@struktoai/mirage-core/dist/vfs/ram/store.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. =========
/**
 * A RAM store's file table, keeping `held` equal to the bytes it holds, and
 * `usage.used` too when a capacity caps the store. Counting here, rather than
 * at each op, means no change to the table can miss the count; the
 * workspace's `max_memory` sums `held`. It refuses nothing: an op checks
 * growth with `checkCapacity` before it stores, in the same synchronous step.
 * Mirrors Python's `RAMFiles`.
 */
export class RAMFiles extends Map {
    usage;
    /** The bytes the table holds, which the workspace's `max_memory` sums. */
    held = 0;
    constructor(usage = null) {
        super();
        this.usage = usage;
    }
    count(delta) {
        this.held += delta;
        const usage = this.usage;
        if (usage !== null && usage.used !== null)
            usage.used += delta;
    }
    set(key, value) {
        this.count(value.byteLength - (this.get(key)?.byteLength ?? 0));
        return super.set(key, value);
    }
    delete(key) {
        this.count(-(this.get(key)?.byteLength ?? 0));
        return super.delete(key);
    }
    clear() {
        super.clear();
        this.held = 0;
        if (this.usage !== null)
            this.usage.used = 0;
    }
}
export class RAMStore {
    usage;
    files;
    dirs = new Set(['/']);
    modified = new Map();
    attrs = new Map();
    /** `usage` is the store's capacity and counted bytes, null when uncapped. */
    constructor(usage = null) {
        this.usage = usage;
        this.files = new RAMFiles(usage);
    }
}
//# sourceMappingURL=store.js.map