@fastpaca/cria 0.0.1 → 1.0.1

package/dist/memory/postgres.d.ts

@@ -0,0 +1,71 @@
+import type { PoolConfig } from "pg";
+import type { KVMemory, MemoryEntry } from "./key-value";
+/**
+ * Configuration options for the Postgres store.
+ */
+export interface PostgresStoreOptions extends PoolConfig {
+    /**
+     * Table name for storing entries.
+     * The table will be created automatically if it doesn't exist.
+     * @default "cria_kv_store"
+     */
+    tableName?: string;
+    /**
+     * Whether to create the table on first use if it doesn't exist.
+     * @default true
+     */
+    autoCreateTable?: boolean;
+}
+/**
+ * Postgres-backed implementation of KVMemory.
+ *
+ * Plug-and-play adapter using node-postgres (pg). Just pass your connection options.
+ *
+ * The store will automatically create the required table if it doesn't exist.
+ *
+ * @template T - The type of data to store
+ *
+ * @example
+ * ```typescript
+ * import { PostgresStore } from "@fastpaca/cria/memory/postgres";
+ *
+ * // Connect using environment variables (PG* env vars)
+ * const store = new PostgresStore<{ content: string }>();
+ *
+ * // Connect with options
+ * const store = new PostgresStore<{ content: string }>({
+ *   connectionString: "postgres://user:pass@localhost/mydb",
+ * });
+ *
+ * await store.set("key-1", { content: "Hello" });
+ * const entry = await store.get("key-1");
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom table name
+ * const store = new PostgresStore<string>({
+ *   host: "localhost",
+ *   database: "myapp",
+ *   tableName: "my_app_memory",
+ * });
+ * ```
+ */
+export declare class PostgresStore<T = unknown> implements KVMemory<T> {
+    private readonly pool;
+    private readonly tableName;
+    private readonly autoCreateTable;
+    private tableCreated;
+    constructor(options?: PostgresStoreOptions);
+    private ensureTable;
+    get(key: string): Promise<MemoryEntry<T> | null>;
+    set(key: string, data: T, metadata?: Record<string, unknown>): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    /**
+     * Close the connection pool.
+     * Call this when you're done using the store to clean up connections.
+     */
+    end(): Promise<void>;
+}
+export type { KVMemory, MemoryEntry } from "./key-value";
+//# sourceMappingURL=postgres.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/memory/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAErC,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,oBAAyB;YAQhC,WAAW;IAkBnB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAsBhD,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,EACP,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAyBV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW3C;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAG3B;AAGD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/memory/postgres.js

@@ -0,0 +1,109 @@
+import { Pool } from "pg";
+/**
+ * Postgres-backed implementation of KVMemory.
+ *
+ * Plug-and-play adapter using node-postgres (pg). Just pass your connection options.
+ *
+ * The store will automatically create the required table if it doesn't exist.
+ *
+ * @template T - The type of data to store
+ *
+ * @example
+ * ```typescript
+ * import { PostgresStore } from "@fastpaca/cria/memory/postgres";
+ *
+ * // Connect using environment variables (PG* env vars)
+ * const store = new PostgresStore<{ content: string }>();
+ *
+ * // Connect with options
+ * const store = new PostgresStore<{ content: string }>({
+ *   connectionString: "postgres://user:pass@localhost/mydb",
+ * });
+ *
+ * await store.set("key-1", { content: "Hello" });
+ * const entry = await store.get("key-1");
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom table name
+ * const store = new PostgresStore<string>({
+ *   host: "localhost",
+ *   database: "myapp",
+ *   tableName: "my_app_memory",
+ * });
+ * ```
+ */
+export class PostgresStore {
+    pool;
+    tableName;
+    autoCreateTable;
+    tableCreated = false;
+    constructor(options = {}) {
+        const { tableName, autoCreateTable, ...poolConfig } = options;
+        this.pool = new Pool(poolConfig);
+        this.tableName = tableName ?? "cria_kv_store";
+        this.autoCreateTable = autoCreateTable ?? true;
+    }
+    async ensureTable() {
+        if (this.tableCreated || !this.autoCreateTable) {
+            return;
+        }
+        await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS ${this.tableName} (
+        key TEXT PRIMARY KEY,
+        data JSONB NOT NULL,
+        created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+        updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+        metadata JSONB
+      )
+    `);
+        this.tableCreated = true;
+    }
+    async get(key) {
+        await this.ensureTable();
+        const result = await this.pool.query(`SELECT key, data, created_at, updated_at, metadata FROM ${this.tableName} WHERE key = $1`, [key]);
+        const row = result.rows[0];
+        if (row === undefined) {
+            return null;
+        }
+        return {
+            data: row.data,
+            createdAt: new Date(row.created_at).getTime(),
+            updatedAt: new Date(row.updated_at).getTime(),
+            ...(row.metadata && { metadata: row.metadata }),
+        };
+    }
+    async set(key, data, metadata) {
+        await this.ensureTable();
+        const now = new Date();
+        // Use UPSERT to handle both insert and update cases
+        // ON CONFLICT preserves created_at and updates updated_at
+        await this.pool.query(`
+      INSERT INTO ${this.tableName} (key, data, created_at, updated_at, metadata)
+      VALUES ($1, $2, $3, $3, $4)
+      ON CONFLICT (key) DO UPDATE SET
+        data = EXCLUDED.data,
+        updated_at = EXCLUDED.updated_at,
+        metadata = EXCLUDED.metadata
+      `, [
+            key,
+            JSON.stringify(data),
+            now,
+            metadata ? JSON.stringify(metadata) : null,
+        ]);
+    }
+    async delete(key) {
+        await this.ensureTable();
+        const result = await this.pool.query(`DELETE FROM ${this.tableName} WHERE key = $1`, [key]);
+        return (result.rowCount ?? 0) > 0;
+    }
+    /**
+     * Close the connection pool.
+     * Call this when you're done using the store to clean up connections.
+     */
+    async end() {
+        await this.pool.end();
+    }
+}
+//# sourceMappingURL=postgres.js.map

package/dist/memory/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../src/memory/postgres.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAgC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,OAAO,aAAa;IACP,IAAI,CAAO;IACX,SAAS,CAAS;IAClB,eAAe,CAAU;IAClC,YAAY,GAAG,KAAK,CAAC;IAE7B,YAAY,UAAgC,EAAE;QAC5C,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;QAE9D,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,eAAe,CAAC;QAC9C,IAAI,CAAC,eAAe,GAAG,eAAe,IAAI,IAAI,CAAC;IACjD,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;mCACS,IAAI,CAAC,SAAS;;;;;;;KAO5C,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC,2DAA2D,IAAI,CAAC,SAAS,iBAAiB,EAC1F,CAAC,GAAG,CAAC,CACN,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE3B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAS;YACnB,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;YAC7C,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;YAC7C,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;SAChD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CACP,GAAW,EACX,IAAO,EACP,QAAkC;QAElC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAEvB,oDAAoD;QACpD,0DAA0D;QAC1D,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB;oBACc,IAAI,CAAC,SAAS;;;;;;OAM3B,EACD;YACE,GAAG;YACH,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YACpB,GAAG;YACH,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;SAC3C,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAClC,eAAe,IAAI,CAAC,SAAS,iBAAiB,EAC9C,CAAC,GAAG,CAAC,CACN,CAAC;QAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/memory/qdrant/index.d.ts

@@ -0,0 +1,64 @@
+import type { QdrantClient } from "@qdrant/js-client-rest";
+import type { MemoryEntry } from "../key-value";
+import type { VectorMemory, VectorSearchOptions, VectorSearchResult } from "../vector";
+/**
+ * Function to generate embeddings for text.
+ */
+export type EmbeddingFunction = (text: string) => Promise<number[]>;
+/**
+ * Options for creating a QdrantStore.
+ */
+export interface QdrantStoreOptions {
+    /** The Qdrant client instance */
+    client: QdrantClient;
+    /** The name of the collection to use */
+    collectionName: string;
+    /** Function to generate embeddings from text */
+    embed: EmbeddingFunction;
+    /** Optional: the name of the vector field (for collections with named vectors) */
+    vectorName?: string;
+}
+/**
+ * VectorMemory implementation backed by Qdrant.
+ *
+ * This adapter wraps a Qdrant collection and implements the VectorMemory interface,
+ * allowing you to use Qdrant for RAG workflows with Cria's VectorSearch component.
+ *
+ * @template T - The type of data stored in the payload
+ *
+ * @example
+ * ```typescript
+ * import { QdrantClient } from "@qdrant/js-client-rest";
+ * import { QdrantStore } from "@fastpaca/cria/memory/qdrant";
+ * import { VectorSearch } from "@fastpaca/cria";
+ *
+ * const client = new QdrantClient({ url: "http://localhost:6333" });
+ *
+ * const store = new QdrantStore({
+ *   client,
+ *   collectionName: "my-docs",
+ *   embed: async (text) => {
+ *     // Use your embedding model (OpenAI, Cohere, etc.)
+ *     return await getEmbedding(text);
+ *   },
+ * });
+ *
+ * // Use with VectorSearch
+ * <VectorSearch store={store} limit={5}>
+ *   What is RAG?
+ * </VectorSearch>
+ * ```
+ */
+export declare class QdrantStore<T = unknown> implements VectorMemory<T> {
+    private readonly client;
+    private readonly collectionName;
+    private readonly embedFn;
+    private readonly vectorName;
+    constructor(options: QdrantStoreOptions);
+    private embed;
+    get(key: string): Promise<MemoryEntry<T> | null>;
+    set(key: string, data: T, metadata?: Record<string, unknown>): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    search(query: string, options?: VectorSearchOptions): Promise<VectorSearchResult<T>[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/qdrant/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/qdrant/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,KAAK,EAAE,iBAAiB,CAAC;IACzB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAwBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;gBAEpC,OAAO,EAAE,kBAAkB;YAOzB,KAAK;IAUb,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAgBhD,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,EACP,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IA0BV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYrC,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;CAiCpC"}

package/dist/memory/qdrant/index.js

@@ -0,0 +1,136 @@
+/**
+ * Convert a Qdrant payload to a MemoryEntry.
+ */
+function payloadToEntry(payload) {
+    return {
+        data: payload.data,
+        createdAt: payload.createdAt,
+        updatedAt: payload.updatedAt,
+        ...(payload.metadata && { metadata: payload.metadata }),
+    };
+}
+/**
+ * VectorMemory implementation backed by Qdrant.
+ *
+ * This adapter wraps a Qdrant collection and implements the VectorMemory interface,
+ * allowing you to use Qdrant for RAG workflows with Cria's VectorSearch component.
+ *
+ * @template T - The type of data stored in the payload
+ *
+ * @example
+ * ```typescript
+ * import { QdrantClient } from "@qdrant/js-client-rest";
+ * import { QdrantStore } from "@fastpaca/cria/memory/qdrant";
+ * import { VectorSearch } from "@fastpaca/cria";
+ *
+ * const client = new QdrantClient({ url: "http://localhost:6333" });
+ *
+ * const store = new QdrantStore({
+ *   client,
+ *   collectionName: "my-docs",
+ *   embed: async (text) => {
+ *     // Use your embedding model (OpenAI, Cohere, etc.)
+ *     return await getEmbedding(text);
+ *   },
+ * });
+ *
+ * // Use with VectorSearch
+ * <VectorSearch store={store} limit={5}>
+ *   What is RAG?
+ * </VectorSearch>
+ * ```
+ */
+export class QdrantStore {
+    client;
+    collectionName;
+    embedFn;
+    vectorName;
+    constructor(options) {
+        this.client = options.client;
+        this.collectionName = options.collectionName;
+        this.embedFn = options.embed;
+        this.vectorName = options.vectorName;
+    }
+    async embed(text, context) {
+        try {
+            return await this.embedFn(text);
+        }
+        catch (error) {
+            throw new Error(`QdrantStore: embedding failed during ${context}`, {
+                cause: error,
+            });
+        }
+    }
+    async get(key) {
+        const response = await this.client.retrieve(this.collectionName, {
+            ids: [key],
+            with_payload: true,
+        });
+        const point = response[0];
+        if (!point) {
+            return null;
+        }
+        const payload = point.payload;
+        return payload ? payloadToEntry(payload) : null;
+    }
+    async set(key, data, metadata) {
+        const now = Date.now();
+        // Convert data to text for embedding
+        const textToEmbed = typeof data === "string" ? data : JSON.stringify(data);
+        const vector = await this.embed(textToEmbed, `set("${key}")`);
+        const payload = {
+            data,
+            createdAt: now,
+            updatedAt: now,
+            ...(metadata && { metadata }),
+        };
+        await this.client.upsert(this.collectionName, {
+            wait: true,
+            points: [
+                {
+                    id: key,
+                    vector: this.vectorName ? { [this.vectorName]: vector } : vector,
+                    payload: payload,
+                },
+            ],
+        });
+    }
+    async delete(key) {
+        const existing = await this.get(key);
+        if (!existing) {
+            return false;
+        }
+        await this.client.delete(this.collectionName, {
+            wait: true,
+            points: [key],
+        });
+        return true;
+    }
+    async search(query, options) {
+        const limit = options?.limit ?? 10;
+        const threshold = options?.threshold;
+        const queryVector = await this.embed(query, "search");
+        const response = await this.client.search(this.collectionName, {
+            vector: this.vectorName
+                ? { name: this.vectorName, vector: queryVector }
+                : queryVector,
+            limit,
+            with_payload: true,
+            ...(threshold !== undefined && { score_threshold: threshold }),
+        });
+        const results = [];
+        for (const point of response) {
+            const payload = point.payload;
+            if (!payload) {
+                continue;
+            }
+            results.push({
+                key: String(point.id),
+                score: point.score,
+                entry: payloadToEntry(payload),
+            });
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/memory/qdrant/index.js.map

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

package/dist/memory/redis.d.ts

@@ -0,0 +1,70 @@
+import type { RedisOptions } from "ioredis";
+import type { KVMemory, MemoryEntry } from "./key-value";
+/**
+ * Configuration options for the Redis store.
+ */
+export interface RedisStoreOptions extends RedisOptions {
+    /**
+     * Key prefix for all entries stored by this instance.
+     * Useful for namespacing multiple stores in the same Redis instance.
+     * @default "cria:kv:"
+     */
+    keyPrefix?: string;
+    /**
+     * TTL (time-to-live) in seconds for entries.
+     * If set, entries will automatically expire after this duration.
+     * @default undefined (no expiration)
+     */
+    ttlSeconds?: number;
+}
+/**
+ * Redis-backed implementation of KVMemory.
+ *
+ * Plug-and-play adapter using ioredis. Just pass your connection options.
+ *
+ * @template T - The type of data to store
+ *
+ * @example
+ * ```typescript
+ * import { RedisStore } from "@fastpaca/cria/memory/redis";
+ *
+ * // Connect to localhost:6379
+ * const store = new RedisStore<{ content: string }>();
+ *
+ * // Connect with options
+ * const store = new RedisStore<{ content: string }>({
+ *   host: "redis.example.com",
+ *   port: 6379,
+ *   password: "secret",
+ * });
+ *
+ * await store.set("key-1", { content: "Hello" });
+ * const entry = await store.get("key-1");
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With TTL and custom prefix
+ * const store = new RedisStore<string>({
+ *   keyPrefix: "myapp:memory:",
+ *   ttlSeconds: 3600, // 1 hour TTL
+ * });
+ * ```
+ */
+export declare class RedisStore<T = unknown> implements KVMemory<T> {
+    private readonly client;
+    private readonly prefix;
+    private readonly ttlSeconds?;
+    constructor(options?: RedisStoreOptions);
+    private prefixedKey;
+    get(key: string): Promise<MemoryEntry<T> | null>;
+    set(key: string, data: T, metadata?: Record<string, unknown>): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    /**
+     * Disconnect from Redis.
+     * Call this when you're done using the store to clean up connections.
+     */
+    disconnect(): Promise<void>;
+}
+export type { KVMemory, MemoryEntry } from "./key-value";
+//# sourceMappingURL=redis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/memory/redis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;gBAEzB,OAAO,GAAE,iBAAsB;IAW3C,OAAO,CAAC,WAAW;IAIb,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAiBhD,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,EACP,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IA6BV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC;AAGD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/memory/redis.js

@@ -0,0 +1,100 @@
+import Redis from "ioredis";
+/**
+ * Redis-backed implementation of KVMemory.
+ *
+ * Plug-and-play adapter using ioredis. Just pass your connection options.
+ *
+ * @template T - The type of data to store
+ *
+ * @example
+ * ```typescript
+ * import { RedisStore } from "@fastpaca/cria/memory/redis";
+ *
+ * // Connect to localhost:6379
+ * const store = new RedisStore<{ content: string }>();
+ *
+ * // Connect with options
+ * const store = new RedisStore<{ content: string }>({
+ *   host: "redis.example.com",
+ *   port: 6379,
+ *   password: "secret",
+ * });
+ *
+ * await store.set("key-1", { content: "Hello" });
+ * const entry = await store.get("key-1");
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With TTL and custom prefix
+ * const store = new RedisStore<string>({
+ *   keyPrefix: "myapp:memory:",
+ *   ttlSeconds: 3600, // 1 hour TTL
+ * });
+ * ```
+ */
+export class RedisStore {
+    client;
+    prefix;
+    ttlSeconds;
+    constructor(options = {}) {
+        const { keyPrefix, ttlSeconds, ...redisOptions } = options;
+        this.client = new Redis(redisOptions);
+        this.prefix = keyPrefix ?? "cria:kv:";
+        if (ttlSeconds !== undefined) {
+            this.ttlSeconds = ttlSeconds;
+        }
+    }
+    prefixedKey(key) {
+        return `${this.prefix}${key}`;
+    }
+    async get(key) {
+        const raw = await this.client.get(this.prefixedKey(key));
+        if (raw === null) {
+            return null;
+        }
+        const stored = JSON.parse(raw);
+        return {
+            data: stored.data,
+            createdAt: stored.createdAt,
+            updatedAt: stored.updatedAt,
+            ...(stored.metadata && { metadata: stored.metadata }),
+        };
+    }
+    async set(key, data, metadata) {
+        const prefixedKey = this.prefixedKey(key);
+        const now = Date.now();
+        // Try to get existing entry to preserve createdAt
+        const existingRaw = await this.client.get(prefixedKey);
+        let createdAt = now;
+        if (existingRaw !== null) {
+            const existing = JSON.parse(existingRaw);
+            createdAt = existing.createdAt;
+        }
+        const entry = {
+            data,
+            createdAt,
+            updatedAt: now,
+            ...(metadata && { metadata }),
+        };
+        const value = JSON.stringify(entry);
+        if (this.ttlSeconds !== undefined) {
+            await this.client.set(prefixedKey, value, "EX", this.ttlSeconds);
+        }
+        else {
+            await this.client.set(prefixedKey, value);
+        }
+    }
+    async delete(key) {
+        const count = await this.client.del(this.prefixedKey(key));
+        return count > 0;
+    }
+    /**
+     * Disconnect from Redis.
+     * Call this when you're done using the store to clean up connections.
+     */
+    async disconnect() {
+        await this.client.quit();
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/memory/redis.js.map

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

package/dist/memory/vector.d.ts

@@ -0,0 +1,53 @@
+import type { MaybePromise } from "../types";
+import type { KVMemory, MemoryEntry } from "./key-value";
+/**
+ * Search result from a vector memory query.
+ */
+export interface VectorSearchResult<T = unknown> {
+    /** The matching entry */
+    entry: MemoryEntry<T>;
+    /** The key of the matching entry */
+    key: string;
+    /** Similarity score (0-1, higher is more similar) */
+    score: number;
+}
+/**
+ * Options for vector search operations.
+ */
+export interface VectorSearchOptions {
+    /** Maximum number of results to return. Default: 10 */
+    limit?: number;
+    /** Minimum similarity threshold (0-1). Results below this are excluded. */
+    threshold?: number;
+}
+/**
+ * Vector memory interface for semantic search.
+ *
+ * Extends the KV memory interface with vector-based similarity search.
+ * Useful for RAG (Retrieval Augmented Generation), semantic memory,
+ * and finding related content.
+ *
+ * @template T - The type of data stored in the memory
+ *
+ * @example
+ * ```typescript
+ * // Implementation would use embeddings from OpenAI, Cohere, etc.
+ * class PineconeStore<T> implements VectorMemory<T> {
+ *   async search(query: string, options?: VectorSearchOptions) {
+ *     const embedding = await this.embedder(query);
+ *     return this.client.query(embedding, options);
+ *   }
+ *   // ... other methods
+ * }
+ * ```
+ */
+export interface VectorMemory<T = unknown> extends KVMemory<T> {
+    /**
+     * Search for entries semantically similar to the query.
+     * @param query - The search query (will be embedded)
+     * @param options - Search options
+     * @returns Matching entries sorted by similarity (highest first)
+     */
+    search(query: string, options?: VectorSearchOptions): MaybePromise<VectorSearchResult<T>[]>;
+}
+//# sourceMappingURL=vector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../src/memory/vector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,yBAAyB;IACzB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACtB,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAC5D;;;;;OAKG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;CAC1C"}

package/dist/memory/vector.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vector.js.map

package/dist/memory/vector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.js","sourceRoot":"","sources":["../../src/memory/vector.ts"],"names":[],"mappings":""}