@agenticc/storage-memory 1.0.0

package/dist/session.js

@@ -0,0 +1,285 @@
+/**
+ * Session Management
+ *
+ * Manages conversation sessions for the Agent.
+ * Each session maintains its own conversation history and metadata.
+ *
+ * _Requirements: 9.1, 9.4_
+ */
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * Session Manager
+ *
+ * Manages the lifecycle of conversation sessions.
+ * Provides methods for creating, retrieving, and managing sessions.
+ */
+export class SessionManager {
+    sessions = new Map();
+    defaultSessionId = 'default';
+    /**
+     * Create a new session
+     *
+     * @param options - Session creation options
+     * @returns The new session ID
+     */
+    createSession(options) {
+        const id = options?.id ?? uuidv4();
+        // Check if session already exists
+        if (this.sessions.has(id)) {
+            throw new Error(`Session with ID "${id}" already exists`);
+        }
+        const now = new Date();
+        const session = {
+            id,
+            messages: [],
+            createdAt: now,
+            updatedAt: now,
+            metadata: options?.metadata,
+            active: true,
+        };
+        // Add system message if provided
+        if (options?.systemMessage) {
+            session.messages.push({
+                id: uuidv4(),
+                role: 'system',
+                content: options.systemMessage,
+                timestamp: now,
+            });
+        }
+        this.sessions.set(id, session);
+        return id;
+    }
+    /**
+     * Get a session by ID
+     *
+     * @param sessionId - Session ID
+     * @returns The session or undefined if not found
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Get or create a session
+     *
+     * @param sessionId - Session ID
+     * @param options - Options for creating if not exists
+     * @returns The session
+     */
+    getOrCreateSession(sessionId, options) {
+        let session = this.sessions.get(sessionId);
+        if (!session) {
+            this.createSession({ ...options, id: sessionId });
+            session = this.sessions.get(sessionId);
+        }
+        return session;
+    }
+    /**
+     * Check if a session exists
+     *
+     * @param sessionId - Session ID
+     * @returns True if session exists
+     */
+    hasSession(sessionId) {
+        return this.sessions.has(sessionId);
+    }
+    /**
+     * Get all sessions matching query options
+     *
+     * @param options - Query options
+     * @returns Array of matching sessions
+     */
+    querySessions(options) {
+        let sessions = Array.from(this.sessions.values());
+        // Apply filters
+        if (options?.active !== undefined) {
+            sessions = sessions.filter((s) => s.active === options.active);
+        }
+        if (options?.createdAfter) {
+            sessions = sessions.filter((s) => s.createdAt >= options.createdAfter);
+        }
+        if (options?.createdBefore) {
+            sessions = sessions.filter((s) => s.createdAt <= options.createdBefore);
+        }
+        // Sort by creation date (newest first)
+        sessions.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+        // Apply pagination
+        if (options?.offset) {
+            sessions = sessions.slice(options.offset);
+        }
+        if (options?.limit) {
+            sessions = sessions.slice(0, options.limit);
+        }
+        return sessions;
+    }
+    /**
+     * 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) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return [];
+        }
+        // Return a copy sorted by timestamp (chronological order)
+        return [...session.messages].sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());
+    }
+    /**
+     * 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, content, metadata) {
+        const session = this.getOrCreateSession(sessionId);
+        const message = {
+            id: uuidv4(),
+            role: 'user',
+            content,
+            timestamp: new Date(),
+            metadata,
+        };
+        session.messages.push(message);
+        session.updatedAt = new Date();
+        return 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, response, metadata) {
+        const session = this.getOrCreateSession(sessionId);
+        const message = {
+            id: uuidv4(),
+            role: 'assistant',
+            content: ('message' in response ? response.message : JSON.stringify(response)),
+            timestamp: new Date(),
+            responseType: response.type,
+            metadata,
+        };
+        // Add tool calls if present
+        if (response.type === 'execute' && response.toolCalls) {
+            message.toolCalls = response.toolCalls;
+        }
+        session.messages.push(message);
+        session.updatedAt = new Date();
+        return message;
+    }
+    /**
+     * Add a system message to a session
+     *
+     * @param sessionId - Session ID
+     * @param content - Message content
+     * @returns The created message
+     */
+    addSystemMessage(sessionId, content) {
+        const session = this.getOrCreateSession(sessionId);
+        const message = {
+            id: uuidv4(),
+            role: 'system',
+            content,
+            timestamp: new Date(),
+        };
+        session.messages.push(message);
+        session.updatedAt = new Date();
+        return message;
+    }
+    /**
+     * Close a session (mark as inactive)
+     *
+     * @param sessionId - Session ID
+     * @returns True if session was closed
+     */
+    closeSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return false;
+        }
+        session.active = false;
+        session.updatedAt = new Date();
+        return true;
+    }
+    /**
+     * Delete a session
+     *
+     * @param sessionId - Session ID
+     * @returns True if session was deleted
+     */
+    deleteSession(sessionId) {
+        return this.sessions.delete(sessionId);
+    }
+    /**
+     * Clear all messages in a session
+     *
+     * @param sessionId - Session ID
+     * @returns True if session was cleared
+     */
+    clearSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return false;
+        }
+        session.messages = [];
+        session.updatedAt = new Date();
+        return true;
+    }
+    /**
+     * Update session metadata
+     *
+     * @param sessionId - Session ID
+     * @param metadata - New metadata (merged with existing)
+     * @returns True if session was updated
+     */
+    updateMetadata(sessionId, metadata) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return false;
+        }
+        session.metadata = { ...session.metadata, ...metadata };
+        session.updatedAt = new Date();
+        return true;
+    }
+    /**
+     * Get the default session ID
+     */
+    getDefaultSessionId() {
+        return this.defaultSessionId;
+    }
+    /**
+     * Set the default session ID
+     */
+    setDefaultSessionId(sessionId) {
+        this.defaultSessionId = sessionId;
+    }
+    /**
+     * Get total number of sessions
+     */
+    getSessionCount() {
+        return this.sessions.size;
+    }
+    /**
+     * Get total number of messages across all sessions
+     */
+    getTotalMessageCount() {
+        let count = 0;
+        for (const session of this.sessions.values()) {
+            count += session.messages.length;
+        }
+        return count;
+    }
+}
+/**
+ * Create a new SessionManager instance
+ */
+export function createSessionManager() {
+    return new SessionManager();
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@agenticc/storage-memory",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "In-memory storage adapter for @agenticc/core - for development and testing",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "ai",
+    "agent",
+    "storage",
+    "memory",
+    "in-memory",
+    "session",
+    "conversation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Chajian/agentic.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Chajian/agentic/issues"
+  },
+  "homepage": "https://github.com/Chajian/agentic#readme",
+  "author": "Chajian <xylyjy@gmail.com>",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc && tsc-alias",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write src/**/*.ts",
+    "format:check": "prettier --check src/**/*.ts",
+    "test": "vitest --run --passWithNoTests",
+    "test:coverage": "vitest --run --coverage --passWithNoTests",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run clean && npm run build && npm run typecheck"
+  },
+  "dependencies": {
+    "uuid": "^11.0.3"
+  },
+  "devDependencies": {
+    "@agenticc/core": "workspace:*",
+    "@types/node": "^22.10.2",
+    "@types/uuid": "^10.0.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "rimraf": "^6.0.1",
+    "tsc-alias": "^1.8.10",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "peerDependencies": {
+    "@agenticc/core": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}