@falai/agent 0.3.10 → 0.3.12

package/dist/cjs/adapters/PrismaAdapter.js

@@ -0,0 +1,335 @@
+"use strict";
+/**
+ * Prisma adapter for persistence
+ * Simple, provider-like API with automatic schema creation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrismaAdapter = void 0;
+/**
+ * Prisma Adapter - Provider-style API for Prisma persistence
+ *
+ * @example
+ * ```typescript
+ * import { PrismaClient } from '@prisma/client';
+ * import { Agent, PrismaAdapter } from '@falai/agent';
+ *
+ * const prisma = new PrismaClient();
+ *
+ * const agent = new Agent({
+ *   name: "My Agent",
+ *   ai: provider,
+ *   persistence: {
+ *     adapter: new PrismaAdapter({ prisma }),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+class PrismaAdapter {
+    constructor(options) {
+        this.initialized = false;
+        this.prisma = options.prisma;
+        this.options = {
+            prisma: options.prisma,
+            tables: {
+                sessions: options.tables?.sessions || "agentSession",
+                messages: options.tables?.messages || "agentMessage",
+            },
+            fieldMappings: options.fieldMappings,
+            autoMigrate: options.autoMigrate ?? false,
+        };
+        // Initialize repositories
+        this.sessionRepository = new PrismaSessionRepository(this.prisma, this.options.tables.sessions, this.options.fieldMappings?.sessions);
+        this.messageRepository = new PrismaMessageRepository(this.prisma, this.options.tables.messages, this.options.fieldMappings?.messages);
+        // Auto-initialize if configured
+        if (this.options.autoMigrate) {
+            this.initialize().catch((error) => {
+                console.error("[PrismaAdapter] Auto-migration failed:", error);
+            });
+        }
+    }
+    /**
+     * Initialize the adapter (check/create tables)
+     * Called automatically if autoMigrate is enabled
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        if (this.options.autoMigrate && this.prisma.$executeRaw) {
+            // Note: This is a simplified example. In production, use Prisma Migrate.
+            console.warn("[PrismaAdapter] autoMigrate is experimental. Use Prisma Migrate for production.");
+            // Table creation would go here, but it's database-specific
+            // Better to rely on Prisma Migrate
+            await Promise.resolve(); // Satisfy async requirement
+        }
+        this.initialized = true;
+    }
+    /**
+     * Disconnect from the database
+     */
+    async disconnect() {
+        if (this.prisma.$disconnect) {
+            await this.prisma.$disconnect();
+        }
+    }
+}
+exports.PrismaAdapter = PrismaAdapter;
+/**
+ * Prisma Session Repository
+ * Internal implementation - users should use PrismaAdapter instead
+ */
+class PrismaSessionRepository {
+    constructor(prismaClient, tableName, fieldMappings) {
+        this.prisma = prismaClient;
+        this.tableName = tableName;
+        this.fieldMap = fieldMappings || {};
+    }
+    /**
+     * Map our standard field names to custom schema field names
+     */
+    mapFields(data) {
+        const mapped = {};
+        for (const [key, value] of Object.entries(data)) {
+            const mappedKey = this.fieldMap[key] || key;
+            mapped[mappedKey] = value;
+        }
+        return mapped;
+    }
+    /**
+     * Map custom schema field names back to our standard field names
+     */
+    unmapFields(data) {
+        if (!data)
+            return data;
+        const reverseMap = {};
+        for (const [standardKey, customKey] of Object.entries(this.fieldMap)) {
+            reverseMap[customKey] = standardKey;
+        }
+        const unmapped = {};
+        for (const [key, value] of Object.entries(data)) {
+            const unmappedKey = reverseMap[key] || key;
+            unmapped[unmappedKey] = value;
+        }
+        return unmapped;
+    }
+    getModel() {
+        return this.prisma[this.tableName];
+    }
+    async create(data) {
+        const mapped = this.mapFields(data);
+        const result = await this.getModel().create({
+            data: mapped,
+        });
+        return this.unmapFields(result);
+    }
+    async findById(id) {
+        const result = await this.getModel().findUnique({
+            where: { [this.fieldMap.id || "id"]: id },
+        });
+        return result ? this.unmapFields(result) : null;
+    }
+    async findActiveByUserId(userId) {
+        const result = await this.getModel().findFirst({
+            where: {
+                [this.fieldMap.userId || "userId"]: userId,
+                [this.fieldMap.status || "status"]: "active",
+            },
+            orderBy: {
+                [this.fieldMap.createdAt || "createdAt"]: "desc",
+            },
+        });
+        return result ? this.unmapFields(result) : null;
+    }
+    async findByUserId(userId, limit = 100) {
+        const results = await this.getModel().findMany({
+            where: {
+                [this.fieldMap.userId || "userId"]: userId,
+            },
+            orderBy: {
+                [this.fieldMap.createdAt || "createdAt"]: "desc",
+            },
+            take: limit,
+        });
+        return results.map((r) => this.unmapFields(r));
+    }
+    async update(id, data) {
+        const mapped = this.mapFields(data);
+        const result = await this.getModel().update({
+            where: { [this.fieldMap.id || "id"]: id },
+            data: {
+                ...mapped,
+                [this.fieldMap.updatedAt || "updatedAt"]: new Date(),
+            },
+        });
+        return this.unmapFields(result);
+    }
+    async updateStatus(id, status, completedAt) {
+        const data = {
+            [this.fieldMap.status || "status"]: status,
+            [this.fieldMap.updatedAt || "updatedAt"]: new Date(),
+        };
+        if (completedAt) {
+            data[this.fieldMap.completedAt || "completedAt"] = completedAt;
+        }
+        const result = await this.getModel().update({
+            where: { [this.fieldMap.id || "id"]: id },
+            data,
+        });
+        return this.unmapFields(result);
+    }
+    async updateCollectedData(id, collectedData) {
+        const result = await this.getModel().update({
+            where: { [this.fieldMap.id || "id"]: id },
+            data: {
+                [this.fieldMap.collectedData || "collectedData"]: collectedData,
+                [this.fieldMap.updatedAt || "updatedAt"]: new Date(),
+            },
+        });
+        return this.unmapFields(result);
+    }
+    async updateRouteState(id, route, state) {
+        const data = {
+            [this.fieldMap.updatedAt || "updatedAt"]: new Date(),
+        };
+        if (route !== undefined) {
+            data[this.fieldMap.currentRoute || "currentRoute"] = route;
+        }
+        if (state !== undefined) {
+            data[this.fieldMap.currentState || "currentState"] = state;
+        }
+        const result = await this.getModel().update({
+            where: { [this.fieldMap.id || "id"]: id },
+            data,
+        });
+        return this.unmapFields(result);
+    }
+    async incrementMessageCount(id) {
+        const result = await this.getModel().update({
+            where: { [this.fieldMap.id || "id"]: id },
+            data: {
+                [this.fieldMap.messageCount || "messageCount"]: { increment: 1 },
+                [this.fieldMap.lastMessageAt || "lastMessageAt"]: new Date(),
+                [this.fieldMap.updatedAt || "updatedAt"]: new Date(),
+            },
+        });
+        return this.unmapFields(result);
+    }
+    async delete(id) {
+        try {
+            await this.getModel().delete({
+                where: { [this.fieldMap.id || "id"]: id },
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Prisma Message Repository
+ * Internal implementation - users should use PrismaAdapter instead
+ */
+class PrismaMessageRepository {
+    constructor(prismaClient, tableName, fieldMappings) {
+        this.prisma = prismaClient;
+        this.tableName = tableName;
+        this.fieldMap = fieldMappings || {};
+    }
+    /**
+     * Map our standard field names to custom schema field names
+     */
+    mapFields(data) {
+        const mapped = {};
+        for (const [key, value] of Object.entries(data)) {
+            const mappedKey = this.fieldMap[key] || key;
+            mapped[mappedKey] = value;
+        }
+        return mapped;
+    }
+    /**
+     * Map custom schema field names back to our standard field names
+     */
+    unmapFields(data) {
+        if (!data)
+            return data;
+        const reverseMap = {};
+        for (const [standardKey, customKey] of Object.entries(this.fieldMap)) {
+            reverseMap[customKey] = standardKey;
+        }
+        const unmapped = {};
+        for (const [key, value] of Object.entries(data)) {
+            const unmappedKey = reverseMap[key] || key;
+            unmapped[unmappedKey] = value;
+        }
+        return unmapped;
+    }
+    getModel() {
+        return this.prisma[this.tableName];
+    }
+    async create(data) {
+        const mapped = this.mapFields(data);
+        const result = await this.getModel().create({
+            data: mapped,
+        });
+        return this.unmapFields(result);
+    }
+    async findById(id) {
+        const result = await this.getModel().findUnique({
+            where: { [this.fieldMap.id || "id"]: id },
+        });
+        return result ? this.unmapFields(result) : null;
+    }
+    async findBySessionId(sessionId, limit = 1000) {
+        const results = await this.getModel().findMany({
+            where: {
+                [this.fieldMap.sessionId || "sessionId"]: sessionId,
+            },
+            orderBy: {
+                [this.fieldMap.createdAt || "createdAt"]: "asc",
+            },
+            take: limit,
+        });
+        return results.map((r) => this.unmapFields(r));
+    }
+    async findByUserId(userId, limit = 100) {
+        const results = await this.getModel().findMany({
+            where: {
+                [this.fieldMap.userId || "userId"]: userId,
+            },
+            orderBy: {
+                [this.fieldMap.createdAt || "createdAt"]: "desc",
+            },
+            take: limit,
+        });
+        return results.map((r) => this.unmapFields(r));
+    }
+    async delete(id) {
+        try {
+            await this.getModel().delete({
+                where: { [this.fieldMap.id || "id"]: id },
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async deleteBySessionId(sessionId) {
+        const result = await this.getModel().deleteMany({
+            where: {
+                [this.fieldMap.sessionId || "sessionId"]: sessionId,
+            },
+        });
+        return result.count || 0;
+    }
+    async deleteByUserId(userId) {
+        const result = await this.getModel().deleteMany({
+            where: {
+                [this.fieldMap.userId || "userId"]: userId,
+            },
+        });
+        return result.count || 0;
+    }
+}
+//# sourceMappingURL=PrismaAdapter.js.map

package/dist/cjs/adapters/PrismaAdapter.js.map

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

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

@@ -0,0 +1,6 @@
+/**
+ * Database adapters for persistence
+ */
+export { PrismaAdapter } from "./PrismaAdapter";
+export type { PrismaClient, FieldMappings, PrismaAdapterOptions, } from "./PrismaAdapter";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/cjs/adapters/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Database adapters for persistence
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrismaAdapter = void 0;
+var PrismaAdapter_1 = require("./PrismaAdapter");
+Object.defineProperty(exports, "PrismaAdapter", { enumerable: true, get: function () { return PrismaAdapter_1.PrismaAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iDAAgD;AAAvC,8GAAA,aAAa,OAAA"}

package/dist/cjs/core/Agent.d.ts

@@ -7,6 +7,7 @@ import type { RouteOptions } from "../types/route";
 import { Route } from "./Route";
 import { DomainRegistry } from "./DomainRegistry";
 import { Observation } from "./Observation";
+import { PersistenceManager } from "./PersistenceManager";
 /**
  * Main Agent class with generic context support
  */
@@ -19,6 +20,7 @@ export declare class Agent<TContext = unknown> {
     private observations;
     private domainRegistry;
     private context;
+    private persistenceManager;
     /**
      * Dynamic domain property - populated via addDomain
      */
@@ -70,6 +72,31 @@ export declare class Agent<TContext = unknown> {
      * @internal
      */
     private getContext;
+    /**
+     * Generate a response based on history and context as a stream
+     */
+    respondStream(params: {
+        history: Event[];
+        state?: StateRef;
+        contextOverride?: Partial<TContext>;
+        signal?: AbortSignal;
+    }): AsyncGenerator<{
+        delta: string;
+        accumulated: string;
+        done: boolean;
+        route?: {
+            id: string;
+            title: string;
+        } | null;
+        state?: {
+            id: string;
+            description?: string;
+        } | null;
+        toolCalls?: Array<{
+            toolName: string;
+            arguments: Record<string, unknown>;
+        }>;
+    }>;
     /**
      * Generate a response based on history and context
      */
@@ -117,6 +144,14 @@ export declare class Agent<TContext = unknown> {
      * Get the domain registry
      */
     getDomainRegistry(): DomainRegistry;
+    /**
+     * Get the persistence manager (if configured)
+     */
+    getPersistenceManager(): PersistenceManager | undefined;
+    /**
+     * Check if persistence is enabled
+     */
+    hasPersistence(): boolean;
     /**
      * Get allowed domains for a specific route
      * @param routeId - Route ID to check

package/dist/cjs/core/Agent.d.ts.map

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

package/dist/cjs/core/Agent.js

@@ -8,6 +8,7 @@ const Route_1 = require("./Route");
 const DomainRegistry_1 = require("./DomainRegistry");
 const PromptBuilder_1 = require("./PromptBuilder");
 const Observation_1 = require("./Observation");
+const PersistenceManager_1 = require("./PersistenceManager");
 /**
  * Main Agent class with generic context support
  */
@@ -34,6 +35,16 @@ class Agent {
         }
         // Initialize context if provided
         this.context = options.context;
+        // Initialize persistence if configured
+        if (options.persistence) {
+            this.persistenceManager = new PersistenceManager_1.PersistenceManager(options.persistence);
+            // Initialize the adapter if it has an initialize method
+            if (options.persistence.adapter.initialize) {
+                options.persistence.adapter.initialize().catch((error) => {
+                    console.error("[Agent] Persistence adapter initialization failed:", error);
+                });
+            }
+        }
         // Initialize from options
         if (options.terms) {
             this.terms = [...options.terms];
@@ -171,6 +182,136 @@ class Agent {
         // Otherwise return the stored context
         return this.context;
     }
+    /**
+     * Generate a response based on history and context as a stream
+     */
+    async *respondStream(params) {
+        const { history, contextOverride, signal } = params;
+        // Get current context (may fetch from provider)
+        let currentContext = await this.getContext();
+        // Call beforeRespond hook if configured
+        if (this.options.hooks?.beforeRespond && currentContext !== undefined) {
+            currentContext = await this.options.hooks.beforeRespond(currentContext);
+            // Update stored context with the result from beforeRespond
+            this.context = currentContext;
+        }
+        // Merge context with override
+        const effectiveContext = {
+            ...currentContext,
+            ...contextOverride,
+        };
+        // Build prompt (same as respond method)
+        const promptBuilder = new PromptBuilder_1.PromptBuilder();
+        // Add agent identity
+        if (this.options.description) {
+            promptBuilder.addAgentIdentity({
+                name: this.options.name,
+                description: this.options.description,
+            });
+        }
+        // Add interaction history
+        promptBuilder.addInteractionHistoryForMessageGeneration(history);
+        // Add glossary
+        if (this.terms.length > 0) {
+            promptBuilder.addGlossary(this.terms);
+        }
+        // Add guidelines (convert to GuidelineMatch format, filter enabled only)
+        const enabledGuidelines = this.guidelines.filter((g) => g.enabled !== false);
+        if (enabledGuidelines.length > 0) {
+            const guidelineMatches = enabledGuidelines.map((g) => ({
+                guideline: g,
+            }));
+            promptBuilder.addGuidelinesForMessageGeneration(guidelineMatches);
+        }
+        // Add capabilities
+        if (this.capabilities.length > 0) {
+            promptBuilder.addCapabilitiesForMessageGeneration(this.capabilities);
+        }
+        // Add observations
+        if (this.observations.length > 0) {
+            const observationsWithRoutes = this.observations
+                .map((obs) => ({
+                description: obs.description,
+                routes: obs.getRoutes().map((routeRef) => {
+                    const route = this.routes.find((r) => r.id === routeRef.id);
+                    return { title: route?.title || routeRef.id };
+                }),
+            }))
+                .filter((obs) => obs.routes.length > 0);
+            if (observationsWithRoutes.length > 0) {
+                promptBuilder.addObservations(observationsWithRoutes);
+            }
+        }
+        // Add active routes with their rules and prohibitions
+        if (this.routes.length > 0) {
+            promptBuilder.addActiveRoutes(this.routes.map((r) => ({
+                title: r.title,
+                description: r.description,
+                conditions: r.conditions,
+                domains: r.getDomains(),
+                rules: r.getRules(),
+                prohibitions: r.getProhibitions(),
+            })));
+        }
+        // Add domains (tools) information if any domains are registered
+        const allDomains = this.domainRegistry.all();
+        if (Object.keys(allDomains).length > 0) {
+            promptBuilder.addDomains(allDomains);
+        }
+        // Add JSON response schema instructions
+        promptBuilder.addJsonResponseSchema();
+        // Build final prompt
+        const prompt = promptBuilder.build();
+        // Generate message stream using AI provider with JSON mode enabled
+        const stream = this.options.ai.generateMessageStream({
+            prompt,
+            history,
+            context: effectiveContext,
+            signal,
+            parameters: {
+                jsonMode: true,
+            },
+        });
+        // Stream chunks to caller
+        for await (const chunk of stream) {
+            // Extract route and state from structured response on final chunk
+            let route = null;
+            let state = null;
+            let toolCalls;
+            if (chunk.done && chunk.structured) {
+                // Find route by title
+                if (chunk.structured.route) {
+                    const foundRoute = this.routes.find((r) => r.title === chunk.structured?.route);
+                    if (foundRoute) {
+                        route = {
+                            id: foundRoute.id,
+                            title: foundRoute.title,
+                        };
+                    }
+                }
+                // Create state reference if provided
+                if (chunk.structured.state) {
+                    state = {
+                        id: "dynamic_state",
+                        description: chunk.structured.state,
+                    };
+                }
+                // Extract tool calls
+                if (chunk.structured.toolCalls &&
+                    chunk.structured.toolCalls.length > 0) {
+                    toolCalls = chunk.structured.toolCalls;
+                }
+            }
+            yield {
+                delta: chunk.delta,
+                accumulated: chunk.accumulated,
+                done: chunk.done,
+                route: route || undefined,
+                state: state || undefined,
+                toolCalls,
+            };
+        }
+    }
     /**
      * Generate a response based on history and context
      */
@@ -335,6 +476,18 @@ class Agent {
     getDomainRegistry() {
         return this.domainRegistry;
     }
+    /**
+     * Get the persistence manager (if configured)
+     */
+    getPersistenceManager() {
+        return this.persistenceManager;
+    }
+    /**
+     * Check if persistence is enabled
+     */
+    hasPersistence() {
+        return this.persistenceManager !== undefined;
+    }
     /**
      * Get allowed domains for a specific route
      * @param routeId - Route ID to check