@falai/agent 0.3.12 → 0.3.20

package/README.md

@@ -902,6 +902,78 @@ Control agent behavior and communication style per route:
 - 💬 Different communication styles per route
 - 🎨 Perfect for multi-channel bots (WhatsApp, email, chat)
 
+### 💾 [Prisma Persistence](./examples/prisma-persistence.ts)
+
+Complete example of auto-saving sessions and messages with Prisma ORM:
+
+- 💾 Auto-save sessions and messages to database
+- 🔄 Load conversation history on agent initialization
+- 📊 Track conversation state across restarts
+- 🎯 Full example with lifecycle hooks
+- 📝 Includes schema example
+
+### ⚡ [Redis Persistence](./examples/redis-persistence.ts)
+
+Fast, in-memory persistence for high-throughput applications:
+
+- 🚀 Lightning-fast session storage
+- ⏰ Configurable TTLs for auto-cleanup
+- 🔑 Custom key prefixes
+- 💨 Perfect for real-time chat applications
+
+---
+
+## 💾 Database Adapters
+
+**Optional persistence** - Choose the database that fits your needs. All adapters follow the same simple provider pattern:
+
+### 🎯 Available Adapters
+
+| Adapter               | Use Case                          | Install                      |
+| --------------------- | --------------------------------- | ---------------------------- |
+| **PrismaAdapter**     | Type-safe ORM with migrations     | `npm install @prisma/client` |
+| **RedisAdapter**      | Fast in-memory for real-time apps | `npm install ioredis`        |
+| **MongoAdapter**      | Flexible document storage         | `npm install mongodb`        |
+| **PostgreSQLAdapter** | Raw SQL with auto table creation  | `npm install pg`             |
+
+### ⚡ Quick Setup
+
+```typescript
+import { Agent, PrismaAdapter } from "@falai/agent";
+import { PrismaClient } from "@prisma/client";
+
+const prisma = new PrismaClient();
+
+const agent = new Agent({
+  name: "My Agent",
+  ai: provider,
+  persistence: {
+    adapter: new PrismaAdapter({ prisma }),
+    userId: "user_123",
+    autoSave: true, // Automatically save all messages
+  },
+});
+```
+
+That's it! Sessions and messages are now automatically persisted.
+
+### 📚 Full Documentation
+
+See [**docs/PERSISTENCE.md**](./docs/PERSISTENCE.md) for:
+
+- Complete adapter API reference
+- Custom table names & field mappings
+- Lifecycle hooks for persistence
+- Creating custom adapters
+- Migration guides
+
+See [**docs/ADAPTERS.md**](./docs/ADAPTERS.md) for:
+
+- Detailed adapter comparison
+- Configuration examples for each database
+- Performance characteristics
+- Type safety guarantees
+
 ---
 
 ## 🏗️ Architecture

package/dist/adapters/MongoAdapter.d.ts

@@ -0,0 +1,97 @@
+/**
+ * MongoDB adapter for persistence
+ * Document-based storage with flexible schema
+ */
+import type { SessionRepository, MessageRepository, PersistenceAdapter } from "../types/persistence";
+/**
+ * MongoDB collection interface - matches mongodb driver
+ */
+export interface MongoCollection<T = Record<string, unknown>> {
+    insertOne(doc: T): Promise<{
+        insertedId: unknown;
+    }>;
+    findOne(filter: Record<string, unknown>): Promise<T | null>;
+    find(filter: Record<string, unknown>): {
+        sort(sort: Record<string, number>): {
+            limit(limit: number): {
+                toArray(): Promise<T[]>;
+            };
+        };
+        toArray(): Promise<T[]>;
+    };
+    updateOne(filter: Record<string, unknown>, update: Record<string, unknown>): Promise<{
+        matchedCount: number;
+    }>;
+    deleteOne(filter: Record<string, unknown>): Promise<{
+        deletedCount: number;
+    }>;
+    deleteMany(filter: Record<string, unknown>): Promise<{
+        deletedCount: number;
+    }>;
+}
+/**
+ * MongoDB database interface
+ */
+export interface MongoDatabase {
+    collection<T = Record<string, unknown>>(name: string): MongoCollection<T>;
+}
+/**
+ * MongoDB client interface
+ */
+export interface MongoClient {
+    db(name?: string): MongoDatabase;
+    close(): Promise<void>;
+}
+/**
+ * Options for MongoDB adapter
+ */
+export interface MongoAdapterOptions {
+    /**
+     * MongoDB client instance
+     */
+    client: MongoClient;
+    /**
+     * Database name
+     */
+    databaseName: string;
+    /**
+     * Collection names (default: "agent_sessions" and "agent_messages")
+     */
+    collections?: {
+        sessions?: string;
+        messages?: string;
+    };
+}
+/**
+ * MongoDB Adapter - Provider-style API for MongoDB persistence
+ *
+ * @example
+ * ```typescript
+ * import { MongoClient } from 'mongodb';
+ * import { Agent, MongoAdapter } from '@falai/agent';
+ *
+ * const client = new MongoClient('mongodb://localhost:27017');
+ * await client.connect();
+ *
+ * const agent = new Agent({
+ *   name: "My Agent",
+ *   ai: provider,
+ *   persistence: {
+ *     adapter: new MongoAdapter({
+ *       client,
+ *       databaseName: 'myapp',
+ *     }),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+export declare class MongoAdapter implements PersistenceAdapter {
+    readonly sessionRepository: SessionRepository;
+    readonly messageRepository: MessageRepository;
+    private client;
+    private db;
+    constructor(options: MongoAdapterOptions);
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=MongoAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MongoAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/MongoAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAIjB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpD,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5D,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QACrC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;YAClC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG;gBACpB,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;aACzB,CAAC;SACH,CAAC;QACF,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;KACzB,CAAC;IACF,SAAS,CACP,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,UAAU,CACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;CAC3E;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;IAEpB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,YAAa,YAAW,kBAAkB;IACrD,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,EAAE,CAAgB;gBAEd,OAAO,EAAE,mBAAmB;IAgBlC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/adapters/MongoAdapter.js

@@ -0,0 +1,163 @@
+/**
+ * MongoDB adapter for persistence
+ * Document-based storage with flexible schema
+ */
+/**
+ * MongoDB Adapter - Provider-style API for MongoDB persistence
+ *
+ * @example
+ * ```typescript
+ * import { MongoClient } from 'mongodb';
+ * import { Agent, MongoAdapter } from '@falai/agent';
+ *
+ * const client = new MongoClient('mongodb://localhost:27017');
+ * await client.connect();
+ *
+ * const agent = new Agent({
+ *   name: "My Agent",
+ *   ai: provider,
+ *   persistence: {
+ *     adapter: new MongoAdapter({
+ *       client,
+ *       databaseName: 'myapp',
+ *     }),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+export class MongoAdapter {
+    constructor(options) {
+        this.client = options.client;
+        this.db = options.client.db(options.databaseName);
+        const sessionCollection = options.collections?.sessions || "agent_sessions";
+        const messageCollection = options.collections?.messages || "agent_messages";
+        this.sessionRepository = new MongoSessionRepository(this.db.collection(sessionCollection));
+        this.messageRepository = new MongoMessageRepository(this.db.collection(messageCollection));
+    }
+    async disconnect() {
+        await this.client.close();
+    }
+}
+/**
+ * MongoDB Session Repository
+ */
+class MongoSessionRepository {
+    constructor(collection) {
+        this.collection = collection;
+    }
+    async create(data) {
+        const now = new Date();
+        const session = {
+            ...data,
+            id: `session_${Date.now()}_${Math.random().toString(36).slice(2)}`,
+            status: data.status || "active",
+            messageCount: data.messageCount || 0,
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.collection.insertOne(session);
+        return session;
+    }
+    async findById(id) {
+        return await this.collection.findOne({ id });
+    }
+    async findActiveByUserId(userId) {
+        return await this.collection.findOne({ userId, status: "active" });
+    }
+    async findByUserId(userId, limit = 100) {
+        return await this.collection
+            .find({ userId })
+            .sort({ createdAt: -1 })
+            .limit(limit)
+            .toArray();
+    }
+    async update(id, data) {
+        const result = await this.collection.updateOne({ id }, { $set: { ...data, updatedAt: new Date() } });
+        if (result.matchedCount === 0)
+            return null;
+        return await this.findById(id);
+    }
+    async updateStatus(id, status, completedAt) {
+        const updateData = {
+            status,
+            updatedAt: new Date(),
+        };
+        if (completedAt) {
+            updateData.completedAt = completedAt;
+        }
+        const result = await this.collection.updateOne({ id }, { $set: updateData });
+        if (result.matchedCount === 0)
+            return null;
+        return await this.findById(id);
+    }
+    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.collection.updateOne({ id }, {
+            $inc: { messageCount: 1 },
+            $set: { lastMessageAt: new Date(), updatedAt: new Date() },
+        });
+        if (result.matchedCount === 0)
+            return null;
+        return await this.findById(id);
+    }
+    async delete(id) {
+        const result = await this.collection.deleteOne({ id });
+        return result.deletedCount > 0;
+    }
+}
+/**
+ * MongoDB Message Repository
+ */
+class MongoMessageRepository {
+    constructor(collection) {
+        this.collection = collection;
+    }
+    async create(data) {
+        const message = {
+            ...data,
+            id: `msg_${Date.now()}_${Math.random().toString(36).slice(2)}`,
+            createdAt: new Date(),
+        };
+        await this.collection.insertOne(message);
+        return message;
+    }
+    async findById(id) {
+        return await this.collection.findOne({ id });
+    }
+    async findBySessionId(sessionId, limit = 1000) {
+        return await this.collection
+            .find({ sessionId })
+            .sort({ createdAt: 1 })
+            .limit(limit)
+            .toArray();
+    }
+    async findByUserId(userId, limit = 100) {
+        return await this.collection
+            .find({ userId })
+            .sort({ createdAt: -1 })
+            .limit(limit)
+            .toArray();
+    }
+    async delete(id) {
+        const result = await this.collection.deleteOne({ id });
+        return result.deletedCount > 0;
+    }
+    async deleteBySessionId(sessionId) {
+        const result = await this.collection.deleteMany({ sessionId });
+        return result.deletedCount;
+    }
+    async deleteByUserId(userId) {
+        const result = await this.collection.deleteMany({ userId });
+        return result.deletedCount;
+    }
+}
+//# sourceMappingURL=MongoAdapter.js.map

package/dist/adapters/MongoAdapter.js.map

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

package/dist/adapters/PostgreSQLAdapter.d.ts

@@ -0,0 +1,71 @@
+/**
+ * PostgreSQL adapter for persistence
+ * Raw SQL adapter for PostgreSQL with custom schemas
+ */
+import type { SessionRepository, MessageRepository, PersistenceAdapter } from "../types/persistence";
+/**
+ * PostgreSQL query result interface
+ */
+export interface PgQueryResult<T = Record<string, unknown>> {
+    rows: T[];
+    rowCount: number;
+}
+/**
+ * PostgreSQL client interface - matches pg (node-postgres)
+ */
+export interface PgClient {
+    query<T = Record<string, unknown>>(sql: string, values?: unknown[]): Promise<PgQueryResult<T>>;
+    end(): Promise<void>;
+}
+/**
+ * Options for PostgreSQL adapter
+ */
+export interface PostgreSQLAdapterOptions {
+    /**
+     * PostgreSQL client instance (from 'pg' package)
+     */
+    client: PgClient;
+    /**
+     * Table names (default: "agent_sessions" and "agent_messages")
+     */
+    tables?: {
+        sessions?: string;
+        messages?: string;
+    };
+}
+/**
+ * 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 declare class PostgreSQLAdapter implements PersistenceAdapter {
+    readonly sessionRepository: SessionRepository;
+    readonly messageRepository: MessageRepository;
+    private client;
+    constructor(options: PostgreSQLAdapterOptions);
+    initialize(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=PostgreSQLAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PostgreSQLAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/PostgreSQLAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAIjB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,OAAO,CAAC,MAAM,CAAW;gBAEb,OAAO,EAAE,wBAAwB;IAiBvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiD3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

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