@struktoai/mirage-core/dist/observe/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. =========
/**
 * Shared ObserverStore behavior.
 *
 * Implementations only provide `append`/`write`/`readMatching`/`clear`;
 * `readAll` is reading with the empty suffix (every key matches), and
 * `close` defaults to a no-op for stores that hold no connections.
 * Mirrors Python `ObserverStoreBase`.
 */
export class ObserverStoreBase {
    readAll() {
        return this.readMatching('');
    }
    close() {
        return Promise.resolve();
    }
}
/** In-memory ObserverStore backed by a Map (the default). */
export class RAMObserverStore extends ObserverStoreBase {
    files = new Map();
    // Each file's buffer with room to grow: `files` holds the written prefix
    // of it, so an append copies only its own bytes, as Python's bytearray
    // does. Copying the whole log on every append made a long session's
    // ops quadratic.
    room = new Map();
    append(path, data) {
        const existing = this.files.get(path) ?? new Uint8Array(0);
        const size = existing.byteLength + data.byteLength;
        let room = this.room.get(path);
        // A file set through `write` or `files` is not the prefix of its room.
        const prefix = room?.buffer === existing.buffer && existing.byteOffset === 0;
        if (room === undefined || !prefix || room.byteLength < size) {
            const grown = new Uint8Array(Math.max(size, 2 * existing.byteLength));
            grown.set(existing);
            room = grown;
            this.room.set(path, room);
        }
        room.set(data, existing.byteLength);
        this.files.set(path, room.subarray(0, size));
        return Promise.resolve();
    }
    write(path, data) {
        this.files.set(path, data);
        this.room.delete(path);
        return Promise.resolve();
    }
    readMatching(suffix) {
        const out = new Map();
        for (const [k, v] of this.files) {
            if (k.endsWith(suffix))
                out.set(k, v);
        }
        return Promise.resolve(out);
    }
    clear() {
        this.files.clear();
        this.room.clear();
        return Promise.resolve();
    }
}
//# sourceMappingURL=store.js.map