@majkapp/majk-chat-sessions 1.0.0

package/README.md

@@ -0,0 +1,127 @@
+# Magic Chat Sessions
+
+Session management for Magic Chat conversations. This package provides persistent conversation storage and retrieval capabilities.
+
+## Features
+
+- **Persistent Sessions**: Store complete conversation histories with metadata
+- **Working Directory Organization**: Sessions are organized by the working directory where they were created
+- **Automatic Cleanup**: Configurable session cleanup based on age and count limits
+- **UUID-based Session IDs**: Each session has a unique identifier for easy reference
+- **Flexible Storage**: Pluggable storage interface with filesystem implementation
+
+## Usage
+
+### Basic Session Management
+
+```typescript
+import { SessionManager } from '@majkapp/majk-chat-sessions';
+
+const sessionManager = new SessionManager();
+
+// Create a new session
+const sessionId = await sessionManager.createSession('/path/to/project', {
+  title: 'My Chat Session',
+  provider: 'openai',
+  model: 'gpt-4',
+  initialMessages: []
+});
+
+// Add messages to the session
+await sessionManager.addMessage({
+  role: 'user',
+  content: 'Hello, how are you?'
+});
+
+// Continue the most recent session in a directory
+const sessionData = await sessionManager.continueLatestSession('/path/to/project');
+
+// Load a specific session
+const sessionData = await sessionManager.loadSession(sessionId, '/path/to/project');
+
+// List all sessions in a directory
+const sessions = await sessionManager.listSessions('/path/to/project');
+```
+
+### CLI Integration
+
+The sessions package is integrated into the Magic Chat CLI with the following flags:
+
+- `--continue`: Continue the most recent session in the current directory
+- `--session <uuid>`: Continue a specific session by UUID
+- `--session-title <title>`: Set a title for new sessions
+- `--list-sessions`: List all sessions in the current directory
+- `--delete-session <uuid>`: Delete a specific session
+
+### Directory Organization
+
+Sessions are stored in `~/.majk/chat-sessions/` organized by sanitized working directory names:
+
+```
+~/.majk/chat-sessions/
+├── home_user_projects_myapp/
+│   ├── 550e8400-e29b-41d4-a716-446655440000.json
+│   └── 6ba7b810-9dad-11d1-80b4-00c04fd430c8.json
+└── home_user_documents/
+    └── f47ac10b-58cc-4372-a567-0e02b2c3d479.json
+```
+
+## Configuration
+
+```typescript
+import { SessionManager, FileSystemSessionStorage } from '@majkapp/majk-chat-sessions';
+
+const sessionManager = new SessionManager({
+  baseDirectory: '/custom/sessions/path',  // Default: ~/.majk/chat-sessions
+  maxSessions: 500,                        // Default: 1000
+  autoCleanup: true,                       // Default: true
+  cleanupAfterDays: 30                     // Default: 90
+});
+```
+
+## Custom Storage
+
+You can implement custom storage backends by implementing the `SessionStorage` interface:
+
+```typescript
+import { SessionStorage, SessionData, SessionListItem } from '@majkapp/majk-chat-sessions';
+
+class CustomStorage implements SessionStorage {
+  async save(sessionData: SessionData): Promise<void> {
+    // Your implementation
+  }
+  
+  async load(sessionId: string, workingDirectory: string): Promise<SessionData | null> {
+    // Your implementation
+  }
+  
+  // ... implement other methods
+}
+
+const sessionManager = new SessionManager({
+  storage: new CustomStorage()
+});
+```
+
+## Session Data Structure
+
+```typescript
+interface SessionData {
+  metadata: {
+    id: string;
+    workingDirectory: string;
+    createdAt: Date;
+    updatedAt: Date;
+    title?: string;
+    provider?: string;
+    model?: string;
+    totalMessages: number;
+  };
+  messages: Message[];  // Array of chat messages
+  context?: Record<string, any>;  // Additional context data
+}
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { SessionManager } from './session-manager';
+export { FileSystemSessionStorage } from './storage/filesystem';
+export { SessionMetadata, SessionData, SessionListItem, SessionStorageConfig, SessionStorage } from './types/session';
+export { SessionManagerConfig } from './session-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EACL,eAAe,EACf,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemSessionStorage = exports.SessionManager = void 0;
+var session_manager_1 = require("./session-manager");
+Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return session_manager_1.SessionManager; } });
+var filesystem_1 = require("./storage/filesystem");
+Object.defineProperty(exports, "FileSystemSessionStorage", { enumerable: true, get: function () { return filesystem_1.FileSystemSessionStorage; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AACvB,mDAAgE;AAAvD,sHAAA,wBAAwB,OAAA"}

package/dist/session-manager.d.ts

@@ -0,0 +1,33 @@
+import { Message } from '@majkapp/majk-chat-core';
+import { SessionStorage, SessionData, SessionMetadata, SessionListItem, SessionStorageConfig } from './types/session';
+export interface SessionManagerConfig extends SessionStorageConfig {
+    storage?: SessionStorage;
+}
+export declare class SessionManager {
+    private storage;
+    private currentSession;
+    constructor(config?: SessionManagerConfig);
+    createSession(workingDirectory: string, options?: {
+        title?: string;
+        provider?: string;
+        model?: string;
+        initialMessages?: Message[];
+        context?: Record<string, any>;
+    }): Promise<string>;
+    loadSession(sessionId: string, workingDirectory: string): Promise<SessionData | null>;
+    continueLatestSession(workingDirectory: string): Promise<SessionData | null>;
+    addMessage(message: Message): Promise<void>;
+    addMessages(messages: Message[]): Promise<void>;
+    updateSessionMetadata(updates: Partial<SessionMetadata>): Promise<void>;
+    updateSessionContext(context: Record<string, any>): Promise<void>;
+    getCurrentSession(): SessionData | null;
+    getCurrentSessionId(): string | null;
+    getMessages(): Message[];
+    listSessions(workingDirectory: string): Promise<SessionListItem[]>;
+    deleteSession(sessionId: string, workingDirectory: string): Promise<boolean>;
+    sessionExists(sessionId: string, workingDirectory: string): Promise<boolean>;
+    cleanup(workingDirectory?: string): Promise<number>;
+    clearCurrentSession(): void;
+    generateSessionTitle(maxLength?: number): Promise<string | null>;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGtH,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,cAAc,CAA4B;gBAEtC,MAAM,GAAE,oBAAyB;IAIvC,aAAa,CACjB,gBAAgB,EAAE,MAAM,EACxB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC1B,GACL,OAAO,CAAC,MAAM,CAAC;IA2BZ,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAUrF,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAU5E,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/C,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvE,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASvE,iBAAiB,IAAI,WAAW,GAAG,IAAI;IAIvC,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAIpC,WAAW,IAAI,OAAO,EAAE;IAIlB,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIlE,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU5E,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5E,OAAO,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzD,mBAAmB,IAAI,IAAI;IAIrB,oBAAoB,CAAC,SAAS,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA+B3E"}

package/dist/session-manager.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = void 0;
+const uuid_1 = require("uuid");
+const filesystem_1 = require("./storage/filesystem");
+class SessionManager {
+    constructor(config = {}) {
+        this.currentSession = null;
+        this.storage = config.storage || new filesystem_1.FileSystemSessionStorage(config);
+    }
+    async createSession(workingDirectory, options = {}) {
+        const sessionId = (0, uuid_1.v4)();
+        const now = new Date();
+        const metadata = {
+            id: sessionId,
+            workingDirectory,
+            createdAt: now,
+            updatedAt: now,
+            title: options.title,
+            provider: options.provider,
+            model: options.model,
+            totalMessages: options.initialMessages?.length || 0
+        };
+        const sessionData = {
+            metadata,
+            messages: options.initialMessages || [],
+            context: options.context
+        };
+        await this.storage.save(sessionData);
+        this.currentSession = sessionData;
+        return sessionId;
+    }
+    async loadSession(sessionId, workingDirectory) {
+        const sessionData = await this.storage.load(sessionId, workingDirectory);
+        if (sessionData) {
+            this.currentSession = sessionData;
+        }
+        return sessionData;
+    }
+    async continueLatestSession(workingDirectory) {
+        const sessionData = await this.storage.getLatest(workingDirectory);
+        if (sessionData) {
+            this.currentSession = sessionData;
+        }
+        return sessionData;
+    }
+    async addMessage(message) {
+        if (!this.currentSession) {
+            throw new Error('No active session. Create or load a session first.');
+        }
+        this.currentSession.messages.push(message);
+        this.currentSession.metadata.totalMessages = this.currentSession.messages.length;
+        this.currentSession.metadata.updatedAt = new Date();
+        await this.storage.save(this.currentSession);
+    }
+    async addMessages(messages) {
+        if (!this.currentSession) {
+            throw new Error('No active session. Create or load a session first.');
+        }
+        this.currentSession.messages.push(...messages);
+        this.currentSession.metadata.totalMessages = this.currentSession.messages.length;
+        this.currentSession.metadata.updatedAt = new Date();
+        await this.storage.save(this.currentSession);
+    }
+    async updateSessionMetadata(updates) {
+        if (!this.currentSession) {
+            throw new Error('No active session. Create or load a session first.');
+        }
+        Object.assign(this.currentSession.metadata, updates);
+        this.currentSession.metadata.updatedAt = new Date();
+        await this.storage.save(this.currentSession);
+    }
+    async updateSessionContext(context) {
+        if (!this.currentSession) {
+            throw new Error('No active session. Create or load a session first.');
+        }
+        this.currentSession.context = { ...this.currentSession.context, ...context };
+        await this.storage.save(this.currentSession);
+    }
+    getCurrentSession() {
+        return this.currentSession;
+    }
+    getCurrentSessionId() {
+        return this.currentSession?.metadata.id || null;
+    }
+    getMessages() {
+        return this.currentSession?.messages || [];
+    }
+    async listSessions(workingDirectory) {
+        return await this.storage.list(workingDirectory);
+    }
+    async deleteSession(sessionId, workingDirectory) {
+        const deleted = await this.storage.delete(sessionId, workingDirectory);
+        if (deleted && this.currentSession?.metadata.id === sessionId) {
+            this.currentSession = null;
+        }
+        return deleted;
+    }
+    async sessionExists(sessionId, workingDirectory) {
+        return await this.storage.exists(sessionId, workingDirectory);
+    }
+    async cleanup(workingDirectory) {
+        return await this.storage.cleanup(workingDirectory);
+    }
+    clearCurrentSession() {
+        this.currentSession = null;
+    }
+    async generateSessionTitle(maxLength = 50) {
+        if (!this.currentSession || this.currentSession.messages.length === 0) {
+            return null;
+        }
+        const firstUserMessage = this.currentSession.messages.find(m => m.role === 'user');
+        if (!firstUserMessage) {
+            return null;
+        }
+        let content = '';
+        if (typeof firstUserMessage.content === 'string') {
+            content = firstUserMessage.content;
+        }
+        else if (Array.isArray(firstUserMessage.content)) {
+            const textBlocks = firstUserMessage.content.filter(block => block.type === 'text');
+            if (textBlocks.length > 0) {
+                content = textBlocks[0].text;
+            }
+        }
+        if (!content) {
+            return null;
+        }
+        const title = content.length > maxLength
+            ? content.substring(0, maxLength).trim() + '...'
+            : content.trim();
+        await this.updateSessionMetadata({ title });
+        return title;
+    }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=session-manager.js.map

package/dist/session-manager.js.map

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

package/dist/storage/filesystem.d.ts

@@ -0,0 +1,24 @@
+import { SessionStorage, SessionData, SessionListItem, SessionStorageConfig } from '../types/session';
+export declare class FileSystemSessionStorage implements SessionStorage {
+    private baseDirectory;
+    private maxSessions;
+    private autoCleanup;
+    private cleanupAfterDays;
+    constructor(config?: SessionStorageConfig);
+    private sanitizeDirectoryName;
+    private getSessionDirectory;
+    private getSessionFilePath;
+    private ensureDirectoryExists;
+    private readSessionFile;
+    private writeSessionFile;
+    save(sessionData: SessionData): Promise<void>;
+    load(sessionId: string, workingDirectory: string): Promise<SessionData | null>;
+    exists(sessionId: string, workingDirectory: string): Promise<boolean>;
+    list(workingDirectory: string): Promise<SessionListItem[]>;
+    private extractLastMessageContent;
+    delete(sessionId: string, workingDirectory: string): Promise<boolean>;
+    getLatest(workingDirectory: string): Promise<SessionData | null>;
+    cleanup(workingDirectory?: string): Promise<number>;
+    private performCleanup;
+}
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/storage/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/storage/filesystem.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEtG,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,GAAE,oBAAyB;IAO7C,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,kBAAkB;YAIZ,qBAAqB;YAQrB,eAAe;YAiBf,gBAAgB;IASxB,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB7C,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK9E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA+ChE,OAAO,CAAC,yBAAyB;IAkB3B,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcrE,SAAS,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAWhE,OAAO,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAuB3C,cAAc;CA2B7B"}

package/dist/storage/filesystem.js

@@ -0,0 +1,248 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemSessionStorage = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+class FileSystemSessionStorage {
+    constructor(config = {}) {
+        this.baseDirectory = config.baseDirectory || path.join(os.homedir(), '.majk', 'chat-sessions');
+        this.maxSessions = config.maxSessions || 1000;
+        this.autoCleanup = config.autoCleanup ?? true;
+        this.cleanupAfterDays = config.cleanupAfterDays || 90;
+    }
+    sanitizeDirectoryName(dirPath) {
+        return dirPath
+            .replace(/^\/+|\/+$/g, '')
+            .replace(/[^a-zA-Z0-9_\-]/g, '_')
+            .replace(/_+/g, '_')
+            .toLowerCase();
+    }
+    getSessionDirectory(workingDirectory) {
+        const sanitizedName = this.sanitizeDirectoryName(workingDirectory);
+        const homeSanitized = this.sanitizeDirectoryName(os.homedir());
+        let sessionDirName;
+        if (workingDirectory.startsWith(os.homedir())) {
+            const relativePath = path.relative(os.homedir(), workingDirectory);
+            sessionDirName = `home_${this.sanitizeDirectoryName(relativePath)}`;
+        }
+        else {
+            sessionDirName = sanitizedName;
+        }
+        return path.join(this.baseDirectory, sessionDirName);
+    }
+    getSessionFilePath(sessionId, workingDirectory) {
+        return path.join(this.getSessionDirectory(workingDirectory), `${sessionId}.json`);
+    }
+    async ensureDirectoryExists(dirPath) {
+        try {
+            await fs.access(dirPath);
+        }
+        catch {
+            await fs.mkdir(dirPath, { recursive: true });
+        }
+    }
+    async readSessionFile(filePath) {
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const data = JSON.parse(content);
+            data.metadata.createdAt = new Date(data.metadata.createdAt);
+            data.metadata.updatedAt = new Date(data.metadata.updatedAt);
+            return data;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw new Error(`Failed to read session file: ${error}`);
+        }
+    }
+    async writeSessionFile(filePath, sessionData) {
+        try {
+            const content = JSON.stringify(sessionData, null, 2);
+            await fs.writeFile(filePath, content, 'utf-8');
+        }
+        catch (error) {
+            throw new Error(`Failed to write session file: ${error}`);
+        }
+    }
+    async save(sessionData) {
+        const sessionDir = this.getSessionDirectory(sessionData.metadata.workingDirectory);
+        await this.ensureDirectoryExists(sessionDir);
+        const filePath = this.getSessionFilePath(sessionData.metadata.id, sessionData.metadata.workingDirectory);
+        sessionData.metadata.updatedAt = new Date();
+        sessionData.metadata.totalMessages = sessionData.messages.length;
+        await this.writeSessionFile(filePath, sessionData);
+        if (this.autoCleanup) {
+            await this.performCleanup(sessionData.metadata.workingDirectory);
+        }
+    }
+    async load(sessionId, workingDirectory) {
+        const filePath = this.getSessionFilePath(sessionId, workingDirectory);
+        return await this.readSessionFile(filePath);
+    }
+    async exists(sessionId, workingDirectory) {
+        const filePath = this.getSessionFilePath(sessionId, workingDirectory);
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async list(workingDirectory) {
+        const sessionDir = this.getSessionDirectory(workingDirectory);
+        try {
+            await fs.access(sessionDir);
+        }
+        catch {
+            return [];
+        }
+        try {
+            const files = await fs.readdir(sessionDir);
+            const sessionFiles = files.filter(file => file.endsWith('.json'));
+            const sessions = [];
+            for (const file of sessionFiles) {
+                const filePath = path.join(sessionDir, file);
+                try {
+                    const sessionData = await this.readSessionFile(filePath);
+                    if (sessionData) {
+                        const lastMessage = sessionData.messages.length > 0
+                            ? this.extractLastMessageContent(sessionData.messages[sessionData.messages.length - 1])
+                            : undefined;
+                        sessions.push({
+                            id: sessionData.metadata.id,
+                            title: sessionData.metadata.title,
+                            createdAt: sessionData.metadata.createdAt,
+                            updatedAt: sessionData.metadata.updatedAt,
+                            totalMessages: sessionData.metadata.totalMessages,
+                            lastMessage
+                        });
+                    }
+                }
+                catch (error) {
+                    // Skip corrupted or unreadable session files
+                    console.warn(`Skipping corrupted session file: ${file}`);
+                    continue;
+                }
+            }
+            return sessions.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+        }
+        catch (error) {
+            throw new Error(`Failed to list sessions: ${error}`);
+        }
+    }
+    extractLastMessageContent(message) {
+        if (typeof message.content === 'string') {
+            return message.content.length > 100
+                ? message.content.substring(0, 100) + '...'
+                : message.content;
+        }
+        if (Array.isArray(message.content)) {
+            const textBlocks = message.content.filter((block) => block.type === 'text');
+            if (textBlocks.length > 0) {
+                const text = textBlocks[0].text;
+                return text.length > 100 ? text.substring(0, 100) + '...' : text;
+            }
+        }
+        return '[Complex content]';
+    }
+    async delete(sessionId, workingDirectory) {
+        const filePath = this.getSessionFilePath(sessionId, workingDirectory);
+        try {
+            await fs.unlink(filePath);
+            return true;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return false;
+            }
+            throw new Error(`Failed to delete session: ${error}`);
+        }
+    }
+    async getLatest(workingDirectory) {
+        const sessions = await this.list(workingDirectory);
+        if (sessions.length === 0) {
+            return null;
+        }
+        const latest = sessions[0];
+        return await this.load(latest.id, workingDirectory);
+    }
+    async cleanup(workingDirectory) {
+        let cleanedUp = 0;
+        if (workingDirectory) {
+            cleanedUp += await this.performCleanup(workingDirectory);
+        }
+        else {
+            try {
+                const workingDirs = await fs.readdir(this.baseDirectory);
+                for (const dir of workingDirs) {
+                    const fullPath = path.join(this.baseDirectory, dir);
+                    const stats = await fs.stat(fullPath);
+                    if (stats.isDirectory()) {
+                        cleanedUp += await this.performCleanup(fullPath);
+                    }
+                }
+            }
+            catch (error) {
+                // Ignore if base directory doesn't exist
+            }
+        }
+        return cleanedUp;
+    }
+    async performCleanup(workingDirectory) {
+        const cutoffDate = new Date();
+        cutoffDate.setDate(cutoffDate.getDate() - this.cleanupAfterDays);
+        const sessions = await this.list(workingDirectory);
+        let cleanedUp = 0;
+        const sessionsToDelete = sessions.filter(session => session.updatedAt < cutoffDate);
+        if (sessions.length - sessionsToDelete.length > this.maxSessions) {
+            const excessSessions = sessions
+                .slice(this.maxSessions)
+                .filter(session => !sessionsToDelete.includes(session));
+            sessionsToDelete.push(...excessSessions);
+        }
+        for (const session of sessionsToDelete) {
+            if (await this.delete(session.id, workingDirectory)) {
+                cleanedUp++;
+            }
+        }
+        return cleanedUp;
+    }
+}
+exports.FileSystemSessionStorage = FileSystemSessionStorage;
+//# sourceMappingURL=filesystem.js.map

package/dist/storage/filesystem.js.map

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

package/dist/types/session.d.ts

@@ -0,0 +1,40 @@
+import { Message } from '@majkapp/majk-chat-core';
+export interface SessionMetadata {
+    id: string;
+    workingDirectory: string;
+    createdAt: Date;
+    updatedAt: Date;
+    title?: string;
+    provider?: string;
+    model?: string;
+    totalMessages: number;
+}
+export interface SessionData {
+    metadata: SessionMetadata;
+    messages: Message[];
+    context?: Record<string, any>;
+}
+export interface SessionListItem {
+    id: string;
+    title?: string;
+    createdAt: Date;
+    updatedAt: Date;
+    totalMessages: number;
+    lastMessage?: string;
+}
+export interface SessionStorageConfig {
+    baseDirectory?: string;
+    maxSessions?: number;
+    autoCleanup?: boolean;
+    cleanupAfterDays?: number;
+}
+export interface SessionStorage {
+    save(sessionData: SessionData): Promise<void>;
+    load(sessionId: string, workingDirectory: string): Promise<SessionData | null>;
+    exists(sessionId: string, workingDirectory: string): Promise<boolean>;
+    list(workingDirectory: string): Promise<SessionListItem[]>;
+    delete(sessionId: string, workingDirectory: string): Promise<boolean>;
+    getLatest(workingDirectory: string): Promise<SessionData | null>;
+    cleanup(workingDirectory?: string): Promise<number>;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC/E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC3D,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,SAAS,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACjE,OAAO,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrD"}

package/dist/types/session.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=session.js.map

package/dist/types/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@majkapp/majk-chat-sessions",
+  "version": "1.0.0",
+  "description": "Session management for Magic Chat conversations",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "clean": "rm -rf dist",
+    "prepare": "echo 'Use npm run build from root to build all packages'"
+  },
+  "keywords": [
+    "majk-chat",
+    "sessions",
+    "conversation",
+    "storage"
+  ],
+  "author": "Jules White",
+  "license": "MIT",
+  "dependencies": {
+    "@majkapp/majk-chat-core": "file:../majk-chat-core",
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.14.0",
+    "@types/uuid": "^9.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.5",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ]
+}