@struktoai/mirage-core/dist/cache/versions.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 { OpRecord } from "../observe/record.js";
import { CONTENT_CHANGING_OPS, REMOVAL_OPS, RETRACT_FINGERPRINT_OPS, STAMP_FINGERPRINT_OPS, SUBTREE_RETRACT_OPS, } from "../observe/record.js";
import { underPath } from "../utils/key_prefix.js";
import { OwnRead } from "./types.js";
/** Identity of one live mount; never persisted. */
export class VersionScope {
    pins = new Map();
}
/** A live session's observations, independent of shared cache eviction. */
export class VersionHistory {
    scopes = new WeakMap();
    /**
     * Return the token observed for this mount-relative key, ABSENT when the
     * session last found no file there.
     */
    read(scope, key) {
        const entries = this.scopes.get(scope);
        const held = entries?.has(key) === true ? entries.get(key) : scope.pins.get(key);
        return held instanceof OpRecord ? held.fingerprint : (held ?? null);
    }
    /** Retain a refused condition, or a miss, until this session reads again. */
    keep(scope, key, version) {
        const held = this.scopes.get(scope) ?? new Map();
        held.set(key, version);
        this.scopes.set(scope, held);
    }
    /** Keep the exact record, including a stream's later token stamp. */
    observe(scope, key, rec) {
        if (rec.op === 'read' && !rec.complete && (rec.bytes === 0 || rec.fingerprint === null))
            return;
        if (!STAMP_FINGERPRINT_OPS.has(rec.op) &&
            !RETRACT_FINGERPRINT_OPS.has(rec.op) &&
            !CONTENT_CHANGING_OPS.has(rec.op))
            return;
        const held = this.scopes.get(scope) ?? new Map();
        const left = REMOVAL_OPS.has(rec.op) ? OwnRead.ABSENT : null;
        if (SUBTREE_RETRACT_OPS.has(rec.op)) {
            for (const name of new Set([...held.keys(), ...scope.pins.keys()]))
                if (underPath(name, key))
                    held.set(name, left);
        }
        if (STAMP_FINGERPRINT_OPS.has(rec.op))
            held.set(key, rec);
        else
            held.set(key, left);
        this.scopes.set(scope, held);
    }
}
//# sourceMappingURL=versions.js.map