@falai/agent 0.3.12 → 0.3.21

package/dist/adapters/PostgreSQLAdapter.js

@@ -0,0 +1,256 @@
+/**
+ * PostgreSQL adapter for persistence
+ * Raw SQL adapter for PostgreSQL with custom schemas
+ */
+/**
+ * PostgreSQL Adapter - Provider-style API for PostgreSQL persistence
+ *
+ * @example
+ * ```typescript
+ * import { Client } from 'pg';
+ * import { Agent, PostgreSQLAdapter } from '@falai/agent';
+ *
+ * const client = new Client({
+ *   host: 'localhost',
+ *   port: 5432,
+ *   database: 'myapp',
+ *   user: 'postgres',
+ *   password: 'password',
+ * });
+ * await client.connect();
+ *
+ * const agent = new Agent({
+ *   name: "My Agent",
+ *   ai: provider,
+ *   persistence: {
+ *     adapter: new PostgreSQLAdapter({ client }),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+export class PostgreSQLAdapter {
+    constructor(options) {
+        this.client = options.client;
+        const sessionTable = options.tables?.sessions || "agent_sessions";
+        const messageTable = options.tables?.messages || "agent_messages";
+        this.sessionRepository = new PostgreSQLSessionRepository(this.client, sessionTable);
+        this.messageRepository = new PostgreSQLMessageRepository(this.client, messageTable);
+    }
+    async initialize() {
+        // Create tables if they don't exist
+        const sessionTable = "agent_sessions";
+        const messageTable = "agent_messages";
+        await this.client.query(`
+      CREATE TABLE IF NOT EXISTS ${sessionTable} (
+        id VARCHAR(255) PRIMARY KEY,
+        user_id VARCHAR(255),
+        agent_name VARCHAR(255),
+        status VARCHAR(50) DEFAULT 'active',
+        current_route VARCHAR(255),
+        current_state VARCHAR(255),
+        collected_data JSONB,
+        message_count INTEGER DEFAULT 0,
+        last_message_at TIMESTAMP,
+        completed_at TIMESTAMP,
+        created_at TIMESTAMP DEFAULT NOW(),
+        updated_at TIMESTAMP DEFAULT NOW()
+      )
+    `);
+        await this.client.query(`
+      CREATE INDEX IF NOT EXISTS idx_sessions_user_id ON ${sessionTable}(user_id);
+      CREATE INDEX IF NOT EXISTS idx_sessions_status ON ${sessionTable}(status);
+    `);
+        await this.client.query(`
+      CREATE TABLE IF NOT EXISTS ${messageTable} (
+        id VARCHAR(255) PRIMARY KEY,
+        session_id VARCHAR(255) NOT NULL,
+        user_id VARCHAR(255),
+        role VARCHAR(50) NOT NULL,
+        content TEXT NOT NULL,
+        route VARCHAR(255),
+        state VARCHAR(255),
+        tool_calls JSONB,
+        event JSONB,
+        created_at TIMESTAMP DEFAULT NOW(),
+        FOREIGN KEY (session_id) REFERENCES ${sessionTable}(id) ON DELETE CASCADE
+      )
+    `);
+        await this.client.query(`
+      CREATE INDEX IF NOT EXISTS idx_messages_session_id ON ${messageTable}(session_id);
+      CREATE INDEX IF NOT EXISTS idx_messages_user_id ON ${messageTable}(user_id);
+    `);
+    }
+    async disconnect() {
+        await this.client.end();
+    }
+}
+/**
+ * PostgreSQL Session Repository
+ */
+class PostgreSQLSessionRepository {
+    constructor(client, tableName) {
+        this.client = client;
+        this.tableName = tableName;
+    }
+    async create(data) {
+        const id = `session_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+        const now = new Date();
+        const result = await this.client.query(`INSERT INTO ${this.tableName} 
+       (id, user_id, agent_name, status, collected_data, message_count, created_at, updated_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8)
+       RETURNING *`, [
+            id,
+            data.userId || null,
+            data.agentName || null,
+            data.status || "active",
+            JSON.stringify(data.collectedData || {}),
+            data.messageCount || 0,
+            now,
+            now,
+        ]);
+        return result.rows[0];
+    }
+    async findById(id) {
+        const result = await this.client.query(`SELECT * FROM ${this.tableName} WHERE id = $1`, [id]);
+        return result.rows[0] || null;
+    }
+    async findActiveByUserId(userId) {
+        const result = await this.client.query(`SELECT * FROM ${this.tableName} 
+       WHERE user_id = $1 AND status = 'active'
+       ORDER BY created_at DESC
+       LIMIT 1`, [userId]);
+        return result.rows[0] || null;
+    }
+    async findByUserId(userId, limit = 100) {
+        const result = await this.client.query(`SELECT * FROM ${this.tableName} 
+       WHERE user_id = $1
+       ORDER BY created_at DESC
+       LIMIT $2`, [userId, limit]);
+        return result.rows;
+    }
+    async update(id, data) {
+        const fields = [];
+        const values = [];
+        let paramIndex = 1;
+        if (data.status !== undefined) {
+            fields.push(`status = $${paramIndex++}`);
+            values.push(data.status);
+        }
+        if (data.collectedData !== undefined) {
+            fields.push(`collected_data = $${paramIndex++}`);
+            values.push(JSON.stringify(data.collectedData));
+        }
+        if (data.currentRoute !== undefined) {
+            fields.push(`current_route = $${paramIndex++}`);
+            values.push(data.currentRoute);
+        }
+        if (data.currentState !== undefined) {
+            fields.push(`current_state = $${paramIndex++}`);
+            values.push(data.currentState);
+        }
+        if (data.messageCount !== undefined) {
+            fields.push(`message_count = $${paramIndex++}`);
+            values.push(data.messageCount);
+        }
+        if (data.lastMessageAt !== undefined) {
+            fields.push(`last_message_at = $${paramIndex++}`);
+            values.push(data.lastMessageAt);
+        }
+        if (data.completedAt !== undefined) {
+            fields.push(`completed_at = $${paramIndex++}`);
+            values.push(data.completedAt);
+        }
+        fields.push(`updated_at = $${paramIndex++}`);
+        values.push(new Date());
+        values.push(id);
+        const result = await this.client.query(`UPDATE ${this.tableName} 
+       SET ${fields.join(", ")}
+       WHERE id = $${paramIndex}
+       RETURNING *`, values);
+        return result.rows[0] || null;
+    }
+    async updateStatus(id, status, completedAt) {
+        return await this.update(id, { status, completedAt });
+    }
+    async updateCollectedData(id, collectedData) {
+        return await this.update(id, { collectedData });
+    }
+    async updateRouteState(id, route, state) {
+        return await this.update(id, {
+            currentRoute: route,
+            currentState: state,
+        });
+    }
+    async incrementMessageCount(id) {
+        const result = await this.client.query(`UPDATE ${this.tableName}
+       SET message_count = message_count + 1,
+           last_message_at = NOW(),
+           updated_at = NOW()
+       WHERE id = $1
+       RETURNING *`, [id]);
+        return result.rows[0] || null;
+    }
+    async delete(id) {
+        const result = await this.client.query(`DELETE FROM ${this.tableName} WHERE id = $1`, [id]);
+        return result.rowCount > 0;
+    }
+}
+/**
+ * PostgreSQL Message Repository
+ */
+class PostgreSQLMessageRepository {
+    constructor(client, tableName) {
+        this.client = client;
+        this.tableName = tableName;
+    }
+    async create(data) {
+        const id = `msg_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+        const result = await this.client.query(`INSERT INTO ${this.tableName}
+       (id, session_id, user_id, role, content, route, state, tool_calls, event, created_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, NOW())
+       RETURNING *`, [
+            id,
+            data.sessionId,
+            data.userId || null,
+            data.role,
+            data.content,
+            data.route || null,
+            data.state || null,
+            JSON.stringify(data.toolCalls || null),
+            JSON.stringify(data.event || null),
+        ]);
+        return result.rows[0];
+    }
+    async findById(id) {
+        const result = await this.client.query(`SELECT * FROM ${this.tableName} WHERE id = $1`, [id]);
+        return result.rows[0] || null;
+    }
+    async findBySessionId(sessionId, limit = 1000) {
+        const result = await this.client.query(`SELECT * FROM ${this.tableName}
+       WHERE session_id = $1
+       ORDER BY created_at ASC
+       LIMIT $2`, [sessionId, limit]);
+        return result.rows;
+    }
+    async findByUserId(userId, limit = 100) {
+        const result = await this.client.query(`SELECT * FROM ${this.tableName}
+       WHERE user_id = $1
+       ORDER BY created_at DESC
+       LIMIT $2`, [userId, limit]);
+        return result.rows;
+    }
+    async delete(id) {
+        const result = await this.client.query(`DELETE FROM ${this.tableName} WHERE id = $1`, [id]);
+        return result.rowCount > 0;
+    }
+    async deleteBySessionId(sessionId) {
+        const result = await this.client.query(`DELETE FROM ${this.tableName} WHERE session_id = $1`, [sessionId]);
+        return result.rowCount;
+    }
+    async deleteByUserId(userId) {
+        const result = await this.client.query(`DELETE FROM ${this.tableName} WHERE user_id = $1`, [userId]);
+        return result.rowCount;
+    }
+}
+//# sourceMappingURL=PostgreSQLAdapter.js.map

package/dist/adapters/PostgreSQLAdapter.js.map

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

package/dist/adapters/RedisAdapter.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Redis adapter for persistence
+ * Uses Redis for fast session/message storage
+ */
+import type { SessionRepository, MessageRepository, PersistenceAdapter } from "../types/persistence";
+/**
+ * Redis client interface - matches ioredis/redis clients
+ */
+export interface RedisClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<string | null>;
+    setex(key: string, seconds: number, value: string): Promise<string>;
+    del(...keys: string[]): Promise<number>;
+    keys(pattern: string): Promise<string[]>;
+    hgetall(key: string): Promise<Record<string, string>>;
+    hset(key: string, field: string, value: string): Promise<number>;
+    expire(key: string, seconds: number): Promise<number>;
+    quit(): Promise<string>;
+}
+/**
+ * Options for Redis adapter
+ */
+export interface RedisAdapterOptions {
+    /**
+     * Redis client instance (ioredis or node-redis)
+     */
+    redis: RedisClient;
+    /**
+     * Key prefix for all keys (default: "agent:")
+     */
+    keyPrefix?: string;
+    /**
+     * TTL in seconds for sessions (default: 7 days)
+     */
+    sessionTTL?: number;
+    /**
+     * TTL in seconds for messages (default: 30 days)
+     */
+    messageTTL?: number;
+}
+/**
+ * Redis Adapter - Provider-style API for Redis persistence
+ *
+ * @example
+ * ```typescript
+ * import Redis from 'ioredis';
+ * import { Agent, RedisAdapter } from '@falai/agent';
+ *
+ * const redis = new Redis();
+ *
+ * const agent = new Agent({
+ *   name: "My Agent",
+ *   ai: provider,
+ *   persistence: {
+ *     adapter: new RedisAdapter({ redis }),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+export declare class RedisAdapter implements PersistenceAdapter {
+    readonly sessionRepository: SessionRepository;
+    readonly messageRepository: MessageRepository;
+    private redis;
+    private keyPrefix;
+    private sessionTTL;
+    private messageTTL;
+    constructor(options: RedisAdapterOptions);
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=RedisAdapter.d.ts.map

package/dist/adapters/RedisAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/RedisAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAIjB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAa,YAAW,kBAAkB;IACrD,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,mBAAmB;IAmBlC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/adapters/RedisAdapter.js

@@ -0,0 +1,226 @@
+/**
+ * Redis adapter for persistence
+ * Uses Redis for fast session/message storage
+ */
+/**
+ * Redis Adapter - Provider-style API for Redis persistence
+ *
+ * @example
+ * ```typescript
+ * import Redis from 'ioredis';
+ * import { Agent, RedisAdapter } from '@falai/agent';
+ *
+ * const redis = new Redis();
+ *
+ * const agent = new Agent({
+ *   name: "My Agent",
+ *   ai: provider,
+ *   persistence: {
+ *     adapter: new RedisAdapter({ redis }),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+export class RedisAdapter {
+    constructor(options) {
+        this.redis = options.redis;
+        this.keyPrefix = options.keyPrefix || "agent:";
+        this.sessionTTL = options.sessionTTL || 7 * 24 * 60 * 60; // 7 days
+        this.messageTTL = options.messageTTL || 30 * 24 * 60 * 60; // 30 days
+        this.sessionRepository = new RedisSessionRepository(this.redis, this.keyPrefix, this.sessionTTL);
+        this.messageRepository = new RedisMessageRepository(this.redis, this.keyPrefix, this.messageTTL);
+    }
+    async disconnect() {
+        await this.redis.quit();
+    }
+}
+/**
+ * Redis Session Repository
+ */
+class RedisSessionRepository {
+    constructor(redis, keyPrefix, ttl) {
+        this.redis = redis;
+        this.keyPrefix = keyPrefix;
+        this.ttl = ttl;
+    }
+    getKey(id) {
+        return `${this.keyPrefix}session:${id}`;
+    }
+    getUserKey(userId) {
+        return `${this.keyPrefix}user:${userId}:sessions`;
+    }
+    async create(data) {
+        const id = `session_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+        const now = new Date();
+        const session = {
+            ...data,
+            id,
+            createdAt: now,
+            updatedAt: now,
+            status: data.status || "active",
+            messageCount: data.messageCount || 0,
+        };
+        await this.redis.setex(this.getKey(id), this.ttl, JSON.stringify(session));
+        // Add to user's session list
+        if (data.userId) {
+            await this.redis.hset(this.getUserKey(data.userId), id, now.toISOString());
+        }
+        return session;
+    }
+    async findById(id) {
+        const data = await this.redis.get(this.getKey(id));
+        if (!data)
+            return null;
+        try {
+            return JSON.parse(data);
+        }
+        catch (error) {
+            console.error(`Error parsing session data for id ${id}:`, error);
+            return null;
+        }
+    }
+    async findActiveByUserId(userId) {
+        const sessionIds = await this.redis.hgetall(this.getUserKey(userId));
+        for (const sessionId of Object.keys(sessionIds)) {
+            const session = await this.findById(sessionId);
+            if (session && session.status === "active") {
+                return session;
+            }
+        }
+        return null;
+    }
+    async findByUserId(userId, limit = 100) {
+        const sessionIds = await this.redis.hgetall(this.getUserKey(userId));
+        const sessions = [];
+        for (const sessionId of Object.keys(sessionIds).slice(0, limit)) {
+            const session = await this.findById(sessionId);
+            if (session) {
+                sessions.push(session);
+            }
+        }
+        return sessions.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    async update(id, data) {
+        const existing = await this.findById(id);
+        if (!existing)
+            return null;
+        const updated = {
+            ...existing,
+            ...data,
+            updatedAt: new Date(),
+        };
+        await this.redis.setex(this.getKey(id), this.ttl, JSON.stringify(updated));
+        return updated;
+    }
+    async updateStatus(id, status, completedAt) {
+        return this.update(id, { status, completedAt });
+    }
+    async updateCollectedData(id, collectedData) {
+        return this.update(id, { collectedData });
+    }
+    async updateRouteState(id, route, state) {
+        return this.update(id, { currentRoute: route, currentState: state });
+    }
+    async incrementMessageCount(id) {
+        const session = await this.findById(id);
+        if (!session)
+            return null;
+        return this.update(id, {
+            messageCount: (session.messageCount || 0) + 1,
+            lastMessageAt: new Date(),
+        });
+    }
+    async delete(id) {
+        const result = await this.redis.del(this.getKey(id));
+        return result > 0;
+    }
+}
+/**
+ * Redis Message Repository
+ */
+class RedisMessageRepository {
+    constructor(redis, keyPrefix, ttl) {
+        this.redis = redis;
+        this.keyPrefix = keyPrefix;
+        this.ttl = ttl;
+    }
+    getKey(id) {
+        return `${this.keyPrefix}message:${id}`;
+    }
+    getSessionKey(sessionId) {
+        return `${this.keyPrefix}session:${sessionId}:messages`;
+    }
+    async create(data) {
+        const id = `msg_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+        const message = {
+            ...data,
+            id,
+            createdAt: new Date(),
+        };
+        await this.redis.setex(this.getKey(id), this.ttl, JSON.stringify(message));
+        await this.redis.hset(this.getSessionKey(data.sessionId), id, message.createdAt.toISOString());
+        return message;
+    }
+    async findById(id) {
+        const data = await this.redis.get(this.getKey(id));
+        if (!data)
+            return null;
+        try {
+            return JSON.parse(data);
+        }
+        catch (error) {
+            console.error(`Error parsing message data for id ${id}:`, error);
+            return null;
+        }
+    }
+    async findBySessionId(sessionId, limit = 1000) {
+        const messageIds = await this.redis.hgetall(this.getSessionKey(sessionId));
+        const messages = [];
+        for (const messageId of Object.keys(messageIds).slice(0, limit)) {
+            const message = await this.findById(messageId);
+            if (message) {
+                messages.push(message);
+            }
+        }
+        return messages.sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
+    }
+    async findByUserId(userId, limit = 100) {
+        // Redis doesn't have efficient user-level querying
+        // This would require additional indexing
+        const pattern = `${this.keyPrefix}message:*`;
+        const keys = await this.redis.keys(pattern);
+        const messages = [];
+        for (const key of keys.slice(0, limit)) {
+            const data = await this.redis.get(key);
+            if (data) {
+                const message = JSON.parse(data);
+                if (message.userId === userId) {
+                    messages.push(message);
+                }
+            }
+        }
+        return messages.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    async delete(id) {
+        const result = await this.redis.del(this.getKey(id));
+        return result > 0;
+    }
+    async deleteBySessionId(sessionId) {
+        const messageIds = await this.redis.hgetall(this.getSessionKey(sessionId));
+        const keys = Object.keys(messageIds).map((id) => this.getKey(id));
+        if (keys.length === 0)
+            return 0;
+        const result = await this.redis.del(...keys);
+        await this.redis.del(this.getSessionKey(sessionId));
+        return result;
+    }
+    async deleteByUserId(userId) {
+        const messages = await this.findByUserId(userId);
+        const keys = messages.map((m) => this.getKey(m.id));
+        if (keys.length === 0)
+            return 0;
+        return await this.redis.del(...keys);
+    }
+}
+//# sourceMappingURL=RedisAdapter.js.map

package/dist/adapters/RedisAdapter.js.map

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

package/dist/adapters/SQLiteAdapter.d.ts

@@ -0,0 +1,69 @@
+/**
+ * SQLite adapter for persistence
+ * Lightweight, file-based database perfect for local development
+ */
+import type { SessionRepository, MessageRepository, PersistenceAdapter } from "../types/persistence";
+/**
+ * SQLite database interface - matches better-sqlite3
+ */
+export interface SqliteDatabase {
+    prepare(sql: string): SqliteStatement;
+    exec(sql: string): void;
+    close(): void;
+}
+/**
+ * SQLite statement interface
+ */
+export interface SqliteStatement {
+    run(...params: unknown[]): {
+        changes: number;
+        lastInsertRowid: number;
+    };
+    get(...params: unknown[]): Record<string, unknown> | undefined;
+    all(...params: unknown[]): Array<Record<string, unknown>>;
+}
+/**
+ * Options for SQLite adapter
+ */
+export interface SQLiteAdapterOptions {
+    /**
+     * SQLite database instance (better-sqlite3)
+     */
+    db: SqliteDatabase;
+    /**
+     * Table names (default: "agent_sessions" and "agent_messages")
+     */
+    tables?: {
+        sessions?: string;
+        messages?: string;
+    };
+}
+/**
+ * SQLite Adapter - Provider-style API for SQLite persistence
+ *
+ * @example
+ * ```typescript
+ * import Database from 'better-sqlite3';
+ * import { Agent, SQLiteAdapter } from '@falai/agent';
+ *
+ * const db = new Database('agent.db');
+ *
+ * const agent = new Agent({
+ *   name: "My Agent",
+ *   ai: provider,
+ *   persistence: {
+ *     adapter: new SQLiteAdapter({ db }),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+export declare class SQLiteAdapter implements PersistenceAdapter {
+    readonly sessionRepository: SessionRepository;
+    readonly messageRepository: MessageRepository;
+    private db;
+    constructor(options: SQLiteAdapterOptions);
+    initialize(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=SQLiteAdapter.d.ts.map

package/dist/adapters/SQLiteAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SQLiteAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/SQLiteAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAIjB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/D,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,EAAE,EAAE,cAAc,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,aAAc,YAAW,kBAAkB;IACtD,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,OAAO,CAAC,EAAE,CAAiB;gBAEf,OAAO,EAAE,oBAAoB;IAUnC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqD3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlC"}