@falai/agent 0.3.12 → 0.3.21

package/dist/cjs/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/cjs/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/cjs/adapters/RedisAdapter.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Redis adapter for persistence
+ * Uses Redis for fast session/message storage
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisAdapter = void 0;
+/**
+ * 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",
+ *   },
+ * });
+ * ```
+ */
+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();
+    }
+}
+exports.RedisAdapter = RedisAdapter;
+/**
+ * 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/cjs/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/cjs/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/cjs/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"}