@xynehq/jaf 0.1.2

package/dist/memory/providers/redis.js

@@ -0,0 +1,354 @@
+import { createSuccess, createFailure, createMemoryConnectionError, createMemoryNotFoundError, createMemoryStorageError } from '../types';
+/**
+ * Redis memory provider - persistent across server restarts
+ * Best for production environments with shared state
+ */
+export async function createRedisProvider(config, redisClient) {
+    const fullConfig = {
+        ...config,
+        type: 'redis',
+        host: config.host ?? 'localhost',
+        port: config.port ?? 6379,
+        db: config.db ?? 0,
+        keyPrefix: config.keyPrefix ?? 'jaf:memory:'
+    };
+    try {
+        await redisClient.ping();
+        console.log(`[MEMORY:Redis] Connected to Redis at ${fullConfig.host}:${fullConfig.port}`);
+    }
+    catch (error) {
+        throw createMemoryConnectionError('Redis', error);
+    }
+    const ensureConnected = () => {
+        if (!redisClient) {
+            throw createMemoryConnectionError('Redis', new Error('Redis client not initialized'));
+        }
+        return redisClient;
+    };
+    const getKey = (conversationId) => {
+        return `${fullConfig.keyPrefix}${conversationId}`;
+    };
+    const getUserKey = (userId) => {
+        return `${fullConfig.keyPrefix}user:${userId}:*`;
+    };
+    const storeMessages = async (conversationId, messages, metadata) => {
+        const client = ensureConnected();
+        try {
+            const now = new Date();
+            const conversation = {
+                conversationId,
+                userId: metadata?.userId,
+                messages,
+                metadata: {
+                    createdAt: now,
+                    updatedAt: now,
+                    totalMessages: messages.length,
+                    lastActivity: now,
+                    traceId: metadata?.traceId,
+                    ...metadata
+                }
+            };
+            const key = getKey(conversationId);
+            const value = JSON.stringify(conversation, null, 0); // Compact JSON
+            await client.set(key, value);
+            // Set TTL if configured
+            if (fullConfig.ttl) {
+                await client.expire(key, fullConfig.ttl);
+            }
+            console.log(`[MEMORY:Redis] Stored ${messages.length} messages for conversation ${conversationId}`);
+            return createSuccess(undefined);
+        }
+        catch (error) {
+            return createFailure(createMemoryStorageError('store messages', 'Redis', error));
+        }
+    };
+    const getConversation = async (conversationId) => {
+        const client = ensureConnected();
+        try {
+            const key = getKey(conversationId);
+            const value = await client.get(key);
+            if (!value) {
+                return createSuccess(null);
+            }
+            const conversation = JSON.parse(value);
+            // Convert date strings back to Date objects
+            const convertedConversation = {
+                ...conversation,
+                metadata: conversation.metadata ? {
+                    ...conversation.metadata,
+                    createdAt: conversation.metadata.createdAt ? new Date(conversation.metadata.createdAt) : new Date(),
+                    updatedAt: conversation.metadata.updatedAt ? new Date(conversation.metadata.updatedAt) : new Date(),
+                    lastActivity: conversation.metadata.lastActivity ? new Date(conversation.metadata.lastActivity) : new Date()
+                } : undefined
+            };
+            // Update last activity
+            const updatedConversation = {
+                ...convertedConversation,
+                metadata: {
+                    ...convertedConversation.metadata,
+                    lastActivity: new Date()
+                }
+            };
+            // Store updated last activity (fire and forget)
+            client.set(key, JSON.stringify(updatedConversation, null, 0)).catch(console.error);
+            console.log(`[MEMORY:Redis] Retrieved conversation ${conversationId} with ${convertedConversation.messages.length} messages`);
+            return createSuccess(updatedConversation);
+        }
+        catch (error) {
+            return createFailure(createMemoryStorageError('get conversation', 'Redis', error));
+        }
+    };
+    const appendMessages = async (conversationId, messages, metadata) => {
+        const client = ensureConnected();
+        try {
+            const existingResult = await getConversation(conversationId);
+            if (!existingResult.success) {
+                return existingResult;
+            }
+            if (!existingResult.data) {
+                return createFailure(createMemoryNotFoundError(conversationId, 'Redis'));
+            }
+            const existing = existingResult.data;
+            const updatedMessages = [...existing.messages, ...messages];
+            const now = new Date();
+            const updatedConversation = {
+                ...existing,
+                messages: updatedMessages,
+                metadata: {
+                    ...existing.metadata,
+                    updatedAt: now,
+                    lastActivity: now,
+                    totalMessages: updatedMessages.length,
+                    traceId: metadata?.traceId || existing.metadata?.traceId,
+                    ...metadata
+                }
+            };
+            const key = getKey(conversationId);
+            await client.set(key, JSON.stringify(updatedConversation, null, 0));
+            // Refresh TTL if configured
+            if (fullConfig.ttl) {
+                await client.expire(key, fullConfig.ttl);
+            }
+            console.log(`[MEMORY:Redis] Appended ${messages.length} messages to conversation ${conversationId} (total: ${updatedMessages.length})`);
+            return createSuccess(undefined);
+        }
+        catch (error) {
+            return createFailure(createMemoryStorageError('append messages', 'Redis', error));
+        }
+    };
+    const findConversations = async (query) => {
+        const client = ensureConnected();
+        try {
+            // Get all conversation keys
+            const pattern = query.userId
+                ? getUserKey(query.userId)
+                : `${fullConfig.keyPrefix}*`;
+            const keys = await client.keys(pattern);
+            const results = [];
+            // Fetch conversations in parallel
+            const conversations = await Promise.all(keys.map(async (key) => {
+                try {
+                    const value = await client.get(key);
+                    return value ? JSON.parse(value) : null;
+                }
+                catch {
+                    return null; // Skip malformed entries
+                }
+            }));
+            // Filter and process results
+            for (const conversation of conversations) {
+                if (!conversation)
+                    continue;
+                // Convert date strings back to Date objects
+                const convertedConversation = {
+                    ...conversation,
+                    metadata: conversation.metadata ? {
+                        ...conversation.metadata,
+                        createdAt: conversation.metadata.createdAt ? new Date(conversation.metadata.createdAt) : new Date(),
+                        updatedAt: conversation.metadata.updatedAt ? new Date(conversation.metadata.updatedAt) : new Date(),
+                        lastActivity: conversation.metadata.lastActivity ? new Date(conversation.metadata.lastActivity) : new Date()
+                    } : undefined
+                };
+                // Apply filters
+                let matches = true;
+                if (query.conversationId && convertedConversation.conversationId !== query.conversationId) {
+                    matches = false;
+                }
+                if (query.traceId && convertedConversation.metadata?.traceId !== query.traceId) {
+                    matches = false;
+                }
+                if (query.since && convertedConversation.metadata?.createdAt && convertedConversation.metadata.createdAt < query.since) {
+                    matches = false;
+                }
+                if (query.until && convertedConversation.metadata?.createdAt && convertedConversation.metadata.createdAt > query.until) {
+                    matches = false;
+                }
+                if (matches) {
+                    results.push(convertedConversation);
+                }
+            }
+            // Sort by last activity (most recent first)
+            results.sort((a, b) => {
+                const aTime = a.metadata?.lastActivity?.getTime() || 0;
+                const bTime = b.metadata?.lastActivity?.getTime() || 0;
+                return bTime - aTime;
+            });
+            // Apply pagination
+            const offset = query.offset || 0;
+            const limit = query.limit || results.length;
+            const paginatedResults = results.slice(offset, offset + limit);
+            console.log(`[MEMORY:Redis] Found ${paginatedResults.length} conversations matching query`);
+            return createSuccess(paginatedResults);
+        }
+        catch (error) {
+            return createFailure(createMemoryStorageError('find conversations', 'Redis', error));
+        }
+    };
+    const getRecentMessages = async (conversationId, limit = 50) => {
+        const conversationResult = await getConversation(conversationId);
+        if (!conversationResult.success) {
+            return conversationResult;
+        }
+        if (!conversationResult.data) {
+            return createSuccess([]);
+        }
+        const messages = conversationResult.data.messages.slice(-limit);
+        console.log(`[MEMORY:Redis] Retrieved ${messages.length} recent messages for conversation ${conversationId}`);
+        return createSuccess(messages);
+    };
+    const deleteConversation = async (conversationId) => {
+        const client = ensureConnected();
+        try {
+            const key = getKey(conversationId);
+            const deleted = await client.del(key);
+            console.log(`[MEMORY:Redis] ${deleted > 0 ? 'Deleted' : 'Attempted to delete non-existent'} conversation ${conversationId}`);
+            return createSuccess(deleted > 0);
+        }
+        catch (error) {
+            return createFailure(createMemoryStorageError('delete conversation', 'Redis', error));
+        }
+    };
+    const clearUserConversations = async (userId) => {
+        const client = ensureConnected();
+        try {
+            const pattern = getUserKey(userId);
+            const keys = await client.keys(pattern);
+            if (keys.length === 0) {
+                return createSuccess(0);
+            }
+            // Delete in batches to avoid blocking Redis
+            let deletedCount = 0;
+            const batchSize = 100;
+            for (let i = 0; i < keys.length; i += batchSize) {
+                const batch = keys.slice(i, i + batchSize);
+                const results = await Promise.all(batch.map(key => client.del(key)));
+                deletedCount += results.reduce((sum, result) => sum + result, 0);
+            }
+            console.log(`[MEMORY:Redis] Cleared ${deletedCount} conversations for user ${userId}`);
+            return createSuccess(deletedCount);
+        }
+        catch (error) {
+            return createFailure(createMemoryStorageError('clear user conversations', 'Redis', error));
+        }
+    };
+    const getStats = async (userId) => {
+        const client = ensureConnected();
+        try {
+            const pattern = userId
+                ? getUserKey(userId)
+                : `${fullConfig.keyPrefix}*`;
+            const keys = await client.keys(pattern);
+            let totalConversations = 0;
+            let totalMessages = 0;
+            let oldestDate;
+            let newestDate;
+            // Process conversations in batches
+            const batchSize = 50;
+            for (let i = 0; i < keys.length; i += batchSize) {
+                const batch = keys.slice(i, i + batchSize);
+                const conversations = await Promise.all(batch.map(async (key) => {
+                    try {
+                        const value = await client.get(key);
+                        return value ? JSON.parse(value) : null;
+                    }
+                    catch {
+                        return null;
+                    }
+                }));
+                for (const conversation of conversations) {
+                    if (!conversation)
+                        continue;
+                    totalConversations++;
+                    totalMessages += conversation.messages.length;
+                    const createdAt = conversation.metadata?.createdAt
+                        ? new Date(conversation.metadata.createdAt)
+                        : undefined;
+                    if (createdAt) {
+                        if (!oldestDate || createdAt < oldestDate) {
+                            oldestDate = createdAt;
+                        }
+                        if (!newestDate || createdAt > newestDate) {
+                            newestDate = createdAt;
+                        }
+                    }
+                }
+            }
+            return createSuccess({
+                totalConversations,
+                totalMessages,
+                oldestConversation: oldestDate,
+                newestConversation: newestDate
+            });
+        }
+        catch (error) {
+            return createFailure(createMemoryStorageError('get stats', 'Redis', error));
+        }
+    };
+    const healthCheck = async () => {
+        const start = Date.now();
+        try {
+            const client = ensureConnected();
+            await client.ping();
+            // Test basic operations
+            const testId = `health-check-${Date.now()}`;
+            const testKey = getKey(testId);
+            await client.set(testKey, JSON.stringify({ test: true }));
+            await client.get(testKey);
+            await client.del(testKey);
+            const latencyMs = Date.now() - start;
+            return createSuccess({ healthy: true, latencyMs });
+        }
+        catch (error) {
+            return createSuccess({
+                healthy: false,
+                latencyMs: Date.now() - start,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    };
+    const close = async () => {
+        try {
+            if (redisClient) {
+                console.log('[MEMORY:Redis] Closing Redis connection');
+                await redisClient.quit();
+            }
+            return createSuccess(undefined);
+        }
+        catch (error) {
+            return createFailure(createMemoryStorageError('close connection', 'Redis', error));
+        }
+    };
+    return {
+        storeMessages,
+        getConversation,
+        appendMessages,
+        findConversations,
+        getRecentMessages,
+        deleteConversation,
+        clearUserConversations,
+        getStats,
+        healthCheck,
+        close
+    };
+}
+//# sourceMappingURL=redis.js.map

package/dist/memory/providers/redis.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,296 @@
+import { z } from 'zod';
+import { Message, TraceId } from '../core/types';
+export type Result<T, E = MemoryErrorUnion> = {
+    readonly success: true;
+    readonly data: T;
+} | {
+    readonly success: false;
+    readonly error: E;
+};
+/**
+ * Memory management types for the JAF framework
+ */
+export interface ConversationMemory {
+    readonly conversationId: string;
+    readonly userId?: string;
+    readonly messages: readonly Message[];
+    readonly metadata?: {
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+        readonly totalMessages: number;
+        readonly lastActivity: Date;
+        readonly [key: string]: any;
+    };
+}
+export interface MemoryQuery {
+    readonly conversationId?: string;
+    readonly userId?: string;
+    readonly traceId?: TraceId;
+    readonly limit?: number;
+    readonly offset?: number;
+    readonly since?: Date;
+    readonly until?: Date;
+}
+export type MemoryProvider = {
+    /**
+     * Store messages for a conversation
+     */
+    readonly storeMessages: (conversationId: string, messages: readonly Message[], metadata?: {
+        userId?: string;
+        traceId?: TraceId;
+        [key: string]: any;
+    }) => Promise<Result<void>>;
+    /**
+     * Retrieve conversation history
+     */
+    readonly getConversation: (conversationId: string) => Promise<Result<ConversationMemory | null>>;
+    /**
+     * Append new messages to existing conversation
+     */
+    readonly appendMessages: (conversationId: string, messages: readonly Message[], metadata?: {
+        traceId?: TraceId;
+        [key: string]: any;
+    }) => Promise<Result<void>>;
+    /**
+     * Search conversations by query
+     */
+    readonly findConversations: (query: MemoryQuery) => Promise<Result<ConversationMemory[]>>;
+    /**
+     * Get recent messages from a conversation
+     */
+    readonly getRecentMessages: (conversationId: string, limit?: number) => Promise<Result<readonly Message[]>>;
+    /**
+     * Delete conversation
+     */
+    readonly deleteConversation: (conversationId: string) => Promise<Result<boolean>>;
+    /**
+     * Clear all conversations for a user
+     */
+    readonly clearUserConversations: (userId: string) => Promise<Result<number>>;
+    /**
+     * Get conversation statistics
+     */
+    readonly getStats: (userId?: string) => Promise<Result<{
+        totalConversations: number;
+        totalMessages: number;
+        oldestConversation?: Date;
+        newestConversation?: Date;
+    }>>;
+    /**
+     * Health check for the memory provider
+     */
+    readonly healthCheck: () => Promise<Result<{
+        healthy: boolean;
+        latencyMs?: number;
+        error?: string;
+    }>>;
+    /**
+     * Close/cleanup the provider
+     */
+    readonly close: () => Promise<Result<void>>;
+};
+export interface MemoryConfig {
+    readonly provider: MemoryProvider;
+    readonly autoStore?: boolean;
+    readonly maxMessages?: number;
+    readonly ttl?: number;
+    readonly compressionThreshold?: number;
+}
+export declare const InMemoryConfigSchema: z.ZodObject<{
+    type: z.ZodLiteral<"memory">;
+    maxConversations: z.ZodDefault<z.ZodNumber>;
+    maxMessagesPerConversation: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "memory";
+    maxConversations: number;
+    maxMessagesPerConversation: number;
+}, {
+    type: "memory";
+    maxConversations?: number | undefined;
+    maxMessagesPerConversation?: number | undefined;
+}>;
+export declare const RedisConfigSchema: z.ZodObject<{
+    type: z.ZodLiteral<"redis">;
+    url: z.ZodOptional<z.ZodString>;
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    password: z.ZodOptional<z.ZodString>;
+    db: z.ZodDefault<z.ZodNumber>;
+    keyPrefix: z.ZodDefault<z.ZodString>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "redis";
+    host: string;
+    port: number;
+    db: number;
+    keyPrefix: string;
+    url?: string | undefined;
+    password?: string | undefined;
+    ttl?: number | undefined;
+}, {
+    type: "redis";
+    url?: string | undefined;
+    host?: string | undefined;
+    port?: number | undefined;
+    password?: string | undefined;
+    db?: number | undefined;
+    keyPrefix?: string | undefined;
+    ttl?: number | undefined;
+}>;
+export declare const PostgresConfigSchema: z.ZodObject<{
+    type: z.ZodLiteral<"postgres">;
+    connectionString: z.ZodOptional<z.ZodString>;
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    database: z.ZodDefault<z.ZodString>;
+    username: z.ZodDefault<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    ssl: z.ZodDefault<z.ZodBoolean>;
+    tableName: z.ZodDefault<z.ZodString>;
+    maxConnections: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "postgres";
+    host: string;
+    port: number;
+    database: string;
+    username: string;
+    ssl: boolean;
+    tableName: string;
+    maxConnections: number;
+    password?: string | undefined;
+    connectionString?: string | undefined;
+}, {
+    type: "postgres";
+    host?: string | undefined;
+    port?: number | undefined;
+    password?: string | undefined;
+    connectionString?: string | undefined;
+    database?: string | undefined;
+    username?: string | undefined;
+    ssl?: boolean | undefined;
+    tableName?: string | undefined;
+    maxConnections?: number | undefined;
+}>;
+export declare const MemoryProviderConfigSchema: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"memory">;
+    maxConversations: z.ZodDefault<z.ZodNumber>;
+    maxMessagesPerConversation: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "memory";
+    maxConversations: number;
+    maxMessagesPerConversation: number;
+}, {
+    type: "memory";
+    maxConversations?: number | undefined;
+    maxMessagesPerConversation?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"redis">;
+    url: z.ZodOptional<z.ZodString>;
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    password: z.ZodOptional<z.ZodString>;
+    db: z.ZodDefault<z.ZodNumber>;
+    keyPrefix: z.ZodDefault<z.ZodString>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "redis";
+    host: string;
+    port: number;
+    db: number;
+    keyPrefix: string;
+    url?: string | undefined;
+    password?: string | undefined;
+    ttl?: number | undefined;
+}, {
+    type: "redis";
+    url?: string | undefined;
+    host?: string | undefined;
+    port?: number | undefined;
+    password?: string | undefined;
+    db?: number | undefined;
+    keyPrefix?: string | undefined;
+    ttl?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"postgres">;
+    connectionString: z.ZodOptional<z.ZodString>;
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    database: z.ZodDefault<z.ZodString>;
+    username: z.ZodDefault<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    ssl: z.ZodDefault<z.ZodBoolean>;
+    tableName: z.ZodDefault<z.ZodString>;
+    maxConnections: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "postgres";
+    host: string;
+    port: number;
+    database: string;
+    username: string;
+    ssl: boolean;
+    tableName: string;
+    maxConnections: number;
+    password?: string | undefined;
+    connectionString?: string | undefined;
+}, {
+    type: "postgres";
+    host?: string | undefined;
+    port?: number | undefined;
+    password?: string | undefined;
+    connectionString?: string | undefined;
+    database?: string | undefined;
+    username?: string | undefined;
+    ssl?: boolean | undefined;
+    tableName?: string | undefined;
+    maxConnections?: number | undefined;
+}>]>;
+export type InMemoryConfig = z.infer<typeof InMemoryConfigSchema>;
+export type RedisConfig = z.infer<typeof RedisConfigSchema>;
+export type PostgresConfig = z.infer<typeof PostgresConfigSchema>;
+export type MemoryProviderConfig = z.infer<typeof MemoryProviderConfigSchema>;
+export type MemoryError = {
+    readonly _tag: 'MemoryError';
+    readonly message: string;
+    readonly code: string;
+    readonly provider: string;
+    readonly cause?: Error;
+};
+export type MemoryConnectionError = {
+    readonly _tag: 'MemoryConnectionError';
+    readonly message: string;
+    readonly provider: string;
+    readonly cause?: Error;
+};
+export type MemoryNotFoundError = {
+    readonly _tag: 'MemoryNotFoundError';
+    readonly message: string;
+    readonly conversationId: string;
+    readonly provider: string;
+};
+export type MemoryStorageError = {
+    readonly _tag: 'MemoryStorageError';
+    readonly message: string;
+    readonly operation: string;
+    readonly provider: string;
+    readonly cause?: Error;
+};
+export type MemoryErrorUnion = MemoryConnectionError | MemoryNotFoundError | MemoryStorageError;
+export declare const createMemoryError: (message: string, code: string, provider: string, cause?: Error) => MemoryError;
+export declare const createMemoryConnectionError: (provider: string, cause?: Error) => MemoryConnectionError;
+export declare const createMemoryNotFoundError: (conversationId: string, provider: string) => MemoryNotFoundError;
+export declare const createMemoryStorageError: (operation: string, provider: string, cause?: Error) => MemoryStorageError;
+export declare const isMemoryError: (error: any) => error is MemoryErrorUnion;
+export declare const isMemoryConnectionError: (error: any) => error is MemoryConnectionError;
+export declare const isMemoryNotFoundError: (error: any) => error is MemoryNotFoundError;
+export declare const isMemoryStorageError: (error: any) => error is MemoryStorageError;
+export declare const createSuccess: <T>(data: T) => Result<T>;
+export declare const createFailure: <E extends MemoryErrorUnion>(error: E) => Result<never, E>;
+export declare const isSuccess: <T, E>(result: Result<T, E>) => result is {
+    success: true;
+    data: T;
+};
+export declare const isFailure: <T, E>(result: Result<T, E>) => result is {
+    success: false;
+    error: E;
+};
+//# sourceMappingURL=types.d.ts.map