@agenticc/storage-memory 1.0.0

package/dist/message-store.js

@@ -0,0 +1,404 @@
+/**
+ * Message Store
+ *
+ * Provides persistent storage for conversation messages.
+ * Supports storing user messages, agent responses, and tool call records.
+ *
+ * _Requirements: 9.2_
+ */
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * Message Store
+ *
+ * In-memory message store with support for persistence hooks.
+ * Can be extended with database persistence by implementing the
+ * MessagePersistence interface.
+ */
+export class MessageStore {
+    messages = new Map();
+    sessions = new Map();
+    toolCalls = new Map();
+    // Index for faster lookups
+    messagesBySession = new Map();
+    toolCallsBySession = new Map();
+    toolCallsByMessage = new Map();
+    /**
+     * Store a user message
+     *
+     * @param sessionId - Session ID
+     * @param content - Message content
+     * @param metadata - Optional metadata
+     * @returns The stored message
+     */
+    storeUserMessage(sessionId, content, metadata) {
+        this.ensureSession(sessionId);
+        const message = {
+            id: uuidv4(),
+            sessionId,
+            role: 'user',
+            content,
+            timestamp: new Date(),
+            metadata,
+            persisted: false,
+        };
+        this.addMessage(message);
+        return message;
+    }
+    /**
+     * Store an assistant message with agent response
+     *
+     * @param sessionId - Session ID
+     * @param response - Agent response
+     * @param metadata - Optional metadata
+     * @returns The stored message
+     */
+    storeAssistantMessage(sessionId, response, metadata) {
+        this.ensureSession(sessionId);
+        const message = {
+            id: uuidv4(),
+            sessionId,
+            role: 'assistant',
+            content: ('message' in response ? response.message : JSON.stringify(response)),
+            timestamp: new Date(),
+            responseType: response.type,
+            metadata,
+            persisted: false,
+        };
+        // Store tool calls if present
+        if (response.type === 'execute' && response.toolCalls) {
+            message.toolCalls = response.toolCalls;
+            this.storeToolCalls(sessionId, message.id, response.toolCalls);
+        }
+        this.addMessage(message);
+        return message;
+    }
+    /**
+     * Store a system message
+     *
+     * @param sessionId - Session ID
+     * @param content - Message content
+     * @returns The stored message
+     */
+    storeSystemMessage(sessionId, content) {
+        this.ensureSession(sessionId);
+        const message = {
+            id: uuidv4(),
+            sessionId,
+            role: 'system',
+            content,
+            timestamp: new Date(),
+            persisted: false,
+        };
+        this.addMessage(message);
+        return message;
+    }
+    /**
+     * Store tool call records
+     *
+     * @param sessionId - Session ID
+     * @param messageId - Message ID
+     * @param toolCalls - Tool call records
+     */
+    storeToolCalls(sessionId, messageId, toolCalls) {
+        for (const call of toolCalls) {
+            const storedCall = {
+                ...call,
+                id: uuidv4(),
+                sessionId,
+                messageId,
+                timestamp: new Date(),
+            };
+            this.toolCalls.set(storedCall.id, storedCall);
+            // Update indexes
+            if (!this.toolCallsBySession.has(sessionId)) {
+                this.toolCallsBySession.set(sessionId, new Set());
+            }
+            this.toolCallsBySession.get(sessionId).add(storedCall.id);
+            if (!this.toolCallsByMessage.has(messageId)) {
+                this.toolCallsByMessage.set(messageId, new Set());
+            }
+            this.toolCallsByMessage.get(messageId).add(storedCall.id);
+        }
+    }
+    /**
+     * Get a message by ID
+     *
+     * @param messageId - Message ID
+     * @returns The message or undefined
+     */
+    getMessage(messageId) {
+        return this.messages.get(messageId);
+    }
+    /**
+     * Query messages with filters
+     *
+     * @param options - Query options
+     * @returns Array of matching messages
+     */
+    queryMessages(options) {
+        let messages;
+        // Start with session filter if provided (uses index)
+        if (options?.sessionId) {
+            const messageIds = this.messagesBySession.get(options.sessionId);
+            if (!messageIds) {
+                return [];
+            }
+            messages = Array.from(messageIds)
+                .map((id) => this.messages.get(id))
+                .filter(Boolean);
+        }
+        else {
+            messages = Array.from(this.messages.values());
+        }
+        // Apply filters
+        if (options?.role) {
+            messages = messages.filter((m) => m.role === options.role);
+        }
+        if (options?.responseType) {
+            messages = messages.filter((m) => m.responseType === options.responseType);
+        }
+        if (options?.after) {
+            messages = messages.filter((m) => m.timestamp >= options.after);
+        }
+        if (options?.before) {
+            messages = messages.filter((m) => m.timestamp <= options.before);
+        }
+        // Sort by timestamp
+        const order = options?.order ?? 'asc';
+        messages.sort((a, b) => {
+            const diff = a.timestamp.getTime() - b.timestamp.getTime();
+            return order === 'asc' ? diff : -diff;
+        });
+        // Apply pagination
+        if (options?.offset) {
+            messages = messages.slice(options.offset);
+        }
+        if (options?.limit) {
+            messages = messages.slice(0, options.limit);
+        }
+        // Optionally exclude tool calls
+        if (options?.includeToolCalls === false) {
+            messages = messages.map((m) => {
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                const { toolCalls, ...rest } = m;
+                return rest;
+            });
+        }
+        return messages;
+    }
+    /**
+     * Get conversation history for a session
+     * Messages are returned in chronological order
+     *
+     * @param sessionId - Session ID
+     * @returns Array of messages ordered by timestamp
+     */
+    getSessionHistory(sessionId) {
+        return this.queryMessages({
+            sessionId,
+            order: 'asc',
+        });
+    }
+    /**
+     * Query tool calls with filters
+     *
+     * @param options - Query options
+     * @returns Array of matching tool calls
+     */
+    queryToolCalls(options) {
+        let calls;
+        // Start with session filter if provided (uses index)
+        if (options?.sessionId) {
+            const callIds = this.toolCallsBySession.get(options.sessionId);
+            if (!callIds) {
+                return [];
+            }
+            calls = Array.from(callIds)
+                .map((id) => this.toolCalls.get(id))
+                .filter(Boolean);
+        }
+        else {
+            calls = Array.from(this.toolCalls.values());
+        }
+        // Apply filters
+        if (options?.toolName) {
+            calls = calls.filter((c) => c.toolName === options.toolName);
+        }
+        if (options?.success !== undefined) {
+            calls = calls.filter((c) => c.result.success === options.success);
+        }
+        if (options?.after) {
+            calls = calls.filter((c) => c.timestamp >= options.after);
+        }
+        if (options?.before) {
+            calls = calls.filter((c) => c.timestamp <= options.before);
+        }
+        // Sort by timestamp (newest first)
+        calls.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+        // Apply limit
+        if (options?.limit) {
+            calls = calls.slice(0, options.limit);
+        }
+        return calls;
+    }
+    /**
+     * Get tool calls for a specific message
+     *
+     * @param messageId - Message ID
+     * @returns Array of tool calls
+     */
+    getToolCallsForMessage(messageId) {
+        const callIds = this.toolCallsByMessage.get(messageId);
+        if (!callIds) {
+            return [];
+        }
+        return Array.from(callIds)
+            .map((id) => this.toolCalls.get(id))
+            .filter(Boolean);
+    }
+    /**
+     * Get a session by ID
+     *
+     * @param sessionId - Session ID
+     * @returns The session or undefined
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Get all sessions
+     *
+     * @returns Array of all sessions
+     */
+    getAllSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /**
+     * Delete a message
+     *
+     * @param messageId - Message ID
+     * @returns True if deleted
+     */
+    deleteMessage(messageId) {
+        const message = this.messages.get(messageId);
+        if (!message) {
+            return false;
+        }
+        // Remove from session index
+        const sessionMessages = this.messagesBySession.get(message.sessionId);
+        if (sessionMessages) {
+            sessionMessages.delete(messageId);
+        }
+        // Remove associated tool calls
+        const toolCallIds = this.toolCallsByMessage.get(messageId);
+        if (toolCallIds) {
+            for (const callId of toolCallIds) {
+                this.toolCalls.delete(callId);
+                const sessionCalls = this.toolCallsBySession.get(message.sessionId);
+                if (sessionCalls) {
+                    sessionCalls.delete(callId);
+                }
+            }
+            this.toolCallsByMessage.delete(messageId);
+        }
+        return this.messages.delete(messageId);
+    }
+    /**
+     * Delete all messages in a session
+     *
+     * @param sessionId - Session ID
+     * @returns Number of messages deleted
+     */
+    deleteSessionMessages(sessionId) {
+        const messageIds = this.messagesBySession.get(sessionId);
+        if (!messageIds) {
+            return 0;
+        }
+        let count = 0;
+        for (const messageId of messageIds) {
+            if (this.deleteMessage(messageId)) {
+                count++;
+            }
+        }
+        this.messagesBySession.delete(sessionId);
+        this.toolCallsBySession.delete(sessionId);
+        this.sessions.delete(sessionId);
+        return count;
+    }
+    /**
+     * Get message count for a session
+     *
+     * @param sessionId - Session ID
+     * @returns Number of messages
+     */
+    getMessageCount(sessionId) {
+        return this.messagesBySession.get(sessionId)?.size ?? 0;
+    }
+    /**
+     * Get total message count across all sessions
+     *
+     * @returns Total number of messages
+     */
+    getTotalMessageCount() {
+        return this.messages.size;
+    }
+    /**
+     * Get total tool call count
+     *
+     * @returns Total number of tool calls
+     */
+    getTotalToolCallCount() {
+        return this.toolCalls.size;
+    }
+    /**
+     * Clear all data
+     */
+    clear() {
+        this.messages.clear();
+        this.sessions.clear();
+        this.toolCalls.clear();
+        this.messagesBySession.clear();
+        this.toolCallsBySession.clear();
+        this.toolCallsByMessage.clear();
+    }
+    /**
+     * Ensure a session exists
+     */
+    ensureSession(sessionId) {
+        if (!this.sessions.has(sessionId)) {
+            const now = new Date();
+            this.sessions.set(sessionId, {
+                id: sessionId,
+                messages: [],
+                createdAt: now,
+                updatedAt: now,
+                active: true,
+                persisted: false,
+            });
+        }
+    }
+    /**
+     * Add a message to storage
+     */
+    addMessage(message) {
+        this.messages.set(message.id, message);
+        // Update session index
+        if (!this.messagesBySession.has(message.sessionId)) {
+            this.messagesBySession.set(message.sessionId, new Set());
+        }
+        this.messagesBySession.get(message.sessionId).add(message.id);
+        // Update session timestamp
+        const session = this.sessions.get(message.sessionId);
+        if (session) {
+            session.updatedAt = new Date();
+            session.messages.push(message);
+        }
+    }
+}
+/**
+ * Create a new MessageStore instance
+ */
+export function createMessageStore() {
+    return new MessageStore();
+}
+//# sourceMappingURL=message-store.js.map

package/dist/message-store.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Session Management
+ *
+ * Manages conversation sessions for the Agent.
+ * Each session maintains its own conversation history and metadata.
+ *
+ * _Requirements: 9.1, 9.4_
+ */
+interface ToolCallRecord {
+    toolName: string;
+    arguments: Record<string, unknown>;
+    result: {
+        success: boolean;
+        content: string;
+        data?: unknown;
+    };
+}
+type ExecuteResponse = {
+    type: 'execute';
+    message: string;
+    data?: unknown;
+    toolCalls?: ToolCallRecord[];
+};
+type GenericAgentResponse = {
+    type: string;
+    message?: string;
+    data?: unknown;
+    toolCalls?: ToolCallRecord[];
+};
+type AgentResponse = ExecuteResponse | GenericAgentResponse;
+/**
+ * Message in conversation history
+ */
+export interface Message {
+    /** Unique message ID */
+    id: string;
+    /** Message role */
+    role: 'user' | 'assistant' | 'system';
+    /** Message content */
+    content: string;
+    /** Message timestamp */
+    timestamp: Date;
+    /** Tool calls made during this message (for assistant messages) */
+    toolCalls?: ToolCallRecord[];
+    /** Response type (for assistant messages) */
+    responseType?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Conversation session
+ */
+export interface Session {
+    /** Unique session ID */
+    id: string;
+    /** Messages in this session */
+    messages: Message[];
+    /** Session creation time */
+    createdAt: Date;
+    /** Last update time */
+    updatedAt: Date;
+    /** Session metadata */
+    metadata?: Record<string, unknown>;
+    /** Whether the session is active */
+    active: boolean;
+}
+/**
+ * Options for creating a new session
+ */
+export interface CreateSessionOptions {
+    /** Custom session ID (auto-generated if not provided) */
+    id?: string;
+    /** Initial metadata */
+    metadata?: Record<string, unknown>;
+    /** Initial system message */
+    systemMessage?: string;
+}
+/**
+ * Options for querying sessions
+ */
+export interface SessionQueryOptions {
+    /** Filter by active status */
+    active?: boolean;
+    /** Filter by creation date (after) */
+    createdAfter?: Date;
+    /** Filter by creation date (before) */
+    createdBefore?: Date;
+    /** Maximum number of sessions to return */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Session Manager
+ *
+ * Manages the lifecycle of conversation sessions.
+ * Provides methods for creating, retrieving, and managing sessions.
+ */
+export declare class SessionManager {
+    private sessions;
+    private defaultSessionId;
+    /**
+     * Create a new session
+     *
+     * @param options - Session creation options
+     * @returns The new session ID
+     */
+    createSession(options?: CreateSessionOptions): string;
+    /**
+     * Get a session by ID
+     *
+     * @param sessionId - Session ID
+     * @returns The session or undefined if not found
+     */
+    getSession(sessionId: string): Session | undefined;
+    /**
+     * Get or create a session
+     *
+     * @param sessionId - Session ID
+     * @param options - Options for creating if not exists
+     * @returns The session
+     */
+    getOrCreateSession(sessionId: string, options?: Omit<CreateSessionOptions, 'id'>): Session;
+    /**
+     * Check if a session exists
+     *
+     * @param sessionId - Session ID
+     * @returns True if session exists
+     */
+    hasSession(sessionId: string): boolean;
+    /**
+     * Get all sessions matching query options
+     *
+     * @param options - Query options
+     * @returns Array of matching sessions
+     */
+    querySessions(options?: SessionQueryOptions): Session[];
+    /**
+     * Get conversation history for a session
+     * Messages are returned in chronological order (oldest first)
+     *
+     * @param sessionId - Session ID
+     * @returns Array of messages ordered by timestamp
+     */
+    getHistory(sessionId: string): Message[];
+    /**
+     * Add a user message to a session
+     *
+     * @param sessionId - Session ID
+     * @param content - Message content
+     * @param metadata - Optional metadata
+     * @returns The created message
+     */
+    addUserMessage(sessionId: string, content: string, metadata?: Record<string, unknown>): Message;
+    /**
+     * Add an assistant message to a session
+     *
+     * @param sessionId - Session ID
+     * @param response - Agent response
+     * @param metadata - Optional metadata
+     * @returns The created message
+     */
+    addAssistantMessage(sessionId: string, response: AgentResponse, metadata?: Record<string, unknown>): Message;
+    /**
+     * Add a system message to a session
+     *
+     * @param sessionId - Session ID
+     * @param content - Message content
+     * @returns The created message
+     */
+    addSystemMessage(sessionId: string, content: string): Message;
+    /**
+     * Close a session (mark as inactive)
+     *
+     * @param sessionId - Session ID
+     * @returns True if session was closed
+     */
+    closeSession(sessionId: string): boolean;
+    /**
+     * Delete a session
+     *
+     * @param sessionId - Session ID
+     * @returns True if session was deleted
+     */
+    deleteSession(sessionId: string): boolean;
+    /**
+     * Clear all messages in a session
+     *
+     * @param sessionId - Session ID
+     * @returns True if session was cleared
+     */
+    clearSession(sessionId: string): boolean;
+    /**
+     * Update session metadata
+     *
+     * @param sessionId - Session ID
+     * @param metadata - New metadata (merged with existing)
+     * @returns True if session was updated
+     */
+    updateMetadata(sessionId: string, metadata: Record<string, unknown>): boolean;
+    /**
+     * Get the default session ID
+     */
+    getDefaultSessionId(): string;
+    /**
+     * Set the default session ID
+     */
+    setDefaultSessionId(sessionId: string): void;
+    /**
+     * Get total number of sessions
+     */
+    getSessionCount(): number;
+    /**
+     * Get total number of messages across all sessions
+     */
+    getTotalMessageCount(): number;
+}
+/**
+ * Create a new SessionManager instance
+ */
+export declare function createSessionManager(): SessionManager;
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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