@falai/agent 0.3.20 → 0.3.22

package/README.md

@@ -921,6 +921,15 @@ Fast, in-memory persistence for high-throughput applications:
 - 🔑 Custom key prefixes
 - 💨 Perfect for real-time chat applications
 
+### 🔍 [OpenSearch Persistence](./examples/opensearch-persistence.ts)
+
+Full-text search and analytics-powered persistence:
+
+- 🔍 Built-in full-text search across all messages
+- 📊 Powerful aggregations and analytics
+- 🌐 Compatible with Elasticsearch 7.x
+- ☁️ AWS OpenSearch Service ready
+
 ---
 
 ## 💾 Database Adapters
@@ -929,12 +938,15 @@ Fast, in-memory persistence for high-throughput applications:
 
 ### 🎯 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`             |
+| 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`                             |
+| **SQLiteAdapter**     | Lightweight local database         | `npm install better-sqlite3`                 |
+| **OpenSearchAdapter** | Full-text search & analytics       | `npm install @opensearch-project/opensearch` |
+| **MemoryAdapter**     | Testing & development (no install) | Built-in (no dependencies) ✨                |
 
 ### ⚡ Quick Setup
 

package/dist/adapters/MemoryAdapter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Memory adapter for persistence
+ * In-memory storage for testing and development (no database required)
+ */
+import type { SessionRepository, MessageRepository, SessionData, MessageData, PersistenceAdapter } from "../types/persistence";
+/**
+ * Memory Adapter - Provider-style API for in-memory persistence
+ *
+ * Perfect for:
+ * - Testing
+ * - Development
+ * - Prototyping
+ * - No database setup required
+ *
+ * @example
+ * ```typescript
+ * import { Agent, MemoryAdapter } from '@falai/agent';
+ *
+ * const agent = new Agent({
+ *   name: "My Agent",
+ *   ai: provider,
+ *   persistence: {
+ *     adapter: new MemoryAdapter(),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+export declare class MemoryAdapter implements PersistenceAdapter {
+    readonly sessionRepository: SessionRepository;
+    readonly messageRepository: MessageRepository;
+    private sessions;
+    private messages;
+    constructor();
+    /**
+     * Clear all data (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get data snapshot (useful for debugging)
+     */
+    getSnapshot(): {
+        sessions: SessionData[];
+        messages: MessageData[];
+    };
+}
+//# sourceMappingURL=MemoryAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/MemoryAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,WAAW,EAEX,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,aAAc,YAAW,kBAAkB;IACtD,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAA2B;;IAU3C;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,WAAW,IAAI;QACb,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,QAAQ,EAAE,WAAW,EAAE,CAAC;KACzB;CAMF"}

package/dist/adapters/MemoryAdapter.js

@@ -0,0 +1,178 @@
+/**
+ * Memory adapter for persistence
+ * In-memory storage for testing and development (no database required)
+ */
+/**
+ * Memory Adapter - Provider-style API for in-memory persistence
+ *
+ * Perfect for:
+ * - Testing
+ * - Development
+ * - Prototyping
+ * - No database setup required
+ *
+ * @example
+ * ```typescript
+ * import { Agent, MemoryAdapter } from '@falai/agent';
+ *
+ * const agent = new Agent({
+ *   name: "My Agent",
+ *   ai: provider,
+ *   persistence: {
+ *     adapter: new MemoryAdapter(),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+export class MemoryAdapter {
+    constructor() {
+        this.sessions = new Map();
+        this.messages = new Map();
+        this.sessionRepository = new MemorySessionRepository(this.sessions);
+        this.messageRepository = new MemoryMessageRepository(this.messages);
+    }
+    /**
+     * Clear all data (useful for testing)
+     */
+    clear() {
+        this.sessions.clear();
+        this.messages.clear();
+    }
+    /**
+     * Get data snapshot (useful for debugging)
+     */
+    getSnapshot() {
+        return {
+            sessions: Array.from(this.sessions.values()),
+            messages: Array.from(this.messages.values()),
+        };
+    }
+}
+/**
+ * Memory Session Repository
+ */
+class MemorySessionRepository {
+    constructor(sessions) {
+        this.sessions = sessions;
+    }
+    async create(data) {
+        const id = `session_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+        const now = new Date();
+        const session = {
+            ...data,
+            id,
+            status: data.status || "active",
+            messageCount: data.messageCount || 0,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.sessions.set(id, session);
+        return Promise.resolve(session);
+    }
+    async findById(id) {
+        const session = this.sessions.get(id) || null;
+        return Promise.resolve(session);
+    }
+    async findActiveByUserId(userId) {
+        const sessions = Array.from(this.sessions.values())
+            .filter((s) => s.userId === userId && s.status === "active")
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+        return Promise.resolve(sessions[0] || null);
+    }
+    async findByUserId(userId, limit = 100) {
+        const sessions = Array.from(this.sessions.values())
+            .filter((s) => s.userId === userId)
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())
+            .slice(0, limit);
+        return Promise.resolve(sessions);
+    }
+    async update(id, data) {
+        const existing = this.sessions.get(id);
+        if (!existing)
+            return null;
+        const updated = {
+            ...existing,
+            ...data,
+            updatedAt: new Date(),
+        };
+        this.sessions.set(id, updated);
+        return Promise.resolve(updated);
+    }
+    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 session = this.sessions.get(id);
+        if (!session)
+            return null;
+        return await this.update(id, {
+            messageCount: (session.messageCount || 0) + 1,
+            lastMessageAt: new Date(),
+        });
+    }
+    async delete(id) {
+        const result = this.sessions.delete(id);
+        return Promise.resolve(result);
+    }
+}
+/**
+ * Memory Message Repository
+ */
+class MemoryMessageRepository {
+    constructor(messages) {
+        this.messages = messages;
+    }
+    async create(data) {
+        const id = `msg_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+        const message = {
+            ...data,
+            id,
+            createdAt: new Date(),
+        };
+        this.messages.set(id, message);
+        return Promise.resolve(message);
+    }
+    async findById(id) {
+        const message = this.messages.get(id) || null;
+        return Promise.resolve(message);
+    }
+    async findBySessionId(sessionId, limit = 1000) {
+        const messages = Array.from(this.messages.values())
+            .filter((m) => m.sessionId === sessionId)
+            .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime())
+            .slice(0, limit);
+        return Promise.resolve(messages);
+    }
+    async findByUserId(userId, limit = 100) {
+        const messages = Array.from(this.messages.values())
+            .filter((m) => m.userId === userId)
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())
+            .slice(0, limit);
+        return Promise.resolve(messages);
+    }
+    async delete(id) {
+        const result = this.messages.delete(id);
+        return Promise.resolve(result);
+    }
+    async deleteBySessionId(sessionId) {
+        const toDelete = Array.from(this.messages.values()).filter((m) => m.sessionId === sessionId);
+        toDelete.forEach((m) => this.messages.delete(m.id));
+        return Promise.resolve(toDelete.length);
+    }
+    async deleteByUserId(userId) {
+        const toDelete = Array.from(this.messages.values()).filter((m) => m.userId === userId);
+        toDelete.forEach((m) => this.messages.delete(m.id));
+        return Promise.resolve(toDelete.length);
+    }
+}
+//# sourceMappingURL=MemoryAdapter.js.map

package/dist/adapters/MemoryAdapter.js.map

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

package/dist/adapters/OpenSearchAdapter.d.ts

@@ -0,0 +1,169 @@
+/**
+ * OpenSearch Persistence Adapter
+ *
+ * Provides persistence for sessions and messages using OpenSearch.
+ * Also compatible with Elasticsearch 7.x (not tested with newer versions).
+ *
+ * @example
+ * ```typescript
+ * import { Client } from '@opensearch-project/opensearch';
+ * import { OpenSearchAdapter } from '@falai/agent';
+ *
+ * const client = new Client({
+ *   node: 'https://localhost:9200',
+ *   auth: {
+ *     username: 'admin',
+ *     password: 'admin'
+ *   }
+ * });
+ *
+ * const adapter = new OpenSearchAdapter(client, {
+ *   indices: {
+ *     sessions: 'agent_sessions',
+ *     messages: 'agent_messages'
+ *   },
+ *   autoCreateIndices: true
+ * });
+ *
+ * const agent = new Agent({
+ *   model: provider,
+ *   persistence: { adapter }
+ * });
+ * ```
+ */
+import type { PersistenceAdapter, SessionRepository, MessageRepository } from "../types/persistence.js";
+/**
+ * OpenSearch Client interface (minimal typing for the official client)
+ */
+export interface OpenSearchClient {
+    index(params: {
+        index: string;
+        id?: string;
+        body: Record<string, unknown>;
+        refresh?: boolean | "wait_for";
+    }): Promise<{
+        body: {
+            _id: string;
+            result: string;
+        };
+    }>;
+    get(params: {
+        index: string;
+        id: string;
+    }): Promise<{
+        body: {
+            _source: Record<string, unknown>;
+        };
+    }>;
+    update(params: {
+        index: string;
+        id: string;
+        body: {
+            doc: Record<string, unknown>;
+        };
+        refresh?: boolean | "wait_for";
+    }): Promise<{
+        body: {
+            result: string;
+        };
+    }>;
+    delete(params: {
+        index: string;
+        id: string;
+        refresh?: boolean | "wait_for";
+    }): Promise<{
+        body: {
+            result: string;
+        };
+    }>;
+    deleteByQuery(params: {
+        index: string;
+        body: {
+            query: Record<string, unknown>;
+        };
+        refresh?: boolean | "wait_for";
+    }): Promise<{
+        body: {
+            deleted: number;
+        };
+    }>;
+    search(params: {
+        index: string;
+        body: {
+            query?: Record<string, unknown>;
+            sort?: Array<Record<string, unknown>>;
+            size?: number;
+        };
+    }): Promise<{
+        body: {
+            hits: {
+                hits: Array<{
+                    _id: string;
+                    _source: Record<string, unknown>;
+                }>;
+            };
+        };
+    }>;
+    indices: {
+        exists(params: {
+            index: string;
+        }): Promise<{
+            body: boolean;
+        }>;
+        create(params: {
+            index: string;
+            body: {
+                mappings?: Record<string, unknown>;
+            };
+        }): Promise<{
+            body: {
+                acknowledged: boolean;
+            };
+        }>;
+    };
+}
+/**
+ * Configuration options for the OpenSearch adapter
+ */
+export interface OpenSearchAdapterOptions {
+    /**
+     * Index names for sessions and messages
+     * @default { sessions: 'agent_sessions', messages: 'agent_messages' }
+     */
+    indices?: {
+        sessions?: string;
+        messages?: string;
+    };
+    /**
+     * Automatically create indices with mappings if they don't exist
+     * @default true
+     */
+    autoCreateIndices?: boolean;
+    /**
+     * Refresh strategy for write operations
+     * - true: Refresh immediately (slower, good for testing)
+     * - false: Refresh in background (faster, eventual consistency)
+     * - 'wait_for': Wait for refresh (balanced)
+     * @default false
+     */
+    refresh?: boolean | "wait_for";
+}
+/**
+ * OpenSearch persistence adapter
+ *
+ * Stores sessions and messages as documents in OpenSearch indices.
+ * Compatible with OpenSearch 1.x, 2.x and Elasticsearch 7.x.
+ */
+export declare class OpenSearchAdapter implements PersistenceAdapter {
+    readonly sessionRepository: SessionRepository;
+    readonly messageRepository: MessageRepository;
+    private readonly client;
+    private readonly sessionIndex;
+    private readonly messageIndex;
+    private readonly autoCreateIndices;
+    private readonly refresh;
+    constructor(client: OpenSearchClient, options?: OpenSearchAdapterOptions);
+    initialize(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=OpenSearchAdapter.d.ts.map

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

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