@igniter-js/agents 0.1.0

package/dist/adapters/index.mjs

@@ -0,0 +1,1021 @@
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { join } from 'path';
+
+// src/adapters/memory.adapter.ts
+var IgniterAgentInMemoryAdapter = class _IgniterAgentInMemoryAdapter {
+  /**
+   * Creates a new IgniterAgentInMemoryAdapter.
+   * 
+   * @param options - Adapter configuration
+   * 
+   * @example
+   * ```typescript
+   * const adapter = new IgniterAgentInMemoryAdapter({
+   *   namespace: 'myapp',
+   *   maxMessages: 1000,
+   *   maxChats: 100
+   * });
+   * ```
+   */
+  constructor(options = {}) {
+    /**
+     * Storage for working memory.
+     * Key format: `{namespace}:{scope}:{identifier}`
+     * @internal
+     */
+    this._workingMemory = /* @__PURE__ */ new Map();
+    /**
+     * Storage for conversation messages.
+     * Key format: `{namespace}:{chatId}`
+     * @internal
+     */
+    this._messages = /* @__PURE__ */ new Map();
+    /**
+     * Storage for chat sessions.
+     * Key format: `{namespace}:{chatId}`
+     * @internal
+     */
+    this._chats = /* @__PURE__ */ new Map();
+    this.options = {
+      namespace: options.namespace ?? "igniter",
+      maxMessages: options.maxMessages ?? 1e3,
+      maxChats: options.maxChats ?? 100
+    };
+  }
+  /**
+   * Factory method to create a new adapter instance.
+   * @param options - Adapter configuration
+   * @returns A new IgniterAgentInMemoryAdapter instance
+   *
+   * @example
+   * ```typescript
+   * const adapter = IgniterAgentInMemoryAdapter.create({
+   *   namespace: 'test',
+   * });
+   * ```
+   */
+  static create(options) {
+    return new _IgniterAgentInMemoryAdapter(options);
+  }
+  /* ---------------------------------------------------------------------------
+   * HELPER METHODS
+   * --------------------------------------------------------------------------- */
+  /**
+   * Generates a storage key with namespace prefix.
+   * @internal
+   */
+  _key(...parts) {
+    return [this.options.namespace, ...parts].join(":");
+  }
+  /* ---------------------------------------------------------------------------
+   * LIFECYCLE METHODS
+   * --------------------------------------------------------------------------- */
+  /**
+   * Connects to the storage backend (no-op for in-memory).
+   * 
+   * @description
+   * In-memory adapter doesn't require connection setup.
+   * This method exists for interface compatibility.
+   */
+  async connect() {
+  }
+  /**
+   * Disconnects from the storage backend (no-op for in-memory).
+   * 
+   * @description
+   * In-memory adapter doesn't require disconnection.
+   * This method exists for interface compatibility.
+   */
+  async disconnect() {
+  }
+  /**
+   * Checks if the adapter is connected.
+   * 
+   * @returns Always true for in-memory adapter
+   */
+  isConnected() {
+    return true;
+  }
+  /**
+   * Clears all stored data.
+   * 
+   * @description
+   * Removes all working memory, messages, and chat sessions.
+   * Use with caution.
+   * 
+   * @example
+   * ```typescript
+   * // Clear all data (useful for testing)
+   * await adapter.clear();
+   * ```
+   */
+  async clear() {
+    this._workingMemory.clear();
+    this._messages.clear();
+    this._chats.clear();
+  }
+  /* ---------------------------------------------------------------------------
+   * WORKING MEMORY METHODS
+   * --------------------------------------------------------------------------- */
+  /**
+   * Gets working memory for a scope and identifier.
+   * 
+   * @param params - The scope and identifier
+   * @returns The working memory or null if not found
+   * 
+   * @example
+   * ```typescript
+   * const memory = await adapter.getWorkingMemory({
+   *   scope: 'chat',
+   *   identifier: 'chat_123'
+   * });
+   * 
+   * if (memory) {
+   *   console.log('Content:', memory.content);
+   *   console.log('Updated:', memory.updatedAt);
+   * }
+   * ```
+   */
+  async getWorkingMemory(params) {
+    const key = this._key("memory", params.scope, params.identifier);
+    return this._workingMemory.get(key) ?? null;
+  }
+  /**
+   * Updates working memory for a scope and identifier.
+   * 
+   * @param params - The scope, identifier, and new content
+   * 
+   * @example
+   * ```typescript
+   * await adapter.updateWorkingMemory({
+   *   scope: 'chat',
+   *   identifier: 'chat_123',
+   *   content: `
+   *     ## User Preferences
+   *     - Prefers TypeScript
+   *     - Uses VS Code
+   *   `
+   * });
+   * ```
+   */
+  async updateWorkingMemory(params) {
+    const key = this._key("memory", params.scope, params.identifier);
+    this._workingMemory.set(key, {
+      content: params.content,
+      updatedAt: /* @__PURE__ */ new Date()
+    });
+  }
+  /* ---------------------------------------------------------------------------
+   * MESSAGE METHODS
+   * --------------------------------------------------------------------------- */
+  /**
+   * Saves a message to the conversation history.
+   * 
+   * @param message - The message to save
+   * 
+   * @example
+   * ```typescript
+   * await adapter.saveMessage({
+   *   chatId: 'chat_123',
+   *   userId: 'user_456',
+   *   role: 'user',
+   *   content: 'How do I use TypeScript?',
+   *   timestamp: new Date()
+   * });
+   * ```
+   */
+  async saveMessage(message) {
+    const key = this._key("messages", message.chatId);
+    let messages = this._messages.get(key);
+    if (!messages) {
+      messages = [];
+      this._messages.set(key, messages);
+    }
+    messages.push(message);
+    if (messages.length > this.options.maxMessages) {
+      messages.splice(0, messages.length - this.options.maxMessages);
+    }
+  }
+  /**
+   * Gets messages from the conversation history.
+   * 
+   * @typeParam T - The message type to return
+   * @param params - Query parameters
+   * @returns Array of messages
+   * 
+   * @example
+   * ```typescript
+   * const messages = await adapter.getMessages({
+   *   chatId: 'chat_123',
+   *   limit: 50
+   * });
+   * 
+   * for (const msg of messages) {
+   *   console.log(`[${msg.role}]: ${msg.content}`);
+   * }
+   * ```
+   */
+  async getMessages(params) {
+    const key = this._key("messages", params.chatId);
+    let messages = this._messages.get(key) ?? [];
+    if (params.userId) {
+      messages = messages.filter((m) => m.userId === params.userId);
+    }
+    if (params.limit && params.limit > 0) {
+      messages = messages.slice(-params.limit);
+    }
+    return messages.map((m) => ({
+      id: `${m.chatId}-${m.timestamp.getTime()}`,
+      role: m.role,
+      content: m.content,
+      createdAt: m.timestamp
+    }));
+  }
+  /* ---------------------------------------------------------------------------
+   * CHAT SESSION METHODS
+   * --------------------------------------------------------------------------- */
+  /**
+   * Saves or updates a chat session.
+   * 
+   * @param chat - The chat session to save
+   * 
+   * @example
+   * ```typescript
+   * await adapter.saveChat({
+   *   chatId: 'chat_123',
+   *   userId: 'user_456',
+   *   title: 'TypeScript Help',
+   *   createdAt: new Date(),
+   *   updatedAt: new Date(),
+   *   messageCount: 0
+   * });
+   * ```
+   */
+  async saveChat(chat) {
+    const key = this._key("chats", chat.chatId);
+    this._chats.set(key, chat);
+    if (this._chats.size > this.options.maxChats) {
+      const entries = Array.from(this._chats.entries()).sort((a, b) => a[1].updatedAt.getTime() - b[1].updatedAt.getTime());
+      const toRemove = entries.slice(0, this._chats.size - this.options.maxChats);
+      for (const [k] of toRemove) {
+        this._chats.delete(k);
+      }
+    }
+  }
+  /**
+   * Gets chat sessions matching the query parameters.
+   * 
+   * @param params - Query parameters
+   * @returns Array of chat sessions
+   * 
+   * @example
+   * ```typescript
+   * const chats = await adapter.getChats({
+   *   userId: 'user_456',
+   *   search: 'typescript',
+   *   limit: 10
+   * });
+   * 
+   * for (const chat of chats) {
+   *   console.log(`${chat.title} (${chat.messageCount} messages)`);
+   * }
+   * ```
+   */
+  async getChats(params) {
+    let chats = Array.from(this._chats.values());
+    if (params.userId) {
+      chats = chats.filter((c) => c.userId === params.userId);
+    }
+    if (params.search) {
+      const searchLower = params.search.toLowerCase();
+      chats = chats.filter(
+        (c) => c.title?.toLowerCase().includes(searchLower)
+      );
+    }
+    chats.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+    if (params.limit && params.limit > 0) {
+      chats = chats.slice(0, params.limit);
+    }
+    return chats;
+  }
+  /**
+   * Gets a specific chat session by ID.
+   * 
+   * @param chatId - The chat ID
+   * @returns The chat session or null if not found
+   * 
+   * @example
+   * ```typescript
+   * const chat = await adapter.getChat('chat_123');
+   * 
+   * if (chat) {
+   *   console.log('Title:', chat.title);
+   *   console.log('Messages:', chat.messageCount);
+   * }
+   * ```
+   */
+  async getChat(chatId) {
+    const key = this._key("chats", chatId);
+    return this._chats.get(key) ?? null;
+  }
+  /**
+   * Updates the title of a chat session.
+   * 
+   * @param chatId - The chat ID
+   * @param title - The new title
+   * 
+   * @example
+   * ```typescript
+   * await adapter.updateChatTitle('chat_123', 'New Title');
+   * ```
+   */
+  async updateChatTitle(chatId, title) {
+    const key = this._key("chats", chatId);
+    const chat = this._chats.get(key);
+    if (chat) {
+      chat.title = title;
+      chat.updatedAt = /* @__PURE__ */ new Date();
+    }
+  }
+  /**
+   * Deletes a chat session and its messages.
+   * 
+   * @param chatId - The chat ID to delete
+   * 
+   * @example
+   * ```typescript
+   * await adapter.deleteChat('chat_123');
+   * ```
+   */
+  async deleteChat(chatId) {
+    const chatKey = this._key("chats", chatId);
+    const messagesKey = this._key("messages", chatId);
+    this._chats.delete(chatKey);
+    this._messages.delete(messagesKey);
+  }
+  /* ---------------------------------------------------------------------------
+   * STATS METHODS
+   * --------------------------------------------------------------------------- */
+  /**
+   * Gets storage statistics.
+   * 
+   * @returns Current storage stats
+   * 
+   * @example
+   * ```typescript
+   * const stats = await adapter.getStats();
+   * console.log(`Storing ${stats.messageCount} messages`);
+   * console.log(`Across ${stats.chatCount} chats`);
+   * ```
+   */
+  async getStats() {
+    let messageCount = 0;
+    for (const messages of this._messages.values()) {
+      messageCount += messages.length;
+    }
+    return {
+      workingMemoryCount: this._workingMemory.size,
+      messageCount,
+      chatCount: this._chats.size,
+      timestamp: /* @__PURE__ */ new Date()
+    };
+  }
+};
+var IgniterAgentJSONFileAdapter = class _IgniterAgentJSONFileAdapter {
+  /**
+   * Creates a new IgniterAgentJSONFileAdapter.
+   * 
+   * @param options - Adapter configuration
+   * 
+   * @example
+   * ```typescript
+   * const adapter = new IgniterAgentJSONFileAdapter({
+   *   dataDir: './memory',
+   *   namespace: 'myapp'
+   * });
+   * ```
+   */
+  constructor(options = {}) {
+    /**
+     * Whether the adapter is currently connected and ready to use.
+     * @internal
+     */
+    this._connected = false;
+    /**
+     * In-memory cache of working memory entries.
+     * @internal
+     */
+    this._workingMemoryCache = /* @__PURE__ */ new Map();
+    /**
+     * In-memory cache of messages.
+     * @internal
+     */
+    this._messagesCache = /* @__PURE__ */ new Map();
+    /**
+     * In-memory cache of chat sessions.
+     * @internal
+     */
+    this._chatsCache = /* @__PURE__ */ new Map();
+    this.options = {
+      dataDir: options.dataDir ?? "./igniter-agent-memory",
+      namespace: options.namespace ?? "igniter",
+      autoSync: options.autoSync ?? true,
+      debug: options.debug ?? false,
+      maxMessages: options.maxMessages ?? 1e3,
+      maxChats: options.maxChats ?? 100
+    };
+  }
+  /**
+   * Factory method to create a new adapter instance.
+   * @param options - Adapter configuration
+   * @returns A new IgniterAgentJSONFileAdapter instance
+   *
+   * @example
+   * ```typescript
+   * const adapter = IgniterAgentJSONFileAdapter.create({
+   *   dataDir: './data',
+   * });
+   * ```
+   */
+  static create(options) {
+    return new _IgniterAgentJSONFileAdapter(options);
+  }
+  /* ---------------------------------------------------------------------------
+   * PRIVATE HELPER METHODS
+   * --------------------------------------------------------------------------- */
+  /**
+   * Logs debug messages if debug mode is enabled.
+   * @internal
+   */
+  _log(message, data) {
+    if (this.options.debug) {
+      console.log(`[IgniterAgentJSONFileAdapter] ${message}`, data ?? "");
+    }
+  }
+  /**
+   * Gets the path for the working memory JSON file.
+   * @internal
+   */
+  _getWorkingMemoryPath() {
+    return join(this.options.dataDir, "working-memory.json");
+  }
+  /**
+   * Gets the path for the chats JSON file.
+   * @internal
+   */
+  _getChatsPath() {
+    return join(this.options.dataDir, "chats.json");
+  }
+  /**
+   * Gets the directory for message files.
+   * @internal
+   */
+  _getMessagesDir() {
+    return join(this.options.dataDir, "messages");
+  }
+  /**
+   * Gets the path for a specific chat's messages JSON file.
+   * @internal
+   */
+  _getMessagesPath(chatId) {
+    return join(this._getMessagesDir(), `${chatId}.json`);
+  }
+  /**
+   * Generates a cache key with namespace prefix.
+   * @internal
+   */
+  _key(...parts) {
+    return [this.options.namespace, ...parts].join(":");
+  }
+  /**
+   * Loads working memory from disk.
+   * @internal
+   */
+  async _loadWorkingMemory() {
+    try {
+      const path = this._getWorkingMemoryPath();
+      const content = await readFile(path, "utf-8");
+      const data = JSON.parse(content);
+      this._workingMemoryCache.clear();
+      for (const [key, value] of Object.entries(data)) {
+        this._workingMemoryCache.set(key, {
+          content: value.content,
+          updatedAt: new Date(value.updatedAt)
+        });
+      }
+      this._log("Loaded working memory", {
+        entries: this._workingMemoryCache.size
+      });
+    } catch (err) {
+      this._log("Working memory file not found, starting fresh");
+    }
+  }
+  /**
+   * Loads chats from disk.
+   * @internal
+   */
+  async _loadChats() {
+    try {
+      const path = this._getChatsPath();
+      const content = await readFile(path, "utf-8");
+      const data = JSON.parse(content);
+      this._chatsCache.clear();
+      for (const [key, value] of Object.entries(data)) {
+        const chat = value;
+        this._chatsCache.set(key, {
+          chatId: chat.chatId,
+          userId: chat.userId,
+          title: chat.title,
+          createdAt: new Date(chat.createdAt),
+          updatedAt: new Date(chat.updatedAt),
+          messageCount: chat.messageCount
+        });
+      }
+      this._log("Loaded chats", { entries: this._chatsCache.size });
+    } catch (err) {
+      this._log("Chats file not found, starting fresh");
+    }
+  }
+  /**
+   * Loads a specific chat's messages from disk.
+   * @internal
+   */
+  async _loadMessages(chatId) {
+    try {
+      const path = this._getMessagesPath(chatId);
+      const content = await readFile(path, "utf-8");
+      const data = JSON.parse(content);
+      const key = this._key("messages", chatId);
+      const messages = data.map(
+        (msg) => ({
+          chatId: msg.chatId,
+          userId: msg.userId,
+          role: msg.role,
+          content: msg.content,
+          timestamp: new Date(msg.timestamp)
+        })
+      );
+      this._messagesCache.set(key, messages);
+      this._log("Loaded messages", { chatId, count: messages.length });
+    } catch (err) {
+      this._log("Messages file not found for chat", { chatId });
+    }
+  }
+  /**
+   * Saves working memory to disk.
+   * @internal
+   */
+  async _saveWorkingMemory() {
+    const path = this._getWorkingMemoryPath();
+    const data = {};
+    for (const [key, value] of this._workingMemoryCache.entries()) {
+      data[key] = {
+        content: value.content,
+        updatedAt: value.updatedAt.toISOString()
+      };
+    }
+    await writeFile(path, JSON.stringify(data, null, 2));
+    this._log("Saved working memory");
+  }
+  /**
+   * Saves chats to disk.
+   * @internal
+   */
+  async _saveChats() {
+    const path = this._getChatsPath();
+    const data = {};
+    for (const [key, value] of this._chatsCache.entries()) {
+      data[key] = {
+        chatId: value.chatId,
+        userId: value.userId,
+        title: value.title,
+        createdAt: value.createdAt.toISOString(),
+        updatedAt: value.updatedAt.toISOString(),
+        messageCount: value.messageCount
+      };
+    }
+    await writeFile(path, JSON.stringify(data, null, 2));
+    this._log("Saved chats");
+  }
+  /**
+   * Saves messages for a specific chat to disk.
+   * @internal
+   */
+  async _saveMessages(chatId) {
+    const key = this._key("messages", chatId);
+    const messages = this._messagesCache.get(key) ?? [];
+    const path = this._getMessagesPath(chatId);
+    const data = messages.map((msg) => ({
+      chatId: msg.chatId,
+      userId: msg.userId,
+      role: msg.role,
+      content: msg.content,
+      timestamp: msg.timestamp.toISOString()
+    }));
+    await writeFile(path, JSON.stringify(data, null, 2));
+    this._log("Saved messages", { chatId, count: messages.length });
+  }
+  /* ---------------------------------------------------------------------------
+   * LIFECYCLE METHODS
+   * --------------------------------------------------------------------------- */
+  /**
+   * Connects to the storage backend and loads data from disk.
+   * 
+   * @description
+   * Creates necessary directories and loads all data into memory cache.
+   * Must be called before using the adapter.
+   * 
+   * @throws {Error} If directory creation fails
+   * 
+   * @example
+   * ```typescript
+   * const adapter = new IgniterAgentJSONFileAdapter();
+   * await adapter.connect();
+   * ```
+   */
+  async connect() {
+    try {
+      await mkdir(this.options.dataDir, { recursive: true });
+      await mkdir(this._getMessagesDir(), { recursive: true });
+      await this._loadWorkingMemory();
+      await this._loadChats();
+      this._connected = true;
+      this._log("Connected successfully", {
+        dataDir: this.options.dataDir
+      });
+    } catch (err) {
+      this._log("Connection failed", err);
+      throw err;
+    }
+  }
+  /**
+   * Disconnects from the storage backend.
+   * 
+   * @description
+   * Syncs any pending changes to disk before disconnecting.
+   * 
+   * @example
+   * ```typescript
+   * await adapter.disconnect();
+   * ```
+   */
+  async disconnect() {
+    if (this._connected) {
+      await this.sync();
+      this._connected = false;
+      this._log("Disconnected");
+    }
+  }
+  /**
+   * Checks if the adapter is connected and ready to use.
+   * 
+   * @returns True if connected, false otherwise
+   */
+  isConnected() {
+    return this._connected;
+  }
+  /**
+   * Manually syncs all in-memory data to disk.
+   * 
+   * @description
+   * Called automatically if autoSync is enabled. Can be called manually
+   * to ensure data is persisted to disk.
+   * 
+   * @example
+   * ```typescript
+   * await adapter.updateWorkingMemory({ ... });
+   * await adapter.sync(); // Ensure written to disk
+   * ```
+   */
+  async sync() {
+    try {
+      await this._saveWorkingMemory();
+      await this._saveChats();
+      for (const chatId of this._messagesCache.keys()) {
+        const idParts = chatId.split(":");
+        if (idParts.length > 0) {
+          const actualChatId = idParts[idParts.length - 1];
+          await this._saveMessages(actualChatId);
+        }
+      }
+      this._log("Synced all data to disk");
+    } catch (err) {
+      this._log("Sync failed", err);
+      throw err;
+    }
+  }
+  /**
+   * Clears all stored data from disk and memory.
+   * 
+   * @description
+   * Removes all working memory, messages, and chat sessions.
+   * Use with caution.
+   * 
+   * @example
+   * ```typescript
+   * await adapter.clear();
+   * ```
+   */
+  async clear() {
+    this._workingMemoryCache.clear();
+    this._messagesCache.clear();
+    this._chatsCache.clear();
+    if (this.options.autoSync) {
+      await this.sync();
+    }
+    this._log("Cleared all data");
+  }
+  /* ---------------------------------------------------------------------------
+   * WORKING MEMORY METHODS
+   * --------------------------------------------------------------------------- */
+  /**
+   * Gets working memory for a scope and identifier.
+   * 
+   * @param params - The scope and identifier
+   * @returns The working memory or null if not found
+   * 
+   * @example
+   * ```typescript
+   * const memory = await adapter.getWorkingMemory({
+   *   scope: 'chat',
+   *   identifier: 'chat_123'
+   * });
+   * 
+   * if (memory) {
+   *   console.log('Content:', memory.content);
+   * }
+   * ```
+   */
+  async getWorkingMemory(params) {
+    const key = this._key("memory", params.scope, params.identifier);
+    return this._workingMemoryCache.get(key) ?? null;
+  }
+  /**
+   * Updates working memory for a scope and identifier.
+   * 
+   * @param params - The scope, identifier, and new content
+   * 
+   * @example
+   * ```typescript
+   * await adapter.updateWorkingMemory({
+   *   scope: 'chat',
+   *   identifier: 'chat_123',
+   *   content: 'User prefers TypeScript'
+   * });
+   * ```
+   */
+  async updateWorkingMemory(params) {
+    const key = this._key("memory", params.scope, params.identifier);
+    this._workingMemoryCache.set(key, {
+      content: params.content,
+      updatedAt: /* @__PURE__ */ new Date()
+    });
+    if (this.options.autoSync) {
+      await this._saveWorkingMemory();
+    }
+  }
+  /* ---------------------------------------------------------------------------
+   * MESSAGE METHODS
+   * --------------------------------------------------------------------------- */
+  /**
+   * Saves a message to the conversation history.
+   * 
+   * @param message - The message to save
+   * 
+   * @example
+   * ```typescript
+   * await adapter.saveMessage({
+   *   chatId: 'chat_123',
+   *   userId: 'user_456',
+   *   role: 'user',
+   *   content: 'How do I use TypeScript?',
+   *   timestamp: new Date()
+   * });
+   * ```
+   */
+  async saveMessage(message) {
+    const key = this._key("messages", message.chatId);
+    let messages = this._messagesCache.get(key);
+    if (!messages) {
+      messages = [];
+      this._messagesCache.set(key, messages);
+    }
+    messages.push(message);
+    if (messages.length > this.options.maxMessages) {
+      messages.splice(0, messages.length - this.options.maxMessages);
+    }
+    if (this.options.autoSync) {
+      await this._saveMessages(message.chatId);
+    }
+  }
+  /**
+   * Gets messages from the conversation history.
+   * 
+   * @typeParam T - The message type to return
+   * @param params - Query parameters
+   * @returns Array of messages
+   * 
+   * @example
+   * ```typescript
+   * const messages = await adapter.getMessages({
+   *   chatId: 'chat_123',
+   *   limit: 50
+   * });
+   * 
+   * for (const msg of messages) {
+   *   console.log(`[${msg.role}]: ${msg.content}`);
+   * }
+   * ```
+   */
+  async getMessages(params) {
+    const key = this._key("messages", params.chatId);
+    if (!this._messagesCache.has(key)) {
+      await this._loadMessages(params.chatId);
+    }
+    let messages = this._messagesCache.get(key) ?? [];
+    if (params.userId) {
+      messages = messages.filter((m) => m.userId === params.userId);
+    }
+    if (params.limit && params.limit > 0) {
+      messages = messages.slice(-params.limit);
+    }
+    return messages.map((m) => ({
+      id: `${m.chatId}-${m.timestamp.getTime()}`,
+      role: m.role,
+      content: m.content,
+      createdAt: m.timestamp
+    }));
+  }
+  /* ---------------------------------------------------------------------------
+   * CHAT SESSION METHODS
+   * --------------------------------------------------------------------------- */
+  /**
+   * Saves or updates a chat session.
+   * 
+   * @param chat - The chat session to save
+   * 
+   * @example
+   * ```typescript
+   * await adapter.saveChat({
+   *   chatId: 'chat_123',
+   *   userId: 'user_456',
+   *   title: 'TypeScript Help',
+   *   createdAt: new Date(),
+   *   updatedAt: new Date(),
+   *   messageCount: 0
+   * });
+   * ```
+   */
+  async saveChat(chat) {
+    const key = this._key("chats", chat.chatId);
+    this._chatsCache.set(key, chat);
+    if (this._chatsCache.size > this.options.maxChats) {
+      const entries = Array.from(this._chatsCache.entries()).sort(
+        (a, b) => a[1].updatedAt.getTime() - b[1].updatedAt.getTime()
+      );
+      const toRemove = entries.slice(
+        0,
+        this._chatsCache.size - this.options.maxChats
+      );
+      for (const [k] of toRemove) {
+        this._chatsCache.delete(k);
+      }
+    }
+    if (this.options.autoSync) {
+      await this._saveChats();
+    }
+  }
+  /**
+   * Gets chat sessions matching the query parameters.
+   * 
+   * @param params - Query parameters
+   * @returns Array of chat sessions
+   * 
+   * @example
+   * ```typescript
+   * const chats = await adapter.getChats({
+   *   userId: 'user_456',
+   *   search: 'typescript',
+   *   limit: 10
+   * });
+   * 
+   * for (const chat of chats) {
+   *   console.log(`${chat.title} (${chat.messageCount} messages)`);
+   * }
+   * ```
+   */
+  async getChats(params) {
+    let chats = Array.from(this._chatsCache.values());
+    if (params.userId) {
+      chats = chats.filter((c) => c.userId === params.userId);
+    }
+    if (params.search) {
+      const searchLower = params.search.toLowerCase();
+      chats = chats.filter(
+        (c) => c.title?.toLowerCase().includes(searchLower)
+      );
+    }
+    chats.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+    if (params.limit && params.limit > 0) {
+      chats = chats.slice(0, params.limit);
+    }
+    return chats;
+  }
+  /**
+   * Gets a specific chat session by ID.
+   * 
+   * @param chatId - The chat ID
+   * @returns The chat session or null if not found
+   * 
+   * @example
+   * ```typescript
+   * const chat = await adapter.getChat('chat_123');
+   * 
+   * if (chat) {
+   *   console.log('Title:', chat.title);
+   * }
+   * ```
+   */
+  async getChat(chatId) {
+    const key = this._key("chats", chatId);
+    return this._chatsCache.get(key) ?? null;
+  }
+  /**
+   * Updates the title of a chat session.
+   * 
+   * @param chatId - The chat ID
+   * @param title - The new title
+   * 
+   * @example
+   * ```typescript
+   * await adapter.updateChatTitle('chat_123', 'New Title');
+   * ```
+   */
+  async updateChatTitle(chatId, title) {
+    const key = this._key("chats", chatId);
+    const chat = this._chatsCache.get(key);
+    if (chat) {
+      chat.title = title;
+      chat.updatedAt = /* @__PURE__ */ new Date();
+      if (this.options.autoSync) {
+        await this._saveChats();
+      }
+    }
+  }
+  /**
+   * Deletes a chat session and its messages.
+   * 
+   * @param chatId - The chat ID to delete
+   * 
+   * @example
+   * ```typescript
+   * await adapter.deleteChat('chat_123');
+   * ```
+   */
+  async deleteChat(chatId) {
+    const chatKey = this._key("chats", chatId);
+    const messagesKey = this._key("messages", chatId);
+    this._chatsCache.delete(chatKey);
+    this._messagesCache.delete(messagesKey);
+    if (this.options.autoSync) {
+      await this._saveChats();
+      try {
+        const path = this._getMessagesPath(chatId);
+        await readFile(path);
+        this._log("Messages file for deleted chat still exists");
+      } catch {
+      }
+    }
+  }
+  /* ---------------------------------------------------------------------------
+   * STATS METHODS
+   * --------------------------------------------------------------------------- */
+  /**
+   * Gets storage statistics.
+   * 
+   * @returns Current storage stats
+   * 
+   * @example
+   * ```typescript
+   * const stats = await adapter.getStats();
+   * console.log(`Storing ${stats.messageCount} messages`);
+   * console.log(`Across ${stats.chatCount} chats`);
+   * ```
+   */
+  async getStats() {
+    let messageCount = 0;
+    for (const messages of this._messagesCache.values()) {
+      messageCount += messages.length;
+    }
+    return {
+      workingMemoryCount: this._workingMemoryCache.size,
+      messageCount,
+      chatCount: this._chatsCache.size,
+      timestamp: /* @__PURE__ */ new Date()
+    };
+  }
+};
+
+export { IgniterAgentInMemoryAdapter, IgniterAgentJSONFileAdapter };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map