@laserdata/laser-sdk 0.5.3 → 0.6.0

package/dist/memory/handle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../src/memory/handle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../src/memory/handle.ts"],"names":[],"mappings":"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"}

package/dist/memory/handle.js

@@ -1,108 +1,222 @@
+import { InvalidError, UnsupportedError } from "../client/errors.js";
+import { ConversationId } from "../types/ids.js";
 import { LogMemory } from "./log-memory.js";
 import { Lifetime, MemoryId, MemoryKind, RecallStrategy, toContextBlock } from "./types.js";
-import { VectorMemory } from "./vector-memory.js";
+import { VectorMemory, WITH_EMBEDDER } from "./vector-memory.js";
+// How many items one consolidation pass recalls and operates over.
+const CONSOLIDATION_WINDOW = 10_000;
 export const MemoryBackend = { Auto: "auto", Log: "log", Vector: "vector" };
 export class MemoryHandle {
-    backend;
-    constructor(backend) {
-        this.backend = backend;
+    store;
+    constructor(store) {
+        this.store = store;
     }
+    /** @internal */
+    static create(store) {
+        return new MemoryHandle(store);
+    }
+    /** Which backend this handle resolved to: `log` for the durable stream
+     * model, `vector` for the in-process similarity index, `custom` for a
+     * caller-supplied backend. A reranked handle reports its inner backend. */
+    get backend() {
+        return backendKindOf(this.store);
+    }
+    /** @internal */
     static log(laser, namespace) {
         return new MemoryHandle(new LogMemory(laser, namespace));
     }
-    /** Opens durable memory on a caller-named topic. */
+    /** @internal */
     static logTopic(laser, topic, stream) {
         return new MemoryHandle(new LogMemory(laser, topic, topic, stream));
     }
+    /** A standalone in-process vector handle over `embedder`, with no `Laser`
+     * and no governance. */
     static vector(embedder) {
         return new MemoryHandle(new VectorMemory(embedder));
     }
+    /** @internal */
     static governedVector(laser, embedder) {
         return new MemoryHandle(VectorMemory.governed(laser, embedder));
     }
+    /** @internal */
     static custom(memory) {
-        return new MemoryHandle(memory);
+        const append = memory.append?.bind(memory);
+        return new MemoryHandle({
+            ...(append === undefined ? {} : { append }),
+            remember: (scope, payload) => memory.remember(scope, payload),
+            recall: (scope, query) => memory.recall(scope, query),
+            improve: (scope, feedback) => memory.improve(scope, feedback),
+            forget: (scope, id) => memory.forget(scope, id)
+        });
     }
     remember(scopeOrPayload, payload) {
         if (scopeOrPayload instanceof Uint8Array)
-            return new RememberBuilder(this, scopeOrPayload);
-        return this.backend.remember(scopeOrPayload, required(payload));
+            return RememberBuilder.create(this, scopeOrPayload);
+        return this.store.remember(scopeOrPayload, required(payload));
     }
     recall(scope, query) {
         if (scope === undefined)
-            return new RecallBuilder(this);
-        return this.backend.recall(scope, query ?? {});
+            return RecallBuilder.create(this);
+        if (scope instanceof ConversationId)
+            return RecallBuilder.create(this, scope);
+        return this.store.recall(scope, query ?? {});
     }
     /** Recall by folding the memory topic in process instead of reading the
      * managed view. The log backend folds, the vector backend is already in
      * process, and a reranked backend folds its inner backend then reranks. */
     recallFolded(scope, query) {
-        return recallFoldedOn(this.backend, scope, query);
+        return recallFoldedOn(this.store, scope, query);
     }
+    /** Records `feedback` on the item it targets. The built-in backends address
+     * the item by id alone, and `scope` only stamps the feedback record's
+     * provenance. */
     improve(scope, feedback) {
-        return this.backend.improve(scope, feedback);
+        return this.store.improve(scope, feedback);
     }
+    /** Forgets the item `id`. The built-in backends address the item by id
+     * alone, so an item remembered under another scope is forgotten too, and
+     * `scope` only stamps the tombstone's provenance. */
     forget(scope, id) {
-        return this.backend.forget(scope, id);
+        return this.store.forget(scope, id);
     }
     async context(scope, query = {}) {
-        return toContextBlock(await this.backend.recall(scope, query), query.tokenBudget);
-    }
-    async consolidate(scope, maxItems) {
-        const items = await this.backend.recall(scope, {
-            limit: 10_000,
-            strategy: RecallStrategy.Recent
-        });
-        const stale = items.slice(Math.max(0, maxItems));
-        for (const item of stale)
-            await this.backend.forget(scope, item.id);
-        return { scanned: items.length, kept: items.length - stale.length, forgotten: stale.length };
+        return toContextBlock(await this.store.recall(scope, query), query.tokenBudget);
+    }
+    /** One consolidation pass over `scope`: keeps the newest `maxItems` and
+     * forgets the rest. With a `summarizer`, the `message` items are first folded
+     * into one durable summary per conversation, stored under `scope` narrowed
+     * to that conversation, and `pruneSummarized` forgets the folded items. */
+    async consolidate(scope, maxItems, options = {}) {
+        if (!Number.isSafeInteger(maxItems) || maxItems < 0)
+            throw new InvalidError("consolidation maxItems must be a non-negative safe integer");
+        const items = await this.store.recall(scope, { limit: CONSOLIDATION_WINDOW });
+        let remaining = items;
+        let summarized = 0;
+        let pruned = 0;
+        if (options.summarizer !== undefined) {
+            const sessions = items.filter((item) => item.kind === MemoryKind.Message);
+            if (sessions.length > 0) {
+                // One summary per conversation, so each stays recallable in the
+                // conversation it distills.
+                for (const [conversation, turns] of byConversation(sessions)) {
+                    const summary = await options.summarizer.summarize(turns.map((item) => item.payload.slice()));
+                    await appendOn(this.store, { ...scope, conversation, lifetime: Lifetime.Durable }, MemoryId.new(), MemoryKind.Summary, summary);
+                }
+                summarized = sessions.length;
+                if (options.pruneSummarized === true) {
+                    for (const item of sessions) {
+                        try {
+                            await this.store.forget(scope, item.id);
+                            pruned += 1;
+                        }
+                        catch {
+                            // Failed forgets stay outside the successful prune count.
+                        }
+                    }
+                    remaining = items.filter((item) => item.kind !== MemoryKind.Message);
+                }
+            }
+        }
+        const oldestFirst = [...remaining].sort((left, right) => left.id.asU128() < right.id.asU128() ? -1 : left.id.asU128() > right.id.asU128() ? 1 : 0);
+        for (const item of oldestFirst.slice(0, Math.max(0, oldestFirst.length - maxItems))) {
+            try {
+                await this.store.forget(scope, item.id);
+                pruned += 1;
+            }
+            catch {
+                // Failed forgets stay outside the successful prune count.
+            }
+        }
+        return { summarized, reweighted: 0, pruned, derived: 0 };
     }
     reranker(reranker) {
-        return new MemoryHandle(new RerankedMemory(this.backend, reranker));
-    }
+        return new MemoryHandle(new RerankedMemory(this.store, reranker));
+    }
+    /** Registers the embedding seam for similarity recall. It configures the
+     * in-process vector index, so a vector handle starts a fresh index over
+     * `embedder` with the same governance. The durable log model recalls by
+     * recency and a custom backend owns its retrieval, so both are returned
+     * unchanged. */
+    embedder(embedder) {
+        const store = withEmbedder(this.store, embedder);
+        return store === this.store ? this : new MemoryHandle(store);
+    }
+    /** @internal */
     logBackend() {
-        return this.backend instanceof LogMemory ? this.backend : undefined;
+        return namedMemoryOf(this.store);
+    }
+    /** Writes named point state under your own `key`. Every write is a durable
+     * event on the memory topic. Only the log-backed handle has a key space, so
+     * the vector handle refuses with `UnsupportedError`. */
+    set(key, payload) {
+        return this.namedMemory("set").setNamed(key, payload);
+    }
+    /** Point-reads the named item written by `set`, from the managed key-value
+     * view, or `undefined`. */
+    fetch(key) {
+        return this.namedMemory("fetch").fetchNamed(key);
+    }
+    /** Point-reads the named item by folding the memory topic in process. */
+    fetchFolded(key) {
+        return this.namedMemory("fetchFolded").fetchNamedFolded(key);
+    }
+    /** Merge-patches the named item (RFC 7386 over a JSON value): fields in
+     * `patch` overwrite, `null` removes. */
+    update(key, patch) {
+        return this.namedMemory("update").updateNamed(key, patch);
+    }
+    /** Deletes the named item. Removing an absent key is fine. */
+    remove(key) {
+        return this.namedMemory("remove").forgetNamed(key);
+    }
+    namedMemory(verb) {
+        const memory = namedMemoryOf(this.store);
+        if (memory === undefined) {
+            throw new UnsupportedError(`${verb}(key) is the named-item altitude and needs the durable memory handle`, { cause: { surface: "memory" } });
+        }
+        return memory;
     }
     append(scope, id, kind, payload) {
-        if (this.backend instanceof VectorMemory || this.backend instanceof LogMemory) {
-            return this.backend.append(scope, id, kind, payload);
-        }
-        return this.backend.remember(scope, payload);
+        return appendOn(this.store, scope, id, kind, payload);
     }
 }
 export class RememberBuilder {
     handle;
     payload;
-    scope = {};
+    memoryScope = {};
     memoryKind = MemoryKind.Fact;
     deduplicate = false;
     constructor(handle, payload) {
         this.handle = handle;
         this.payload = payload;
     }
-    conversation(conversation) {
-        this.scope = { ...this.scope, conversation };
+    /** @internal */
+    static create(handle, payload) {
+        return new RememberBuilder(handle, payload);
+    }
+    /** Scopes the item to a conversation. */
+    scope(conversation) {
+        this.memoryScope = { ...this.memoryScope, conversation };
         return this;
     }
     user(user) {
-        this.scope = { ...this.scope, user };
+        this.memoryScope = { ...this.memoryScope, user };
         return this;
     }
     agent(agent) {
-        this.scope = { ...this.scope, agent };
+        this.memoryScope = { ...this.memoryScope, agent };
         return this;
     }
     application(application) {
-        this.scope = { ...this.scope, application };
+        this.memoryScope = { ...this.memoryScope, app: application };
         return this;
     }
     stream(stream) {
-        this.scope = { ...this.scope, stream };
+        this.memoryScope = { ...this.memoryScope, stream };
         return this;
     }
     durable() {
-        this.scope = { ...this.scope, lifetime: Lifetime.Durable };
+        this.memoryScope = { ...this.memoryScope, lifetime: Lifetime.Durable };
         return this;
     }
     kind(kind) {
@@ -115,9 +229,9 @@ export class RememberBuilder {
     }
     send() {
         const id = this.deduplicate
-            ? MemoryId.content(this.scope, this.memoryKind, this.payload)
+            ? MemoryId.content(this.memoryScope, this.memoryKind, this.payload)
             : MemoryId.new();
-        return this.handle.append(this.scope, id, this.memoryKind, this.payload);
+        return this.handle.append(this.memoryScope, id, this.memoryKind, this.payload);
     }
 }
 export class RecallBuilder {
@@ -125,12 +239,14 @@ export class RecallBuilder {
     scope = {};
     query = {};
     foldInProcess = false;
-    constructor(handle) {
+    constructor(handle, conversation) {
         this.handle = handle;
+        if (conversation !== undefined)
+            this.scope = { conversation };
     }
-    conversation(conversation) {
-        this.scope = { ...this.scope, conversation };
-        return this;
+    /** @internal */
+    static create(handle, conversation) {
+        return new RecallBuilder(handle, conversation);
     }
     user(user) {
         this.scope = { ...this.scope, user };
@@ -141,7 +257,7 @@ export class RecallBuilder {
         return this;
     }
     application(application) {
-        this.scope = { ...this.scope, application };
+        this.scope = { ...this.scope, app: application };
         return this;
     }
     stream(stream) {
@@ -172,10 +288,6 @@ export class RecallBuilder {
         this.query = { ...this.query, limit };
         return this;
     }
-    tokenBudget(tokenBudget) {
-        this.query = { ...this.query, tokenBudget };
-        return this;
-    }
     /** Fold the memory topic in process instead of reading the managed key-value
      * view, for a deployment that materializes no read view. */
     folded() {
@@ -187,8 +299,10 @@ export class RecallBuilder {
             ? this.handle.recallFolded(this.scope, this.query)
             : this.handle.recall(this.scope, this.query);
     }
-    async block() {
-        return toContextBlock(await this.fetch(), this.query.tokenBudget);
+    /** Runs the recall and renders the items as one prompt-ready block under
+     * `tokenBudget` estimated tokens when given. */
+    async block(tokenBudget) {
+        return toContextBlock(await this.fetch(), tokenBudget);
     }
 }
 // The fold dispatch, mirroring Rust's `recall_folded`: the log backend folds its
@@ -197,24 +311,71 @@ export class RecallBuilder {
 async function recallFoldedOn(backend, scope, query) {
     if (backend instanceof LogMemory)
         return backend.recallFolded(scope, query);
-    if (backend instanceof RerankedMemory)
-        return backend.recallFolded(scope, query);
+    if (backend instanceof RerankedMemory) {
+        const { inner, reranker } = backend[RERANKED]();
+        const items = await recallFoldedOn(inner, scope, query);
+        return query.semantic === undefined ? items : reranker.rerank(query.semantic, items);
+    }
     return backend.recall(scope, query);
 }
-class RerankedMemory {
+function appendOn(memory, scope, id, kind, payload) {
+    if (memory instanceof VectorMemory || memory instanceof LogMemory)
+        return memory.append(scope, id, kind, payload);
+    if (memory instanceof RerankedMemory)
+        return memory.append(scope, id, kind, payload);
+    return memory.append?.(scope, id, kind, payload) ?? memory.remember(scope, payload);
+}
+// Groups summarized turns by conversation, in the order each conversation first
+// appears in the recall, keeping each group's recall order.
+function byConversation(items) {
+    const groups = new Map();
+    for (const item of items) {
+        const conversation = item.provenance.conversationId;
+        const group = groups.get(conversation.toString());
+        if (group === undefined)
+            groups.set(conversation.toString(), [conversation, [item]]);
+        else
+            group[1].push(item);
+    }
+    return [...groups.values()];
+}
+function namedMemoryOf(memory) {
+    if (memory instanceof LogMemory)
+        return memory;
+    return memory instanceof RerankedMemory ? namedMemoryOf(memory[RERANKED]().inner) : undefined;
+}
+function backendKindOf(memory) {
+    if (memory instanceof LogMemory)
+        return "log";
+    if (memory instanceof VectorMemory)
+        return "vector";
+    if (memory instanceof RerankedMemory)
+        return backendKindOf(memory[RERANKED]().inner);
+    return "custom";
+}
+// The wrapped backend and the rerank stage, read by the handle's fold, append,
+// and backend dispatch.
+const RERANKED = Symbol("laser.internal.reranked");
+/** Wraps any {@link Memory} with a {@link Reranker} second stage: `recall` runs
+ * the inner backend's retrieval, then reorders the candidates through the
+ * reranker when the query carries a `semantic` string. `remember`, `append`,
+ * `improve`, and `forget` delegate unchanged. */
+export class RerankedMemory {
     inner;
     reranker;
     constructor(inner, reranker) {
         this.inner = inner;
         this.reranker = reranker;
     }
-    async recallFolded(scope, query) {
-        const items = await recallFoldedOn(this.inner, scope, query);
-        return query.semantic === undefined ? items : this.reranker.rerank(query.semantic, items);
+    [RERANKED]() {
+        return { inner: this.inner, reranker: this.reranker };
     }
     remember(scope, payload) {
         return this.inner.remember(scope, payload);
     }
+    append(scope, id, kind, payload) {
+        return appendOn(this.inner, scope, id, kind, payload);
+    }
     async recall(scope, query) {
         const items = await this.inner.recall(scope, query);
         return query.semantic === undefined ? items : this.reranker.rerank(query.semantic, items);
@@ -226,6 +387,19 @@ class RerankedMemory {
         return this.inner.forget(scope, id);
     }
 }
+// The embedder dispatch, mirroring Rust: a vector backend rebuilds over the new
+// embedder, a reranked backend reconfigures its inner backend, and the log and
+// custom backends ignore it.
+function withEmbedder(memory, embedder) {
+    if (memory instanceof VectorMemory)
+        return memory[WITH_EMBEDDER](embedder);
+    if (memory instanceof RerankedMemory) {
+        const { inner, reranker } = memory[RERANKED]();
+        const configured = withEmbedder(inner, embedder);
+        return configured === inner ? memory : new RerankedMemory(configured, reranker);
+    }
+    return memory;
+}
 function required(payload) {
     if (payload === undefined)
         throw new TypeError("memory payload is required");

package/dist/memory/handle.js.map

@@ -1 +1 @@
-{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../src/memory/handle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../src/memory/handle.ts"],"names":[],"mappings":"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"}

package/dist/memory/log-memory.d.ts

@@ -2,15 +2,15 @@ import type { Laser } from "../client/laser.js";
 import { MemoryId, MemoryKind, type Feedback, type Memory, type MemoryItem, type MemoryQuery, type MemoryScope } from "./types.js";
 export declare class LogMemory implements Memory {
     private readonly laser;
-    readonly namespace: string;
-    readonly topic: string;
-    readonly stream: string | undefined;
     private readonly items;
     private readonly forgotten;
+    private readonly feedback;
     private readonly named;
     private readonly offsets;
-    private sequence;
-    constructor(laser: Laser, namespace: string, topic?: string, stream?: string | undefined);
+    private readonly fold;
+    /** A log-backed memory on `topic` (the audit topic by default). The named
+     * items key on `namespace`, which defaults to the topic's name. */
+    constructor(laser: Laser, namespace?: string, topic?: string, stream?: string | undefined);
     remember(scope: MemoryScope, payload: Uint8Array): Promise<MemoryId>;
     append(scope: MemoryScope, id: MemoryId, kind: MemoryKind, payload: Uint8Array): Promise<MemoryId>;
     /** Reads the managed key-value view the deployment materializes from the
@@ -18,19 +18,31 @@ export declare class LogMemory implements Memory {
      * opt-in {@link LogMemory.recallFolded}, never the default, matching Rust and Python. */
     recall(scope: MemoryScope, query: MemoryQuery): Promise<readonly MemoryItem[]>;
     /** Recall by folding the memory topic in process, the opt-in path for a small
-     * deployment with no materialized read view. */
+     * deployment with no materialized read view. Items come newest first.
+     * Feedback reorders every strategy except `Recent`, and its signal carries
+     * `RecallStrategy.Auto`. */
     recallFolded(scope: MemoryScope, query: MemoryQuery): Promise<readonly MemoryItem[]>;
     improve(scope: MemoryScope, feedback: Feedback): Promise<MemoryId>;
     forget(scope: MemoryScope, id: MemoryId): Promise<void>;
-    set(key: string, payload: Uint8Array): Promise<void>;
+    /** Writes named point state: a keyed item on the topic, reflected in the
+     * fold for read-your-writes. */
+    setNamed(key: string, payload: Uint8Array): Promise<void>;
     /** Reads named point state from the managed key-value view, like {@link LogMemory.recall}.
-     * Folding the topic is the opt-in {@link LogMemory.fetchFolded}. */
-    fetch(key: string): Promise<Uint8Array | undefined>;
-    fetchFolded(key: string): Promise<Uint8Array | undefined>;
-    update(key: string, patch: Uint8Array): Promise<void>;
-    remove(key: string): Promise<void>;
+     * Folding the topic is the opt-in {@link LogMemory.fetchNamedFolded}. */
+    fetchNamed(key: string): Promise<Uint8Array | undefined>;
+    /** Reads named point state by folding the topic in process. */
+    fetchNamedFolded(key: string): Promise<Uint8Array | undefined>;
+    /** Merge-patches the named item (RFC 7386). A patch or a stored value that
+     * is not JSON throws `CodecError`. */
+    updateNamed(key: string, patch: Uint8Array): Promise<void>;
+    /** Deletes named point state with a keyed tombstone. */
+    forgetNamed(key: string): Promise<void>;
     private publish;
+    private target;
+    private govern;
+    private send;
     private catchUp;
+    private drain;
     private absorb;
     private namedKey;
     private requireStream;

package/dist/memory/log-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-memory.d.ts","sourceRoot":"","sources":["../../src/memory/log-memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAW/C,OAAO,EACL,QAAQ,EACR,UAAU,EAEV,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,YAAY,CAAA;AASnB,qBAAa,SAAU,YAAW,MAAM;IAQpC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAVrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAI;IAEpB,YACmB,KAAK,EAAE,KAAK,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAyB,EAChC,MAAM,GAAE,MAAM,GAAG,SAA+B,EACvD;IAEE,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEzE;IAEK,MAAM,CACV,KAAK,EAAE,WAAW,EAClB,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,QAAQ,CAAC,CAQnB;IAED;;6FAEyF;IACnF,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAmBnF;IAED;oDACgD;IAC1C,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAczF;IAEK,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQvE;IAEK,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;IAEK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CASzD;IAED;wEACoE;IAC9D,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAExD;IAEK,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAG9D;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1D;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvC;YAEa,OAAO;YAoCP,OAAO;IAqCrB,OAAO,CAAC,MAAM;IAyDd,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,aAAa;CAMtB"}
+{"version":3,"file":"log-memory.d.ts","sourceRoot":"","sources":["../../src/memory/log-memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAiB/C,OAAO,EACL,QAAQ,EACR,UAAU,EAEV,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,YAAY,CAAA;AAiBnB,qBAAa,SAAU,YAAW,MAAM;IAoBpC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAnBxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAG9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IASnC;uEACmE;IACnE,YACmB,KAAK,EAAE,KAAK,EAC7B,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,GAAE,MAAyB,EAChC,MAAM,GAAE,MAAM,GAAG,SAA+B,EAKjD;IAEK,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEzE;IAEK,MAAM,CACV,KAAK,EAAE,WAAW,EAClB,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,QAAQ,CAAC,CAUnB;IAED;;6FAEyF;IACnF,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CA4CnF;IAED;;;gCAG4B;IACtB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAwBzF;IAEK,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQvE;IAEK,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;IAED;oCACgC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9D;IAED;6EACyE;IACnE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAE7D;IAED,+DAA+D;IACzD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAGnE;IAED;0CACsC;IAChC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/D;IAED,wDAAwD;IAClD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5C;YAEa,OAAO;IAUrB,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,MAAM;YAYA,IAAI;IAsBlB,OAAO,CAAC,OAAO;YAID,KAAK;IA+CnB,OAAO,CAAC,MAAM;IAyDd,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,aAAa;CAMtB"}