@agentskit/memory 0.4.2 → 0.5.0

package/README.md

@@ -1,5 +1,7 @@
 # @agentskit/memory
 
+![stability: stable](https://img.shields.io/badge/stability-stable-brightgreen)
+
 Persist conversations and add vector search to your agents — swap backends without changing agent code.
 
 ## Why

package/dist/index.cjs

@@ -8,6 +8,30 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   if (typeof require !== "undefined") return require.apply(this, arguments);
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
+function fileChatMemory(path) {
+  return {
+    async load() {
+      try {
+        const fs = await import('fs/promises');
+        const raw = await fs.readFile(path, "utf8");
+        return core.deserializeMessages(JSON.parse(raw));
+      } catch {
+        return [];
+      }
+    },
+    async save(messages) {
+      const fs = await import('fs/promises');
+      await fs.writeFile(path, JSON.stringify(core.serializeMessages(messages), null, 2), "utf8");
+    },
+    async clear() {
+      try {
+        const fs = await import('fs/promises');
+        await fs.unlink(path);
+      } catch {
+      }
+    }
+  };
+}
 function encodeMessages(messages) {
   return JSON.stringify(core.serializeMessages(messages));
 }
@@ -342,6 +366,7 @@ function fileVectorMemory(config) {
   };
 }
 
+exports.fileChatMemory = fileChatMemory;
 exports.fileVectorMemory = fileVectorMemory;
 exports.redisChatMemory = redisChatMemory;
 exports.redisVectorMemory = redisVectorMemory;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sqlite.ts","../src/redis-client.ts","../src/redis-chat.ts","../src/redis-vector.ts","../src/file-vector.ts"],"names":["serializeMessages","deserializeMessages","encodeMessages","decodeMessages"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ChatMemory, Message, MemoryRecord } from '@agentskit/core'\nimport { serializeMessages, deserializeMessages } from '@agentskit/core'\n\nexport interface SqliteChatMemoryConfig {\n  path: string\n  conversationId?: string\n}\n\nfunction encodeMessages(messages: Message[]): string {\n  return JSON.stringify(serializeMessages(messages))\n}\n\nfunction decodeMessages(json: string | undefined): Message[] {\n  if (!json) return []\n  try {\n    return deserializeMessages(JSON.parse(json) as MemoryRecord)\n  } catch {\n    return []\n  }\n}\n\ninterface SqliteDb {\n  prepare(sql: string): {\n    run(...args: unknown[]): void\n    get(...args: unknown[]): Record<string, unknown> | undefined\n  }\n}\n\nasync function openDatabase(path: string): Promise<SqliteDb> {\n  try {\n    const mod = await import('better-sqlite3')\n    const Database = mod.default ?? mod\n    return new (Database as new (p: string) => SqliteDb)(path)\n  } catch {\n    throw new Error('Install better-sqlite3 to use sqliteChatMemory: npm install better-sqlite3')\n  }\n}\n\nexport function sqliteChatMemory(config: SqliteChatMemoryConfig): ChatMemory {\n  const conversationId = config.conversationId ?? 'default'\n  let dbPromise: Promise<SqliteDb> | null = null\n\n  const getDb = (): Promise<SqliteDb> => {\n    if (!dbPromise) {\n      dbPromise = openDatabase(config.path).then(db => {\n        db.prepare(`\n          CREATE TABLE IF NOT EXISTS conversations (\n            id TEXT PRIMARY KEY,\n            messages TEXT NOT NULL\n          )\n        `).run()\n        return db\n      })\n    }\n    return dbPromise\n  }\n\n  return {\n    async load() {\n      const db = await getDb()\n      const row = db.prepare('SELECT messages FROM conversations WHERE id = ?').get(conversationId)\n      return decodeMessages(row?.messages as string | undefined)\n    },\n    async save(messages) {\n      const db = await getDb()\n      const json = encodeMessages(messages)\n      db.prepare(`\n        INSERT INTO conversations (id, messages) VALUES (?, ?)\n        ON CONFLICT(id) DO UPDATE SET messages = ?\n      `).run(conversationId, json, json)\n    },\n    async clear() {\n      const db = await getDb()\n      db.prepare('DELETE FROM conversations WHERE id = ?').run(conversationId)\n    },\n  }\n}\n","/**\n * Internal Redis client adapter interface.\n * Abstracts the underlying Redis library so it can be swapped\n * (e.g., from `redis` to `ioredis`) without changing consumers.\n */\nexport interface RedisClientAdapter {\n  get(key: string): Promise<string | null>\n  set(key: string, value: string): Promise<void>\n  del(key: string | string[]): Promise<void>\n  keys(pattern: string): Promise<string[]>\n  disconnect(): Promise<void>\n  call(command: string, ...args: (string | number | Buffer)[]): Promise<unknown>\n}\n\nexport interface RedisConnectionConfig {\n  url: string\n  client?: RedisClientAdapter\n}\n\nexport async function createRedisClientAdapter(url: string): Promise<RedisClientAdapter> {\n  let redis: typeof import('redis')\n  try {\n    redis = await import('redis')\n  } catch {\n    throw new Error('Install redis to use Redis memory backends: npm install redis')\n  }\n\n  const client = redis.createClient({ url })\n  await client.connect()\n\n  return {\n    async get(key) {\n      return await client.get(key)\n    },\n    async set(key, value) {\n      await client.set(key, value)\n    },\n    async del(key) {\n      const keys = Array.isArray(key) ? key : [key]\n      if (keys.length > 0) await client.del(keys)\n    },\n    async keys(pattern) {\n      return await client.keys(pattern)\n    },\n    async disconnect() {\n      await client.disconnect()\n    },\n    async call(command, ...args) {\n      return await client.sendCommand([command, ...args.map(String)])\n    },\n  }\n}\n","import type { ChatMemory, Message, MemoryRecord } from '@agentskit/core'\nimport { serializeMessages, deserializeMessages } from '@agentskit/core'\nimport type { RedisClientAdapter, RedisConnectionConfig } from './redis-client'\nimport { createRedisClientAdapter } from './redis-client'\n\nexport interface RedisChatMemoryConfig extends RedisConnectionConfig {\n  keyPrefix?: string\n  conversationId?: string\n}\n\nfunction encodeMessages(messages: Message[]): string {\n  return JSON.stringify(serializeMessages(messages))\n}\n\nfunction decodeMessages(json: string | null): Message[] {\n  if (!json) return []\n  try {\n    return deserializeMessages(JSON.parse(json) as MemoryRecord)\n  } catch {\n    return []\n  }\n}\n\nexport function redisChatMemory(config: RedisChatMemoryConfig): ChatMemory {\n  const prefix = config.keyPrefix ?? 'agentskit:chat'\n  const convId = config.conversationId ?? 'default'\n  const key = `${prefix}:${convId}`\n  let clientPromise: Promise<RedisClientAdapter> | null = null\n\n  const getClient = (): Promise<RedisClientAdapter> => {\n    if (config.client) return Promise.resolve(config.client)\n    if (!clientPromise) clientPromise = createRedisClientAdapter(config.url)\n    return clientPromise\n  }\n\n  return {\n    async load() {\n      const client = await getClient()\n      const json = await client.get(key)\n      return decodeMessages(json)\n    },\n    async save(messages) {\n      const client = await getClient()\n      await client.set(key, encodeMessages(messages))\n    },\n    async clear() {\n      const client = await getClient()\n      await client.del(key)\n    },\n  }\n}\n","import type { VectorMemory, VectorDocument, RetrievedDocument } from '@agentskit/core'\nimport type { RedisClientAdapter, RedisConnectionConfig } from './redis-client'\nimport { createRedisClientAdapter } from './redis-client'\n\nexport interface RedisVectorMemoryConfig extends RedisConnectionConfig {\n  indexName?: string\n  keyPrefix?: string\n  dimensions?: number\n}\n\nfunction float32Buffer(vector: number[]): Buffer {\n  const buffer = Buffer.alloc(vector.length * 4)\n  for (let i = 0; i < vector.length; i++) {\n    buffer.writeFloatLE(vector[i], i * 4)\n  }\n  return buffer\n}\n\nexport function redisVectorMemory(config: RedisVectorMemoryConfig): VectorMemory {\n  const indexName = config.indexName ?? 'agentskit:vectors:idx'\n  const prefix = config.keyPrefix ?? 'agentskit:vec'\n  const dimensions = config.dimensions ?? 0\n  let clientPromise: Promise<RedisClientAdapter> | null = null\n  let indexCreated = false\n\n  const getClient = (): Promise<RedisClientAdapter> => {\n    if (config.client) return Promise.resolve(config.client)\n    if (!clientPromise) clientPromise = createRedisClientAdapter(config.url)\n    return clientPromise\n  }\n\n  const ensureIndex = async (client: RedisClientAdapter, dims: number) => {\n    if (indexCreated) return\n    try {\n      await client.call(\n        'FT.CREATE', indexName,\n        'ON', 'HASH',\n        'PREFIX', '1', `${prefix}:`,\n        'SCHEMA',\n        'content', 'TEXT',\n        'metadata', 'TEXT',\n        'embedding', 'VECTOR', 'HNSW', '6',\n        'TYPE', 'FLOAT32',\n        'DIM', dims,\n        'DISTANCE_METRIC', 'COSINE',\n      )\n    } catch (err: unknown) {\n      const msg = String(err)\n      if (!msg.includes('Index already exists')) throw err\n    }\n    indexCreated = true\n  }\n\n  return {\n    async store(docs: VectorDocument[]) {\n      const client = await getClient()\n      const dims = dimensions || docs[0]?.embedding.length || 0\n      if (dims > 0) await ensureIndex(client, dims)\n\n      for (const doc of docs) {\n        const key = `${prefix}:${doc.id}`\n        await client.call(\n          'HSET', key,\n          'content', doc.content,\n          'metadata', JSON.stringify(doc.metadata ?? {}),\n          'embedding', float32Buffer(doc.embedding),\n        )\n      }\n    },\n    async search(embedding, options) {\n      const client = await getClient()\n      const topK = options?.topK ?? 5\n      const threshold = options?.threshold ?? 0\n\n      const result = await client.call(\n        'FT.SEARCH', indexName,\n        `*=>[KNN ${topK} @embedding $vec AS score]`,\n        'PARAMS', '2', 'vec', float32Buffer(embedding),\n        'SORTBY', 'score',\n        'RETURN', '3', 'content', 'metadata', 'score',\n        'DIALECT', '2',\n      ) as unknown[]\n\n      if (!Array.isArray(result) || result.length < 2) return []\n\n      const docs: RetrievedDocument[] = []\n      // FT.SEARCH returns [total, key1, [field, val, ...], key2, [field, val, ...], ...]\n      for (let i = 1; i < result.length; i += 2) {\n        const key = String(result[i])\n        const fields = result[i + 1] as string[]\n        if (!Array.isArray(fields)) continue\n\n        const fieldMap: Record<string, string> = {}\n        for (let j = 0; j < fields.length; j += 2) {\n          fieldMap[fields[j]] = fields[j + 1]\n        }\n\n        const score = 1 - parseFloat(fieldMap.score ?? '1') // COSINE distance → similarity\n        if (score < threshold) continue\n\n        docs.push({\n          id: key.replace(`${prefix}:`, ''),\n          content: fieldMap.content ?? '',\n          score,\n          metadata: fieldMap.metadata ? JSON.parse(fieldMap.metadata) : undefined,\n        })\n      }\n\n      return docs\n    },\n    async delete(ids) {\n      const client = await getClient()\n      await client.del(ids.map(id => `${prefix}:${id}`))\n    },\n  }\n}\n","import type { VectorMemory, VectorDocument, RetrievedDocument } from '@agentskit/core'\nimport type { VectorStore } from './vector-store'\n\nexport interface FileVectorMemoryConfig {\n  path: string\n  store?: VectorStore\n}\n\nfunction requireVectra(): { LocalIndex: new (path: string) => VectraIndex } {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    return require('vectra')\n  } catch {\n    throw new Error(\n      'Install vectra to use fileVectorMemory: npm install vectra'\n    )\n  }\n}\n\ninterface VectraIndex {\n  isIndexCreated(): Promise<boolean>\n  createIndex(): Promise<void>\n  insertItem(item: { vector: number[]; metadata: Record<string, unknown> }): Promise<unknown>\n  queryItems(vector: number[], topK: number): Promise<Array<{ score: number; item: { metadata: Record<string, unknown> } }>>\n  listItems(): Promise<Array<{ id: string; metadata: Record<string, unknown> }>>;\n  deleteItem(id: string): Promise<void>\n}\n\nfunction createVectraStore(dirPath: string): VectorStore {\n  let index: VectraIndex | null = null\n\n  const getIndex = async (): Promise<VectraIndex> => {\n    if (index) return index\n    const { LocalIndex } = requireVectra()\n    index = new LocalIndex(dirPath)\n    if (!(await index.isIndexCreated())) {\n      await index.createIndex()\n    }\n    return index\n  }\n\n  return {\n    async upsert(docs) {\n      const idx = await getIndex()\n      for (const doc of docs) {\n        await idx.insertItem({\n          vector: doc.vector,\n          metadata: { _id: doc.id, ...doc.metadata },\n        })\n      }\n    },\n    async query(vector, topK) {\n      const idx = await getIndex()\n      const results = await idx.queryItems(vector, topK)\n      return results.map(r => ({\n        id: String(r.item.metadata._id ?? ''),\n        score: r.score,\n        metadata: r.item.metadata,\n      }))\n    },\n    async delete(ids) {\n      const idx = await getIndex()\n      const items = await idx.listItems()\n      for (const item of items) {\n        if (ids.includes(String(item.metadata._id ?? item.id))) {\n          await idx.deleteItem(item.id)\n        }\n      }\n    },\n  }\n}\n\nexport function fileVectorMemory(config: FileVectorMemoryConfig): VectorMemory {\n  const store = config.store ?? createVectraStore(config.path)\n  const contentCache = new Map<string, string>()\n\n  return {\n    async store(docs: VectorDocument[]) {\n      for (const doc of docs) {\n        contentCache.set(doc.id, doc.content)\n      }\n      await store.upsert(docs.map(doc => ({\n        id: doc.id,\n        vector: doc.embedding,\n        metadata: { content: doc.content, ...doc.metadata },\n      })))\n    },\n    async search(embedding, options) {\n      const topK = options?.topK ?? 5\n      const threshold = options?.threshold ?? 0\n      const results = await store.query(embedding, topK)\n\n      return results\n        .filter(r => r.score >= threshold)\n        .map((r): RetrievedDocument => ({\n          id: r.id,\n          content: String(r.metadata.content ?? contentCache.get(r.id) ?? ''),\n          score: r.score,\n          metadata: r.metadata,\n        }))\n    },\n    async delete(ids) {\n      for (const id of ids) contentCache.delete(id)\n      await store.delete(ids)\n    },\n  }\n}\n"]}
+{"version":3,"sources":["../src/file-chat.ts","../src/sqlite.ts","../src/redis-client.ts","../src/redis-chat.ts","../src/redis-vector.ts","../src/file-vector.ts"],"names":["deserializeMessages","serializeMessages","encodeMessages","decodeMessages"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ChatMemory, MemoryRecord } from '@agentskit/core'\nimport { deserializeMessages, serializeMessages } from '@agentskit/core'\n\n/**\n * ChatMemory backed by a JSON file on disk. Node-only.\n *\n * Implements the Memory contract (ADR 0003):\n * - load() returns a snapshot (CM1)\n * - save() is replace-all, not append (CM2)\n * - empty state returns [] (CM5)\n * - clear() is optional but provided here\n */\nexport function fileChatMemory(path: string): ChatMemory {\n  return {\n    async load() {\n      try {\n        const fs = await import('node:fs/promises')\n        const raw = await fs.readFile(path, 'utf8')\n        return deserializeMessages(JSON.parse(raw) as MemoryRecord)\n      } catch {\n        return []\n      }\n    },\n    async save(messages) {\n      const fs = await import('node:fs/promises')\n      await fs.writeFile(path, JSON.stringify(serializeMessages(messages), null, 2), 'utf8')\n    },\n    async clear() {\n      try {\n        const fs = await import('node:fs/promises')\n        await fs.unlink(path)\n      } catch {\n        // Ignore missing files.\n      }\n    },\n  }\n}\n","import type { ChatMemory, Message, MemoryRecord } from '@agentskit/core'\nimport { serializeMessages, deserializeMessages } from '@agentskit/core'\n\nexport interface SqliteChatMemoryConfig {\n  path: string\n  conversationId?: string\n}\n\nfunction encodeMessages(messages: Message[]): string {\n  return JSON.stringify(serializeMessages(messages))\n}\n\nfunction decodeMessages(json: string | undefined): Message[] {\n  if (!json) return []\n  try {\n    return deserializeMessages(JSON.parse(json) as MemoryRecord)\n  } catch {\n    return []\n  }\n}\n\ninterface SqliteDb {\n  prepare(sql: string): {\n    run(...args: unknown[]): void\n    get(...args: unknown[]): Record<string, unknown> | undefined\n  }\n}\n\nasync function openDatabase(path: string): Promise<SqliteDb> {\n  try {\n    const mod = await import('better-sqlite3')\n    const Database = mod.default ?? mod\n    return new (Database as new (p: string) => SqliteDb)(path)\n  } catch {\n    throw new Error('Install better-sqlite3 to use sqliteChatMemory: npm install better-sqlite3')\n  }\n}\n\nexport function sqliteChatMemory(config: SqliteChatMemoryConfig): ChatMemory {\n  const conversationId = config.conversationId ?? 'default'\n  let dbPromise: Promise<SqliteDb> | null = null\n\n  const getDb = (): Promise<SqliteDb> => {\n    if (!dbPromise) {\n      dbPromise = openDatabase(config.path).then(db => {\n        db.prepare(`\n          CREATE TABLE IF NOT EXISTS conversations (\n            id TEXT PRIMARY KEY,\n            messages TEXT NOT NULL\n          )\n        `).run()\n        return db\n      })\n    }\n    return dbPromise\n  }\n\n  return {\n    async load() {\n      const db = await getDb()\n      const row = db.prepare('SELECT messages FROM conversations WHERE id = ?').get(conversationId)\n      return decodeMessages(row?.messages as string | undefined)\n    },\n    async save(messages) {\n      const db = await getDb()\n      const json = encodeMessages(messages)\n      db.prepare(`\n        INSERT INTO conversations (id, messages) VALUES (?, ?)\n        ON CONFLICT(id) DO UPDATE SET messages = ?\n      `).run(conversationId, json, json)\n    },\n    async clear() {\n      const db = await getDb()\n      db.prepare('DELETE FROM conversations WHERE id = ?').run(conversationId)\n    },\n  }\n}\n","/**\n * Internal Redis client adapter interface.\n * Abstracts the underlying Redis library so it can be swapped\n * (e.g., from `redis` to `ioredis`) without changing consumers.\n */\nexport interface RedisClientAdapter {\n  get(key: string): Promise<string | null>\n  set(key: string, value: string): Promise<void>\n  del(key: string | string[]): Promise<void>\n  keys(pattern: string): Promise<string[]>\n  disconnect(): Promise<void>\n  call(command: string, ...args: (string | number | Buffer)[]): Promise<unknown>\n}\n\nexport interface RedisConnectionConfig {\n  url: string\n  client?: RedisClientAdapter\n}\n\nexport async function createRedisClientAdapter(url: string): Promise<RedisClientAdapter> {\n  let redis: typeof import('redis')\n  try {\n    redis = await import('redis')\n  } catch {\n    throw new Error('Install redis to use Redis memory backends: npm install redis')\n  }\n\n  const client = redis.createClient({ url })\n  await client.connect()\n\n  return {\n    async get(key) {\n      return await client.get(key)\n    },\n    async set(key, value) {\n      await client.set(key, value)\n    },\n    async del(key) {\n      const keys = Array.isArray(key) ? key : [key]\n      if (keys.length > 0) await client.del(keys)\n    },\n    async keys(pattern) {\n      return await client.keys(pattern)\n    },\n    async disconnect() {\n      await client.disconnect()\n    },\n    async call(command, ...args) {\n      return await client.sendCommand([command, ...args.map(String)])\n    },\n  }\n}\n","import type { ChatMemory, Message, MemoryRecord } from '@agentskit/core'\nimport { serializeMessages, deserializeMessages } from '@agentskit/core'\nimport type { RedisClientAdapter, RedisConnectionConfig } from './redis-client'\nimport { createRedisClientAdapter } from './redis-client'\n\nexport interface RedisChatMemoryConfig extends RedisConnectionConfig {\n  keyPrefix?: string\n  conversationId?: string\n}\n\nfunction encodeMessages(messages: Message[]): string {\n  return JSON.stringify(serializeMessages(messages))\n}\n\nfunction decodeMessages(json: string | null): Message[] {\n  if (!json) return []\n  try {\n    return deserializeMessages(JSON.parse(json) as MemoryRecord)\n  } catch {\n    return []\n  }\n}\n\nexport function redisChatMemory(config: RedisChatMemoryConfig): ChatMemory {\n  const prefix = config.keyPrefix ?? 'agentskit:chat'\n  const convId = config.conversationId ?? 'default'\n  const key = `${prefix}:${convId}`\n  let clientPromise: Promise<RedisClientAdapter> | null = null\n\n  const getClient = (): Promise<RedisClientAdapter> => {\n    if (config.client) return Promise.resolve(config.client)\n    if (!clientPromise) clientPromise = createRedisClientAdapter(config.url)\n    return clientPromise\n  }\n\n  return {\n    async load() {\n      const client = await getClient()\n      const json = await client.get(key)\n      return decodeMessages(json)\n    },\n    async save(messages) {\n      const client = await getClient()\n      await client.set(key, encodeMessages(messages))\n    },\n    async clear() {\n      const client = await getClient()\n      await client.del(key)\n    },\n  }\n}\n","import type { VectorMemory, VectorDocument, RetrievedDocument } from '@agentskit/core'\nimport type { RedisClientAdapter, RedisConnectionConfig } from './redis-client'\nimport { createRedisClientAdapter } from './redis-client'\n\nexport interface RedisVectorMemoryConfig extends RedisConnectionConfig {\n  indexName?: string\n  keyPrefix?: string\n  dimensions?: number\n}\n\nfunction float32Buffer(vector: number[]): Buffer {\n  const buffer = Buffer.alloc(vector.length * 4)\n  for (let i = 0; i < vector.length; i++) {\n    buffer.writeFloatLE(vector[i], i * 4)\n  }\n  return buffer\n}\n\nexport function redisVectorMemory(config: RedisVectorMemoryConfig): VectorMemory {\n  const indexName = config.indexName ?? 'agentskit:vectors:idx'\n  const prefix = config.keyPrefix ?? 'agentskit:vec'\n  const dimensions = config.dimensions ?? 0\n  let clientPromise: Promise<RedisClientAdapter> | null = null\n  let indexCreated = false\n\n  const getClient = (): Promise<RedisClientAdapter> => {\n    if (config.client) return Promise.resolve(config.client)\n    if (!clientPromise) clientPromise = createRedisClientAdapter(config.url)\n    return clientPromise\n  }\n\n  const ensureIndex = async (client: RedisClientAdapter, dims: number) => {\n    if (indexCreated) return\n    try {\n      await client.call(\n        'FT.CREATE', indexName,\n        'ON', 'HASH',\n        'PREFIX', '1', `${prefix}:`,\n        'SCHEMA',\n        'content', 'TEXT',\n        'metadata', 'TEXT',\n        'embedding', 'VECTOR', 'HNSW', '6',\n        'TYPE', 'FLOAT32',\n        'DIM', dims,\n        'DISTANCE_METRIC', 'COSINE',\n      )\n    } catch (err: unknown) {\n      const msg = String(err)\n      if (!msg.includes('Index already exists')) throw err\n    }\n    indexCreated = true\n  }\n\n  return {\n    async store(docs: VectorDocument[]) {\n      const client = await getClient()\n      const dims = dimensions || docs[0]?.embedding.length || 0\n      if (dims > 0) await ensureIndex(client, dims)\n\n      for (const doc of docs) {\n        const key = `${prefix}:${doc.id}`\n        await client.call(\n          'HSET', key,\n          'content', doc.content,\n          'metadata', JSON.stringify(doc.metadata ?? {}),\n          'embedding', float32Buffer(doc.embedding),\n        )\n      }\n    },\n    async search(embedding, options) {\n      const client = await getClient()\n      const topK = options?.topK ?? 5\n      const threshold = options?.threshold ?? 0\n\n      const result = await client.call(\n        'FT.SEARCH', indexName,\n        `*=>[KNN ${topK} @embedding $vec AS score]`,\n        'PARAMS', '2', 'vec', float32Buffer(embedding),\n        'SORTBY', 'score',\n        'RETURN', '3', 'content', 'metadata', 'score',\n        'DIALECT', '2',\n      ) as unknown[]\n\n      if (!Array.isArray(result) || result.length < 2) return []\n\n      const docs: RetrievedDocument[] = []\n      // FT.SEARCH returns [total, key1, [field, val, ...], key2, [field, val, ...], ...]\n      for (let i = 1; i < result.length; i += 2) {\n        const key = String(result[i])\n        const fields = result[i + 1] as string[]\n        if (!Array.isArray(fields)) continue\n\n        const fieldMap: Record<string, string> = {}\n        for (let j = 0; j < fields.length; j += 2) {\n          fieldMap[fields[j]] = fields[j + 1]\n        }\n\n        const score = 1 - parseFloat(fieldMap.score ?? '1') // COSINE distance → similarity\n        if (score < threshold) continue\n\n        docs.push({\n          id: key.replace(`${prefix}:`, ''),\n          content: fieldMap.content ?? '',\n          score,\n          metadata: fieldMap.metadata ? JSON.parse(fieldMap.metadata) : undefined,\n        })\n      }\n\n      return docs\n    },\n    async delete(ids) {\n      const client = await getClient()\n      await client.del(ids.map(id => `${prefix}:${id}`))\n    },\n  }\n}\n","import type { VectorMemory, VectorDocument, RetrievedDocument } from '@agentskit/core'\nimport type { VectorStore } from './vector-store'\n\nexport interface FileVectorMemoryConfig {\n  path: string\n  store?: VectorStore\n}\n\nfunction requireVectra(): { LocalIndex: new (path: string) => VectraIndex } {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    return require('vectra')\n  } catch {\n    throw new Error(\n      'Install vectra to use fileVectorMemory: npm install vectra'\n    )\n  }\n}\n\ninterface VectraIndex {\n  isIndexCreated(): Promise<boolean>\n  createIndex(): Promise<void>\n  insertItem(item: { vector: number[]; metadata: Record<string, unknown> }): Promise<unknown>\n  queryItems(vector: number[], topK: number): Promise<Array<{ score: number; item: { metadata: Record<string, unknown> } }>>\n  listItems(): Promise<Array<{ id: string; metadata: Record<string, unknown> }>>;\n  deleteItem(id: string): Promise<void>\n}\n\nfunction createVectraStore(dirPath: string): VectorStore {\n  let index: VectraIndex | null = null\n\n  const getIndex = async (): Promise<VectraIndex> => {\n    if (index) return index\n    const { LocalIndex } = requireVectra()\n    index = new LocalIndex(dirPath)\n    if (!(await index.isIndexCreated())) {\n      await index.createIndex()\n    }\n    return index\n  }\n\n  return {\n    async upsert(docs) {\n      const idx = await getIndex()\n      for (const doc of docs) {\n        await idx.insertItem({\n          vector: doc.vector,\n          metadata: { _id: doc.id, ...doc.metadata },\n        })\n      }\n    },\n    async query(vector, topK) {\n      const idx = await getIndex()\n      const results = await idx.queryItems(vector, topK)\n      return results.map(r => ({\n        id: String(r.item.metadata._id ?? ''),\n        score: r.score,\n        metadata: r.item.metadata,\n      }))\n    },\n    async delete(ids) {\n      const idx = await getIndex()\n      const items = await idx.listItems()\n      for (const item of items) {\n        if (ids.includes(String(item.metadata._id ?? item.id))) {\n          await idx.deleteItem(item.id)\n        }\n      }\n    },\n  }\n}\n\nexport function fileVectorMemory(config: FileVectorMemoryConfig): VectorMemory {\n  const store = config.store ?? createVectraStore(config.path)\n  const contentCache = new Map<string, string>()\n\n  return {\n    async store(docs: VectorDocument[]) {\n      for (const doc of docs) {\n        contentCache.set(doc.id, doc.content)\n      }\n      await store.upsert(docs.map(doc => ({\n        id: doc.id,\n        vector: doc.embedding,\n        metadata: { content: doc.content, ...doc.metadata },\n      })))\n    },\n    async search(embedding, options) {\n      const topK = options?.topK ?? 5\n      const threshold = options?.threshold ?? 0\n      const results = await store.query(embedding, topK)\n\n      return results\n        .filter(r => r.score >= threshold)\n        .map((r): RetrievedDocument => ({\n          id: r.id,\n          content: String(r.metadata.content ?? contentCache.get(r.id) ?? ''),\n          score: r.score,\n          metadata: r.metadata,\n        }))\n    },\n    async delete(ids) {\n      for (const id of ids) contentCache.delete(id)\n      await store.delete(ids)\n    },\n  }\n}\n"]}

package/dist/index.d.cts

@@ -1,5 +1,16 @@
 import { ChatMemory, VectorMemory } from '@agentskit/core';
 
+/**
+ * ChatMemory backed by a JSON file on disk. Node-only.
+ *
+ * Implements the Memory contract (ADR 0003):
+ * - load() returns a snapshot (CM1)
+ * - save() is replace-all, not append (CM2)
+ * - empty state returns [] (CM5)
+ * - clear() is optional but provided here
+ */
+declare function fileChatMemory(path: string): ChatMemory;
+
 interface SqliteChatMemoryConfig {
     path: string;
     conversationId?: string;
@@ -59,4 +70,4 @@ interface FileVectorMemoryConfig {
 }
 declare function fileVectorMemory(config: FileVectorMemoryConfig): VectorMemory;
 
-export { type FileVectorMemoryConfig, type RedisChatMemoryConfig, type RedisClientAdapter, type RedisConnectionConfig, type RedisVectorMemoryConfig, type SqliteChatMemoryConfig, type VectorStore, type VectorStoreDocument, type VectorStoreResult, fileVectorMemory, redisChatMemory, redisVectorMemory, sqliteChatMemory };
+export { type FileVectorMemoryConfig, type RedisChatMemoryConfig, type RedisClientAdapter, type RedisConnectionConfig, type RedisVectorMemoryConfig, type SqliteChatMemoryConfig, type VectorStore, type VectorStoreDocument, type VectorStoreResult, fileChatMemory, fileVectorMemory, redisChatMemory, redisVectorMemory, sqliteChatMemory };

package/dist/index.d.ts

@@ -1,5 +1,16 @@
 import { ChatMemory, VectorMemory } from '@agentskit/core';
 
+/**
+ * ChatMemory backed by a JSON file on disk. Node-only.
+ *
+ * Implements the Memory contract (ADR 0003):
+ * - load() returns a snapshot (CM1)
+ * - save() is replace-all, not append (CM2)
+ * - empty state returns [] (CM5)
+ * - clear() is optional but provided here
+ */
+declare function fileChatMemory(path: string): ChatMemory;
+
 interface SqliteChatMemoryConfig {
     path: string;
     conversationId?: string;
@@ -59,4 +70,4 @@ interface FileVectorMemoryConfig {
 }
 declare function fileVectorMemory(config: FileVectorMemoryConfig): VectorMemory;
 
-export { type FileVectorMemoryConfig, type RedisChatMemoryConfig, type RedisClientAdapter, type RedisConnectionConfig, type RedisVectorMemoryConfig, type SqliteChatMemoryConfig, type VectorStore, type VectorStoreDocument, type VectorStoreResult, fileVectorMemory, redisChatMemory, redisVectorMemory, sqliteChatMemory };
+export { type FileVectorMemoryConfig, type RedisChatMemoryConfig, type RedisClientAdapter, type RedisConnectionConfig, type RedisVectorMemoryConfig, type SqliteChatMemoryConfig, type VectorStore, type VectorStoreDocument, type VectorStoreResult, fileChatMemory, fileVectorMemory, redisChatMemory, redisVectorMemory, sqliteChatMemory };

package/dist/index.js

@@ -6,6 +6,30 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   if (typeof require !== "undefined") return require.apply(this, arguments);
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
+function fileChatMemory(path) {
+  return {
+    async load() {
+      try {
+        const fs = await import('fs/promises');
+        const raw = await fs.readFile(path, "utf8");
+        return deserializeMessages(JSON.parse(raw));
+      } catch {
+        return [];
+      }
+    },
+    async save(messages) {
+      const fs = await import('fs/promises');
+      await fs.writeFile(path, JSON.stringify(serializeMessages(messages), null, 2), "utf8");
+    },
+    async clear() {
+      try {
+        const fs = await import('fs/promises');
+        await fs.unlink(path);
+      } catch {
+      }
+    }
+  };
+}
 function encodeMessages(messages) {
   return JSON.stringify(serializeMessages(messages));
 }
@@ -340,6 +364,6 @@ function fileVectorMemory(config) {
   };
 }
 
-export { fileVectorMemory, redisChatMemory, redisVectorMemory, sqliteChatMemory };
+export { fileChatMemory, fileVectorMemory, redisChatMemory, redisVectorMemory, sqliteChatMemory };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sqlite.ts","../src/redis-client.ts","../src/redis-chat.ts","../src/redis-vector.ts","../src/file-vector.ts"],"names":["encodeMessages","serializeMessages","decodeMessages","deserializeMessages"],"mappings":"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","file":"index.js","sourcesContent":["import type { ChatMemory, Message, MemoryRecord } from '@agentskit/core'\nimport { serializeMessages, deserializeMessages } from '@agentskit/core'\n\nexport interface SqliteChatMemoryConfig {\n  path: string\n  conversationId?: string\n}\n\nfunction encodeMessages(messages: Message[]): string {\n  return JSON.stringify(serializeMessages(messages))\n}\n\nfunction decodeMessages(json: string | undefined): Message[] {\n  if (!json) return []\n  try {\n    return deserializeMessages(JSON.parse(json) as MemoryRecord)\n  } catch {\n    return []\n  }\n}\n\ninterface SqliteDb {\n  prepare(sql: string): {\n    run(...args: unknown[]): void\n    get(...args: unknown[]): Record<string, unknown> | undefined\n  }\n}\n\nasync function openDatabase(path: string): Promise<SqliteDb> {\n  try {\n    const mod = await import('better-sqlite3')\n    const Database = mod.default ?? mod\n    return new (Database as new (p: string) => SqliteDb)(path)\n  } catch {\n    throw new Error('Install better-sqlite3 to use sqliteChatMemory: npm install better-sqlite3')\n  }\n}\n\nexport function sqliteChatMemory(config: SqliteChatMemoryConfig): ChatMemory {\n  const conversationId = config.conversationId ?? 'default'\n  let dbPromise: Promise<SqliteDb> | null = null\n\n  const getDb = (): Promise<SqliteDb> => {\n    if (!dbPromise) {\n      dbPromise = openDatabase(config.path).then(db => {\n        db.prepare(`\n          CREATE TABLE IF NOT EXISTS conversations (\n            id TEXT PRIMARY KEY,\n            messages TEXT NOT NULL\n          )\n        `).run()\n        return db\n      })\n    }\n    return dbPromise\n  }\n\n  return {\n    async load() {\n      const db = await getDb()\n      const row = db.prepare('SELECT messages FROM conversations WHERE id = ?').get(conversationId)\n      return decodeMessages(row?.messages as string | undefined)\n    },\n    async save(messages) {\n      const db = await getDb()\n      const json = encodeMessages(messages)\n      db.prepare(`\n        INSERT INTO conversations (id, messages) VALUES (?, ?)\n        ON CONFLICT(id) DO UPDATE SET messages = ?\n      `).run(conversationId, json, json)\n    },\n    async clear() {\n      const db = await getDb()\n      db.prepare('DELETE FROM conversations WHERE id = ?').run(conversationId)\n    },\n  }\n}\n","/**\n * Internal Redis client adapter interface.\n * Abstracts the underlying Redis library so it can be swapped\n * (e.g., from `redis` to `ioredis`) without changing consumers.\n */\nexport interface RedisClientAdapter {\n  get(key: string): Promise<string | null>\n  set(key: string, value: string): Promise<void>\n  del(key: string | string[]): Promise<void>\n  keys(pattern: string): Promise<string[]>\n  disconnect(): Promise<void>\n  call(command: string, ...args: (string | number | Buffer)[]): Promise<unknown>\n}\n\nexport interface RedisConnectionConfig {\n  url: string\n  client?: RedisClientAdapter\n}\n\nexport async function createRedisClientAdapter(url: string): Promise<RedisClientAdapter> {\n  let redis: typeof import('redis')\n  try {\n    redis = await import('redis')\n  } catch {\n    throw new Error('Install redis to use Redis memory backends: npm install redis')\n  }\n\n  const client = redis.createClient({ url })\n  await client.connect()\n\n  return {\n    async get(key) {\n      return await client.get(key)\n    },\n    async set(key, value) {\n      await client.set(key, value)\n    },\n    async del(key) {\n      const keys = Array.isArray(key) ? key : [key]\n      if (keys.length > 0) await client.del(keys)\n    },\n    async keys(pattern) {\n      return await client.keys(pattern)\n    },\n    async disconnect() {\n      await client.disconnect()\n    },\n    async call(command, ...args) {\n      return await client.sendCommand([command, ...args.map(String)])\n    },\n  }\n}\n","import type { ChatMemory, Message, MemoryRecord } from '@agentskit/core'\nimport { serializeMessages, deserializeMessages } from '@agentskit/core'\nimport type { RedisClientAdapter, RedisConnectionConfig } from './redis-client'\nimport { createRedisClientAdapter } from './redis-client'\n\nexport interface RedisChatMemoryConfig extends RedisConnectionConfig {\n  keyPrefix?: string\n  conversationId?: string\n}\n\nfunction encodeMessages(messages: Message[]): string {\n  return JSON.stringify(serializeMessages(messages))\n}\n\nfunction decodeMessages(json: string | null): Message[] {\n  if (!json) return []\n  try {\n    return deserializeMessages(JSON.parse(json) as MemoryRecord)\n  } catch {\n    return []\n  }\n}\n\nexport function redisChatMemory(config: RedisChatMemoryConfig): ChatMemory {\n  const prefix = config.keyPrefix ?? 'agentskit:chat'\n  const convId = config.conversationId ?? 'default'\n  const key = `${prefix}:${convId}`\n  let clientPromise: Promise<RedisClientAdapter> | null = null\n\n  const getClient = (): Promise<RedisClientAdapter> => {\n    if (config.client) return Promise.resolve(config.client)\n    if (!clientPromise) clientPromise = createRedisClientAdapter(config.url)\n    return clientPromise\n  }\n\n  return {\n    async load() {\n      const client = await getClient()\n      const json = await client.get(key)\n      return decodeMessages(json)\n    },\n    async save(messages) {\n      const client = await getClient()\n      await client.set(key, encodeMessages(messages))\n    },\n    async clear() {\n      const client = await getClient()\n      await client.del(key)\n    },\n  }\n}\n","import type { VectorMemory, VectorDocument, RetrievedDocument } from '@agentskit/core'\nimport type { RedisClientAdapter, RedisConnectionConfig } from './redis-client'\nimport { createRedisClientAdapter } from './redis-client'\n\nexport interface RedisVectorMemoryConfig extends RedisConnectionConfig {\n  indexName?: string\n  keyPrefix?: string\n  dimensions?: number\n}\n\nfunction float32Buffer(vector: number[]): Buffer {\n  const buffer = Buffer.alloc(vector.length * 4)\n  for (let i = 0; i < vector.length; i++) {\n    buffer.writeFloatLE(vector[i], i * 4)\n  }\n  return buffer\n}\n\nexport function redisVectorMemory(config: RedisVectorMemoryConfig): VectorMemory {\n  const indexName = config.indexName ?? 'agentskit:vectors:idx'\n  const prefix = config.keyPrefix ?? 'agentskit:vec'\n  const dimensions = config.dimensions ?? 0\n  let clientPromise: Promise<RedisClientAdapter> | null = null\n  let indexCreated = false\n\n  const getClient = (): Promise<RedisClientAdapter> => {\n    if (config.client) return Promise.resolve(config.client)\n    if (!clientPromise) clientPromise = createRedisClientAdapter(config.url)\n    return clientPromise\n  }\n\n  const ensureIndex = async (client: RedisClientAdapter, dims: number) => {\n    if (indexCreated) return\n    try {\n      await client.call(\n        'FT.CREATE', indexName,\n        'ON', 'HASH',\n        'PREFIX', '1', `${prefix}:`,\n        'SCHEMA',\n        'content', 'TEXT',\n        'metadata', 'TEXT',\n        'embedding', 'VECTOR', 'HNSW', '6',\n        'TYPE', 'FLOAT32',\n        'DIM', dims,\n        'DISTANCE_METRIC', 'COSINE',\n      )\n    } catch (err: unknown) {\n      const msg = String(err)\n      if (!msg.includes('Index already exists')) throw err\n    }\n    indexCreated = true\n  }\n\n  return {\n    async store(docs: VectorDocument[]) {\n      const client = await getClient()\n      const dims = dimensions || docs[0]?.embedding.length || 0\n      if (dims > 0) await ensureIndex(client, dims)\n\n      for (const doc of docs) {\n        const key = `${prefix}:${doc.id}`\n        await client.call(\n          'HSET', key,\n          'content', doc.content,\n          'metadata', JSON.stringify(doc.metadata ?? {}),\n          'embedding', float32Buffer(doc.embedding),\n        )\n      }\n    },\n    async search(embedding, options) {\n      const client = await getClient()\n      const topK = options?.topK ?? 5\n      const threshold = options?.threshold ?? 0\n\n      const result = await client.call(\n        'FT.SEARCH', indexName,\n        `*=>[KNN ${topK} @embedding $vec AS score]`,\n        'PARAMS', '2', 'vec', float32Buffer(embedding),\n        'SORTBY', 'score',\n        'RETURN', '3', 'content', 'metadata', 'score',\n        'DIALECT', '2',\n      ) as unknown[]\n\n      if (!Array.isArray(result) || result.length < 2) return []\n\n      const docs: RetrievedDocument[] = []\n      // FT.SEARCH returns [total, key1, [field, val, ...], key2, [field, val, ...], ...]\n      for (let i = 1; i < result.length; i += 2) {\n        const key = String(result[i])\n        const fields = result[i + 1] as string[]\n        if (!Array.isArray(fields)) continue\n\n        const fieldMap: Record<string, string> = {}\n        for (let j = 0; j < fields.length; j += 2) {\n          fieldMap[fields[j]] = fields[j + 1]\n        }\n\n        const score = 1 - parseFloat(fieldMap.score ?? '1') // COSINE distance → similarity\n        if (score < threshold) continue\n\n        docs.push({\n          id: key.replace(`${prefix}:`, ''),\n          content: fieldMap.content ?? '',\n          score,\n          metadata: fieldMap.metadata ? JSON.parse(fieldMap.metadata) : undefined,\n        })\n      }\n\n      return docs\n    },\n    async delete(ids) {\n      const client = await getClient()\n      await client.del(ids.map(id => `${prefix}:${id}`))\n    },\n  }\n}\n","import type { VectorMemory, VectorDocument, RetrievedDocument } from '@agentskit/core'\nimport type { VectorStore } from './vector-store'\n\nexport interface FileVectorMemoryConfig {\n  path: string\n  store?: VectorStore\n}\n\nfunction requireVectra(): { LocalIndex: new (path: string) => VectraIndex } {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    return require('vectra')\n  } catch {\n    throw new Error(\n      'Install vectra to use fileVectorMemory: npm install vectra'\n    )\n  }\n}\n\ninterface VectraIndex {\n  isIndexCreated(): Promise<boolean>\n  createIndex(): Promise<void>\n  insertItem(item: { vector: number[]; metadata: Record<string, unknown> }): Promise<unknown>\n  queryItems(vector: number[], topK: number): Promise<Array<{ score: number; item: { metadata: Record<string, unknown> } }>>\n  listItems(): Promise<Array<{ id: string; metadata: Record<string, unknown> }>>;\n  deleteItem(id: string): Promise<void>\n}\n\nfunction createVectraStore(dirPath: string): VectorStore {\n  let index: VectraIndex | null = null\n\n  const getIndex = async (): Promise<VectraIndex> => {\n    if (index) return index\n    const { LocalIndex } = requireVectra()\n    index = new LocalIndex(dirPath)\n    if (!(await index.isIndexCreated())) {\n      await index.createIndex()\n    }\n    return index\n  }\n\n  return {\n    async upsert(docs) {\n      const idx = await getIndex()\n      for (const doc of docs) {\n        await idx.insertItem({\n          vector: doc.vector,\n          metadata: { _id: doc.id, ...doc.metadata },\n        })\n      }\n    },\n    async query(vector, topK) {\n      const idx = await getIndex()\n      const results = await idx.queryItems(vector, topK)\n      return results.map(r => ({\n        id: String(r.item.metadata._id ?? ''),\n        score: r.score,\n        metadata: r.item.metadata,\n      }))\n    },\n    async delete(ids) {\n      const idx = await getIndex()\n      const items = await idx.listItems()\n      for (const item of items) {\n        if (ids.includes(String(item.metadata._id ?? item.id))) {\n          await idx.deleteItem(item.id)\n        }\n      }\n    },\n  }\n}\n\nexport function fileVectorMemory(config: FileVectorMemoryConfig): VectorMemory {\n  const store = config.store ?? createVectraStore(config.path)\n  const contentCache = new Map<string, string>()\n\n  return {\n    async store(docs: VectorDocument[]) {\n      for (const doc of docs) {\n        contentCache.set(doc.id, doc.content)\n      }\n      await store.upsert(docs.map(doc => ({\n        id: doc.id,\n        vector: doc.embedding,\n        metadata: { content: doc.content, ...doc.metadata },\n      })))\n    },\n    async search(embedding, options) {\n      const topK = options?.topK ?? 5\n      const threshold = options?.threshold ?? 0\n      const results = await store.query(embedding, topK)\n\n      return results\n        .filter(r => r.score >= threshold)\n        .map((r): RetrievedDocument => ({\n          id: r.id,\n          content: String(r.metadata.content ?? contentCache.get(r.id) ?? ''),\n          score: r.score,\n          metadata: r.metadata,\n        }))\n    },\n    async delete(ids) {\n      for (const id of ids) contentCache.delete(id)\n      await store.delete(ids)\n    },\n  }\n}\n"]}
+{"version":3,"sources":["../src/file-chat.ts","../src/sqlite.ts","../src/redis-client.ts","../src/redis-chat.ts","../src/redis-vector.ts","../src/file-vector.ts"],"names":["serializeMessages","deserializeMessages","encodeMessages","decodeMessages"],"mappings":";;;;;;;;AAYO,SAAS,eAAe,IAAA,EAA0B;AACvD,EAAA,OAAO;AAAA,IACL,MAAM,IAAA,GAAO;AACX,MAAA,IAAI;AACF,QAAA,MAAM,EAAA,GAAK,MAAM,OAAO,aAAkB,CAAA;AAC1C,QAAA,MAAM,GAAA,GAAM,MAAM,EAAA,CAAG,QAAA,CAAS,MAAM,MAAM,CAAA;AAC1C,QAAA,OAAO,mBAAA,CAAoB,IAAA,CAAK,KAAA,CAAM,GAAG,CAAiB,CAAA;AAAA,MAC5D,CAAA,CAAA,MAAQ;AACN,QAAA,OAAO,EAAC;AAAA,MACV;AAAA,IACF,CAAA;AAAA,IACA,MAAM,KAAK,QAAA,EAAU;AACnB,MAAA,MAAM,EAAA,GAAK,MAAM,OAAO,aAAkB,CAAA;AAC1C,MAAA,MAAM,EAAA,CAAG,SAAA,CAAU,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,iBAAA,CAAkB,QAAQ,CAAA,EAAG,IAAA,EAAM,CAAC,CAAA,EAAG,MAAM,CAAA;AAAA,IACvF,CAAA;AAAA,IACA,MAAM,KAAA,GAAQ;AACZ,MAAA,IAAI;AACF,QAAA,MAAM,EAAA,GAAK,MAAM,OAAO,aAAkB,CAAA;AAC1C,QAAA,MAAM,EAAA,CAAG,OAAO,IAAI,CAAA;AAAA,MACtB,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF;AAAA,GACF;AACF;AC5BA,SAAS,eAAe,QAAA,EAA6B;AACnD,EAAA,OAAO,IAAA,CAAK,SAAA,CAAUA,iBAAAA,CAAkB,QAAQ,CAAC,CAAA;AACnD;AAEA,SAAS,eAAe,IAAA,EAAqC;AAC3D,EAAA,IAAI,CAAC,IAAA,EAAM,OAAO,EAAC;AACnB,EAAA,IAAI;AACF,IAAA,OAAOC,mBAAAA,CAAoB,IAAA,CAAK,KAAA,CAAM,IAAI,CAAiB,CAAA;AAAA,EAC7D,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAC;AAAA,EACV;AACF;AASA,eAAe,aAAa,IAAA,EAAiC;AAC3D,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAM,OAAO,gBAAgB,CAAA;AACzC,IAAA,MAAM,QAAA,GAAW,IAAI,OAAA,IAAW,GAAA;AAChC,IAAA,OAAO,IAAK,SAAyC,IAAI,CAAA;AAAA,EAC3D,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,MAAM,4EAA4E,CAAA;AAAA,EAC9F;AACF;AAEO,SAAS,iBAAiB,MAAA,EAA4C;AAC3E,EAAA,MAAM,cAAA,GAAiB,OAAO,cAAA,IAAkB,SAAA;AAChD,EAAA,IAAI,SAAA,GAAsC,IAAA;AAE1C,EAAA,MAAM,QAAQ,MAAyB;AACrC,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,SAAA,GAAY,YAAA,CAAa,MAAA,CAAO,IAAI,CAAA,CAAE,KAAK,CAAA,EAAA,KAAM;AAC/C,QAAA,EAAA,CAAG,OAAA,CAAQ;AAAA;AAAA;AAAA;AAAA;AAAA,QAAA,CAKV,EAAE,GAAA,EAAI;AACP,QAAA,OAAO,EAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH;AACA,IAAA,OAAO,SAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,MAAM,IAAA,GAAO;AACX,MAAA,MAAM,EAAA,GAAK,MAAM,KAAA,EAAM;AACvB,MAAA,MAAM,MAAM,EAAA,CAAG,OAAA,CAAQ,iDAAiD,CAAA,CAAE,IAAI,cAAc,CAAA;AAC5F,MAAA,OAAO,cAAA,CAAe,KAAK,QAA8B,CAAA;AAAA,IAC3D,CAAA;AAAA,IACA,MAAM,KAAK,QAAA,EAAU;AACnB,MAAA,MAAM,EAAA,GAAK,MAAM,KAAA,EAAM;AACvB,MAAA,MAAM,IAAA,GAAO,eAAe,QAAQ,CAAA;AACpC,MAAA,EAAA,CAAG,OAAA,CAAQ;AAAA;AAAA;AAAA,MAAA,CAGV,CAAA,CAAE,GAAA,CAAI,cAAA,EAAgB,IAAA,EAAM,IAAI,CAAA;AAAA,IACnC,CAAA;AAAA,IACA,MAAM,KAAA,GAAQ;AACZ,MAAA,MAAM,EAAA,GAAK,MAAM,KAAA,EAAM;AACvB,MAAA,EAAA,CAAG,OAAA,CAAQ,wCAAwC,CAAA,CAAE,GAAA,CAAI,cAAc,CAAA;AAAA,IACzE;AAAA,GACF;AACF;;;ACzDA,eAAsB,yBAAyB,GAAA,EAA0C;AACvF,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI;AACF,IAAA,KAAA,GAAQ,MAAM,OAAO,OAAO,CAAA;AAAA,EAC9B,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,MAAM,+DAA+D,CAAA;AAAA,EACjF;AAEA,EAAA,MAAM,MAAA,GAAS,KAAA,CAAM,YAAA,CAAa,EAAE,KAAK,CAAA;AACzC,EAAA,MAAM,OAAO,OAAA,EAAQ;AAErB,EAAA,OAAO;AAAA,IACL,MAAM,IAAI,GAAA,EAAK;AACb,MAAA,OAAO,MAAM,MAAA,CAAO,GAAA,CAAI,GAAG,CAAA;AAAA,IAC7B,CAAA;AAAA,IACA,MAAM,GAAA,CAAI,GAAA,EAAK,KAAA,EAAO;AACpB,MAAA,MAAM,MAAA,CAAO,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AAAA,IAC7B,CAAA;AAAA,IACA,MAAM,IAAI,GAAA,EAAK;AACb,MAAA,MAAM,OAAO,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,GAAI,GAAA,GAAM,CAAC,GAAG,CAAA;AAC5C,MAAA,IAAI,KAAK,MAAA,GAAS,CAAA,EAAG,MAAM,MAAA,CAAO,IAAI,IAAI,CAAA;AAAA,IAC5C,CAAA;AAAA,IACA,MAAM,KAAK,OAAA,EAAS;AAClB,MAAA,OAAO,MAAM,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA;AAAA,IAClC,CAAA;AAAA,IACA,MAAM,UAAA,GAAa;AACjB,MAAA,MAAM,OAAO,UAAA,EAAW;AAAA,IAC1B,CAAA;AAAA,IACA,MAAM,IAAA,CAAK,OAAA,EAAA,GAAY,IAAA,EAAM;AAC3B,MAAA,OAAO,MAAM,MAAA,CAAO,WAAA,CAAY,CAAC,OAAA,EAAS,GAAG,IAAA,CAAK,GAAA,CAAI,MAAM,CAAC,CAAC,CAAA;AAAA,IAChE;AAAA,GACF;AACF;;;ACzCA,SAASC,gBAAe,QAAA,EAA6B;AACnD,EAAA,OAAO,IAAA,CAAK,SAAA,CAAUF,iBAAAA,CAAkB,QAAQ,CAAC,CAAA;AACnD;AAEA,SAASG,gBAAe,IAAA,EAAgC;AACtD,EAAA,IAAI,CAAC,IAAA,EAAM,OAAO,EAAC;AACnB,EAAA,IAAI;AACF,IAAA,OAAOF,mBAAAA,CAAoB,IAAA,CAAK,KAAA,CAAM,IAAI,CAAiB,CAAA;AAAA,EAC7D,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAC;AAAA,EACV;AACF;AAEO,SAAS,gBAAgB,MAAA,EAA2C;AACzE,EAAA,MAAM,MAAA,GAAS,OAAO,SAAA,IAAa,gBAAA;AACnC,EAAA,MAAM,MAAA,GAAS,OAAO,cAAA,IAAkB,SAAA;AACxC,EAAA,MAAM,GAAA,GAAM,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,MAAM,CAAA,CAAA;AAC/B,EAAA,IAAI,aAAA,GAAoD,IAAA;AAExD,EAAA,MAAM,YAAY,MAAmC;AACnD,IAAA,IAAI,OAAO,MAAA,EAAQ,OAAO,OAAA,CAAQ,OAAA,CAAQ,OAAO,MAAM,CAAA;AACvD,IAAA,IAAI,CAAC,aAAA,EAAe,aAAA,GAAgB,wBAAA,CAAyB,OAAO,GAAG,CAAA;AACvE,IAAA,OAAO,aAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,MAAM,IAAA,GAAO;AACX,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAAU;AAC/B,MAAA,MAAM,IAAA,GAAO,MAAM,MAAA,CAAO,GAAA,CAAI,GAAG,CAAA;AACjC,MAAA,OAAOE,gBAAe,IAAI,CAAA;AAAA,IAC5B,CAAA;AAAA,IACA,MAAM,KAAK,QAAA,EAAU;AACnB,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAAU;AAC/B,MAAA,MAAM,MAAA,CAAO,GAAA,CAAI,GAAA,EAAKD,eAAAA,CAAe,QAAQ,CAAC,CAAA;AAAA,IAChD,CAAA;AAAA,IACA,MAAM,KAAA,GAAQ;AACZ,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAAU;AAC/B,MAAA,MAAM,MAAA,CAAO,IAAI,GAAG,CAAA;AAAA,IACtB;AAAA,GACF;AACF;;;ACxCA,SAAS,cAAc,MAAA,EAA0B;AAC/C,EAAA,MAAM,MAAA,GAAS,MAAA,CAAO,KAAA,CAAM,MAAA,CAAO,SAAS,CAAC,CAAA;AAC7C,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,MAAA,CAAO,QAAQ,CAAA,EAAA,EAAK;AACtC,IAAA,MAAA,CAAO,YAAA,CAAa,MAAA,CAAO,CAAC,CAAA,EAAG,IAAI,CAAC,CAAA;AAAA,EACtC;AACA,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,kBAAkB,MAAA,EAA+C;AAC/E,EAAA,MAAM,SAAA,GAAY,OAAO,SAAA,IAAa,uBAAA;AACtC,EAAA,MAAM,MAAA,GAAS,OAAO,SAAA,IAAa,eAAA;AACnC,EAAA,MAAM,UAAA,GAAa,OAAO,UAAA,IAAc,CAAA;AACxC,EAAA,IAAI,aAAA,GAAoD,IAAA;AACxD,EAAA,IAAI,YAAA,GAAe,KAAA;AAEnB,EAAA,MAAM,YAAY,MAAmC;AACnD,IAAA,IAAI,OAAO,MAAA,EAAQ,OAAO,OAAA,CAAQ,OAAA,CAAQ,OAAO,MAAM,CAAA;AACvD,IAAA,IAAI,CAAC,aAAA,EAAe,aAAA,GAAgB,wBAAA,CAAyB,OAAO,GAAG,CAAA;AACvE,IAAA,OAAO,aAAA;AAAA,EACT,CAAA;AAEA,EAAA,MAAM,WAAA,GAAc,OAAO,MAAA,EAA4B,IAAA,KAAiB;AACtE,IAAA,IAAI,YAAA,EAAc;AAClB,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,CAAO,IAAA;AAAA,QACX,WAAA;AAAA,QAAa,SAAA;AAAA,QACb,IAAA;AAAA,QAAM,MAAA;AAAA,QACN,QAAA;AAAA,QAAU,GAAA;AAAA,QAAK,GAAG,MAAM,CAAA,CAAA,CAAA;AAAA,QACxB,QAAA;AAAA,QACA,SAAA;AAAA,QAAW,MAAA;AAAA,QACX,UAAA;AAAA,QAAY,MAAA;AAAA,QACZ,WAAA;AAAA,QAAa,QAAA;AAAA,QAAU,MAAA;AAAA,QAAQ,GAAA;AAAA,QAC/B,MAAA;AAAA,QAAQ,SAAA;AAAA,QACR,KAAA;AAAA,QAAO,IAAA;AAAA,QACP,iBAAA;AAAA,QAAmB;AAAA,OACrB;AAAA,IACF,SAAS,GAAA,EAAc;AACrB,MAAA,MAAM,GAAA,GAAM,OAAO,GAAG,CAAA;AACtB,MAAA,IAAI,CAAC,GAAA,CAAI,QAAA,CAAS,sBAAsB,GAAG,MAAM,GAAA;AAAA,IACnD;AACA,IAAA,YAAA,GAAe,IAAA;AAAA,EACjB,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,MAAM,MAAM,IAAA,EAAwB;AAClC,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAAU;AAC/B,MAAA,MAAM,OAAO,UAAA,IAAc,IAAA,CAAK,CAAC,CAAA,EAAG,UAAU,MAAA,IAAU,CAAA;AACxD,MAAA,IAAI,IAAA,GAAO,CAAA,EAAG,MAAM,WAAA,CAAY,QAAQ,IAAI,CAAA;AAE5C,MAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,QAAA,MAAM,GAAA,GAAM,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,IAAI,EAAE,CAAA,CAAA;AAC/B,QAAA,MAAM,MAAA,CAAO,IAAA;AAAA,UACX,MAAA;AAAA,UAAQ,GAAA;AAAA,UACR,SAAA;AAAA,UAAW,GAAA,CAAI,OAAA;AAAA,UACf,UAAA;AAAA,UAAY,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,QAAA,IAAY,EAAE,CAAA;AAAA,UAC7C,WAAA;AAAA,UAAa,aAAA,CAAc,IAAI,SAAS;AAAA,SAC1C;AAAA,MACF;AAAA,IACF,CAAA;AAAA,IACA,MAAM,MAAA,CAAO,SAAA,EAAW,OAAA,EAAS;AAC/B,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAAU;AAC/B,MAAA,MAAM,IAAA,GAAO,SAAS,IAAA,IAAQ,CAAA;AAC9B,MAAA,MAAM,SAAA,GAAY,SAAS,SAAA,IAAa,CAAA;AAExC,MAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,IAAA;AAAA,QAC1B,WAAA;AAAA,QAAa,SAAA;AAAA,QACb,WAAW,IAAI,CAAA,0BAAA,CAAA;AAAA,QACf,QAAA;AAAA,QAAU,GAAA;AAAA,QAAK,KAAA;AAAA,QAAO,cAAc,SAAS,CAAA;AAAA,QAC7C,QAAA;AAAA,QAAU,OAAA;AAAA,QACV,QAAA;AAAA,QAAU,GAAA;AAAA,QAAK,SAAA;AAAA,QAAW,UAAA;AAAA,QAAY,OAAA;AAAA,QACtC,SAAA;AAAA,QAAW;AAAA,OACb;AAEA,MAAA,IAAI,CAAC,MAAM,OAAA,CAAQ,MAAM,KAAK,MAAA,CAAO,MAAA,GAAS,CAAA,EAAG,OAAO,EAAC;AAEzD,MAAA,MAAM,OAA4B,EAAC;AAEnC,MAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,MAAA,CAAO,MAAA,EAAQ,KAAK,CAAA,EAAG;AACzC,QAAA,MAAM,GAAA,GAAM,MAAA,CAAO,MAAA,CAAO,CAAC,CAAC,CAAA;AAC5B,QAAA,MAAM,MAAA,GAAS,MAAA,CAAO,CAAA,GAAI,CAAC,CAAA;AAC3B,QAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA,EAAG;AAE5B,QAAA,MAAM,WAAmC,EAAC;AAC1C,QAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,MAAA,CAAO,MAAA,EAAQ,KAAK,CAAA,EAAG;AACzC,UAAA,QAAA,CAAS,OAAO,CAAC,CAAC,CAAA,GAAI,MAAA,CAAO,IAAI,CAAC,CAAA;AAAA,QACpC;AAEA,QAAA,MAAM,KAAA,GAAQ,CAAA,GAAI,UAAA,CAAW,QAAA,CAAS,SAAS,GAAG,CAAA;AAClD,QAAA,IAAI,QAAQ,SAAA,EAAW;AAEvB,QAAA,IAAA,CAAK,IAAA,CAAK;AAAA,UACR,IAAI,GAAA,CAAI,OAAA,CAAQ,CAAA,EAAG,MAAM,KAAK,EAAE,CAAA;AAAA,UAChC,OAAA,EAAS,SAAS,OAAA,IAAW,EAAA;AAAA,UAC7B,KAAA;AAAA,UACA,UAAU,QAAA,CAAS,QAAA,GAAW,KAAK,KAAA,CAAM,QAAA,CAAS,QAAQ,CAAA,GAAI;AAAA,SAC/D,CAAA;AAAA,MACH;AAEA,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IACA,MAAM,OAAO,GAAA,EAAK;AAChB,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAAU;AAC/B,MAAA,MAAM,MAAA,CAAO,GAAA,CAAI,GAAA,CAAI,GAAA,CAAI,CAAA,EAAA,KAAM,GAAG,MAAM,CAAA,CAAA,EAAI,EAAE,CAAA,CAAE,CAAC,CAAA;AAAA,IACnD;AAAA,GACF;AACF;;;AC3GA,SAAS,aAAA,GAAmE;AAC1E,EAAA,IAAI;AAEF,IAAA,OAAO,UAAQ,QAAQ,CAAA;AAAA,EACzB,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACF;AAWA,SAAS,kBAAkB,OAAA,EAA8B;AACvD,EAAA,IAAI,KAAA,GAA4B,IAAA;AAEhC,EAAA,MAAM,WAAW,YAAkC;AACjD,IAAA,IAAI,OAAO,OAAO,KAAA;AAClB,IAAA,MAAM,EAAE,UAAA,EAAW,GAAI,aAAA,EAAc;AACrC,IAAA,KAAA,GAAQ,IAAI,WAAW,OAAO,CAAA;AAC9B,IAAA,IAAI,CAAE,MAAM,KAAA,CAAM,cAAA,EAAe,EAAI;AACnC,MAAA,MAAM,MAAM,WAAA,EAAY;AAAA,IAC1B;AACA,IAAA,OAAO,KAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,MAAM,OAAO,IAAA,EAAM;AACjB,MAAA,MAAM,GAAA,GAAM,MAAM,QAAA,EAAS;AAC3B,MAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,QAAA,MAAM,IAAI,UAAA,CAAW;AAAA,UACnB,QAAQ,GAAA,CAAI,MAAA;AAAA,UACZ,UAAU,EAAE,GAAA,EAAK,IAAI,EAAA,EAAI,GAAG,IAAI,QAAA;AAAS,SAC1C,CAAA;AAAA,MACH;AAAA,IACF,CAAA;AAAA,IACA,MAAM,KAAA,CAAM,MAAA,EAAQ,IAAA,EAAM;AACxB,MAAA,MAAM,GAAA,GAAM,MAAM,QAAA,EAAS;AAC3B,MAAA,MAAM,OAAA,GAAU,MAAM,GAAA,CAAI,UAAA,CAAW,QAAQ,IAAI,CAAA;AACjD,MAAA,OAAO,OAAA,CAAQ,IAAI,CAAA,CAAA,MAAM;AAAA,QACvB,IAAI,MAAA,CAAO,CAAA,CAAE,IAAA,CAAK,QAAA,CAAS,OAAO,EAAE,CAAA;AAAA,QACpC,OAAO,CAAA,CAAE,KAAA;AAAA,QACT,QAAA,EAAU,EAAE,IAAA,CAAK;AAAA,OACnB,CAAE,CAAA;AAAA,IACJ,CAAA;AAAA,IACA,MAAM,OAAO,GAAA,EAAK;AAChB,MAAA,MAAM,GAAA,GAAM,MAAM,QAAA,EAAS;AAC3B,MAAA,MAAM,KAAA,GAAQ,MAAM,GAAA,CAAI,SAAA,EAAU;AAClC,MAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,QAAA,IAAI,GAAA,CAAI,SAAS,MAAA,CAAO,IAAA,CAAK,SAAS,GAAA,IAAO,IAAA,CAAK,EAAE,CAAC,CAAA,EAAG;AACtD,UAAA,MAAM,GAAA,CAAI,UAAA,CAAW,IAAA,CAAK,EAAE,CAAA;AAAA,QAC9B;AAAA,MACF;AAAA,IACF;AAAA,GACF;AACF;AAEO,SAAS,iBAAiB,MAAA,EAA8C;AAC7E,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,KAAA,IAAS,iBAAA,CAAkB,OAAO,IAAI,CAAA;AAC3D,EAAA,MAAM,YAAA,uBAAmB,GAAA,EAAoB;AAE7C,EAAA,OAAO;AAAA,IACL,MAAM,MAAM,IAAA,EAAwB;AAClC,MAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,QAAA,YAAA,CAAa,GAAA,CAAI,GAAA,CAAI,EAAA,EAAI,GAAA,CAAI,OAAO,CAAA;AAAA,MACtC;AACA,MAAA,MAAM,KAAA,CAAM,MAAA,CAAO,IAAA,CAAK,GAAA,CAAI,CAAA,GAAA,MAAQ;AAAA,QAClC,IAAI,GAAA,CAAI,EAAA;AAAA,QACR,QAAQ,GAAA,CAAI,SAAA;AAAA,QACZ,UAAU,EAAE,OAAA,EAAS,IAAI,OAAA,EAAS,GAAG,IAAI,QAAA;AAAS,QAClD,CAAC,CAAA;AAAA,IACL,CAAA;AAAA,IACA,MAAM,MAAA,CAAO,SAAA,EAAW,OAAA,EAAS;AAC/B,MAAA,MAAM,IAAA,GAAO,SAAS,IAAA,IAAQ,CAAA;AAC9B,MAAA,MAAM,SAAA,GAAY,SAAS,SAAA,IAAa,CAAA;AACxC,MAAA,MAAM,OAAA,GAAU,MAAM,KAAA,CAAM,KAAA,CAAM,WAAW,IAAI,CAAA;AAEjD,MAAA,OAAO,OAAA,CACJ,OAAO,CAAA,CAAA,KAAK,CAAA,CAAE,SAAS,SAAS,CAAA,CAChC,GAAA,CAAI,CAAC,CAAA,MAA0B;AAAA,QAC9B,IAAI,CAAA,CAAE,EAAA;AAAA,QACN,OAAA,EAAS,MAAA,CAAO,CAAA,CAAE,QAAA,CAAS,OAAA,IAAW,aAAa,GAAA,CAAI,CAAA,CAAE,EAAE,CAAA,IAAK,EAAE,CAAA;AAAA,QAClE,OAAO,CAAA,CAAE,KAAA;AAAA,QACT,UAAU,CAAA,CAAE;AAAA,OACd,CAAE,CAAA;AAAA,IACN,CAAA;AAAA,IACA,MAAM,OAAO,GAAA,EAAK;AAChB,MAAA,KAAA,MAAW,EAAA,IAAM,GAAA,EAAK,YAAA,CAAa,MAAA,CAAO,EAAE,CAAA;AAC5C,MAAA,MAAM,KAAA,CAAM,OAAO,GAAG,CAAA;AAAA,IACxB;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import type { ChatMemory, MemoryRecord } from '@agentskit/core'\nimport { deserializeMessages, serializeMessages } from '@agentskit/core'\n\n/**\n * ChatMemory backed by a JSON file on disk. Node-only.\n *\n * Implements the Memory contract (ADR 0003):\n * - load() returns a snapshot (CM1)\n * - save() is replace-all, not append (CM2)\n * - empty state returns [] (CM5)\n * - clear() is optional but provided here\n */\nexport function fileChatMemory(path: string): ChatMemory {\n  return {\n    async load() {\n      try {\n        const fs = await import('node:fs/promises')\n        const raw = await fs.readFile(path, 'utf8')\n        return deserializeMessages(JSON.parse(raw) as MemoryRecord)\n      } catch {\n        return []\n      }\n    },\n    async save(messages) {\n      const fs = await import('node:fs/promises')\n      await fs.writeFile(path, JSON.stringify(serializeMessages(messages), null, 2), 'utf8')\n    },\n    async clear() {\n      try {\n        const fs = await import('node:fs/promises')\n        await fs.unlink(path)\n      } catch {\n        // Ignore missing files.\n      }\n    },\n  }\n}\n","import type { ChatMemory, Message, MemoryRecord } from '@agentskit/core'\nimport { serializeMessages, deserializeMessages } from '@agentskit/core'\n\nexport interface SqliteChatMemoryConfig {\n  path: string\n  conversationId?: string\n}\n\nfunction encodeMessages(messages: Message[]): string {\n  return JSON.stringify(serializeMessages(messages))\n}\n\nfunction decodeMessages(json: string | undefined): Message[] {\n  if (!json) return []\n  try {\n    return deserializeMessages(JSON.parse(json) as MemoryRecord)\n  } catch {\n    return []\n  }\n}\n\ninterface SqliteDb {\n  prepare(sql: string): {\n    run(...args: unknown[]): void\n    get(...args: unknown[]): Record<string, unknown> | undefined\n  }\n}\n\nasync function openDatabase(path: string): Promise<SqliteDb> {\n  try {\n    const mod = await import('better-sqlite3')\n    const Database = mod.default ?? mod\n    return new (Database as new (p: string) => SqliteDb)(path)\n  } catch {\n    throw new Error('Install better-sqlite3 to use sqliteChatMemory: npm install better-sqlite3')\n  }\n}\n\nexport function sqliteChatMemory(config: SqliteChatMemoryConfig): ChatMemory {\n  const conversationId = config.conversationId ?? 'default'\n  let dbPromise: Promise<SqliteDb> | null = null\n\n  const getDb = (): Promise<SqliteDb> => {\n    if (!dbPromise) {\n      dbPromise = openDatabase(config.path).then(db => {\n        db.prepare(`\n          CREATE TABLE IF NOT EXISTS conversations (\n            id TEXT PRIMARY KEY,\n            messages TEXT NOT NULL\n          )\n        `).run()\n        return db\n      })\n    }\n    return dbPromise\n  }\n\n  return {\n    async load() {\n      const db = await getDb()\n      const row = db.prepare('SELECT messages FROM conversations WHERE id = ?').get(conversationId)\n      return decodeMessages(row?.messages as string | undefined)\n    },\n    async save(messages) {\n      const db = await getDb()\n      const json = encodeMessages(messages)\n      db.prepare(`\n        INSERT INTO conversations (id, messages) VALUES (?, ?)\n        ON CONFLICT(id) DO UPDATE SET messages = ?\n      `).run(conversationId, json, json)\n    },\n    async clear() {\n      const db = await getDb()\n      db.prepare('DELETE FROM conversations WHERE id = ?').run(conversationId)\n    },\n  }\n}\n","/**\n * Internal Redis client adapter interface.\n * Abstracts the underlying Redis library so it can be swapped\n * (e.g., from `redis` to `ioredis`) without changing consumers.\n */\nexport interface RedisClientAdapter {\n  get(key: string): Promise<string | null>\n  set(key: string, value: string): Promise<void>\n  del(key: string | string[]): Promise<void>\n  keys(pattern: string): Promise<string[]>\n  disconnect(): Promise<void>\n  call(command: string, ...args: (string | number | Buffer)[]): Promise<unknown>\n}\n\nexport interface RedisConnectionConfig {\n  url: string\n  client?: RedisClientAdapter\n}\n\nexport async function createRedisClientAdapter(url: string): Promise<RedisClientAdapter> {\n  let redis: typeof import('redis')\n  try {\n    redis = await import('redis')\n  } catch {\n    throw new Error('Install redis to use Redis memory backends: npm install redis')\n  }\n\n  const client = redis.createClient({ url })\n  await client.connect()\n\n  return {\n    async get(key) {\n      return await client.get(key)\n    },\n    async set(key, value) {\n      await client.set(key, value)\n    },\n    async del(key) {\n      const keys = Array.isArray(key) ? key : [key]\n      if (keys.length > 0) await client.del(keys)\n    },\n    async keys(pattern) {\n      return await client.keys(pattern)\n    },\n    async disconnect() {\n      await client.disconnect()\n    },\n    async call(command, ...args) {\n      return await client.sendCommand([command, ...args.map(String)])\n    },\n  }\n}\n","import type { ChatMemory, Message, MemoryRecord } from '@agentskit/core'\nimport { serializeMessages, deserializeMessages } from '@agentskit/core'\nimport type { RedisClientAdapter, RedisConnectionConfig } from './redis-client'\nimport { createRedisClientAdapter } from './redis-client'\n\nexport interface RedisChatMemoryConfig extends RedisConnectionConfig {\n  keyPrefix?: string\n  conversationId?: string\n}\n\nfunction encodeMessages(messages: Message[]): string {\n  return JSON.stringify(serializeMessages(messages))\n}\n\nfunction decodeMessages(json: string | null): Message[] {\n  if (!json) return []\n  try {\n    return deserializeMessages(JSON.parse(json) as MemoryRecord)\n  } catch {\n    return []\n  }\n}\n\nexport function redisChatMemory(config: RedisChatMemoryConfig): ChatMemory {\n  const prefix = config.keyPrefix ?? 'agentskit:chat'\n  const convId = config.conversationId ?? 'default'\n  const key = `${prefix}:${convId}`\n  let clientPromise: Promise<RedisClientAdapter> | null = null\n\n  const getClient = (): Promise<RedisClientAdapter> => {\n    if (config.client) return Promise.resolve(config.client)\n    if (!clientPromise) clientPromise = createRedisClientAdapter(config.url)\n    return clientPromise\n  }\n\n  return {\n    async load() {\n      const client = await getClient()\n      const json = await client.get(key)\n      return decodeMessages(json)\n    },\n    async save(messages) {\n      const client = await getClient()\n      await client.set(key, encodeMessages(messages))\n    },\n    async clear() {\n      const client = await getClient()\n      await client.del(key)\n    },\n  }\n}\n","import type { VectorMemory, VectorDocument, RetrievedDocument } from '@agentskit/core'\nimport type { RedisClientAdapter, RedisConnectionConfig } from './redis-client'\nimport { createRedisClientAdapter } from './redis-client'\n\nexport interface RedisVectorMemoryConfig extends RedisConnectionConfig {\n  indexName?: string\n  keyPrefix?: string\n  dimensions?: number\n}\n\nfunction float32Buffer(vector: number[]): Buffer {\n  const buffer = Buffer.alloc(vector.length * 4)\n  for (let i = 0; i < vector.length; i++) {\n    buffer.writeFloatLE(vector[i], i * 4)\n  }\n  return buffer\n}\n\nexport function redisVectorMemory(config: RedisVectorMemoryConfig): VectorMemory {\n  const indexName = config.indexName ?? 'agentskit:vectors:idx'\n  const prefix = config.keyPrefix ?? 'agentskit:vec'\n  const dimensions = config.dimensions ?? 0\n  let clientPromise: Promise<RedisClientAdapter> | null = null\n  let indexCreated = false\n\n  const getClient = (): Promise<RedisClientAdapter> => {\n    if (config.client) return Promise.resolve(config.client)\n    if (!clientPromise) clientPromise = createRedisClientAdapter(config.url)\n    return clientPromise\n  }\n\n  const ensureIndex = async (client: RedisClientAdapter, dims: number) => {\n    if (indexCreated) return\n    try {\n      await client.call(\n        'FT.CREATE', indexName,\n        'ON', 'HASH',\n        'PREFIX', '1', `${prefix}:`,\n        'SCHEMA',\n        'content', 'TEXT',\n        'metadata', 'TEXT',\n        'embedding', 'VECTOR', 'HNSW', '6',\n        'TYPE', 'FLOAT32',\n        'DIM', dims,\n        'DISTANCE_METRIC', 'COSINE',\n      )\n    } catch (err: unknown) {\n      const msg = String(err)\n      if (!msg.includes('Index already exists')) throw err\n    }\n    indexCreated = true\n  }\n\n  return {\n    async store(docs: VectorDocument[]) {\n      const client = await getClient()\n      const dims = dimensions || docs[0]?.embedding.length || 0\n      if (dims > 0) await ensureIndex(client, dims)\n\n      for (const doc of docs) {\n        const key = `${prefix}:${doc.id}`\n        await client.call(\n          'HSET', key,\n          'content', doc.content,\n          'metadata', JSON.stringify(doc.metadata ?? {}),\n          'embedding', float32Buffer(doc.embedding),\n        )\n      }\n    },\n    async search(embedding, options) {\n      const client = await getClient()\n      const topK = options?.topK ?? 5\n      const threshold = options?.threshold ?? 0\n\n      const result = await client.call(\n        'FT.SEARCH', indexName,\n        `*=>[KNN ${topK} @embedding $vec AS score]`,\n        'PARAMS', '2', 'vec', float32Buffer(embedding),\n        'SORTBY', 'score',\n        'RETURN', '3', 'content', 'metadata', 'score',\n        'DIALECT', '2',\n      ) as unknown[]\n\n      if (!Array.isArray(result) || result.length < 2) return []\n\n      const docs: RetrievedDocument[] = []\n      // FT.SEARCH returns [total, key1, [field, val, ...], key2, [field, val, ...], ...]\n      for (let i = 1; i < result.length; i += 2) {\n        const key = String(result[i])\n        const fields = result[i + 1] as string[]\n        if (!Array.isArray(fields)) continue\n\n        const fieldMap: Record<string, string> = {}\n        for (let j = 0; j < fields.length; j += 2) {\n          fieldMap[fields[j]] = fields[j + 1]\n        }\n\n        const score = 1 - parseFloat(fieldMap.score ?? '1') // COSINE distance → similarity\n        if (score < threshold) continue\n\n        docs.push({\n          id: key.replace(`${prefix}:`, ''),\n          content: fieldMap.content ?? '',\n          score,\n          metadata: fieldMap.metadata ? JSON.parse(fieldMap.metadata) : undefined,\n        })\n      }\n\n      return docs\n    },\n    async delete(ids) {\n      const client = await getClient()\n      await client.del(ids.map(id => `${prefix}:${id}`))\n    },\n  }\n}\n","import type { VectorMemory, VectorDocument, RetrievedDocument } from '@agentskit/core'\nimport type { VectorStore } from './vector-store'\n\nexport interface FileVectorMemoryConfig {\n  path: string\n  store?: VectorStore\n}\n\nfunction requireVectra(): { LocalIndex: new (path: string) => VectraIndex } {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    return require('vectra')\n  } catch {\n    throw new Error(\n      'Install vectra to use fileVectorMemory: npm install vectra'\n    )\n  }\n}\n\ninterface VectraIndex {\n  isIndexCreated(): Promise<boolean>\n  createIndex(): Promise<void>\n  insertItem(item: { vector: number[]; metadata: Record<string, unknown> }): Promise<unknown>\n  queryItems(vector: number[], topK: number): Promise<Array<{ score: number; item: { metadata: Record<string, unknown> } }>>\n  listItems(): Promise<Array<{ id: string; metadata: Record<string, unknown> }>>;\n  deleteItem(id: string): Promise<void>\n}\n\nfunction createVectraStore(dirPath: string): VectorStore {\n  let index: VectraIndex | null = null\n\n  const getIndex = async (): Promise<VectraIndex> => {\n    if (index) return index\n    const { LocalIndex } = requireVectra()\n    index = new LocalIndex(dirPath)\n    if (!(await index.isIndexCreated())) {\n      await index.createIndex()\n    }\n    return index\n  }\n\n  return {\n    async upsert(docs) {\n      const idx = await getIndex()\n      for (const doc of docs) {\n        await idx.insertItem({\n          vector: doc.vector,\n          metadata: { _id: doc.id, ...doc.metadata },\n        })\n      }\n    },\n    async query(vector, topK) {\n      const idx = await getIndex()\n      const results = await idx.queryItems(vector, topK)\n      return results.map(r => ({\n        id: String(r.item.metadata._id ?? ''),\n        score: r.score,\n        metadata: r.item.metadata,\n      }))\n    },\n    async delete(ids) {\n      const idx = await getIndex()\n      const items = await idx.listItems()\n      for (const item of items) {\n        if (ids.includes(String(item.metadata._id ?? item.id))) {\n          await idx.deleteItem(item.id)\n        }\n      }\n    },\n  }\n}\n\nexport function fileVectorMemory(config: FileVectorMemoryConfig): VectorMemory {\n  const store = config.store ?? createVectraStore(config.path)\n  const contentCache = new Map<string, string>()\n\n  return {\n    async store(docs: VectorDocument[]) {\n      for (const doc of docs) {\n        contentCache.set(doc.id, doc.content)\n      }\n      await store.upsert(docs.map(doc => ({\n        id: doc.id,\n        vector: doc.embedding,\n        metadata: { content: doc.content, ...doc.metadata },\n      })))\n    },\n    async search(embedding, options) {\n      const topK = options?.topK ?? 5\n      const threshold = options?.threshold ?? 0\n      const results = await store.query(embedding, topK)\n\n      return results\n        .filter(r => r.score >= threshold)\n        .map((r): RetrievedDocument => ({\n          id: r.id,\n          content: String(r.metadata.content ?? contentCache.get(r.id) ?? ''),\n          score: r.score,\n          metadata: r.metadata,\n        }))\n    },\n    async delete(ids) {\n      for (const id of ids) contentCache.delete(id)\n      await store.delete(ids)\n    },\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentskit/memory",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Persistent and vector memory backends for AgentsKit.",
   "keywords": [
     "agentskit",
@@ -31,21 +31,26 @@
     "access": "public"
   },
   "dependencies": {
-    "@agentskit/core": "0.4.2"
+    "@agentskit/core": "1.0.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.12",
-    "@types/node": "^25.5.2",
-    "better-sqlite3": "^12.8.0",
-    "redis": "^5.11.0",
+    "@types/node": "^25.6.0",
+    "better-sqlite3": "^12.9.0",
+    "redis": "^5.12.1",
     "tsup": "^8.5.0",
     "typescript": "^6.0.2",
     "vectra": "^0.14.0",
-    "vitest": "^4.1.2"
+    "vitest": "^4.1.4"
+  },
+  "agentskit": {
+    "stability": "stable",
+    "stabilityNote": "File/SQLite/Redis backends — Memory contract v1."
   },
   "scripts": {
     "build": "tsup",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "lint": "tsc --noEmit",
     "dev": "tsup --watch"
   }