@falai/agent 3.4.3 → 3.4.5

package/dist/cjs/adapters/RedisAdapter.js

@@ -0,0 +1,290 @@
+"use strict";
+/**
+ * Redis adapter for persistence
+ * Uses Redis for fast session/message storage
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisAdapter = void 0;
+const errors_js_1 = require("../types/errors.js");
+const index_js_1 = require("../utils/index.js");
+const sessionRow_js_1 = require("./sessionRow.js");
+/**
+ * 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",
+ *   provider: 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 = data.id || (0, index_js_1.createSessionId)();
+        const now = new Date();
+        const session = {
+            ...data,
+            id,
+            createdAt: now,
+            updatedAt: now,
+            status: data.status || "active",
+            messageCount: data.messageCount || 0,
+            version: data.version ?? 1,
+        };
+        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 {
+            const parsed = JSON.parse(data);
+            // JSON round-trips turn Dates into ISO strings — coerce on read so
+            // callers always get Date instances (parity with the SQL adapters).
+            return {
+                ...parsed,
+                lastMessageAt: (0, sessionRow_js_1.coerceDate)(parsed.lastMessageAt),
+                completedAt: (0, sessionRow_js_1.coerceDate)(parsed.completedAt),
+                createdAt: (0, sessionRow_js_1.coerceDate)(parsed.createdAt) ?? new Date(),
+                updatedAt: (0, sessionRow_js_1.coerceDate)(parsed.updatedAt) ?? new Date(),
+            };
+        }
+        catch (error) {
+            index_js_1.logger.error(`Error parsing session data for id ${id}:`, error);
+            return null;
+        }
+    }
+    async findActiveByUserId(userId) {
+        const sessionIds = await this.redis.hgetall(this.getUserKey(userId));
+        // Newest-first: the hash values ARE the sessions' createdAt ISO strings,
+        // which sort lexicographically. Iterating hash order instead would return
+        // an arbitrary active session, not the most recent one.
+        const newestFirst = Object.keys(sessionIds).sort((a, b) => sessionIds[b].localeCompare(sessionIds[a]));
+        for (const sessionId of newestFirst) {
+            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));
+        // Sort BEFORE limiting (hash values are the createdAt ISO strings) —
+        // limiting first would keep an arbitrary hash-order subset.
+        const newestFirst = Object.keys(sessionIds)
+            .sort((a, b) => sessionIds[b].localeCompare(sessionIds[a]))
+            .slice(0, limit);
+        const sessions = [];
+        for (const sessionId of newestFirst) {
+            const session = await this.findById(sessionId);
+            if (session) {
+                sessions.push(session);
+            }
+        }
+        return sessions;
+    }
+    async update(id, data, options) {
+        const existing = await this.findById(id);
+        if (!existing)
+            return null;
+        // Check-then-set on the stored JSON — not fully atomic (no WATCH/MULTI)
+        if (options?.expectedVersion !== undefined &&
+            existing.version !== undefined &&
+            existing.version !== options.expectedVersion) {
+            throw new errors_js_1.SessionConflictError(id, options.expectedVersion, existing.version);
+        }
+        const updated = {
+            ...existing,
+            ...data,
+            version: (existing.version ?? options?.expectedVersion ?? 0) + 1,
+            updatedAt: new Date(),
+        };
+        await this.redis.setex(this.getKey(id), this.ttl, JSON.stringify(updated));
+        return updated;
+    }
+    async updateStatus(id, status, completedAt) {
+        // An undefined completedAt must be omitted, not spread — update() writes
+        // whatever keys it receives, and SQL skips undefined columns.
+        return this.update(id, completedAt ? { status, completedAt } : { status });
+    }
+    async updateCollectedData(id, collectedData) {
+        return this.update(id, { collectedData });
+    }
+    async updateFlowStep(id, flow, step) {
+        // Mirror SQL's conditional column assembly: only defined values are written.
+        return this.update(id, {
+            ...(flow !== undefined && { currentFlow: flow }),
+            ...(step !== undefined && { currentStep: step }),
+        });
+    }
+    async incrementMessageCount(id) {
+        const session = await this.findById(id);
+        if (!session)
+            return null;
+        // Bookkeeping write, deliberately NOT routed through update(): count bumps
+        // run alongside saveSessionState's version CAS every turn, so they must
+        // not move `version` (matches the SQL adapters' dedicated statement).
+        const updated = {
+            ...session,
+            messageCount: (session.messageCount || 0) + 1,
+            lastMessageAt: new Date(),
+            updatedAt: new Date(),
+        };
+        await this.redis.setex(this.getKey(id), this.ttl, JSON.stringify(updated));
+        return updated;
+    }
+    async delete(id) {
+        // Look up first so the user index can be cleaned too — otherwise
+        // findActiveByUserId/findByUserId chase dead ids forever.
+        const existing = await this.findById(id);
+        if (!existing)
+            return false;
+        const result = await this.redis.del(this.getKey(id));
+        if (existing.userId) {
+            await this.redis.hdel(this.getUserKey(existing.userId), 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 {
+            const message = JSON.parse(data);
+            return { ...message, createdAt: (0, sessionRow_js_1.coerceDate)(message.createdAt) ?? new Date() };
+        }
+        catch (error) {
+            index_js_1.logger.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));
+        // Fetch ALL candidates first — limiting before sorting would keep an
+        // arbitrary hash-order subset instead of the oldest messages. The fetches
+        // are independent, so run them concurrently instead of N serialized
+        // round trips.
+        const fetched = await Promise.all(Object.keys(messageIds).map((messageId) => this.findById(messageId)));
+        const messages = fetched.filter((m) => m !== null);
+        // Chronological order (matches PostgreSQL/Mongo adapters); limit applies
+        // only after sorting is meaningful.
+        return messages
+            .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime())
+            .slice(0, limit);
+    }
+    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);
+        // Filter by userId BEFORE limiting — slicing keys first would drop
+        // matching messages that happen to sort after unrelated users' keys.
+        // ponytail: full keyspace scan per user query (pre-existing ceiling of
+        // this adapter); the upgrade path is a per-user message index.
+        const fetched = await Promise.all(keys.map((key) => this.redis.get(key)));
+        const messages = [];
+        for (const data of fetched) {
+            if (!data)
+                continue;
+            const parsed = JSON.parse(data);
+            if (parsed.userId === userId) {
+                messages.push({ ...parsed, createdAt: (0, sessionRow_js_1.coerceDate)(parsed.createdAt) ?? new Date() });
+            }
+        }
+        return messages
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())
+            .slice(0, limit);
+    }
+    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":";AAAA;;;GAGG;;;AAYH,kDAA0D;AAC1D,gDAA4D;AAC5D,mDAA6C;AA2C7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,YAAY;IAQvB,YAAY,OAA4B;QACtC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,SAAS;QACnE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU;QAErE,IAAI,CAAC,iBAAiB,GAAG,IAAI,sBAAsB,CACjD,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,UAAU,CAChB,CAAC;QAEF,IAAI,CAAC,iBAAiB,GAAG,IAAI,sBAAsB,CACjD,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,UAAU,CAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;CACF;AA9BD,oCA8BC;AAED;;GAEG;AACH,MAAM,sBAAsB;IAE1B,YACU,KAAkB,EAClB,SAAiB,EACjB,GAAW;QAFX,UAAK,GAAL,KAAK,CAAa;QAClB,cAAS,GAAT,SAAS,CAAQ;QACjB,QAAG,GAAH,GAAG,CAAQ;IACjB,CAAC;IAEG,MAAM,CAAC,EAAU;QACvB,OAAO,GAAG,IAAI,CAAC,SAAS,WAAW,EAAE,EAAE,CAAC;IAC1C,CAAC;IAEO,UAAU,CAAC,MAAc;QAC/B,OAAO,GAAG,IAAI,CAAC,SAAS,QAAQ,MAAM,WAAW,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,MAAM,CACV,IAEC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,IAAA,0BAAe,GAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAuB;YAClC,GAAG,IAAI;YACP,EAAE;YACF,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,QAAQ;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,CAAC;YACpC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,CAAC;SAC3B,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAE3E,6BAA6B;QAC7B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAC5B,EAAE,EACF,GAAG,CAAC,WAAW,EAAE,CAClB,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAC;YACtD,mEAAmE;YACnE,oEAAoE;YACpE,OAAO;gBACL,GAAG,MAAM;gBACT,aAAa,EAAE,IAAA,0BAAU,EAAC,MAAM,CAAC,aAAa,CAAC;gBAC/C,WAAW,EAAE,IAAA,0BAAU,EAAC,MAAM,CAAC,WAAW,CAAC;gBAC3C,SAAS,EAAE,IAAA,0BAAU,EAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,EAAE;gBACrD,SAAS,EAAE,IAAA,0BAAU,EAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,EAAE;aACtD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iBAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,MAAc;QACrC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAErE,yEAAyE;QACzE,0EAA0E;QAC1E,wDAAwD;QACxD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACxD,UAAU,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAC3C,CAAC;QACF,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC/C,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC3C,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,MAAc,EACd,KAAK,GAAG,GAAG;QAEX,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAErE,qEAAqE;QACrE,4DAA4D;QAC5D,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;aACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;aAC1D,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACnB,MAAM,QAAQ,GAAyB,EAAE,CAAC;QAC1C,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC/C,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,MAAM,CACV,EAAU,EACV,IAA2D,EAC3D,OAA8B;QAE9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE3B,wEAAwE;QACxE,IACE,OAAO,EAAE,eAAe,KAAK,SAAS;YACtC,QAAQ,CAAC,OAAO,KAAK,SAAS;YAC9B,QAAQ,CAAC,OAAO,KAAK,OAAO,CAAC,eAAe,EAC5C,CAAC;YACD,MAAM,IAAI,gCAAoB,CAC5B,EAAE,EACF,OAAO,CAAC,eAAe,EACvB,QAAQ,CAAC,OAAO,CACjB,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAuB;YAClC,GAAG,QAAQ;YACX,GAAG,IAAI;YACP,OAAO,EAAE,CAAC,QAAQ,CAAC,OAAO,IAAI,OAAO,EAAE,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC;YAChE,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAE3E,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,EAAU,EACV,MAAqB,EACrB,WAAkB;QAElB,yEAAyE;QACzE,8DAA8D;QAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,EAAU,EACV,aAAwC;QAExC,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,EAAU,EACV,IAAa,EACb,IAAa;QAEb,6EAA6E;QAC7E,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE;YACrB,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAChD,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;SACjD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,EAAU;QACpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,2EAA2E;QAC3E,wEAAwE;QACxE,sEAAsE;QACtE,MAAM,OAAO,GAAuB;YAClC,GAAG,OAAO;YACV,YAAY,EAAE,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC;YAC7C,aAAa,EAAE,IAAI,IAAI,EAAE;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;QACF,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3E,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,iEAAiE;QACjE,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE5B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,MAAM,GAAG,CAAC,CAAC;IACpB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,sBAAsB;IAC1B,YACU,KAAkB,EAClB,SAAiB,EACjB,GAAW;QAFX,UAAK,GAAL,KAAK,CAAa;QAClB,cAAS,GAAT,SAAS,CAAQ;QACjB,QAAG,GAAH,GAAG,CAAQ;IACjB,CAAC;IAEG,MAAM,CAAC,EAAU;QACvB,OAAO,GAAG,IAAI,CAAC,SAAS,WAAW,EAAE,EAAE,CAAC;IAC1C,CAAC;IAEO,aAAa,CAAC,SAAiB;QACrC,OAAO,GAAG,IAAI,CAAC,SAAS,WAAW,SAAS,WAAW,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,MAAM,CACV,IAA2C;QAE3C,MAAM,EAAE,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,OAAO,GAAgB;YAC3B,GAAG,IAAI;YACP,EAAE;YACF,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3E,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CACnB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,EAClC,EAAE,EACF,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,CAChC,CAAC;QAEF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC;YAChD,OAAO,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,IAAA,0BAAU,EAAC,OAAO,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QAChF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iBAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,SAAiB,EACjB,KAAK,GAAG,IAAI;QAEZ,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;QAE3E,qEAAqE;QACrE,0EAA0E;QAC1E,oEAAoE;QACpE,eAAe;QACf,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CACrE,CAAC;QACF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAErE,yEAAyE;QACzE,oCAAoC;QACpC,OAAO,QAAQ;aACZ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;aAC7D,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,KAAK,GAAG,GAAG;QAC5C,mDAAmD;QACnD,yCAAyC;QACzC,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,WAAW,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE5C,mEAAmE;QACnE,qEAAqE;QACrE,uEAAuE;QACvE,+DAA+D;QAC/D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,MAAM,GAAgB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,IAAA,0BAAU,EAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;QAED,OAAO,QAAQ;aACZ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;aAC7D,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,OAAO,MAAM,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QACvC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAElE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAEhC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;QAEpD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEpD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAEhC,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/cjs/adapters/SQLiteAdapter.d.ts

@@ -0,0 +1,86 @@
+/**
+ * SQLite adapter for persistence
+ * Lightweight, file-based database perfect for local development
+ *
+ * ## v2 Migration
+ *
+ * If upgrading from v1, run the following migration on your sessions table:
+ *
+ * ```sql
+ * -- SQLite 3.35.0+ supports DROP COLUMN:
+ * ALTER TABLE agent_sessions DROP COLUMN pending_transition;
+ * -- For older versions, recreate the table without pending_transition.
+ *
+ * ALTER TABLE agent_sessions ADD COLUMN pending_directive TEXT;
+ * ALTER TABLE agent_sessions ADD COLUMN signals TEXT;
+ * ```
+ *
+ * `pending_directive` stores the JSON-serialized `Directive` that the pipeline
+ * applies at the start of the next turn. `signals` is a reserved TEXT (JSON)
+ * column for the v2.x Signals feature — pass-through only in v2.0.
+ */
+import type { SessionRepository, MessageRepository, PersistenceAdapter } from "../types/index.js";
+/**
+ * SQLite database interface - matches better-sqlite3
+ */
+export interface SqliteDatabase {
+    prepare(sql: string): SqliteStatement;
+    exec(sql: string): void;
+    close(): void;
+}
+/**
+ * SQLite statement interface - matches better-sqlite3 Statement
+ */
+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",
+ *   provider: provider,
+ *   persistence: {
+ *     adapter: new SQLiteAdapter({ db }),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+export declare class SQLiteAdapter<TData = Record<string, unknown>> implements PersistenceAdapter<TData> {
+    readonly sessionRepository: SessionRepository<TData>;
+    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;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAIjB,kBAAkB,EAInB,MAAM,mBAAmB,CAAC;AAK3B;;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,aAAa,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,YAAW,kBAAkB,CAAC,KAAK,CAAC;IAC9F,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC5D,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,OAAO,CAAC,EAAE,CAAiB;gBAEf,OAAO,EAAE,oBAAoB;IAanC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiE3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlC"}