@falai/agent 0.1.0-alpha2

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

@@ -0,0 +1,97 @@
+/**
+ * MongoDB adapter for persistence
+ * Document-based storage with flexible schema
+ */
+import type { MessageRepository, PersistenceAdapter, SessionRepository } from "../types";
+/**
+ * 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",
+ *   provider: provider,
+ *   persistence: {
+ *     adapter: new MongoAdapter({
+ *       client,
+ *       databaseName: 'myapp',
+ *     }),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+export declare class MongoAdapter<TData = Record<string, unknown>> implements PersistenceAdapter<TData> {
+    readonly sessionRepository: SessionRepository<TData>;
+    readonly messageRepository: MessageRepository;
+    private client;
+    private db;
+    constructor(options: MongoAdapterOptions);
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=MongoAdapter.d.ts.map

package/dist/src/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,EAEV,iBAAiB,EACjB,kBAAkB,EAElB,iBAAiB,EAIlB,MAAM,UAAU,CAAC;AAElB;;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,YAAY,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACvD,YAAW,kBAAkB,CAAC,KAAK,CAAC;IAEpC,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC5D,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/src/adapters/MongoAdapter.js

@@ -0,0 +1,164 @@
+/**
+ * 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",
+ *   provider: 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: 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 updateRouteStep(id, route, step) {
+        return await this.update(id, {
+            currentRoute: route,
+            currentStep: step,
+        });
+    }
+    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/src/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/src/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";
+/**
+ * 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;
+    }): 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<TData = Record<string, unknown>> implements PersistenceAdapter<TData> {
+    readonly sessionRepository: SessionRepository<TData>;
+    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/src/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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"}