@falai/agent 3.4.3 → 3.4.4

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

@@ -0,0 +1,85 @@
+/**
+ * PostgreSQL adapter for persistence
+ * Raw SQL adapter for PostgreSQL with custom schemas
+ *
+ * ## v2 Migration
+ *
+ * If upgrading from v1, run the following migration on your sessions table:
+ *
+ * ```sql
+ * ALTER TABLE agent_sessions DROP COLUMN IF EXISTS pending_transition;
+ * ALTER TABLE agent_sessions ADD COLUMN IF NOT EXISTS pending_directive JSONB;
+ * ALTER TABLE agent_sessions ADD COLUMN IF NOT EXISTS signals JSONB;
+ * ```
+ *
+ * `pending_directive` stores the serialized `Directive` that the pipeline
+ * applies at the start of the next turn. `signals` is a reserved JSONB column
+ * for the v2.x Signals feature — pass-through only in v2.0.
+ */
+import type { SessionRepository, MessageRepository, PersistenceAdapter } from "../types/index.js";
+/**
+ * PostgreSQL query result interface
+ */
+export interface PgQueryResult<T = Record<string, unknown>> {
+    rows: T[];
+    rowCount: number;
+}
+/**
+ * PostgreSQL client interface - matches pg (node-postgres)
+ */
+export interface PgClient {
+    query<T = Record<string, unknown>>(sql: string, values?: unknown[]): Promise<PgQueryResult<T>>;
+    end(): Promise<void>;
+}
+/**
+ * Options for PostgreSQL adapter
+ */
+export interface PostgreSQLAdapterOptions {
+    /**
+     * PostgreSQL client instance (from 'pg' package)
+     */
+    client: PgClient;
+    /**
+     * Table names (default: "agent_sessions" and "agent_messages")
+     */
+    tables?: {
+        sessions?: string;
+        messages?: string;
+    };
+}
+/**
+ * PostgreSQL Adapter - Provider-style API for PostgreSQL persistence
+ *
+ * @example
+ * ```typescript
+ * import { Client } from 'pg';
+ * import { Agent, PostgreSQLAdapter } from '@falai/agent';
+ *
+ * const client = new Client({
+ *   host: 'localhost',
+ *   port: 5432,
+ *   database: 'myapp',
+ *   user: 'postgres',
+ *   password: 'password',
+ * });
+ * await client.connect();
+ *
+ * const agent = new Agent({
+ *   name: "My Agent",
+ *   provider: provider,
+ *   persistence: {
+ *     adapter: new PostgreSQLAdapter({ client }),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+export declare class PostgreSQLAdapter<TData = Record<string, unknown>> implements PersistenceAdapter<TData> {
+    readonly sessionRepository: SessionRepository<TData>;
+    readonly messageRepository: MessageRepository;
+    private client;
+    constructor(options: PostgreSQLAdapterOptions);
+    initialize(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=PostgreSQLAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PostgreSQLAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/PostgreSQLAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAEV,iBAAiB,EACjB,iBAAiB,EAIjB,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AAK3B;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAiB,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,YAAW,kBAAkB,CAAC,KAAK,CAAC;IAClG,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC5D,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,OAAO,CAAC,MAAM,CAAW;gBAEb,OAAO,EAAE,wBAAwB;IAiBvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0D3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/cjs/adapters/PostgreSQLAdapter.js

@@ -0,0 +1,312 @@
+"use strict";
+/**
+ * PostgreSQL adapter for persistence
+ * Raw SQL adapter for PostgreSQL with custom schemas
+ *
+ * ## v2 Migration
+ *
+ * If upgrading from v1, run the following migration on your sessions table:
+ *
+ * ```sql
+ * ALTER TABLE agent_sessions DROP COLUMN IF EXISTS pending_transition;
+ * ALTER TABLE agent_sessions ADD COLUMN IF NOT EXISTS pending_directive JSONB;
+ * ALTER TABLE agent_sessions ADD COLUMN IF NOT EXISTS signals JSONB;
+ * ```
+ *
+ * `pending_directive` stores the serialized `Directive` that the pipeline
+ * applies at the start of the next turn. `signals` is a reserved JSONB column
+ * for the v2.x Signals feature — pass-through only in v2.0.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgreSQLAdapter = 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");
+/**
+ * PostgreSQL Adapter - Provider-style API for PostgreSQL persistence
+ *
+ * @example
+ * ```typescript
+ * import { Client } from 'pg';
+ * import { Agent, PostgreSQLAdapter } from '@falai/agent';
+ *
+ * const client = new Client({
+ *   host: 'localhost',
+ *   port: 5432,
+ *   database: 'myapp',
+ *   user: 'postgres',
+ *   password: 'password',
+ * });
+ * await client.connect();
+ *
+ * const agent = new Agent({
+ *   name: "My Agent",
+ *   provider: provider,
+ *   persistence: {
+ *     adapter: new PostgreSQLAdapter({ client }),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+class PostgreSQLAdapter {
+    constructor(options) {
+        this.client = options.client;
+        const sessionTable = options.tables?.sessions || "agent_sessions";
+        const messageTable = options.tables?.messages || "agent_messages";
+        this.sessionRepository = new PostgreSQLSessionRepository(this.client, sessionTable);
+        this.messageRepository = new PostgreSQLMessageRepository(this.client, messageTable);
+    }
+    async initialize() {
+        // Create tables if they don't exist
+        const sessionTable = "agent_sessions";
+        const messageTable = "agent_messages";
+        await this.client.query(`
+      CREATE TABLE IF NOT EXISTS ${sessionTable} (
+        id VARCHAR(255) PRIMARY KEY,
+        user_id VARCHAR(255),
+        agent_name VARCHAR(255),
+        status VARCHAR(50) DEFAULT 'active',
+        current_flow VARCHAR(255),
+        current_step VARCHAR(255),
+        collected_data JSONB,
+        pending_directive JSONB,
+        signals JSONB,
+        message_count INTEGER DEFAULT 0,
+        last_message_at TIMESTAMP,
+        completed_at TIMESTAMP,
+        version INTEGER,
+        created_at TIMESTAMP DEFAULT NOW(),
+        updated_at TIMESTAMP DEFAULT NOW()
+      )
+    `);
+        // Migration: add the optimistic-concurrency version column to tables
+        // created by pre-2.4 versions
+        await this.client.query(`
+      ALTER TABLE ${sessionTable} ADD COLUMN IF NOT EXISTS version INTEGER
+    `);
+        await this.client.query(`
+      CREATE INDEX IF NOT EXISTS idx_sessions_user_id ON ${sessionTable}(user_id);
+      CREATE INDEX IF NOT EXISTS idx_sessions_status ON ${sessionTable}(status);
+    `);
+        await this.client.query(`
+      CREATE TABLE IF NOT EXISTS ${messageTable} (
+        id VARCHAR(255) PRIMARY KEY,
+        session_id VARCHAR(255) NOT NULL,
+        user_id VARCHAR(255),
+        role VARCHAR(50) NOT NULL,
+        content TEXT NOT NULL,
+        flow VARCHAR(255),
+        step VARCHAR(255),
+        tool_calls JSONB,
+        event JSONB,
+        created_at TIMESTAMP DEFAULT NOW(),
+        FOREIGN KEY (session_id) REFERENCES ${sessionTable}(id) ON DELETE CASCADE
+      )
+    `);
+        await this.client.query(`
+      CREATE INDEX IF NOT EXISTS idx_messages_session_id ON ${messageTable}(session_id);
+      CREATE INDEX IF NOT EXISTS idx_messages_user_id ON ${messageTable}(user_id);
+    `);
+    }
+    async disconnect() {
+        await this.client.end();
+    }
+}
+exports.PostgreSQLAdapter = PostgreSQLAdapter;
+/**
+ * PostgreSQL Session Repository
+ */
+class PostgreSQLSessionRepository {
+    constructor(client, tableName) {
+        this.client = client;
+        this.tableName = tableName;
+    }
+    async create(data) {
+        const id = data.id || (0, index_js_1.createSessionId)();
+        const now = new Date();
+        const result = await this.client.query(`INSERT INTO ${this.tableName}
+       (id, user_id, agent_name, status, current_flow, current_step, collected_data, message_count, last_message_at, completed_at, version, created_at, updated_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13)
+       RETURNING *`, [
+            id,
+            data.userId || null,
+            data.agentName || null,
+            data.status || "active",
+            data.currentFlow || null,
+            data.currentStep || null,
+            JSON.stringify(data.collectedData || {}),
+            data.messageCount || 0,
+            data.lastMessageAt ?? null,
+            data.completedAt ?? null,
+            data.version ?? 1,
+            now,
+            now,
+        ]);
+        return (0, sessionRow_js_1.deserializeSessionRow)(result.rows[0]);
+    }
+    async findById(id) {
+        const result = await this.client.query(`SELECT * FROM ${this.tableName} WHERE id = $1`, [id]);
+        return result.rows[0] ? (0, sessionRow_js_1.deserializeSessionRow)(result.rows[0]) : null;
+    }
+    async findActiveByUserId(userId) {
+        const result = await this.client.query(`SELECT * FROM ${this.tableName}
+       WHERE user_id = $1 AND status = 'active'
+       ORDER BY created_at DESC
+       LIMIT 1`, [userId]);
+        return result.rows[0] ? (0, sessionRow_js_1.deserializeSessionRow)(result.rows[0]) : null;
+    }
+    async findByUserId(userId, limit = 100) {
+        const result = await this.client.query(`SELECT * FROM ${this.tableName}
+       WHERE user_id = $1
+       ORDER BY created_at DESC
+       LIMIT $2`, [userId, limit]);
+        return result.rows.map((row) => (0, sessionRow_js_1.deserializeSessionRow)(row));
+    }
+    async update(id, data, options) {
+        const fields = [];
+        const values = [];
+        let paramIndex = 1;
+        if (data.status !== undefined) {
+            fields.push(`status = $${paramIndex++}`);
+            values.push(data.status);
+        }
+        if (data.collectedData !== undefined) {
+            fields.push(`collected_data = $${paramIndex++}`);
+            values.push(JSON.stringify(data.collectedData));
+        }
+        if (data.currentFlow !== undefined) {
+            fields.push(`current_flow = $${paramIndex++}`);
+            values.push(data.currentFlow);
+        }
+        if (data.currentStep !== undefined) {
+            fields.push(`current_step = $${paramIndex++}`);
+            values.push(data.currentStep);
+        }
+        if (data.messageCount !== undefined) {
+            fields.push(`message_count = $${paramIndex++}`);
+            values.push(data.messageCount);
+        }
+        if (data.lastMessageAt !== undefined) {
+            fields.push(`last_message_at = $${paramIndex++}`);
+            values.push(data.lastMessageAt);
+        }
+        if (data.completedAt !== undefined) {
+            fields.push(`completed_at = $${paramIndex++}`);
+            values.push(data.completedAt);
+        }
+        fields.push(`updated_at = $${paramIndex++}`);
+        values.push(new Date());
+        if (options?.expectedVersion !== undefined) {
+            const expectedVersion = options.expectedVersion;
+            // Compare-and-swap in a single statement: rows without a stored version
+            // (pre-2.4) are accepted and adopt expectedVersion as their base
+            fields.push(`version = COALESCE(version, $${paramIndex++}) + 1`);
+            values.push(expectedVersion);
+            const idParam = paramIndex++;
+            values.push(id);
+            const versionParam = paramIndex++;
+            values.push(expectedVersion);
+            const result = await this.client.query(`UPDATE ${this.tableName}
+         SET ${fields.join(", ")}
+         WHERE id = $${idParam} AND (version IS NULL OR version = $${versionParam})
+         RETURNING *`, values);
+            if (result.rows[0])
+                return (0, sessionRow_js_1.deserializeSessionRow)(result.rows[0]);
+            const existing = await this.findById(id);
+            if (!existing)
+                return null;
+            throw new errors_js_1.SessionConflictError(id, expectedVersion, existing.version);
+        }
+        fields.push(`version = COALESCE(version, 0) + 1`);
+        values.push(id);
+        const result = await this.client.query(`UPDATE ${this.tableName}
+       SET ${fields.join(", ")}
+       WHERE id = $${paramIndex}
+       RETURNING *`, values);
+        return result.rows[0] ? (0, sessionRow_js_1.deserializeSessionRow)(result.rows[0]) : null;
+    }
+    async updateStatus(id, status, completedAt) {
+        return await this.update(id, { status, completedAt });
+    }
+    async updateCollectedData(id, collectedData) {
+        return await this.update(id, { collectedData });
+    }
+    async updateFlowStep(id, flow, step) {
+        return await this.update(id, {
+            currentFlow: flow,
+            currentStep: step,
+        });
+    }
+    async incrementMessageCount(id) {
+        const result = await this.client.query(`UPDATE ${this.tableName}
+       SET message_count = message_count + 1,
+           last_message_at = NOW(),
+           updated_at = NOW()
+       WHERE id = $1
+       RETURNING *`, [id]);
+        return result.rows[0] ? (0, sessionRow_js_1.deserializeSessionRow)(result.rows[0]) : null;
+    }
+    async delete(id) {
+        const result = await this.client.query(`DELETE FROM ${this.tableName} WHERE id = $1`, [id]);
+        return result.rowCount > 0;
+    }
+}
+/**
+ * PostgreSQL Message Repository
+ */
+class PostgreSQLMessageRepository {
+    constructor(client, tableName) {
+        this.client = client;
+        this.tableName = tableName;
+    }
+    async create(data) {
+        const id = `msg_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+        const result = await this.client.query(`INSERT INTO ${this.tableName}
+       (id, session_id, user_id, role, content, flow, step, tool_calls, event, created_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, NOW())
+       RETURNING *`, [
+            id,
+            data.sessionId,
+            data.userId || null,
+            data.role,
+            data.content,
+            data.flow || null,
+            data.step || null,
+            JSON.stringify(data.toolCalls || null),
+            JSON.stringify(data.event || null),
+        ]);
+        return result.rows[0];
+    }
+    async findById(id) {
+        const result = await this.client.query(`SELECT * FROM ${this.tableName} WHERE id = $1`, [id]);
+        return result.rows[0] || null;
+    }
+    async findBySessionId(sessionId, limit = 1000) {
+        const result = await this.client.query(`SELECT * FROM ${this.tableName}
+       WHERE session_id = $1
+       ORDER BY created_at ASC
+       LIMIT $2`, [sessionId, limit]);
+        return result.rows;
+    }
+    async findByUserId(userId, limit = 100) {
+        const result = await this.client.query(`SELECT * FROM ${this.tableName}
+       WHERE user_id = $1
+       ORDER BY created_at DESC
+       LIMIT $2`, [userId, limit]);
+        return result.rows;
+    }
+    async delete(id) {
+        const result = await this.client.query(`DELETE FROM ${this.tableName} WHERE id = $1`, [id]);
+        return result.rowCount > 0;
+    }
+    async deleteBySessionId(sessionId) {
+        const result = await this.client.query(`DELETE FROM ${this.tableName} WHERE session_id = $1`, [sessionId]);
+        return result.rowCount;
+    }
+    async deleteByUserId(userId) {
+        const result = await this.client.query(`DELETE FROM ${this.tableName} WHERE user_id = $1`, [userId]);
+        return result.rowCount;
+    }
+}
+//# sourceMappingURL=PostgreSQLAdapter.js.map

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

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

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

@@ -0,0 +1,115 @@
+/**
+ * Prisma adapter for persistence
+ * Simple, provider-like API with automatic schema creation
+ */
+import type { SessionRepository, MessageRepository, SessionData, MessageData, PersistenceAdapter } from "../types/index.js";
+/**
+ * Prisma model operations
+ */
+export interface PrismaModel {
+    create: (params: {
+        data: Record<string, unknown>;
+    }) => Promise<Record<string, unknown>>;
+    findUnique: (params: {
+        where: Record<string, unknown>;
+    }) => Promise<Record<string, unknown> | null>;
+    findFirst: (params: {
+        where: Record<string, unknown>;
+        orderBy?: Record<string, string>;
+    }) => Promise<Record<string, unknown> | null>;
+    findMany: (params: {
+        where: Record<string, unknown>;
+        orderBy?: Record<string, string>;
+        take?: number;
+    }) => Promise<Array<Record<string, unknown>>>;
+    update: (params: {
+        where: Record<string, unknown>;
+        data: Record<string, unknown>;
+    }) => Promise<Record<string, unknown>>;
+    delete: (params: {
+        where: Record<string, unknown>;
+    }) => Promise<Record<string, unknown>>;
+    deleteMany: (params: {
+        where: Record<string, unknown>;
+    }) => Promise<{
+        count: number;
+    }>;
+}
+/**
+ * Prisma client interface - matches the shape of a generated Prisma client
+ */
+export interface PrismaClient extends Record<string, unknown> {
+    $queryRaw?: <T = unknown>(query: TemplateStringsArray | string, ...values: unknown[]) => Promise<T>;
+    $executeRaw?: (query: TemplateStringsArray | string, ...values: unknown[]) => Promise<number>;
+    $disconnect?: () => Promise<void>;
+}
+/**
+ * Configuration for field mappings
+ */
+export interface FieldMappings {
+    sessions?: Partial<Record<keyof SessionData, string>>;
+    messages?: Partial<Record<keyof MessageData, string>>;
+}
+/**
+ * Options for creating a Prisma adapter
+ */
+export interface PrismaAdapterOptions {
+    /**
+     * Prisma client instance
+     */
+    prisma: PrismaClient;
+    /**
+     * Table/model names (defaults to 'agentSession' and 'agentMessage')
+     */
+    tables?: {
+        sessions?: string;
+        messages?: string;
+    };
+    /**
+     * Field mappings (optional, if your schema uses different field names)
+     */
+    fieldMappings?: FieldMappings;
+    /**
+     * Whether to auto-create tables if they don't exist (default: false)
+     * Note: Only works if your Prisma client has $executeRaw method
+     */
+    autoMigrate?: boolean;
+}
+/**
+ * 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",
+ *   provider: provider,
+ *   persistence: {
+ *     adapter: new PrismaAdapter({ prisma }),
+ *     userId: "user_123",
+ *   },
+ * });
+ * ```
+ */
+export declare class PrismaAdapter<TData = Record<string, unknown>> implements PersistenceAdapter<TData> {
+    readonly sessionRepository: SessionRepository<TData>;
+    readonly messageRepository: MessageRepository;
+    private prisma;
+    private options;
+    private initialized;
+    constructor(options: PrismaAdapterOptions);
+    /**
+     * Initialize the adapter (check/create tables)
+     * Called automatically if autoMigrate is enabled
+     */
+    initialize(): Promise<void>;
+    /**
+     * Disconnect from the database
+     */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=PrismaAdapter.d.ts.map

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

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