@falai/agent 0.3.11 → 0.3.20

package/README.md

@@ -57,6 +57,27 @@
 - **Domain Registry** - Organize capabilities by domain
 - **Context Awareness** - Tools receive typed context automatically
 
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### 💾 **Optional Persistence**
+
+- **Provider Pattern** - Simple API like AI providers
+- **Prisma Ready** - Built-in ORM adapter
+- **Auto-save** - Automatic session & message persistence
+- **Extensible** - Create adapters for any database
+
+</td>
+<td width="50%">
+
+### 🎯 **Smart Routing**
+
+- **Deterministic IDs** - Consistent identifiers across restarts
+- **Route Scoping** - Control tool access per route
+- **Rules & Prohibitions** - Fine-grained behavior control
+
 </td>
 </tr>
 </table>
@@ -225,6 +246,7 @@ See [streaming-agent.ts](./examples/streaming-agent.ts) for complete examples.
 - **[Getting Started](./docs/GETTING_STARTED.md)** - Your first agent in 5 minutes
 - **[Constructor Options](./docs/CONSTRUCTOR_OPTIONS.md)** - Declarative vs Fluent API patterns
 - **[Context Management](./docs/CONTEXT_MANAGEMENT.md)** - Persistent conversations & state management
+- **[Persistence](./docs/PERSISTENCE.md)** - Optional database persistence with Prisma **(NEW!)**
 - **[API Reference](./docs/API_REFERENCE.md)** - Complete API documentation
 - **[Architecture](./docs/STRUCTURE.md)** - Package structure and design principles
 
@@ -595,6 +617,66 @@ const saveTool = defineTool("save_data", async (ctx, data) => {
 
 See [Context Management Guide](./docs/CONTEXT_MANAGEMENT.md) for complete patterns and best practices.
 
+### 💾 Optional Database Persistence (NEW!)
+
+For **production applications** that need to persist sessions and messages:
+
+```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,
+  // ✨ Just add this!
+  persistence: {
+    adapter: new PrismaAdapter({ prisma }),
+    autoSave: true,
+    userId: "user_123",
+  },
+});
+
+// Access persistence manager
+const persistence = agent.getPersistenceManager();
+
+// Create a session
+const session = await persistence.createSession({
+  userId: "user_123",
+  agentName: "My Agent",
+});
+
+// Load history
+const history = await persistence.loadSessionHistory(session.id);
+
+// Generate response
+const response = await agent.respond({ history });
+
+// Optionally Save message (automatically saves if autoSave: true)
+await persistence.saveMessage({
+  sessionId: session.id,
+  role: "agent",
+  content: response.message,
+});
+```
+
+**Features:**
+
+- ✅ **Provider Pattern** - Simple API like AI providers
+- ✅ **Prisma Built-in** - Ready-to-use ORM adapter
+- ✅ **Auto-save** - Automatic message tracking
+- ✅ **Custom Adapters** - Create for any database (MongoDB, Redis, etc.)
+- ✅ **Lifecycle Integration** - Works seamlessly with context hooks
+
+**Setup (3 steps):**
+
+1. Install: `npm install @prisma/client prisma`
+2. Copy schema from `examples/prisma-schema.example.prisma`
+3. Run: `npx prisma generate && npx prisma migrate dev`
+
+See [Persistence Guide](./docs/PERSISTENCE.md) for complete documentation and custom adapter examples.
+
 ### 📖 Domain Glossary
 
 Teach your agent business-specific language:
@@ -751,6 +833,16 @@ const openrouterProvider = new OpenRouterProvider({
 - 🔧 Two approaches: lifecycle hooks vs context provider
 - 📝 Complete onboarding flow across multiple turns
 
+### 💾 [Prisma Persistence](./examples/prisma-persistence.ts) **(NEW!)**
+
+**Production-ready database persistence:**
+
+- ✨ Provider pattern - simple as `new PrismaAdapter({ prisma })`
+- 🗄️ Automatic session and message persistence
+- 🔄 Seamless lifecycle hook integration
+- 📊 Complete examples: basic, advanced, and minimal
+- 🎯 3-step setup with Prisma ORM
+
 ### 🏢 [Business Onboarding](./examples/business-onboarding.ts)
 
 **Production-ready business onboarding with advanced patterns:**
@@ -810,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"}