@ebowwa/coder 0.2.1 → 0.7.64

package/dist/core/sessions/index.js

@@ -0,0 +1,442 @@
+/**
+ * Session Store - Composable session management
+ * Composes persistence, metadata, and export modules
+ */
+import { homedir } from "os";
+import { join } from "path";
+import { SessionPersistence } from "./persistence.js";
+import { SessionMetadataManager } from "./metadata.js";
+import { SessionExporter } from "./export.js";
+// Re-export types for convenience
+export * from "./types.js";
+export { SessionPersistence } from "./persistence.js";
+export { SessionMetadataManager } from "./metadata.js";
+export { SessionExporter } from "./export.js";
+/**
+ * Main SessionStore class
+ * Composes persistence, metadata, and export functionality
+ */
+export class SessionStore {
+    persistence;
+    metadataManager;
+    exporter;
+    currentSessionId = null;
+    currentMetadata = null;
+    eventHandlers = new Set();
+    constructor(sessionsDir) {
+        const dir = sessionsDir ?? join(homedir(), ".claude", "sessions");
+        this.persistence = new SessionPersistence(dir);
+        this.metadataManager = new SessionMetadataManager(this.persistence);
+        this.exporter = new SessionExporter(this.persistence);
+    }
+    // ============================================
+    // INITIALIZATION
+    // ============================================
+    /**
+     * Initialize the sessions directory
+     */
+    async init() {
+        await this.persistence.init();
+    }
+    /**
+     * Get the sessions directory path
+     */
+    getSessionsDir() {
+        return this.persistence.getSessionsDir();
+    }
+    /**
+     * Get the file path for a specific session
+     */
+    getSessionPath(sessionId) {
+        return this.persistence.getSessionPath(sessionId);
+    }
+    // ============================================
+    // EVENT HANDLING
+    // ============================================
+    /**
+     * Subscribe to session events
+     */
+    onEvent(handler) {
+        this.eventHandlers.add(handler);
+        return () => this.eventHandlers.delete(handler);
+    }
+    /**
+     * Emit a session event
+     */
+    async emit(type) {
+        const event = { ...type, timestamp: type.timestamp ?? Date.now() };
+        await Promise.all([...this.eventHandlers].map((handler) => handler(event)));
+    }
+    // ============================================
+    // SESSION CREATION & MANAGEMENT
+    // ============================================
+    /**
+     * Create a new session (or reuse existing empty session)
+     */
+    async createSession(options) {
+        await this.init();
+        // Try to find an existing empty session to reuse
+        const sessions = await this.listSessions(20);
+        const emptySession = sessions.find((s) => s.messageCount === 0);
+        if (emptySession) {
+            // Reuse the empty session
+            this.currentSessionId = emptySession.id;
+            this.currentMetadata = this.metadataManager.createMetadata({
+                id: emptySession.id,
+                ...options,
+            });
+            await this.persistence.append(emptySession.id, this.currentMetadata);
+            await this.emit({
+                type: "resumed",
+                sessionId: emptySession.id,
+                timestamp: Date.now(),
+                data: { reused: true },
+            });
+            return emptySession.id;
+        }
+        // No empty session found, create new
+        const sessionId = this.metadataManager.generateId();
+        this.currentSessionId = sessionId;
+        this.currentMetadata = this.metadataManager.createMetadata({
+            id: sessionId,
+            ...options,
+        });
+        await this.persistence.append(sessionId, this.currentMetadata);
+        // Write context entry
+        const context = {
+            type: "context",
+            timestamp: Date.now(),
+            workingDirectory: options.workingDirectory,
+        };
+        await this.persistence.append(sessionId, context);
+        await this.emit({
+            type: "created",
+            sessionId,
+            timestamp: Date.now(),
+            data: this.currentMetadata,
+        });
+        return sessionId;
+    }
+    /**
+     * Resume an existing session
+     */
+    async resumeSession(sessionId) {
+        const entries = await this.persistence.read(sessionId);
+        if (entries.length === 0) {
+            return null;
+        }
+        const session = this.parseEntries(entries);
+        session.metadata.id = sessionId; // Ensure ID is set
+        this.currentSessionId = sessionId;
+        this.currentMetadata = session.metadata;
+        await this.emit({
+            type: "resumed",
+            sessionId,
+            timestamp: Date.now(),
+            data: session.metadata,
+        });
+        return session;
+    }
+    /**
+     * Parse session entries into structured session
+     */
+    parseEntries(entries) {
+        let metadata = null;
+        const messages = [];
+        const tools = [];
+        const metrics = [];
+        let context = null;
+        const checkpoints = [];
+        for (const entry of entries) {
+            // All entries have explicit type field now
+            switch (entry.type) {
+                case "metadata":
+                    metadata = entry;
+                    break;
+                case "message":
+                    messages.push(entry.data);
+                    break;
+                case "tool_use":
+                    tools.push(entry);
+                    break;
+                case "metrics":
+                    metrics.push(entry.data);
+                    break;
+                case "context":
+                    context = entry;
+                    break;
+                case "checkpoint":
+                    checkpoints.push(entry);
+                    break;
+            }
+        }
+        if (!metadata) {
+            metadata = this.metadataManager.createMetadata({
+                model: "claude-sonnet-4-6",
+                workingDirectory: process.cwd(),
+            });
+        }
+        return {
+            metadata,
+            messages,
+            tools,
+            metrics,
+            context,
+            checkpoints,
+        };
+    }
+    /**
+     * Delete a session
+     */
+    async deleteSession(sessionId) {
+        const deleted = await this.persistence.delete(sessionId);
+        if (deleted) {
+            await this.emit({
+                type: "deleted",
+                sessionId,
+                timestamp: Date.now(),
+            });
+            if (this.currentSessionId === sessionId) {
+                this.currentSessionId = null;
+                this.currentMetadata = null;
+            }
+        }
+        return deleted;
+    }
+    // ============================================
+    // DATA SAVING
+    // ============================================
+    /**
+     * Save a message to the current session
+     */
+    async saveMessage(message) {
+        if (!this.currentSessionId) {
+            throw new Error("No active session");
+        }
+        const entry = {
+            type: "message",
+            timestamp: Date.now(),
+            data: message,
+        };
+        await this.persistence.append(this.currentSessionId, entry);
+        await this.emit({
+            type: "message_saved",
+            sessionId: this.currentSessionId,
+            timestamp: Date.now(),
+            data: message,
+        });
+    }
+    /**
+     * Save a tool use to the current session
+     */
+    async saveToolUse(toolId, toolName, input, result, isError) {
+        if (!this.currentSessionId) {
+            throw new Error("No active session");
+        }
+        const entry = {
+            type: "tool_use",
+            timestamp: Date.now(),
+            toolId,
+            toolName,
+            input,
+            result,
+            isError,
+        };
+        await this.persistence.append(this.currentSessionId, entry);
+    }
+    /**
+     * Save metrics to the current session
+     */
+    async saveMetrics(metrics) {
+        if (!this.currentSessionId) {
+            throw new Error("No active session");
+        }
+        const entry = {
+            type: "metrics",
+            timestamp: Date.now(),
+            data: metrics,
+        };
+        await this.persistence.append(this.currentSessionId, entry);
+        // Update running totals in metadata
+        if (this.currentMetadata) {
+            this.currentMetadata.totalCost =
+                (this.currentMetadata.totalCost ?? 0) + metrics.costUSD;
+            this.currentMetadata.totalTokens = {
+                input: (this.currentMetadata.totalTokens?.input ?? 0) +
+                    metrics.usage.input_tokens,
+                output: (this.currentMetadata.totalTokens?.output ?? 0) +
+                    metrics.usage.output_tokens,
+            };
+        }
+        await this.emit({
+            type: "metrics_saved",
+            sessionId: this.currentSessionId,
+            timestamp: Date.now(),
+            data: metrics,
+        });
+    }
+    // ============================================
+    // LISTING & QUERYING
+    // ============================================
+    /**
+     * List recent sessions
+     */
+    async listSessions(limit = 20, filter) {
+        await this.init();
+        const files = await this.persistence.listFiles();
+        // Get modification times for sorting
+        const modTimes = await this.persistence.getModificationTimes(files);
+        // Sort by modification time (newest first)
+        const sortedFiles = files.sort((a, b) => {
+            const timeA = modTimes.get(a)?.getTime() ?? 0;
+            const timeB = modTimes.get(b)?.getTime() ?? 0;
+            return timeB - timeA;
+        });
+        // Parse summaries
+        const sessions = [];
+        for (const sessionId of sortedFiles.slice(0, limit * 2)) {
+            const summary = await this.metadataManager.getSummary(sessionId);
+            if (summary) {
+                sessions.push(summary);
+            }
+        }
+        // Apply filter if provided
+        const filtered = filter
+            ? this.metadataManager.filterSessions(sessions, filter)
+            : sessions;
+        // Sort by last activity
+        const sorted = this.metadataManager.sortSessions(filtered, "lastActivity", "desc");
+        return sorted.slice(0, limit);
+    }
+    /**
+     * Get session summary by ID
+     */
+    async getSessionSummary(sessionId) {
+        return this.metadataManager.getSummary(sessionId);
+    }
+    /**
+     * Find empty sessions
+     */
+    async findEmptySessions() {
+        const sessions = await this.listSessions(100);
+        return this.metadataManager.findEmptySessions(sessions);
+    }
+    /**
+     * Clean up empty sessions (delete them)
+     */
+    async cleanupEmptySessions() {
+        const empty = await this.findEmptySessions();
+        let deleted = 0;
+        for (const session of empty) {
+            // Don't delete the current session even if empty
+            if (session.id === this.currentSessionId) {
+                continue;
+            }
+            const success = await this.deleteSession(session.id);
+            if (success) {
+                deleted++;
+            }
+        }
+        return deleted;
+    }
+    // ============================================
+    // EXPORT
+    // ============================================
+    /**
+     * Export session to a file
+     */
+    async exportSession(sessionId, format, outputPath) {
+        const session = await this.resumeSession(sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${sessionId}`);
+        }
+        let content;
+        let defaultExt;
+        switch (format) {
+            case "jsonl": {
+                const sessionFile = this.persistence.getSessionPath(sessionId);
+                content = await Bun.file(sessionFile).text();
+                defaultExt = "jsonl";
+                break;
+            }
+            case "json": {
+                content = this.exporter.export(session, "json");
+                defaultExt = "json";
+                break;
+            }
+            case "markdown": {
+                content = this.exporter.export(session, "markdown");
+                defaultExt = "md";
+                break;
+            }
+            default:
+                throw new Error(`Unsupported format: ${format}`);
+        }
+        const finalPath = outputPath ?? join(process.cwd(), `session-${sessionId}.${defaultExt}`);
+        await Bun.write(finalPath, content);
+        return finalPath;
+    }
+    // ============================================
+    // CURRENT SESSION ACCESSORS
+    // ============================================
+    /**
+     * Get the current session ID
+     */
+    getCurrentSessionId() {
+        return this.currentSessionId;
+    }
+    /**
+     * Get the current session metadata
+     */
+    getCurrentMetadata() {
+        return this.currentMetadata;
+    }
+    /**
+     * Update current session metadata
+     */
+    updateMetadata(updates) {
+        if (this.currentMetadata) {
+            this.currentMetadata = this.metadataManager.merge(this.currentMetadata, updates);
+        }
+    }
+    // ============================================
+    // UTILITY
+    // ============================================
+    /**
+     * Check if a session exists
+     */
+    async sessionExists(sessionId) {
+        return this.persistence.exists(sessionId);
+    }
+    /**
+     * Get session statistics
+     */
+    async getStats() {
+        const sessions = await this.listSessions(1000);
+        const stats = this.metadataManager.calculateStats(sessions);
+        const empty = this.metadataManager.findEmptySessions(sessions);
+        return {
+            totalSessions: stats.totalSessions,
+            totalMessages: stats.totalMessages,
+            totalCost: stats.totalCost,
+            emptySessions: empty.length,
+        };
+    }
+}
+// ============================================
+// HELPER FUNCTIONS (for CLI compatibility)
+// ============================================
+/**
+ * Format a session summary for display
+ */
+export function formatSessionSummary(session) {
+    return SessionExporter.formatSummary(session);
+}
+/**
+ * Print sessions list for CLI
+ */
+export function printSessionsList(sessions) {
+    SessionExporter.printList(sessions);
+}
+// Default export for convenience
+export default SessionStore;

package/dist/core/sessions/metadata.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Session Metadata - Manage session metadata and summaries
+ */
+import type { SessionMetadata, SessionSummary, SessionEntry, SessionFilter } from "./types.js";
+import { SessionPersistence } from "./persistence.js";
+export declare class SessionMetadataManager {
+    private persistence;
+    constructor(persistence: SessionPersistence);
+    /**
+     * Generate a new session ID
+     */
+    generateId(): string;
+    /**
+     * Create metadata for a new session
+     */
+    createMetadata(options: {
+        id?: string;
+        model: string;
+        workingDirectory: string;
+        agentName?: string;
+        agentColor?: string;
+        teamName?: string;
+    }): SessionMetadata;
+    /**
+     * Update metadata timestamps
+     */
+    touch(metadata: SessionMetadata): SessionMetadata;
+    /**
+     * Merge updated fields into metadata
+     */
+    merge(metadata: SessionMetadata, updates: Partial<SessionMetadata>): SessionMetadata;
+    /**
+     * Get summary from session entries
+     */
+    getSummary(sessionId: string): Promise<SessionSummary | null>;
+    /**
+     * Convert entries to summary
+     */
+    entriesToSummary(sessionId: string, entries: SessionEntry[]): SessionSummary | null;
+    /**
+     * Filter sessions based on criteria
+     */
+    filterSessions(sessions: SessionSummary[], filter: SessionFilter): SessionSummary[];
+    /**
+     * Sort sessions by various criteria
+     */
+    sortSessions(sessions: SessionSummary[], sortBy?: "created" | "updated" | "lastActivity" | "messageCount" | "cost", order?: "asc" | "desc"): SessionSummary[];
+    /**
+     * Find empty sessions (no messages)
+     */
+    findEmptySessions(sessions: SessionSummary[]): SessionSummary[];
+    /**
+     * Find sessions by partial ID match
+     */
+    findById(sessions: SessionSummary[], partialId: string): SessionSummary | undefined;
+    /**
+     * Get unique models from sessions
+     */
+    getUniqueModels(sessions: SessionSummary[]): string[];
+    /**
+     * Get unique working directories from sessions
+     */
+    getUniqueDirectories(sessions: SessionSummary[]): string[];
+    /**
+     * Calculate aggregate statistics
+     */
+    calculateStats(sessions: SessionSummary[]): {
+        totalSessions: number;
+        totalMessages: number;
+        totalCost: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        averageMessagesPerSession: number;
+        averageCostPerSession: number;
+    };
+}
+//# sourceMappingURL=metadata.d.ts.map

package/dist/core/sessions/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../packages/src/core/sessions/metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,YAAY,EAGZ,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,WAAW,CAAqB;gBAE5B,WAAW,EAAE,kBAAkB;IAI3C;;OAEG;IACH,UAAU,IAAI,MAAM;IAMpB;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE;QACtB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,eAAe;IAgBnB;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe;IAOjD;;OAEG;IACH,KAAK,CACH,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,eAAe;IAQlB;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAKnE;;OAEG;IACH,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EAAE,GACtB,cAAc,GAAG,IAAI;IAyExB;;OAEG;IACH,cAAc,CACZ,QAAQ,EAAE,cAAc,EAAE,EAC1B,MAAM,EAAE,aAAa,GACpB,cAAc,EAAE;IAqCnB;;OAEG;IACH,YAAY,CACV,QAAQ,EAAE,cAAc,EAAE,EAC1B,MAAM,GAAE,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,GAAG,MAAuB,EACzF,KAAK,GAAE,KAAK,GAAG,MAAe,GAC7B,cAAc,EAAE;IA0BnB;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;IAI/D;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAInF;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE;IAKrD;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE;IAK1D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG;QAC1C,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,yBAAyB,EAAE,MAAM,CAAC;QAClC,qBAAqB,EAAE,MAAM,CAAC;KAC/B;CAuBF"}