beeai-framework 0.1.2

package/dist/logger/pretty.d.cts

@@ -0,0 +1,5 @@
+import pinoPretty from 'pino-pretty';
+
+declare function _default(opts: any): pinoPretty.PrettyStream;
+
+export { _default as default };

package/dist/logger/pretty.d.ts

@@ -0,0 +1,5 @@
+import pinoPretty from 'pino-pretty';
+
+declare function _default(opts: any): pinoPretty.PrettyStream;
+
+export { _default as default };

package/dist/logger/pretty.js

@@ -0,0 +1,72 @@
+import pinoPretty from 'pino-pretty';
+import picocolors from 'picocolors';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const compose = /* @__PURE__ */ __name((...fns) => (value) => fns.reduce((res, f) => f(res), value), "compose");
+var pretty_default = /* @__PURE__ */ __name((opts) => {
+  return pinoPretty({
+    colorize: true,
+    colorizeObjects: true,
+    singleLine: true,
+    hideObject: false,
+    sync: true,
+    levelFirst: true,
+    ...opts,
+    translateTime: "HH:MM:ss",
+    customPrettifiers: {
+      level: (() => {
+        const levels = {
+          TRACE: {
+            letters: "TRC",
+            icon: "\u{1F50E}",
+            formatter: picocolors.gray
+          },
+          DEBUG: {
+            letters: "DBG",
+            icon: "\u{1FAB2}",
+            formatter: picocolors.yellow
+          },
+          INFO: {
+            letters: "INF",
+            icon: "\u2139\uFE0F",
+            formatter: picocolors.green
+          },
+          WARN: {
+            letters: "WRN",
+            icon: "\u26A0\uFE0F",
+            formatter: picocolors.yellow
+          },
+          ERROR: {
+            letters: "ERR",
+            icon: "\u{1F525}",
+            formatter: picocolors.red
+          },
+          FATAL: {
+            letters: "FTL",
+            icon: "\u{1F4A3}",
+            formatter: compose(picocolors.black, picocolors.bgRed)
+          }
+        };
+        const fallback = {
+          letters: "???",
+          icon: "\u{1F937}\u200D",
+          formatter: picocolors.gray
+        };
+        return (logLevel) => {
+          const target = levels[logLevel] || fallback;
+          return `${target.formatter(target.letters)}  ${target.icon} `;
+        };
+      })(),
+      time: /* @__PURE__ */ __name((timestamp) => picocolors.dim(timestamp), "time"),
+      caller: /* @__PURE__ */ __name((caller, key, log, { colors }) => `${colors.greenBright(caller)}`, "caller")
+    },
+    messageFormat: /* @__PURE__ */ __name((log, messageKey) => {
+      return `${log[messageKey]}`;
+    }, "messageFormat")
+  });
+}, "default");
+
+export { pretty_default as default };
+//# sourceMappingURL=pretty.js.map
+//# sourceMappingURL=pretty.js.map

package/dist/logger/pretty.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/logger/pretty.js"],"names":["compose","fns","value","reduce","res","f","opts","pinoPretty","colorize","colorizeObjects","singleLine","hideObject","sync","levelFirst","translateTime","customPrettifiers","level","levels","TRACE","letters","icon","formatter","picocolors","gray","DEBUG","yellow","INFO","green","WARN","ERROR","red","FATAL","black","bgRed","fallback","logLevel","target","time","timestamp","dim","caller","key","log","colors","greenBright","messageFormat","messageKey"],"mappings":";;;;;AAmBA,MAAMA,OACJ,mBAAA,MAAA,CAAA,CAAA,GAAIC,GACJ,KAAA,CAACC,UACCD,GAAIE,CAAAA,MAAAA,CAAO,CAACC,GAAAA,EAAKC,CAAMA,KAAAA,CAAAA,CAAED,GAAAA,CAAAA,EAAMF,KAAAA,CAFjC,EAAA,SAAA,CAAA;AAIF,IAAA,cAAA,2BAAgBI,IAAAA,KAAAA;AACd,EAAA,OAAOC,UAAW,CAAA;IAChBC,QAAU,EAAA,IAAA;IACVC,eAAiB,EAAA,IAAA;IACjBC,UAAY,EAAA,IAAA;IACZC,UAAY,EAAA,KAAA;IACZC,IAAM,EAAA,IAAA;IACNC,UAAY,EAAA,IAAA;IACZ,GAAGP,IAAAA;IACHQ,aAAe,EAAA,UAAA;IACfC,iBAAmB,EAAA;AACjBC,MAAAA,KAAAA,EAAAA,CAAQ,MAAA;AACN,QAAA,MAAMC,MAAS,GAAA;UACbC,KAAO,EAAA;YAAEC,OAAS,EAAA,KAAA;YAAOC,IAAM,EAAA,WAAA;AAAMC,YAAAA,SAAAA,EAAWC,UAAWC,CAAAA;AAAK,WAAA;UAChEC,KAAO,EAAA;YAAEL,OAAS,EAAA,KAAA;YAAOC,IAAM,EAAA,WAAA;AAAMC,YAAAA,SAAAA,EAAWC,UAAWG,CAAAA;AAAO,WAAA;UAClEC,IAAM,EAAA;YAAEP,OAAS,EAAA,KAAA;YAAOC,IAAM,EAAA,cAAA;AAAMC,YAAAA,SAAAA,EAAWC,UAAWK,CAAAA;AAAM,WAAA;UAChEC,IAAM,EAAA;YAAET,OAAS,EAAA,KAAA;YAAOC,IAAM,EAAA,cAAA;AAAMC,YAAAA,SAAAA,EAAWC,UAAWG,CAAAA;AAAO,WAAA;UACjEI,KAAO,EAAA;YAAEV,OAAS,EAAA,KAAA;YAAOC,IAAM,EAAA,WAAA;AAAMC,YAAAA,SAAAA,EAAWC,UAAWQ,CAAAA;AAAI,WAAA;UAC/DC,KAAO,EAAA;YACLZ,OAAS,EAAA,KAAA;YACTC,IAAM,EAAA,WAAA;AACNC,YAAAA,SAAAA,EAAWrB,OAAQsB,CAAAA,UAAAA,CAAWU,KAAOV,EAAAA,UAAAA,CAAWW,KAAK;AACvD;AACF,SAAA;AACA,QAAA,MAAMC,QAAW,GAAA;UAAEf,OAAS,EAAA,KAAA;UAAOC,IAAM,EAAA,iBAAA;AAAOC,UAAAA,SAAAA,EAAWC,UAAWC,CAAAA;AAAK,SAAA;AAE3E,QAAA,OAAO,CAACY,QAAAA,KAAAA;AACN,UAAMC,MAAAA,MAAAA,GAASnB,MAAOkB,CAAAA,QAAAA,CAAaD,IAAAA,QAAAA;AACnC,UAAO,OAAA,CAAA,EAAGE,OAAOf,SAAUe,CAAAA,MAAAA,CAAOjB,OAAO,CAAA,CAAA,EAAA,EAAMiB,OAAOhB,IAAI,CAAA,CAAA,CAAA;AAC5D,SAAA;OACF,GAAA;AACAiB,MAAAA,IAAAA,kBAAOC,MAAAA,CAAAA,CAAAA,SAAAA,KAAchB,UAAWiB,CAAAA,GAAAA,CAAID,SAAAA,CAA9B,EAAA,MAAA,CAAA;AACNE,MAAAA,MAAAA,kBAASA,MAAAA,CAAAA,CAAAA,MAAAA,EAAQC,GAAKC,EAAAA,GAAAA,EAAK,EAAEC,MAAAA,EAAa,KAAA,CAAA,EAAGA,MAAOC,CAAAA,WAAAA,CAAYJ,MAAAA,CAAAA,CAAxD,CAAA,EAAA,QAAA;AACV,KAAA;IACAK,aAAe,kBAAA,MAAA,CAAA,CAACH,KAAKI,UAAAA,KAAAA;AACnB,MAAO,OAAA,CAAA,EAAGJ,GAAII,CAAAA,UAAAA,CAAW,CAAA,CAAA;KADZ,EAAA,eAAA;GAGjB,CAAA;AACF,CAtCe,EAAA,SAAA","file":"pretty.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport pinoPretty from \"pino-pretty\";\nimport picocolors from \"picocolors\";\n\nconst compose =\n  (...fns) =>\n  (value) =>\n    fns.reduce((res, f) => f(res), value);\n\nexport default (opts) => {\n  return pinoPretty({\n    colorize: true,\n    colorizeObjects: true,\n    singleLine: true,\n    hideObject: false,\n    sync: true,\n    levelFirst: true,\n    ...opts,\n    translateTime: \"HH:MM:ss\",\n    customPrettifiers: {\n      level: (() => {\n        const levels = {\n          TRACE: { letters: \"TRC\", icon: \"🔎\", formatter: picocolors.gray },\n          DEBUG: { letters: \"DBG\", icon: \"🪲\", formatter: picocolors.yellow },\n          INFO: { letters: \"INF\", icon: \"ℹ️\", formatter: picocolors.green },\n          WARN: { letters: \"WRN\", icon: \"⚠️\", formatter: picocolors.yellow },\n          ERROR: { letters: \"ERR\", icon: \"🔥\", formatter: picocolors.red },\n          FATAL: {\n            letters: \"FTL\",\n            icon: \"💣\",\n            formatter: compose(picocolors.black, picocolors.bgRed),\n          },\n        };\n        const fallback = { letters: \"???\", icon: \"🤷‍\", formatter: picocolors.gray };\n\n        return (logLevel) => {\n          const target = levels[logLevel] || fallback;\n          return `${target.formatter(target.letters)}  ${target.icon} `;\n        };\n      })(),\n      time: (timestamp) => picocolors.dim(timestamp),\n      caller: (caller, key, log, { colors }) => `${colors.greenBright(caller)}`,\n    },\n    messageFormat: (log, messageKey) => {\n      return `${log[messageKey]}`;\n    },\n  });\n};\n"]}

package/dist/memory/base.cjs

@@ -0,0 +1,98 @@
+'use strict';
+
+var errors_cjs = require('../errors.cjs');
+var serializable_cjs = require('../internals/serializable.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class MemoryError extends errors_cjs.FrameworkError {
+  static {
+    __name(this, "MemoryError");
+  }
+}
+class MemoryFatalError extends MemoryError {
+  static {
+    __name(this, "MemoryFatalError");
+  }
+  constructor(message, errors, options) {
+    super(message, errors, {
+      isFatal: true,
+      isRetryable: false,
+      ...options
+    });
+  }
+}
+class BaseMemory extends serializable_cjs.Serializable {
+  static {
+    __name(this, "BaseMemory");
+  }
+  async addMany(messages, start) {
+    let counter = 0;
+    for await (const msg of messages) {
+      await this.add(msg, start === void 0 ? void 0 : start + counter);
+      counter += 1;
+    }
+  }
+  async deleteMany(messages) {
+    for await (const msg of messages) {
+      await this.delete(msg);
+    }
+  }
+  async splice(start, deleteCount, ...items) {
+    const total = this.messages.length;
+    start = start < 0 ? Math.max(total + start, 0) : start;
+    deleteCount = Math.min(deleteCount, total - start);
+    const deletedItems = this.messages.slice(start, start + deleteCount);
+    await this.deleteMany(deletedItems);
+    await this.addMany(items, start);
+    return deletedItems;
+  }
+  isEmpty() {
+    return this.messages.length === 0;
+  }
+  asReadOnly() {
+    return new ReadOnlyMemory(this);
+  }
+  [Symbol.iterator]() {
+    return this.messages[Symbol.iterator]();
+  }
+}
+class ReadOnlyMemory extends BaseMemory {
+  static {
+    __name(this, "ReadOnlyMemory");
+  }
+  source;
+  constructor(source) {
+    super(), this.source = source;
+  }
+  static {
+    this.register();
+  }
+  // eslint-disable-next-line unused-imports/no-unused-vars
+  async add(message, index) {
+  }
+  // eslint-disable-next-line unused-imports/no-unused-vars
+  async delete(message) {
+    return false;
+  }
+  get messages() {
+    return this.source.messages;
+  }
+  reset() {
+  }
+  createSnapshot() {
+    return {
+      source: this.source
+    };
+  }
+  loadSnapshot(state) {
+    Object.assign(this, state);
+  }
+}
+
+exports.BaseMemory = BaseMemory;
+exports.MemoryError = MemoryError;
+exports.MemoryFatalError = MemoryFatalError;
+exports.ReadOnlyMemory = ReadOnlyMemory;
+//# sourceMappingURL=base.cjs.map
+//# sourceMappingURL=base.cjs.map

package/dist/memory/base.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/memory/base.ts"],"names":["MemoryError","FrameworkError","MemoryFatalError","constructor","message","errors","options","isFatal","isRetryable","BaseMemory","Serializable","addMany","messages","start","counter","msg","add","undefined","deleteMany","delete","splice","deleteCount","items","total","length","Math","max","min","deletedItems","slice","isEmpty","asReadOnly","ReadOnlyMemory","Symbol","iterator","source","register","index","reset","createSnapshot","loadSnapshot","state","Object","assign"],"mappings":"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","file":"base.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Message } from \"@/backend/message.js\";\nimport { FrameworkError, FrameworkErrorOptions } from \"@/errors.js\";\nimport { Serializable } from \"@/internals/serializable.js\";\n\nexport class MemoryError extends FrameworkError {}\nexport class MemoryFatalError extends MemoryError {\n  constructor(message: string, errors?: Error[], options?: FrameworkErrorOptions) {\n    super(message, errors, {\n      isFatal: true,\n      isRetryable: false,\n      ...options,\n    });\n  }\n}\n\nexport abstract class BaseMemory<TState = unknown> extends Serializable<TState> {\n  abstract get messages(): readonly Message[];\n\n  abstract add(message: Message, index?: number): Promise<void>;\n\n  abstract delete(message: Message): Promise<boolean>;\n  abstract reset(): void;\n\n  async addMany(messages: Iterable<Message> | AsyncIterable<Message>, start?: number) {\n    let counter = 0;\n    for await (const msg of messages) {\n      await this.add(msg, start === undefined ? undefined : start + counter);\n      counter += 1;\n    }\n  }\n\n  async deleteMany(messages: Iterable<Message> | AsyncIterable<Message>) {\n    for await (const msg of messages) {\n      await this.delete(msg);\n    }\n  }\n\n  async splice(start: number, deleteCount: number, ...items: Message[]) {\n    const total = this.messages.length;\n\n    start = start < 0 ? Math.max(total + start, 0) : start;\n    deleteCount = Math.min(deleteCount, total - start);\n\n    const deletedItems = this.messages.slice(start, start + deleteCount);\n    await this.deleteMany(deletedItems);\n    await this.addMany(items, start);\n\n    return deletedItems;\n  }\n\n  isEmpty() {\n    return this.messages.length === 0;\n  }\n\n  asReadOnly() {\n    return new ReadOnlyMemory(this);\n  }\n\n  [Symbol.iterator]() {\n    return this.messages[Symbol.iterator]();\n  }\n\n  abstract loadSnapshot(state: TState): void;\n  abstract createSnapshot(): TState;\n}\n\nexport class ReadOnlyMemory<T extends BaseMemory = BaseMemory> extends BaseMemory<{ source: T }> {\n  constructor(public readonly source: T) {\n    super();\n  }\n\n  static {\n    this.register();\n  }\n\n  // eslint-disable-next-line unused-imports/no-unused-vars\n  async add(message: Message, index?: number) {}\n\n  // eslint-disable-next-line unused-imports/no-unused-vars\n  async delete(message: Message) {\n    return false;\n  }\n\n  get messages(): readonly Message[] {\n    return this.source.messages;\n  }\n\n  reset(): void {}\n\n  createSnapshot() {\n    return { source: this.source };\n  }\n\n  loadSnapshot(state: { source: T }) {\n    Object.assign(this, state);\n  }\n}\n"]}

package/dist/memory/base.d.cts

@@ -0,0 +1,44 @@
+import { Message, MessageContentPart } from '../backend/message.cjs';
+import { FrameworkError, FrameworkErrorOptions } from '../errors.cjs';
+import { Serializable } from '../internals/serializable.cjs';
+import 'ai';
+import '../internals/types.cjs';
+import '../internals/helpers/guards.cjs';
+
+declare class MemoryError extends FrameworkError {
+}
+declare class MemoryFatalError extends MemoryError {
+    constructor(message: string, errors?: Error[], options?: FrameworkErrorOptions);
+}
+declare abstract class BaseMemory<TState = unknown> extends Serializable<TState> {
+    abstract get messages(): readonly Message[];
+    abstract add(message: Message, index?: number): Promise<void>;
+    abstract delete(message: Message): Promise<boolean>;
+    abstract reset(): void;
+    addMany(messages: Iterable<Message> | AsyncIterable<Message>, start?: number): Promise<void>;
+    deleteMany(messages: Iterable<Message> | AsyncIterable<Message>): Promise<void>;
+    splice(start: number, deleteCount: number, ...items: Message[]): Promise<Message<MessageContentPart, string>[]>;
+    isEmpty(): boolean;
+    asReadOnly(): ReadOnlyMemory<this>;
+    [Symbol.iterator](): ArrayIterator<Message<MessageContentPart, string>>;
+    abstract loadSnapshot(state: TState): void;
+    abstract createSnapshot(): TState;
+}
+declare class ReadOnlyMemory<T extends BaseMemory = BaseMemory> extends BaseMemory<{
+    source: T;
+}> {
+    readonly source: T;
+    constructor(source: T);
+    add(message: Message, index?: number): Promise<void>;
+    delete(message: Message): Promise<boolean>;
+    get messages(): readonly Message[];
+    reset(): void;
+    createSnapshot(): {
+        source: T;
+    };
+    loadSnapshot(state: {
+        source: T;
+    }): void;
+}
+
+export { BaseMemory, MemoryError, MemoryFatalError, ReadOnlyMemory };

package/dist/memory/base.d.ts

@@ -0,0 +1,44 @@
+import { Message, MessageContentPart } from '../backend/message.js';
+import { FrameworkError, FrameworkErrorOptions } from '../errors.js';
+import { Serializable } from '../internals/serializable.js';
+import 'ai';
+import '../internals/types.js';
+import '../internals/helpers/guards.js';
+
+declare class MemoryError extends FrameworkError {
+}
+declare class MemoryFatalError extends MemoryError {
+    constructor(message: string, errors?: Error[], options?: FrameworkErrorOptions);
+}
+declare abstract class BaseMemory<TState = unknown> extends Serializable<TState> {
+    abstract get messages(): readonly Message[];
+    abstract add(message: Message, index?: number): Promise<void>;
+    abstract delete(message: Message): Promise<boolean>;
+    abstract reset(): void;
+    addMany(messages: Iterable<Message> | AsyncIterable<Message>, start?: number): Promise<void>;
+    deleteMany(messages: Iterable<Message> | AsyncIterable<Message>): Promise<void>;
+    splice(start: number, deleteCount: number, ...items: Message[]): Promise<Message<MessageContentPart, string>[]>;
+    isEmpty(): boolean;
+    asReadOnly(): ReadOnlyMemory<this>;
+    [Symbol.iterator](): ArrayIterator<Message<MessageContentPart, string>>;
+    abstract loadSnapshot(state: TState): void;
+    abstract createSnapshot(): TState;
+}
+declare class ReadOnlyMemory<T extends BaseMemory = BaseMemory> extends BaseMemory<{
+    source: T;
+}> {
+    readonly source: T;
+    constructor(source: T);
+    add(message: Message, index?: number): Promise<void>;
+    delete(message: Message): Promise<boolean>;
+    get messages(): readonly Message[];
+    reset(): void;
+    createSnapshot(): {
+        source: T;
+    };
+    loadSnapshot(state: {
+        source: T;
+    }): void;
+}
+
+export { BaseMemory, MemoryError, MemoryFatalError, ReadOnlyMemory };

package/dist/memory/base.js

@@ -0,0 +1,93 @@
+import { FrameworkError } from '../errors.js';
+import { Serializable } from '../internals/serializable.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class MemoryError extends FrameworkError {
+  static {
+    __name(this, "MemoryError");
+  }
+}
+class MemoryFatalError extends MemoryError {
+  static {
+    __name(this, "MemoryFatalError");
+  }
+  constructor(message, errors, options) {
+    super(message, errors, {
+      isFatal: true,
+      isRetryable: false,
+      ...options
+    });
+  }
+}
+class BaseMemory extends Serializable {
+  static {
+    __name(this, "BaseMemory");
+  }
+  async addMany(messages, start) {
+    let counter = 0;
+    for await (const msg of messages) {
+      await this.add(msg, start === void 0 ? void 0 : start + counter);
+      counter += 1;
+    }
+  }
+  async deleteMany(messages) {
+    for await (const msg of messages) {
+      await this.delete(msg);
+    }
+  }
+  async splice(start, deleteCount, ...items) {
+    const total = this.messages.length;
+    start = start < 0 ? Math.max(total + start, 0) : start;
+    deleteCount = Math.min(deleteCount, total - start);
+    const deletedItems = this.messages.slice(start, start + deleteCount);
+    await this.deleteMany(deletedItems);
+    await this.addMany(items, start);
+    return deletedItems;
+  }
+  isEmpty() {
+    return this.messages.length === 0;
+  }
+  asReadOnly() {
+    return new ReadOnlyMemory(this);
+  }
+  [Symbol.iterator]() {
+    return this.messages[Symbol.iterator]();
+  }
+}
+class ReadOnlyMemory extends BaseMemory {
+  static {
+    __name(this, "ReadOnlyMemory");
+  }
+  source;
+  constructor(source) {
+    super(), this.source = source;
+  }
+  static {
+    this.register();
+  }
+  // eslint-disable-next-line unused-imports/no-unused-vars
+  async add(message, index) {
+  }
+  // eslint-disable-next-line unused-imports/no-unused-vars
+  async delete(message) {
+    return false;
+  }
+  get messages() {
+    return this.source.messages;
+  }
+  reset() {
+  }
+  createSnapshot() {
+    return {
+      source: this.source
+    };
+  }
+  loadSnapshot(state) {
+    Object.assign(this, state);
+  }
+}
+
+export { BaseMemory, MemoryError, MemoryFatalError, ReadOnlyMemory };
+//# sourceMappingURL=base.js.map
+//# sourceMappingURL=base.js.map

package/dist/memory/base.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/memory/base.ts"],"names":["MemoryError","FrameworkError","MemoryFatalError","constructor","message","errors","options","isFatal","isRetryable","BaseMemory","Serializable","addMany","messages","start","counter","msg","add","undefined","deleteMany","delete","splice","deleteCount","items","total","length","Math","max","min","deletedItems","slice","isEmpty","asReadOnly","ReadOnlyMemory","Symbol","iterator","source","register","index","reset","createSnapshot","loadSnapshot","state","Object","assign"],"mappings":"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","file":"base.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Message } from \"@/backend/message.js\";\nimport { FrameworkError, FrameworkErrorOptions } from \"@/errors.js\";\nimport { Serializable } from \"@/internals/serializable.js\";\n\nexport class MemoryError extends FrameworkError {}\nexport class MemoryFatalError extends MemoryError {\n  constructor(message: string, errors?: Error[], options?: FrameworkErrorOptions) {\n    super(message, errors, {\n      isFatal: true,\n      isRetryable: false,\n      ...options,\n    });\n  }\n}\n\nexport abstract class BaseMemory<TState = unknown> extends Serializable<TState> {\n  abstract get messages(): readonly Message[];\n\n  abstract add(message: Message, index?: number): Promise<void>;\n\n  abstract delete(message: Message): Promise<boolean>;\n  abstract reset(): void;\n\n  async addMany(messages: Iterable<Message> | AsyncIterable<Message>, start?: number) {\n    let counter = 0;\n    for await (const msg of messages) {\n      await this.add(msg, start === undefined ? undefined : start + counter);\n      counter += 1;\n    }\n  }\n\n  async deleteMany(messages: Iterable<Message> | AsyncIterable<Message>) {\n    for await (const msg of messages) {\n      await this.delete(msg);\n    }\n  }\n\n  async splice(start: number, deleteCount: number, ...items: Message[]) {\n    const total = this.messages.length;\n\n    start = start < 0 ? Math.max(total + start, 0) : start;\n    deleteCount = Math.min(deleteCount, total - start);\n\n    const deletedItems = this.messages.slice(start, start + deleteCount);\n    await this.deleteMany(deletedItems);\n    await this.addMany(items, start);\n\n    return deletedItems;\n  }\n\n  isEmpty() {\n    return this.messages.length === 0;\n  }\n\n  asReadOnly() {\n    return new ReadOnlyMemory(this);\n  }\n\n  [Symbol.iterator]() {\n    return this.messages[Symbol.iterator]();\n  }\n\n  abstract loadSnapshot(state: TState): void;\n  abstract createSnapshot(): TState;\n}\n\nexport class ReadOnlyMemory<T extends BaseMemory = BaseMemory> extends BaseMemory<{ source: T }> {\n  constructor(public readonly source: T) {\n    super();\n  }\n\n  static {\n    this.register();\n  }\n\n  // eslint-disable-next-line unused-imports/no-unused-vars\n  async add(message: Message, index?: number) {}\n\n  // eslint-disable-next-line unused-imports/no-unused-vars\n  async delete(message: Message) {\n    return false;\n  }\n\n  get messages(): readonly Message[] {\n    return this.source.messages;\n  }\n\n  reset(): void {}\n\n  createSnapshot() {\n    return { source: this.source };\n  }\n\n  loadSnapshot(state: { source: T }) {\n    Object.assign(this, state);\n  }\n}\n"]}

package/dist/memory/slidingMemory.cjs

@@ -0,0 +1,79 @@
+'use strict';
+
+var base_cjs = require('./base.cjs');
+var utils_cjs = require('../serializer/utils.cjs');
+var remeda = require('remeda');
+var array_cjs = require('../internals/helpers/array.cjs');
+var number_cjs = require('../internals/helpers/number.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class SlidingMemory extends base_cjs.BaseMemory {
+  static {
+    __name(this, "SlidingMemory");
+  }
+  messages = [];
+  config;
+  constructor(config) {
+    super();
+    this.config = {
+      ...config,
+      handlers: {
+        removalSelector: config.handlers?.removalSelector ?? ((messages) => [
+          messages[0]
+        ])
+      }
+    };
+  }
+  static {
+    const aliases = [
+      "SlidingWindowMemory"
+    ];
+    this.register(aliases);
+  }
+  async add(message, index) {
+    const { size, handlers } = this.config;
+    const isOverflow = /* @__PURE__ */ __name(() => this.messages.length + 1 > size, "isOverflow");
+    if (isOverflow()) {
+      remeda.pipe(this.messages, handlers.removalSelector, array_cjs.castArray, remeda.filter(remeda.isTruthy), remeda.forEach((message2) => {
+        const index2 = this.messages.indexOf(message2);
+        if (index2 === -1) {
+          throw new base_cjs.MemoryFatalError(`Cannot delete non existing message.`, [], {
+            context: {
+              message: message2,
+              messages: this.messages
+            }
+          });
+        }
+        this.messages.splice(index2, 1);
+      }));
+      if (isOverflow()) {
+        throw new base_cjs.MemoryFatalError(`Custom memory removalSelector did not return any message. Memory overflow has occurred.`);
+      }
+    }
+    index = number_cjs.ensureRange(index ?? this.messages.length, {
+      min: 0,
+      max: this.messages.length
+    });
+    this.messages.splice(index, 0, message);
+  }
+  async delete(message) {
+    return array_cjs.removeFromArray(this.messages, message);
+  }
+  reset() {
+    this.messages.length = 0;
+  }
+  createSnapshot() {
+    return {
+      config: utils_cjs.shallowCopy(this.config),
+      messages: utils_cjs.shallowCopy(this.messages)
+    };
+  }
+  loadSnapshot(state) {
+    Object.assign(this, state);
+  }
+}
+
+exports.SlidingMemory = SlidingMemory;
+//# sourceMappingURL=slidingMemory.cjs.map
+//# sourceMappingURL=slidingMemory.cjs.map

package/dist/memory/slidingMemory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/memory/slidingMemory.ts"],"names":["SlidingMemory","BaseMemory","messages","config","constructor","handlers","removalSelector","aliases","register","add","message","index","size","isOverflow","length","pipe","castArray","filter","isTruthy","forEach","indexOf","MemoryFatalError","context","splice","ensureRange","min","max","delete","removeFromArray","reset","createSnapshot","shallowCopy","loadSnapshot","state","Object","assign"],"mappings":";;;;;;;;;;AAiCO,MAAMA,sBAAsBC,mBAAAA,CAAAA;EAjCnC;;;AAkCkBC,EAAAA,QAAAA,GAAsB,EAAA;AACtBC,EAAAA,MAAAA;AAEhBC,EAAAA,WAAAA,CAAYD,MAAkC,EAAA;AAC5C,IAAK,KAAA,EAAA;AACL,IAAA,IAAA,CAAKA,MAAS,GAAA;MACZ,GAAGA,MAAAA;MACHE,QAAU,EAAA;AACRC,QAAAA,eAAAA,EACEH,MAAOE,CAAAA,QAAAA,EAAUC,eAAoB,KAAA,CAACJ,QAAwB,KAAA;AAACA,UAAAA,QAAAA,CAAS,CAAA;;AAC5E;AACF,KAAA;AACF;EAEA;AACE,IAAA,MAAMK,OAAU,GAAA;AAAC,MAAA;;AACjB,IAAA,IAAA,CAAKC,SAASD,OAAAA,CAAAA;AAChB;EAEA,MAAME,GAAAA,CAAIC,SAAkBC,KAAgB,EAAA;AAC1C,IAAA,MAAM,EAAEC,IAAAA,EAAMP,QAAQ,EAAA,GAAK,IAAKF,CAAAA,MAAAA;AAChC,IAAA,MAAMU,6BAAmB,MAAA,CAAA,MAAA,IAAA,CAAKX,QAASY,CAAAA,MAAAA,GAAS,IAAIF,IAAjC,EAAA,YAAA,CAAA;AAEnB,IAAA,IAAIC,YAAc,EAAA;AAChBE,MACEA,WAAA,CAAA,IAAA,CAAKb,QACLG,EAAAA,QAAAA,CAASC,eACTU,EAAAA,mBAAAA,EACAC,cAAOC,eAAAA,CAAAA,EACPC,cAAQ,CAAA,CAACT,QAAAA,KAAAA;AACP,QAAA,MAAMC,MAAQ,GAAA,IAAA,CAAKT,QAASkB,CAAAA,OAAAA,CAAQV,QAAAA,CAAAA;AACpC,QAAA,IAAIC,WAAU,CAAI,CAAA,EAAA;AAChB,UAAA,MAAM,IAAIU,yBAAAA,CAAiB,CAAuC,mCAAA,CAAA,EAAA,EAAI,EAAA;YACpEC,OAAS,EAAA;cAAEZ,OAAAA,EAAAA,QAAAA;AAASR,cAAAA,QAAAA,EAAU,IAAKA,CAAAA;AAAS;WAC9C,CAAA;AACF;AACA,QAAKA,IAAAA,CAAAA,QAAAA,CAASqB,MAAOZ,CAAAA,MAAAA,EAAO,CAAA,CAAA;AAC9B,OAAA,CAAA,CAAA;AAGF,MAAA,IAAIE,YAAc,EAAA;AAChB,QAAM,MAAA,IAAIQ,0BACR,CAAyF,uFAAA,CAAA,CAAA;AAE7F;AACF;AAEAV,IAAAA,KAAAA,GAAQa,sBAAYb,CAAAA,KAAAA,IAAS,IAAKT,CAAAA,QAAAA,CAASY,MAAQ,EAAA;MAAEW,GAAK,EAAA,CAAA;AAAGC,MAAAA,GAAAA,EAAK,KAAKxB,QAASY,CAAAA;KAAO,CAAA;AACvF,IAAA,IAAA,CAAKZ,QAASqB,CAAAA,MAAAA,CAAOZ,KAAO,EAAA,CAAA,EAAGD,OAAAA,CAAAA;AACjC;AAEA,EAAA,MAAMiB,OAAOjB,OAAkB,EAAA;AAC7B,IAAOkB,OAAAA,yBAAAA,CAAgB,IAAK1B,CAAAA,QAAAA,EAAUQ,OAAAA,CAAAA;AACxC;EAEAmB,KAAQ,GAAA;AACN,IAAA,IAAA,CAAK3B,SAASY,MAAS,GAAA,CAAA;AACzB;EAEAgB,cAAiB,GAAA;AACf,IAAO,OAAA;MAAE3B,MAAQ4B,EAAAA,qBAAAA,CAAY,KAAK5B,MAAM,CAAA;MAAGD,QAAU6B,EAAAA,qBAAAA,CAAY,KAAK7B,QAAQ;AAAE,KAAA;AAClF;AAEA8B,EAAAA,YAAAA,CAAaC,KAA+C,EAAA;AAC1DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,KAAAA,CAAAA;AACtB;AACF","file":"slidingMemory.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Message } from \"@/backend/message.js\";\nimport { BaseMemory, MemoryFatalError } from \"@/memory/base.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { filter, forEach, isTruthy, pipe } from \"remeda\";\nimport { castArray, removeFromArray } from \"@/internals/helpers/array.js\";\nimport { RequiredNested } from \"@/internals/types.js\";\nimport { ensureRange } from \"@/internals/helpers/number.js\";\n\nexport interface Handlers {\n  removalSelector: (messages: Message[]) => Message | Message[];\n}\n\nexport interface SlidingWindowMemoryInput {\n  size: number;\n  handlers?: Partial<Handlers>;\n}\n\nexport class SlidingMemory extends BaseMemory {\n  public readonly messages: Message[] = [];\n  public readonly config: RequiredNested<SlidingWindowMemoryInput>;\n\n  constructor(config: SlidingWindowMemoryInput) {\n    super();\n    this.config = {\n      ...config,\n      handlers: {\n        removalSelector:\n          config.handlers?.removalSelector ?? ((messages: Message[]) => [messages[0]]),\n      },\n    };\n  }\n\n  static {\n    const aliases = [\"SlidingWindowMemory\"];\n    this.register(aliases);\n  }\n\n  async add(message: Message, index?: number) {\n    const { size, handlers } = this.config;\n    const isOverflow = () => this.messages.length + 1 > size;\n\n    if (isOverflow()) {\n      pipe(\n        this.messages,\n        handlers.removalSelector,\n        castArray,\n        filter(isTruthy),\n        forEach((message) => {\n          const index = this.messages.indexOf(message);\n          if (index === -1) {\n            throw new MemoryFatalError(`Cannot delete non existing message.`, [], {\n              context: { message, messages: this.messages },\n            });\n          }\n          this.messages.splice(index, 1);\n        }),\n      );\n\n      if (isOverflow()) {\n        throw new MemoryFatalError(\n          `Custom memory removalSelector did not return any message. Memory overflow has occurred.`,\n        );\n      }\n    }\n\n    index = ensureRange(index ?? this.messages.length, { min: 0, max: this.messages.length });\n    this.messages.splice(index, 0, message);\n  }\n\n  async delete(message: Message) {\n    return removeFromArray(this.messages, message);\n  }\n\n  reset() {\n    this.messages.length = 0;\n  }\n\n  createSnapshot() {\n    return { config: shallowCopy(this.config), messages: shallowCopy(this.messages) };\n  }\n\n  loadSnapshot(state: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, state);\n  }\n}\n"]}

package/dist/memory/slidingMemory.d.cts

@@ -0,0 +1,30 @@
+import { Message, MessageContentPart } from '../backend/message.cjs';
+import { BaseMemory } from './base.cjs';
+import { RequiredNested } from '../internals/types.cjs';
+import '../internals/serializable.cjs';
+import '../internals/helpers/guards.cjs';
+import 'ai';
+import '../errors.cjs';
+
+interface Handlers {
+    removalSelector: (messages: Message[]) => Message | Message[];
+}
+interface SlidingWindowMemoryInput {
+    size: number;
+    handlers?: Partial<Handlers>;
+}
+declare class SlidingMemory extends BaseMemory {
+    readonly messages: Message[];
+    readonly config: RequiredNested<SlidingWindowMemoryInput>;
+    constructor(config: SlidingWindowMemoryInput);
+    add(message: Message, index?: number): Promise<void>;
+    delete(message: Message): Promise<boolean>;
+    reset(): void;
+    createSnapshot(): {
+        config: RequiredNested<SlidingWindowMemoryInput>;
+        messages: Message<MessageContentPart, string>[];
+    };
+    loadSnapshot(state: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { type Handlers, SlidingMemory, type SlidingWindowMemoryInput };

package/dist/memory/slidingMemory.d.ts

@@ -0,0 +1,30 @@
+import { Message, MessageContentPart } from '../backend/message.js';
+import { BaseMemory } from './base.js';
+import { RequiredNested } from '../internals/types.js';
+import '../internals/serializable.js';
+import '../internals/helpers/guards.js';
+import 'ai';
+import '../errors.js';
+
+interface Handlers {
+    removalSelector: (messages: Message[]) => Message | Message[];
+}
+interface SlidingWindowMemoryInput {
+    size: number;
+    handlers?: Partial<Handlers>;
+}
+declare class SlidingMemory extends BaseMemory {
+    readonly messages: Message[];
+    readonly config: RequiredNested<SlidingWindowMemoryInput>;
+    constructor(config: SlidingWindowMemoryInput);
+    add(message: Message, index?: number): Promise<void>;
+    delete(message: Message): Promise<boolean>;
+    reset(): void;
+    createSnapshot(): {
+        config: RequiredNested<SlidingWindowMemoryInput>;
+        messages: Message<MessageContentPart, string>[];
+    };
+    loadSnapshot(state: ReturnType<typeof this.createSnapshot>): void;
+}
+
+export { type Handlers, SlidingMemory, type SlidingWindowMemoryInput };

package/dist/memory/slidingMemory.js

@@ -0,0 +1,77 @@
+import { BaseMemory, MemoryFatalError } from './base.js';
+import { shallowCopy } from '../serializer/utils.js';
+import { pipe, filter, isTruthy, forEach } from 'remeda';
+import { castArray, removeFromArray } from '../internals/helpers/array.js';
+import { ensureRange } from '../internals/helpers/number.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class SlidingMemory extends BaseMemory {
+  static {
+    __name(this, "SlidingMemory");
+  }
+  messages = [];
+  config;
+  constructor(config) {
+    super();
+    this.config = {
+      ...config,
+      handlers: {
+        removalSelector: config.handlers?.removalSelector ?? ((messages) => [
+          messages[0]
+        ])
+      }
+    };
+  }
+  static {
+    const aliases = [
+      "SlidingWindowMemory"
+    ];
+    this.register(aliases);
+  }
+  async add(message, index) {
+    const { size, handlers } = this.config;
+    const isOverflow = /* @__PURE__ */ __name(() => this.messages.length + 1 > size, "isOverflow");
+    if (isOverflow()) {
+      pipe(this.messages, handlers.removalSelector, castArray, filter(isTruthy), forEach((message2) => {
+        const index2 = this.messages.indexOf(message2);
+        if (index2 === -1) {
+          throw new MemoryFatalError(`Cannot delete non existing message.`, [], {
+            context: {
+              message: message2,
+              messages: this.messages
+            }
+          });
+        }
+        this.messages.splice(index2, 1);
+      }));
+      if (isOverflow()) {
+        throw new MemoryFatalError(`Custom memory removalSelector did not return any message. Memory overflow has occurred.`);
+      }
+    }
+    index = ensureRange(index ?? this.messages.length, {
+      min: 0,
+      max: this.messages.length
+    });
+    this.messages.splice(index, 0, message);
+  }
+  async delete(message) {
+    return removeFromArray(this.messages, message);
+  }
+  reset() {
+    this.messages.length = 0;
+  }
+  createSnapshot() {
+    return {
+      config: shallowCopy(this.config),
+      messages: shallowCopy(this.messages)
+    };
+  }
+  loadSnapshot(state) {
+    Object.assign(this, state);
+  }
+}
+
+export { SlidingMemory };
+//# sourceMappingURL=slidingMemory.js.map
+//# sourceMappingURL=slidingMemory.js.map

package/dist/memory/slidingMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/memory/slidingMemory.ts"],"names":["SlidingMemory","BaseMemory","messages","config","constructor","handlers","removalSelector","aliases","register","add","message","index","size","isOverflow","length","pipe","castArray","filter","isTruthy","forEach","indexOf","MemoryFatalError","context","splice","ensureRange","min","max","delete","removeFromArray","reset","createSnapshot","shallowCopy","loadSnapshot","state","Object","assign"],"mappings":";;;;;;;;AAiCO,MAAMA,sBAAsBC,UAAAA,CAAAA;EAjCnC;;;AAkCkBC,EAAAA,QAAAA,GAAsB,EAAA;AACtBC,EAAAA,MAAAA;AAEhBC,EAAAA,WAAAA,CAAYD,MAAkC,EAAA;AAC5C,IAAK,KAAA,EAAA;AACL,IAAA,IAAA,CAAKA,MAAS,GAAA;MACZ,GAAGA,MAAAA;MACHE,QAAU,EAAA;AACRC,QAAAA,eAAAA,EACEH,MAAOE,CAAAA,QAAAA,EAAUC,eAAoB,KAAA,CAACJ,QAAwB,KAAA;AAACA,UAAAA,QAAAA,CAAS,CAAA;;AAC5E;AACF,KAAA;AACF;EAEA;AACE,IAAA,MAAMK,OAAU,GAAA;AAAC,MAAA;;AACjB,IAAA,IAAA,CAAKC,SAASD,OAAAA,CAAAA;AAChB;EAEA,MAAME,GAAAA,CAAIC,SAAkBC,KAAgB,EAAA;AAC1C,IAAA,MAAM,EAAEC,IAAAA,EAAMP,QAAQ,EAAA,GAAK,IAAKF,CAAAA,MAAAA;AAChC,IAAA,MAAMU,6BAAmB,MAAA,CAAA,MAAA,IAAA,CAAKX,QAASY,CAAAA,MAAAA,GAAS,IAAIF,IAAjC,EAAA,YAAA,CAAA;AAEnB,IAAA,IAAIC,YAAc,EAAA;AAChBE,MACE,IAAA,CAAA,IAAA,CAAKb,QACLG,EAAAA,QAAAA,CAASC,eACTU,EAAAA,SAAAA,EACAC,OAAOC,QAAAA,CAAAA,EACPC,OAAQ,CAAA,CAACT,QAAAA,KAAAA;AACP,QAAA,MAAMC,MAAQ,GAAA,IAAA,CAAKT,QAASkB,CAAAA,OAAAA,CAAQV,QAAAA,CAAAA;AACpC,QAAA,IAAIC,WAAU,CAAI,CAAA,EAAA;AAChB,UAAA,MAAM,IAAIU,gBAAAA,CAAiB,CAAuC,mCAAA,CAAA,EAAA,EAAI,EAAA;YACpEC,OAAS,EAAA;cAAEZ,OAAAA,EAAAA,QAAAA;AAASR,cAAAA,QAAAA,EAAU,IAAKA,CAAAA;AAAS;WAC9C,CAAA;AACF;AACA,QAAKA,IAAAA,CAAAA,QAAAA,CAASqB,MAAOZ,CAAAA,MAAAA,EAAO,CAAA,CAAA;AAC9B,OAAA,CAAA,CAAA;AAGF,MAAA,IAAIE,YAAc,EAAA;AAChB,QAAM,MAAA,IAAIQ,iBACR,CAAyF,uFAAA,CAAA,CAAA;AAE7F;AACF;AAEAV,IAAAA,KAAAA,GAAQa,WAAYb,CAAAA,KAAAA,IAAS,IAAKT,CAAAA,QAAAA,CAASY,MAAQ,EAAA;MAAEW,GAAK,EAAA,CAAA;AAAGC,MAAAA,GAAAA,EAAK,KAAKxB,QAASY,CAAAA;KAAO,CAAA;AACvF,IAAA,IAAA,CAAKZ,QAASqB,CAAAA,MAAAA,CAAOZ,KAAO,EAAA,CAAA,EAAGD,OAAAA,CAAAA;AACjC;AAEA,EAAA,MAAMiB,OAAOjB,OAAkB,EAAA;AAC7B,IAAOkB,OAAAA,eAAAA,CAAgB,IAAK1B,CAAAA,QAAAA,EAAUQ,OAAAA,CAAAA;AACxC;EAEAmB,KAAQ,GAAA;AACN,IAAA,IAAA,CAAK3B,SAASY,MAAS,GAAA,CAAA;AACzB;EAEAgB,cAAiB,GAAA;AACf,IAAO,OAAA;MAAE3B,MAAQ4B,EAAAA,WAAAA,CAAY,KAAK5B,MAAM,CAAA;MAAGD,QAAU6B,EAAAA,WAAAA,CAAY,KAAK7B,QAAQ;AAAE,KAAA;AAClF;AAEA8B,EAAAA,YAAAA,CAAaC,KAA+C,EAAA;AAC1DC,IAAOC,MAAAA,CAAAA,MAAAA,CAAO,MAAMF,KAAAA,CAAAA;AACtB;AACF","file":"slidingMemory.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Message } from \"@/backend/message.js\";\nimport { BaseMemory, MemoryFatalError } from \"@/memory/base.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { filter, forEach, isTruthy, pipe } from \"remeda\";\nimport { castArray, removeFromArray } from \"@/internals/helpers/array.js\";\nimport { RequiredNested } from \"@/internals/types.js\";\nimport { ensureRange } from \"@/internals/helpers/number.js\";\n\nexport interface Handlers {\n  removalSelector: (messages: Message[]) => Message | Message[];\n}\n\nexport interface SlidingWindowMemoryInput {\n  size: number;\n  handlers?: Partial<Handlers>;\n}\n\nexport class SlidingMemory extends BaseMemory {\n  public readonly messages: Message[] = [];\n  public readonly config: RequiredNested<SlidingWindowMemoryInput>;\n\n  constructor(config: SlidingWindowMemoryInput) {\n    super();\n    this.config = {\n      ...config,\n      handlers: {\n        removalSelector:\n          config.handlers?.removalSelector ?? ((messages: Message[]) => [messages[0]]),\n      },\n    };\n  }\n\n  static {\n    const aliases = [\"SlidingWindowMemory\"];\n    this.register(aliases);\n  }\n\n  async add(message: Message, index?: number) {\n    const { size, handlers } = this.config;\n    const isOverflow = () => this.messages.length + 1 > size;\n\n    if (isOverflow()) {\n      pipe(\n        this.messages,\n        handlers.removalSelector,\n        castArray,\n        filter(isTruthy),\n        forEach((message) => {\n          const index = this.messages.indexOf(message);\n          if (index === -1) {\n            throw new MemoryFatalError(`Cannot delete non existing message.`, [], {\n              context: { message, messages: this.messages },\n            });\n          }\n          this.messages.splice(index, 1);\n        }),\n      );\n\n      if (isOverflow()) {\n        throw new MemoryFatalError(\n          `Custom memory removalSelector did not return any message. Memory overflow has occurred.`,\n        );\n      }\n    }\n\n    index = ensureRange(index ?? this.messages.length, { min: 0, max: this.messages.length });\n    this.messages.splice(index, 0, message);\n  }\n\n  async delete(message: Message) {\n    return removeFromArray(this.messages, message);\n  }\n\n  reset() {\n    this.messages.length = 0;\n  }\n\n  createSnapshot() {\n    return { config: shallowCopy(this.config), messages: shallowCopy(this.messages) };\n  }\n\n  loadSnapshot(state: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, state);\n  }\n}\n"]}