@agentskit/memory 0.4.0

package/README.md

@@ -0,0 +1,64 @@
+# @agentskit/memory
+
+Persistent and vector memory backends for [AgentsKit](https://github.com/EmersonBraun/agentskit).
+
+## Install
+
+```bash
+npm install @agentskit/memory
+```
+
+Then install the backend(s) you need:
+
+```bash
+npm install better-sqlite3  # for sqliteChatMemory
+npm install vectra           # for fileVectorMemory (default, pure JS)
+npm install redis            # for redisChatMemory / redisVectorMemory
+```
+
+## Backends
+
+| Factory | Contract | Underlying lib | Native? |
+|---------|----------|---------------|---------|
+| `sqliteChatMemory({ path })` | ChatMemory | better-sqlite3 | Yes |
+| `redisChatMemory({ url })` | ChatMemory | redis | No |
+| `redisVectorMemory({ url })` | VectorMemory | redis + RediSearch | No |
+| `fileVectorMemory({ path })` | VectorMemory | vectra | No (pure JS) |
+
+## Quick example
+
+```ts
+import { sqliteChatMemory, fileVectorMemory } from '@agentskit/memory'
+
+// Chat persistence
+const chatMemory = sqliteChatMemory({ path: './chat.db' })
+
+// Vector search
+const vectorMemory = fileVectorMemory({ path: './vectors' })
+await vectorMemory.store([{
+  id: 'doc-1',
+  content: 'AgentsKit is awesome',
+  embedding: [0.1, 0.2, 0.3, ...],
+}])
+const results = await vectorMemory.search([0.1, 0.2, 0.3, ...], { topK: 5 })
+```
+
+## Custom vector store
+
+Bring your own vector backend (LanceDB, usearch, Pinecone, etc.):
+
+```ts
+import type { VectorStore } from '@agentskit/memory'
+
+const myStore: VectorStore = {
+  async upsert(docs) { /* your logic */ },
+  async query(vector, topK) { /* your logic */ },
+  async delete(ids) { /* your logic */ },
+}
+
+const memory = fileVectorMemory({ path: './vectors', store: myStore })
+```
+
+## Docs
+
+[Full documentation](https://emersonbraun.github.io/agentskit/)

package/dist/index.cjs

@@ -0,0 +1,374 @@
+'use strict';
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/sqlite.ts
+function serializeMessages(messages) {
+  const record = {
+    version: 1,
+    messages: messages.map((m) => ({
+      ...m,
+      createdAt: m.createdAt.toISOString()
+    }))
+  };
+  return JSON.stringify(record);
+}
+function deserializeMessages(json) {
+  if (!json) return [];
+  try {
+    const record = JSON.parse(json);
+    if (!record?.messages) return [];
+    return record.messages.map((m) => ({
+      ...m,
+      createdAt: new Date(m.createdAt)
+    }));
+  } catch {
+    return [];
+  }
+}
+async function openDatabase(path) {
+  try {
+    const mod = await import('better-sqlite3');
+    const Database = mod.default ?? mod;
+    return new Database(path);
+  } catch {
+    throw new Error("Install better-sqlite3 to use sqliteChatMemory: npm install better-sqlite3");
+  }
+}
+function sqliteChatMemory(config) {
+  const conversationId = config.conversationId ?? "default";
+  let dbPromise = null;
+  const getDb = () => {
+    if (!dbPromise) {
+      dbPromise = openDatabase(config.path).then((db) => {
+        db.prepare(`
+          CREATE TABLE IF NOT EXISTS conversations (
+            id TEXT PRIMARY KEY,
+            messages TEXT NOT NULL
+          )
+        `).run();
+        return db;
+      });
+    }
+    return dbPromise;
+  };
+  return {
+    async load() {
+      const db = await getDb();
+      const row = db.prepare("SELECT messages FROM conversations WHERE id = ?").get(conversationId);
+      return deserializeMessages(row?.messages);
+    },
+    async save(messages) {
+      const db = await getDb();
+      const json = serializeMessages(messages);
+      db.prepare(`
+        INSERT INTO conversations (id, messages) VALUES (?, ?)
+        ON CONFLICT(id) DO UPDATE SET messages = ?
+      `).run(conversationId, json, json);
+    },
+    async clear() {
+      const db = await getDb();
+      db.prepare("DELETE FROM conversations WHERE id = ?").run(conversationId);
+    }
+  };
+}
+
+// src/redis-client.ts
+async function createRedisClientAdapter(url) {
+  let redis;
+  try {
+    redis = await import('redis');
+  } catch {
+    throw new Error("Install redis to use Redis memory backends: npm install redis");
+  }
+  const client = redis.createClient({ url });
+  await client.connect();
+  return {
+    async get(key) {
+      return await client.get(key);
+    },
+    async set(key, value) {
+      await client.set(key, value);
+    },
+    async del(key) {
+      const keys = Array.isArray(key) ? key : [key];
+      if (keys.length > 0) await client.del(keys);
+    },
+    async keys(pattern) {
+      return await client.keys(pattern);
+    },
+    async disconnect() {
+      await client.disconnect();
+    },
+    async call(command, ...args) {
+      return await client.sendCommand([command, ...args.map(String)]);
+    }
+  };
+}
+
+// src/redis-chat.ts
+function serializeMessages2(messages) {
+  const record = {
+    version: 1,
+    messages: messages.map((m) => ({
+      ...m,
+      createdAt: m.createdAt.toISOString()
+    }))
+  };
+  return JSON.stringify(record);
+}
+function deserializeMessages2(json) {
+  if (!json) return [];
+  try {
+    const record = JSON.parse(json);
+    if (!record?.messages) return [];
+    return record.messages.map((m) => ({
+      ...m,
+      createdAt: new Date(m.createdAt)
+    }));
+  } catch {
+    return [];
+  }
+}
+function redisChatMemory(config) {
+  const prefix = config.keyPrefix ?? "agentskit:chat";
+  const convId = config.conversationId ?? "default";
+  const key = `${prefix}:${convId}`;
+  let clientPromise = null;
+  const getClient = () => {
+    if (config.client) return Promise.resolve(config.client);
+    if (!clientPromise) clientPromise = createRedisClientAdapter(config.url);
+    return clientPromise;
+  };
+  return {
+    async load() {
+      const client = await getClient();
+      const json = await client.get(key);
+      return deserializeMessages2(json);
+    },
+    async save(messages) {
+      const client = await getClient();
+      await client.set(key, serializeMessages2(messages));
+    },
+    async clear() {
+      const client = await getClient();
+      await client.del(key);
+    }
+  };
+}
+
+// src/redis-vector.ts
+function float32Buffer(vector) {
+  const buffer = Buffer.alloc(vector.length * 4);
+  for (let i = 0; i < vector.length; i++) {
+    buffer.writeFloatLE(vector[i], i * 4);
+  }
+  return buffer;
+}
+function redisVectorMemory(config) {
+  const indexName = config.indexName ?? "agentskit:vectors:idx";
+  const prefix = config.keyPrefix ?? "agentskit:vec";
+  const dimensions = config.dimensions ?? 0;
+  let clientPromise = null;
+  let indexCreated = false;
+  const getClient = () => {
+    if (config.client) return Promise.resolve(config.client);
+    if (!clientPromise) clientPromise = createRedisClientAdapter(config.url);
+    return clientPromise;
+  };
+  const ensureIndex = async (client, dims) => {
+    if (indexCreated) return;
+    try {
+      await client.call(
+        "FT.CREATE",
+        indexName,
+        "ON",
+        "HASH",
+        "PREFIX",
+        "1",
+        `${prefix}:`,
+        "SCHEMA",
+        "content",
+        "TEXT",
+        "metadata",
+        "TEXT",
+        "embedding",
+        "VECTOR",
+        "HNSW",
+        "6",
+        "TYPE",
+        "FLOAT32",
+        "DIM",
+        dims,
+        "DISTANCE_METRIC",
+        "COSINE"
+      );
+    } catch (err) {
+      const msg = String(err);
+      if (!msg.includes("Index already exists")) throw err;
+    }
+    indexCreated = true;
+  };
+  return {
+    async store(docs) {
+      const client = await getClient();
+      const dims = dimensions || docs[0]?.embedding.length || 0;
+      if (dims > 0) await ensureIndex(client, dims);
+      for (const doc of docs) {
+        const key = `${prefix}:${doc.id}`;
+        await client.call(
+          "HSET",
+          key,
+          "content",
+          doc.content,
+          "metadata",
+          JSON.stringify(doc.metadata ?? {}),
+          "embedding",
+          float32Buffer(doc.embedding)
+        );
+      }
+    },
+    async search(embedding, options) {
+      const client = await getClient();
+      const topK = options?.topK ?? 5;
+      const threshold = options?.threshold ?? 0;
+      const result = await client.call(
+        "FT.SEARCH",
+        indexName,
+        `*=>[KNN ${topK} @embedding $vec AS score]`,
+        "PARAMS",
+        "2",
+        "vec",
+        float32Buffer(embedding),
+        "SORTBY",
+        "score",
+        "RETURN",
+        "3",
+        "content",
+        "metadata",
+        "score",
+        "DIALECT",
+        "2"
+      );
+      if (!Array.isArray(result) || result.length < 2) return [];
+      const docs = [];
+      for (let i = 1; i < result.length; i += 2) {
+        const key = String(result[i]);
+        const fields = result[i + 1];
+        if (!Array.isArray(fields)) continue;
+        const fieldMap = {};
+        for (let j = 0; j < fields.length; j += 2) {
+          fieldMap[fields[j]] = fields[j + 1];
+        }
+        const score = 1 - parseFloat(fieldMap.score ?? "1");
+        if (score < threshold) continue;
+        docs.push({
+          id: key.replace(`${prefix}:`, ""),
+          content: fieldMap.content ?? "",
+          score,
+          metadata: fieldMap.metadata ? JSON.parse(fieldMap.metadata) : void 0
+        });
+      }
+      return docs;
+    },
+    async delete(ids) {
+      const client = await getClient();
+      await client.del(ids.map((id) => `${prefix}:${id}`));
+    }
+  };
+}
+
+// src/file-vector.ts
+function requireVectra() {
+  try {
+    return __require("vectra");
+  } catch {
+    throw new Error(
+      "Install vectra to use fileVectorMemory: npm install vectra"
+    );
+  }
+}
+function createVectraStore(dirPath) {
+  let index = null;
+  const getIndex = async () => {
+    if (index) return index;
+    const { LocalIndex } = requireVectra();
+    index = new LocalIndex(dirPath);
+    if (!await index.isIndexCreated()) {
+      await index.createIndex();
+    }
+    return index;
+  };
+  return {
+    async upsert(docs) {
+      const idx = await getIndex();
+      for (const doc of docs) {
+        await idx.insertItem({
+          vector: doc.vector,
+          metadata: { _id: doc.id, ...doc.metadata }
+        });
+      }
+    },
+    async query(vector, topK) {
+      const idx = await getIndex();
+      const results = await idx.queryItems(vector, topK);
+      return results.map((r) => ({
+        id: String(r.item.metadata._id ?? ""),
+        score: r.score,
+        metadata: r.item.metadata
+      }));
+    },
+    async delete(ids) {
+      const idx = await getIndex();
+      const items = await idx.listItems();
+      for (const item of items) {
+        if (ids.includes(String(item.metadata._id ?? item.id))) {
+          await idx.deleteItem(item.id);
+        }
+      }
+    }
+  };
+}
+function fileVectorMemory(config) {
+  const store = config.store ?? createVectraStore(config.path);
+  const contentCache = /* @__PURE__ */ new Map();
+  return {
+    async store(docs) {
+      for (const doc of docs) {
+        contentCache.set(doc.id, doc.content);
+      }
+      await store.upsert(docs.map((doc) => ({
+        id: doc.id,
+        vector: doc.embedding,
+        metadata: { content: doc.content, ...doc.metadata }
+      })));
+    },
+    async search(embedding, options) {
+      const topK = options?.topK ?? 5;
+      const threshold = options?.threshold ?? 0;
+      const results = await store.query(embedding, topK);
+      return results.filter((r) => r.score >= threshold).map((r) => ({
+        id: r.id,
+        content: String(r.metadata.content ?? contentCache.get(r.id) ?? ""),
+        score: r.score,
+        metadata: r.metadata
+      }));
+    },
+    async delete(ids) {
+      for (const id of ids) contentCache.delete(id);
+      await store.delete(ids);
+    }
+  };
+}
+
+exports.fileVectorMemory = fileVectorMemory;
+exports.redisChatMemory = redisChatMemory;
+exports.redisVectorMemory = redisVectorMemory;
+exports.sqliteChatMemory = sqliteChatMemory;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ChatMemory, Message, MemoryRecord } from '@agentskit/core'\n\nexport interface SqliteChatMemoryConfig {\n  path: string\n  conversationId?: string\n}\n\nfunction serializeMessages(messages: Message[]): string {\n  const record: MemoryRecord = {\n    version: 1,\n    messages: messages.map(m => ({\n      ...m,\n      createdAt: m.createdAt.toISOString(),\n    })),\n  }\n  return JSON.stringify(record)\n}\n\nfunction deserializeMessages(json: string | undefined): Message[] {\n  if (!json) return []\n  try {\n    const record = JSON.parse(json) as MemoryRecord\n    if (!record?.messages) return []\n    return record.messages.map(m => ({\n      ...m,\n      createdAt: new Date(m.createdAt),\n    }))\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 deserializeMessages(row?.messages as string | undefined)\n    },\n    async save(messages) {\n      const db = await getDb()\n      const json = serializeMessages(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 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 serializeMessages(messages: Message[]): string {\n  const record: MemoryRecord = {\n    version: 1,\n    messages: messages.map(m => ({\n      ...m,\n      createdAt: m.createdAt.toISOString(),\n    })),\n  }\n  return JSON.stringify(record)\n}\n\nfunction deserializeMessages(json: string | null): Message[] {\n  if (!json) return []\n  try {\n    const record = JSON.parse(json) as MemoryRecord\n    if (!record?.messages) return []\n    return record.messages.map(m => ({\n      ...m,\n      createdAt: new Date(m.createdAt),\n    }))\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 deserializeMessages(json)\n    },\n    async save(messages) {\n      const client = await getClient()\n      await client.set(key, serializeMessages(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

@@ -0,0 +1,62 @@
+import { ChatMemory, VectorMemory } from '@agentskit/core';
+
+interface SqliteChatMemoryConfig {
+    path: string;
+    conversationId?: string;
+}
+declare function sqliteChatMemory(config: SqliteChatMemoryConfig): ChatMemory;
+
+/**
+ * Internal Redis client adapter interface.
+ * Abstracts the underlying Redis library so it can be swapped
+ * (e.g., from `redis` to `ioredis`) without changing consumers.
+ */
+interface RedisClientAdapter {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    del(key: string | string[]): Promise<void>;
+    keys(pattern: string): Promise<string[]>;
+    disconnect(): Promise<void>;
+    call(command: string, ...args: (string | number | Buffer)[]): Promise<unknown>;
+}
+interface RedisConnectionConfig {
+    url: string;
+    client?: RedisClientAdapter;
+}
+
+interface RedisChatMemoryConfig extends RedisConnectionConfig {
+    keyPrefix?: string;
+    conversationId?: string;
+}
+declare function redisChatMemory(config: RedisChatMemoryConfig): ChatMemory;
+
+interface RedisVectorMemoryConfig extends RedisConnectionConfig {
+    indexName?: string;
+    keyPrefix?: string;
+    dimensions?: number;
+}
+declare function redisVectorMemory(config: RedisVectorMemoryConfig): VectorMemory;
+
+interface VectorStoreDocument {
+    id: string;
+    vector: number[];
+    metadata: Record<string, unknown>;
+}
+interface VectorStoreResult {
+    id: string;
+    score: number;
+    metadata: Record<string, unknown>;
+}
+interface VectorStore {
+    upsert(docs: VectorStoreDocument[]): Promise<void>;
+    query(vector: number[], topK: number): Promise<VectorStoreResult[]>;
+    delete(ids: string[]): Promise<void>;
+}
+
+interface FileVectorMemoryConfig {
+    path: string;
+    store?: VectorStore;
+}
+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 };

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import { ChatMemory, VectorMemory } from '@agentskit/core';
+
+interface SqliteChatMemoryConfig {
+    path: string;
+    conversationId?: string;
+}
+declare function sqliteChatMemory(config: SqliteChatMemoryConfig): ChatMemory;
+
+/**
+ * Internal Redis client adapter interface.
+ * Abstracts the underlying Redis library so it can be swapped
+ * (e.g., from `redis` to `ioredis`) without changing consumers.
+ */
+interface RedisClientAdapter {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    del(key: string | string[]): Promise<void>;
+    keys(pattern: string): Promise<string[]>;
+    disconnect(): Promise<void>;
+    call(command: string, ...args: (string | number | Buffer)[]): Promise<unknown>;
+}
+interface RedisConnectionConfig {
+    url: string;
+    client?: RedisClientAdapter;
+}
+
+interface RedisChatMemoryConfig extends RedisConnectionConfig {
+    keyPrefix?: string;
+    conversationId?: string;
+}
+declare function redisChatMemory(config: RedisChatMemoryConfig): ChatMemory;
+
+interface RedisVectorMemoryConfig extends RedisConnectionConfig {
+    indexName?: string;
+    keyPrefix?: string;
+    dimensions?: number;
+}
+declare function redisVectorMemory(config: RedisVectorMemoryConfig): VectorMemory;
+
+interface VectorStoreDocument {
+    id: string;
+    vector: number[];
+    metadata: Record<string, unknown>;
+}
+interface VectorStoreResult {
+    id: string;
+    score: number;
+    metadata: Record<string, unknown>;
+}
+interface VectorStore {
+    upsert(docs: VectorStoreDocument[]): Promise<void>;
+    query(vector: number[], topK: number): Promise<VectorStoreResult[]>;
+    delete(ids: string[]): Promise<void>;
+}
+
+interface FileVectorMemoryConfig {
+    path: string;
+    store?: VectorStore;
+}
+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 };

package/dist/index.js

@@ -0,0 +1,369 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/sqlite.ts
+function serializeMessages(messages) {
+  const record = {
+    version: 1,
+    messages: messages.map((m) => ({
+      ...m,
+      createdAt: m.createdAt.toISOString()
+    }))
+  };
+  return JSON.stringify(record);
+}
+function deserializeMessages(json) {
+  if (!json) return [];
+  try {
+    const record = JSON.parse(json);
+    if (!record?.messages) return [];
+    return record.messages.map((m) => ({
+      ...m,
+      createdAt: new Date(m.createdAt)
+    }));
+  } catch {
+    return [];
+  }
+}
+async function openDatabase(path) {
+  try {
+    const mod = await import('better-sqlite3');
+    const Database = mod.default ?? mod;
+    return new Database(path);
+  } catch {
+    throw new Error("Install better-sqlite3 to use sqliteChatMemory: npm install better-sqlite3");
+  }
+}
+function sqliteChatMemory(config) {
+  const conversationId = config.conversationId ?? "default";
+  let dbPromise = null;
+  const getDb = () => {
+    if (!dbPromise) {
+      dbPromise = openDatabase(config.path).then((db) => {
+        db.prepare(`
+          CREATE TABLE IF NOT EXISTS conversations (
+            id TEXT PRIMARY KEY,
+            messages TEXT NOT NULL
+          )
+        `).run();
+        return db;
+      });
+    }
+    return dbPromise;
+  };
+  return {
+    async load() {
+      const db = await getDb();
+      const row = db.prepare("SELECT messages FROM conversations WHERE id = ?").get(conversationId);
+      return deserializeMessages(row?.messages);
+    },
+    async save(messages) {
+      const db = await getDb();
+      const json = serializeMessages(messages);
+      db.prepare(`
+        INSERT INTO conversations (id, messages) VALUES (?, ?)
+        ON CONFLICT(id) DO UPDATE SET messages = ?
+      `).run(conversationId, json, json);
+    },
+    async clear() {
+      const db = await getDb();
+      db.prepare("DELETE FROM conversations WHERE id = ?").run(conversationId);
+    }
+  };
+}
+
+// src/redis-client.ts
+async function createRedisClientAdapter(url) {
+  let redis;
+  try {
+    redis = await import('redis');
+  } catch {
+    throw new Error("Install redis to use Redis memory backends: npm install redis");
+  }
+  const client = redis.createClient({ url });
+  await client.connect();
+  return {
+    async get(key) {
+      return await client.get(key);
+    },
+    async set(key, value) {
+      await client.set(key, value);
+    },
+    async del(key) {
+      const keys = Array.isArray(key) ? key : [key];
+      if (keys.length > 0) await client.del(keys);
+    },
+    async keys(pattern) {
+      return await client.keys(pattern);
+    },
+    async disconnect() {
+      await client.disconnect();
+    },
+    async call(command, ...args) {
+      return await client.sendCommand([command, ...args.map(String)]);
+    }
+  };
+}
+
+// src/redis-chat.ts
+function serializeMessages2(messages) {
+  const record = {
+    version: 1,
+    messages: messages.map((m) => ({
+      ...m,
+      createdAt: m.createdAt.toISOString()
+    }))
+  };
+  return JSON.stringify(record);
+}
+function deserializeMessages2(json) {
+  if (!json) return [];
+  try {
+    const record = JSON.parse(json);
+    if (!record?.messages) return [];
+    return record.messages.map((m) => ({
+      ...m,
+      createdAt: new Date(m.createdAt)
+    }));
+  } catch {
+    return [];
+  }
+}
+function redisChatMemory(config) {
+  const prefix = config.keyPrefix ?? "agentskit:chat";
+  const convId = config.conversationId ?? "default";
+  const key = `${prefix}:${convId}`;
+  let clientPromise = null;
+  const getClient = () => {
+    if (config.client) return Promise.resolve(config.client);
+    if (!clientPromise) clientPromise = createRedisClientAdapter(config.url);
+    return clientPromise;
+  };
+  return {
+    async load() {
+      const client = await getClient();
+      const json = await client.get(key);
+      return deserializeMessages2(json);
+    },
+    async save(messages) {
+      const client = await getClient();
+      await client.set(key, serializeMessages2(messages));
+    },
+    async clear() {
+      const client = await getClient();
+      await client.del(key);
+    }
+  };
+}
+
+// src/redis-vector.ts
+function float32Buffer(vector) {
+  const buffer = Buffer.alloc(vector.length * 4);
+  for (let i = 0; i < vector.length; i++) {
+    buffer.writeFloatLE(vector[i], i * 4);
+  }
+  return buffer;
+}
+function redisVectorMemory(config) {
+  const indexName = config.indexName ?? "agentskit:vectors:idx";
+  const prefix = config.keyPrefix ?? "agentskit:vec";
+  const dimensions = config.dimensions ?? 0;
+  let clientPromise = null;
+  let indexCreated = false;
+  const getClient = () => {
+    if (config.client) return Promise.resolve(config.client);
+    if (!clientPromise) clientPromise = createRedisClientAdapter(config.url);
+    return clientPromise;
+  };
+  const ensureIndex = async (client, dims) => {
+    if (indexCreated) return;
+    try {
+      await client.call(
+        "FT.CREATE",
+        indexName,
+        "ON",
+        "HASH",
+        "PREFIX",
+        "1",
+        `${prefix}:`,
+        "SCHEMA",
+        "content",
+        "TEXT",
+        "metadata",
+        "TEXT",
+        "embedding",
+        "VECTOR",
+        "HNSW",
+        "6",
+        "TYPE",
+        "FLOAT32",
+        "DIM",
+        dims,
+        "DISTANCE_METRIC",
+        "COSINE"
+      );
+    } catch (err) {
+      const msg = String(err);
+      if (!msg.includes("Index already exists")) throw err;
+    }
+    indexCreated = true;
+  };
+  return {
+    async store(docs) {
+      const client = await getClient();
+      const dims = dimensions || docs[0]?.embedding.length || 0;
+      if (dims > 0) await ensureIndex(client, dims);
+      for (const doc of docs) {
+        const key = `${prefix}:${doc.id}`;
+        await client.call(
+          "HSET",
+          key,
+          "content",
+          doc.content,
+          "metadata",
+          JSON.stringify(doc.metadata ?? {}),
+          "embedding",
+          float32Buffer(doc.embedding)
+        );
+      }
+    },
+    async search(embedding, options) {
+      const client = await getClient();
+      const topK = options?.topK ?? 5;
+      const threshold = options?.threshold ?? 0;
+      const result = await client.call(
+        "FT.SEARCH",
+        indexName,
+        `*=>[KNN ${topK} @embedding $vec AS score]`,
+        "PARAMS",
+        "2",
+        "vec",
+        float32Buffer(embedding),
+        "SORTBY",
+        "score",
+        "RETURN",
+        "3",
+        "content",
+        "metadata",
+        "score",
+        "DIALECT",
+        "2"
+      );
+      if (!Array.isArray(result) || result.length < 2) return [];
+      const docs = [];
+      for (let i = 1; i < result.length; i += 2) {
+        const key = String(result[i]);
+        const fields = result[i + 1];
+        if (!Array.isArray(fields)) continue;
+        const fieldMap = {};
+        for (let j = 0; j < fields.length; j += 2) {
+          fieldMap[fields[j]] = fields[j + 1];
+        }
+        const score = 1 - parseFloat(fieldMap.score ?? "1");
+        if (score < threshold) continue;
+        docs.push({
+          id: key.replace(`${prefix}:`, ""),
+          content: fieldMap.content ?? "",
+          score,
+          metadata: fieldMap.metadata ? JSON.parse(fieldMap.metadata) : void 0
+        });
+      }
+      return docs;
+    },
+    async delete(ids) {
+      const client = await getClient();
+      await client.del(ids.map((id) => `${prefix}:${id}`));
+    }
+  };
+}
+
+// src/file-vector.ts
+function requireVectra() {
+  try {
+    return __require("vectra");
+  } catch {
+    throw new Error(
+      "Install vectra to use fileVectorMemory: npm install vectra"
+    );
+  }
+}
+function createVectraStore(dirPath) {
+  let index = null;
+  const getIndex = async () => {
+    if (index) return index;
+    const { LocalIndex } = requireVectra();
+    index = new LocalIndex(dirPath);
+    if (!await index.isIndexCreated()) {
+      await index.createIndex();
+    }
+    return index;
+  };
+  return {
+    async upsert(docs) {
+      const idx = await getIndex();
+      for (const doc of docs) {
+        await idx.insertItem({
+          vector: doc.vector,
+          metadata: { _id: doc.id, ...doc.metadata }
+        });
+      }
+    },
+    async query(vector, topK) {
+      const idx = await getIndex();
+      const results = await idx.queryItems(vector, topK);
+      return results.map((r) => ({
+        id: String(r.item.metadata._id ?? ""),
+        score: r.score,
+        metadata: r.item.metadata
+      }));
+    },
+    async delete(ids) {
+      const idx = await getIndex();
+      const items = await idx.listItems();
+      for (const item of items) {
+        if (ids.includes(String(item.metadata._id ?? item.id))) {
+          await idx.deleteItem(item.id);
+        }
+      }
+    }
+  };
+}
+function fileVectorMemory(config) {
+  const store = config.store ?? createVectraStore(config.path);
+  const contentCache = /* @__PURE__ */ new Map();
+  return {
+    async store(docs) {
+      for (const doc of docs) {
+        contentCache.set(doc.id, doc.content);
+      }
+      await store.upsert(docs.map((doc) => ({
+        id: doc.id,
+        vector: doc.embedding,
+        metadata: { content: doc.content, ...doc.metadata }
+      })));
+    },
+    async search(embedding, options) {
+      const topK = options?.topK ?? 5;
+      const threshold = options?.threshold ?? 0;
+      const results = await store.query(embedding, topK);
+      return results.filter((r) => r.score >= threshold).map((r) => ({
+        id: r.id,
+        content: String(r.metadata.content ?? contentCache.get(r.id) ?? ""),
+        score: r.score,
+        metadata: r.metadata
+      }));
+    },
+    async delete(ids) {
+      for (const id of ids) contentCache.delete(id);
+      await store.delete(ids);
+    }
+  };
+}
+
+export { fileVectorMemory, redisChatMemory, redisVectorMemory, sqliteChatMemory };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"],"mappings":"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","file":"index.js","sourcesContent":["import type { ChatMemory, Message, MemoryRecord } from '@agentskit/core'\n\nexport interface SqliteChatMemoryConfig {\n  path: string\n  conversationId?: string\n}\n\nfunction serializeMessages(messages: Message[]): string {\n  const record: MemoryRecord = {\n    version: 1,\n    messages: messages.map(m => ({\n      ...m,\n      createdAt: m.createdAt.toISOString(),\n    })),\n  }\n  return JSON.stringify(record)\n}\n\nfunction deserializeMessages(json: string | undefined): Message[] {\n  if (!json) return []\n  try {\n    const record = JSON.parse(json) as MemoryRecord\n    if (!record?.messages) return []\n    return record.messages.map(m => ({\n      ...m,\n      createdAt: new Date(m.createdAt),\n    }))\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 deserializeMessages(row?.messages as string | undefined)\n    },\n    async save(messages) {\n      const db = await getDb()\n      const json = serializeMessages(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 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 serializeMessages(messages: Message[]): string {\n  const record: MemoryRecord = {\n    version: 1,\n    messages: messages.map(m => ({\n      ...m,\n      createdAt: m.createdAt.toISOString(),\n    })),\n  }\n  return JSON.stringify(record)\n}\n\nfunction deserializeMessages(json: string | null): Message[] {\n  if (!json) return []\n  try {\n    const record = JSON.parse(json) as MemoryRecord\n    if (!record?.messages) return []\n    return record.messages.map(m => ({\n      ...m,\n      createdAt: new Date(m.createdAt),\n    }))\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 deserializeMessages(json)\n    },\n    async save(messages) {\n      const client = await getClient()\n      await client.set(key, serializeMessages(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

@@ -0,0 +1,41 @@
+{
+  "name": "@agentskit/memory",
+  "version": "0.4.0",
+  "description": "Persistent and vector memory backends for AgentsKit.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "tsc --noEmit",
+    "dev": "tsup --watch"
+  },
+  "dependencies": {
+    "@agentskit/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^24.0.0",
+    "better-sqlite3": "^11.9.1",
+    "redis": "^5.11.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vectra": "^0.9.0",
+    "vitest": "^4.1.2"
+  }
+}