agents-library 0.1.0

package/dist/memory/memory-service.js

@@ -0,0 +1,410 @@
+/**
+ * Memory Service - Hybrid Storage Orchestration
+ *
+ * Orchestrates hybrid memory system:
+ * - Short-term: Conversation context in JSON files (FileStorageAdapter)
+ * - Long-term: Summarized history in ArcadeDB (ArcadeDBAdapter)
+ * - Private: User preferences in JSON files
+ * - Public: Shared knowledge base in JSON files
+ *
+ * Features:
+ * - Automatic archival when conversation exceeds 20 messages
+ * - LLM-based summarization before archival
+ * - Graceful degradation if ArcadeDB unavailable
+ */
+import { ok, err } from '../common/result.js';
+import { FileStorageAdapter } from './file-storage-adapter.js';
+import { ArcadeDBAdapter } from './arcadedb-adapter.js';
+/**
+ * Memory Service
+ *
+ * Manages hybrid memory storage with automatic archival and graceful degradation
+ */
+export class MemoryService {
+    providerManager;
+    fileStorage;
+    dbAdapter = null;
+    isDbAvailable = false;
+    archiveThreshold = 20;
+    /**
+     * Create Memory Service
+     *
+     * @param memoryDataPath - Base directory for file storage
+     * @param arcadedbUrl - ArcadeDB connection URL (optional)
+     * @param arcadedbPassword - ArcadeDB root password (optional, defaults to 'root')
+     * @param providerManager - LLM provider for summarization (optional)
+     */
+    constructor(memoryDataPath, arcadedbUrl, arcadedbPassword, providerManager) {
+        this.providerManager = providerManager;
+        this.fileStorage = new FileStorageAdapter(memoryDataPath);
+        if (arcadedbUrl) {
+            this.dbAdapter = new ArcadeDBAdapter(arcadedbUrl, 'root', arcadedbPassword || 'root');
+        }
+    }
+    /**
+     * Initialize memory service
+     *
+     * Attempts to connect to ArcadeDB, logs warning if unavailable but continues
+     *
+     * @returns Result indicating initialization success
+     */
+    async initialize() {
+        if (this.dbAdapter) {
+            const result = await this.dbAdapter.connect();
+            if (!result.success) {
+                console.warn(`[MemoryService] ArcadeDB unavailable: ${result.error.message}. ` +
+                    'Continuing with short-term storage only.');
+                this.isDbAvailable = false;
+            }
+            else {
+                this.isDbAvailable = true;
+                console.log('[MemoryService] ArcadeDB connected successfully');
+            }
+        }
+        else {
+            console.log('[MemoryService] ArcadeDB not configured, using file storage only');
+        }
+        return ok(undefined);
+    }
+    /**
+     * Store message in conversation history
+     *
+     * Appends message to short-term storage and checks if archival is needed
+     *
+     * @param userId - User identifier
+     * @param channelId - Channel/conversation identifier
+     * @param message - Message to store
+     * @returns Result indicating success or error
+     */
+    async storeMessage(userId, channelId, message) {
+        // Validate message
+        if (!message.role || !message.content) {
+            return err({
+                type: 'VALIDATION_ERROR',
+                message: 'Message must have role and content',
+            });
+        }
+        // Append to conversation file
+        const conversationPath = `${userId}/${channelId}.json`;
+        const result = await this.fileStorage.appendToJSONArray(conversationPath, message);
+        if (!result.success) {
+            return err({
+                type: 'FILE_ERROR',
+                message: `Failed to store message: ${result.error.message}`,
+                originalError: result.error,
+            });
+        }
+        // Check if archival is needed
+        await this.checkArchiveThreshold(userId, channelId);
+        return ok(undefined);
+    }
+    /**
+     * Retrieve conversation context
+     *
+     * Reads recent messages from short-term storage
+     *
+     * @param userId - User identifier
+     * @param channelId - Channel/conversation identifier
+     * @param limit - Maximum number of messages to retrieve (default: 20)
+     * @returns Result with conversation messages or error
+     */
+    async retrieveContext(userId, channelId, limit = 20) {
+        const conversationPath = `${userId}/${channelId}.json`;
+        const result = await this.fileStorage.readJSON(conversationPath);
+        if (!result.success) {
+            return err({
+                type: 'FILE_ERROR',
+                message: `Failed to retrieve context: ${result.error.message}`,
+                originalError: result.error,
+            });
+        }
+        // Handle no conversation history
+        if (result.data === null) {
+            return ok([]);
+        }
+        // Return last N messages
+        const messages = result.data;
+        const recentMessages = messages.slice(-limit);
+        return ok(recentMessages);
+    }
+    /**
+     * Store user preference
+     *
+     * Saves preference to user's preference file
+     *
+     * @param userId - User identifier
+     * @param key - Preference key
+     * @param value - Preference value
+     * @returns Result indicating success or error
+     */
+    async storePreference(userId, key, value) {
+        const preferencePath = `${userId}/preferences.json`;
+        // Read existing preferences
+        const readResult = await this.fileStorage.readJSON(preferencePath);
+        if (!readResult.success) {
+            return err({
+                type: 'FILE_ERROR',
+                message: `Failed to read preferences: ${readResult.error.message}`,
+                originalError: readResult.error,
+            });
+        }
+        const preferences = readResult.data || {};
+        // Update preference
+        preferences[key] = {
+            key,
+            value,
+            updatedAt: Date.now(),
+        };
+        // Write back
+        const writeResult = await this.fileStorage.writeJSON(preferencePath, preferences);
+        if (!writeResult.success) {
+            return err({
+                type: 'FILE_ERROR',
+                message: `Failed to write preferences: ${writeResult.error.message}`,
+                originalError: writeResult.error,
+            });
+        }
+        return ok(undefined);
+    }
+    /**
+     * Get user preference
+     *
+     * Retrieves preference value from user's preference file
+     *
+     * @param userId - User identifier
+     * @param key - Preference key
+     * @returns Result with preference value or null if not found
+     */
+    async getPreference(userId, key) {
+        const preferencePath = `${userId}/preferences.json`;
+        const result = await this.fileStorage.readJSON(preferencePath);
+        if (!result.success) {
+            return err({
+                type: 'FILE_ERROR',
+                message: `Failed to read preferences: ${result.error.message}`,
+                originalError: result.error,
+            });
+        }
+        if (result.data === null || !(key in result.data)) {
+            return ok(null);
+        }
+        return ok(result.data[key].value);
+    }
+    /**
+     * Store knowledge in public knowledge base
+     *
+     * Adds entry to shared knowledge base
+     *
+     * @param entry - Knowledge entry
+     * @returns Result indicating success or error
+     */
+    async storeKnowledge(entry) {
+        const knowledgePath = 'public/knowledge.json';
+        // Read existing knowledge base
+        const readResult = await this.fileStorage.readJSON(knowledgePath);
+        if (!readResult.success) {
+            return err({
+                type: 'FILE_ERROR',
+                message: `Failed to read knowledge base: ${readResult.error.message}`,
+                originalError: readResult.error,
+            });
+        }
+        const knowledge = readResult.data || {};
+        // Add/update entry
+        knowledge[entry.id] = {
+            ...entry,
+            updatedAt: Date.now(),
+        };
+        // Write back
+        const writeResult = await this.fileStorage.writeJSON(knowledgePath, knowledge);
+        if (!writeResult.success) {
+            return err({
+                type: 'FILE_ERROR',
+                message: `Failed to write knowledge base: ${writeResult.error.message}`,
+                originalError: writeResult.error,
+            });
+        }
+        return ok(undefined);
+    }
+    /**
+     * Get knowledge from public knowledge base
+     *
+     * Retrieves entry by ID
+     *
+     * @param id - Knowledge entry ID
+     * @returns Result with knowledge entry or null if not found
+     */
+    async getKnowledge(id) {
+        const knowledgePath = 'public/knowledge.json';
+        const result = await this.fileStorage.readJSON(knowledgePath);
+        if (!result.success) {
+            return err({
+                type: 'FILE_ERROR',
+                message: `Failed to read knowledge base: ${result.error.message}`,
+                originalError: result.error,
+            });
+        }
+        if (result.data === null || !(id in result.data)) {
+            return ok(null);
+        }
+        return ok(result.data[id]);
+    }
+    /**
+     * Check if conversation exceeds archival threshold
+     *
+     * If threshold exceeded, triggers archival to long-term storage
+     *
+     * @param userId - User identifier
+     * @param channelId - Channel identifier
+     */
+    async checkArchiveThreshold(userId, channelId) {
+        const conversationPath = `${userId}/${channelId}.json`;
+        const result = await this.fileStorage.readJSON(conversationPath);
+        if (!result.success || result.data === null) {
+            return;
+        }
+        const messages = result.data;
+        if (messages.length >= this.archiveThreshold) {
+            await this.archiveToLongTerm(userId, channelId, messages);
+        }
+    }
+    /**
+     * Archive conversation to long-term storage
+     *
+     * Summarizes conversation using LLM and stores in ArcadeDB
+     * Trims short-term storage to keep only recent messages
+     *
+     * @param userId - User identifier
+     * @param channelId - Channel identifier
+     * @param messages - Messages to archive
+     */
+    async archiveToLongTerm(userId, channelId, messages) {
+        // Skip if database unavailable
+        if (!this.isDbAvailable || !this.dbAdapter) {
+            console.warn(`[MemoryService] Cannot archive conversation for ${userId}/${channelId}: ` +
+                'Database unavailable');
+            return;
+        }
+        // Generate summary using LLM
+        let summary;
+        if (this.providerManager) {
+            const summaryResult = await this.summarizeConversation(messages);
+            summary = summaryResult.success ? summaryResult.data : 'Summary generation failed';
+        }
+        else {
+            summary = `Conversation with ${messages.length} messages`;
+        }
+        // Create archived summary
+        const archivedSummary = {
+            userId,
+            channelId,
+            summary,
+            messageCount: messages.length,
+            startTime: messages[0].timestamp,
+            endTime: messages[messages.length - 1].timestamp,
+        };
+        // Store in ArcadeDB as vertex
+        const vertexResult = await this.dbAdapter.createVertex('ArchivedConversation', archivedSummary);
+        if (!vertexResult.success) {
+            console.error(`[MemoryService] Failed to archive conversation: ${vertexResult.error.message}`);
+            return;
+        }
+        console.log(`[MemoryService] Archived conversation ${userId}/${channelId} ` +
+            `(${messages.length} messages) with @rid ${vertexResult.data}`);
+        // Trim short-term storage to keep last 10 messages
+        const conversationPath = `${userId}/${channelId}.json`;
+        await this.fileStorage.trimJSONArray(conversationPath, 10);
+    }
+    /**
+     * Summarize conversation using LLM
+     *
+     * @param messages - Messages to summarize
+     * @returns Result with summary text
+     */
+    async summarizeConversation(messages) {
+        if (!this.providerManager) {
+            return err({
+                type: 'PROVIDER_ERROR',
+                message: 'Provider manager not available for summarization',
+            });
+        }
+        // Build conversation text
+        const conversationText = messages
+            .map(m => `${m.role}: ${m.content}`)
+            .join('\n');
+        // Generate summary
+        const result = await this.providerManager.chat([
+            {
+                role: 'user',
+                content: `Summarize the following conversation in 2-3 sentences:\n\n${conversationText}`,
+            },
+        ]);
+        if (!result.success) {
+            return err({
+                type: 'PROVIDER_ERROR',
+                message: `Summarization failed: ${result.error.message}`,
+                originalError: result.error,
+            });
+        }
+        return ok(result.data);
+    }
+    /**
+     * Search long-term storage
+     *
+     * Queries ArcadeDB for archived conversations matching criteria
+     *
+     * @param userId - User identifier
+     * @param searchTerm - Search term for summary content
+     * @param limit - Maximum results to return (default: 10)
+     * @returns Result with archived summaries or error
+     */
+    async searchLongTerm(userId, searchTerm, limit = 10) {
+        if (!this.isDbAvailable || !this.dbAdapter) {
+            return err({
+                type: 'DATABASE_ERROR',
+                message: 'Long-term storage unavailable',
+            });
+        }
+        // Query ArcadeDB using Cypher
+        const cypher = `
+      MATCH (c:ArchivedConversation)
+      WHERE c.userId = $userId AND c.summary CONTAINS $searchTerm
+      RETURN c
+      ORDER BY c.endTime DESC
+      LIMIT $limit
+    `;
+        const result = await this.dbAdapter.query(cypher, { userId, searchTerm, limit });
+        if (!result.success) {
+            return err({
+                type: 'DATABASE_ERROR',
+                message: `Search failed: ${result.error.message}`,
+                originalError: result.error,
+            });
+        }
+        // Extract ArchivedSummary from results
+        const summaries = result.data.map((row) => row.c);
+        return ok(summaries);
+    }
+    /**
+     * Dispose of memory service
+     *
+     * Disconnects from ArcadeDB and performs cleanup
+     *
+     * @returns Result indicating success or error
+     */
+    async dispose() {
+        if (this.dbAdapter && this.isDbAvailable) {
+            const result = await this.dbAdapter.disconnect();
+            if (!result.success) {
+                return err({
+                    type: 'DATABASE_ERROR',
+                    message: `Failed to disconnect: ${result.error.message}`,
+                    originalError: result.error,
+                });
+            }
+            this.isDbAvailable = false;
+        }
+        return ok(undefined);
+    }
+}
+//# sourceMappingURL=memory-service.js.map

package/dist/memory/memory-service.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Memory System Types
+ *
+ * Defines data models for the hybrid memory system combining file-based
+ * short-term storage (JSON/MD files) with ArcadeDB long-term persistence.
+ */
+/**
+ * Memory entry types
+ */
+export type MemoryType = 'short-term' | 'long-term' | 'private' | 'public';
+/**
+ * Base memory entry structure
+ */
+export interface MemoryEntry {
+    id: string;
+    userId: string;
+    channelId?: string;
+    type: MemoryType;
+    content: string;
+    timestamp: Date;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Conversation message (stored in short-term memory)
+ */
+export interface ConversationMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp: Date;
+    userId: string;
+    channelId: string;
+}
+/**
+ * Conversation summary (stored in long-term memory after archival)
+ */
+export interface ConversationSummary {
+    id: string;
+    userId: string;
+    channelId: string;
+    summary: string;
+    messageCount: number;
+    startTime: Date;
+    endTime: Date;
+    keyTopics: string[];
+    archived: Date;
+}
+/**
+ * User preference (stored in private memory)
+ */
+export interface UserPreference {
+    userId: string;
+    key: string;
+    value: unknown;
+    updatedAt: Date;
+}
+/**
+ * Public knowledge entry (stored in shared memory)
+ */
+export interface PublicKnowledge {
+    key: string;
+    value: unknown;
+    source?: string;
+    confidence?: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Memory error types
+ */
+export declare enum MemoryErrorType {
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    FILE_WRITE_ERROR = "FILE_WRITE_ERROR",
+    FILE_READ_ERROR = "FILE_READ_ERROR",
+    DATABASE_ERROR = "DATABASE_ERROR",
+    SERIALIZATION_ERROR = "SERIALIZATION_ERROR",
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Memory operation error
+ */
+export interface MemoryError {
+    type: MemoryErrorType;
+    message: string;
+    operation: string;
+    originalError?: unknown;
+}
+/**
+ * File error types (for FileStorageAdapter)
+ */
+export declare enum FileErrorType {
+    NOT_FOUND = "NOT_FOUND",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    WRITE_FAILED = "WRITE_FAILED",
+    READ_FAILED = "READ_FAILED",
+    PARSE_ERROR = "PARSE_ERROR",
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * File operation error
+ */
+export interface FileError {
+    type: FileErrorType;
+    message: string;
+    filePath: string;
+    originalError?: unknown;
+}
+/**
+ * Database error types (for ArcadeDBAdapter)
+ */
+export declare enum DatabaseErrorType {
+    CONNECTION_FAILED = "CONNECTION_FAILED",
+    QUERY_FAILED = "QUERY_FAILED",
+    TIMEOUT = "TIMEOUT",
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Database operation error
+ */
+export interface DatabaseError {
+    type: DatabaseErrorType;
+    message: string;
+    query?: string;
+    originalError?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/memory/types.d.ts.map

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

package/dist/memory/types.js

@@ -0,0 +1,41 @@
+/**
+ * Memory System Types
+ *
+ * Defines data models for the hybrid memory system combining file-based
+ * short-term storage (JSON/MD files) with ArcadeDB long-term persistence.
+ */
+/**
+ * Memory error types
+ */
+export var MemoryErrorType;
+(function (MemoryErrorType) {
+    MemoryErrorType["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    MemoryErrorType["FILE_WRITE_ERROR"] = "FILE_WRITE_ERROR";
+    MemoryErrorType["FILE_READ_ERROR"] = "FILE_READ_ERROR";
+    MemoryErrorType["DATABASE_ERROR"] = "DATABASE_ERROR";
+    MemoryErrorType["SERIALIZATION_ERROR"] = "SERIALIZATION_ERROR";
+    MemoryErrorType["UNKNOWN"] = "UNKNOWN";
+})(MemoryErrorType || (MemoryErrorType = {}));
+/**
+ * File error types (for FileStorageAdapter)
+ */
+export var FileErrorType;
+(function (FileErrorType) {
+    FileErrorType["NOT_FOUND"] = "NOT_FOUND";
+    FileErrorType["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    FileErrorType["WRITE_FAILED"] = "WRITE_FAILED";
+    FileErrorType["READ_FAILED"] = "READ_FAILED";
+    FileErrorType["PARSE_ERROR"] = "PARSE_ERROR";
+    FileErrorType["UNKNOWN"] = "UNKNOWN";
+})(FileErrorType || (FileErrorType = {}));
+/**
+ * Database error types (for ArcadeDBAdapter)
+ */
+export var DatabaseErrorType;
+(function (DatabaseErrorType) {
+    DatabaseErrorType["CONNECTION_FAILED"] = "CONNECTION_FAILED";
+    DatabaseErrorType["QUERY_FAILED"] = "QUERY_FAILED";
+    DatabaseErrorType["TIMEOUT"] = "TIMEOUT";
+    DatabaseErrorType["UNKNOWN"] = "UNKNOWN";
+})(DatabaseErrorType || (DatabaseErrorType = {}));
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqEH;;GAEG;AACH,MAAM,CAAN,IAAY,eAOX;AAPD,WAAY,eAAe;IACzB,oDAAiC,CAAA;IACjC,wDAAqC,CAAA;IACrC,sDAAmC,CAAA;IACnC,oDAAiC,CAAA;IACjC,8DAA2C,CAAA;IAC3C,sCAAmB,CAAA;AACrB,CAAC,EAPW,eAAe,KAAf,eAAe,QAO1B;AAYD;;GAEG;AACH,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,wCAAuB,CAAA;IACvB,wDAAuC,CAAA;IACvC,8CAA6B,CAAA;IAC7B,4CAA2B,CAAA;IAC3B,4CAA2B,CAAA;IAC3B,oCAAmB,CAAA;AACrB,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AAYD;;GAEG;AACH,MAAM,CAAN,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,4DAAuC,CAAA;IACvC,kDAA6B,CAAA;IAC7B,wCAAmB,CAAA;IACnB,wCAAmB,CAAA;AACrB,CAAC,EALW,iBAAiB,KAAjB,iBAAiB,QAK5B"}