wave-agent-sdk 0.0.6 → 0.0.8

package/dist/services/memoryStore.js

@@ -0,0 +1,200 @@
+/**
+ * Memory Store Service
+ *
+ * Provides in-memory storage for file content with automatic updates.
+ * Optimizes performance by keeping frequently accessed files in memory.
+ */
+import { promises as fs } from "fs";
+import { EventEmitter } from "events";
+export class MemoryStoreService extends EventEmitter {
+    constructor(logger) {
+        super();
+        this.store = new Map();
+        this.updateCounts = new Map();
+        this.logger = logger;
+    }
+    /**
+     * Get content from memory store (loads from file if not loaded)
+     * Maps to FR-006: Keep AGENTS.md content in memory to avoid repeated reads
+     */
+    async getContent(path) {
+        const entry = this.store.get(path);
+        if (entry && entry.isLoaded) {
+            this.logger?.debug(`Live Config: Memory hit for ${path}`);
+            return entry.content;
+        }
+        // Load from file if not in memory
+        return await this.loadFromFile(path, "initial_load");
+    }
+    /**
+     * Update memory content from file
+     * Maps to FR-007: Update memory content when file changes
+     */
+    async updateContent(path) {
+        const previousEntry = this.store.get(path);
+        const previousSize = previousEntry?.content.length || 0;
+        await this.loadFromFile(path, "file_change", previousSize);
+    }
+    /**
+     * Get memory store statistics
+     * For monitoring and debugging
+     */
+    getStats(path) {
+        if (path) {
+            const entry = this.store.get(path);
+            const updateCount = this.updateCounts.get(path) || 0;
+            return {
+                contentSize: entry?.content.length || 0,
+                lastUpdated: entry?.lastModified || 0,
+                updateCount,
+                isLoaded: entry?.isLoaded || false,
+            };
+        }
+        // Return aggregate stats for all entries
+        let totalSize = 0;
+        let latestUpdate = 0;
+        let totalUpdates = 0;
+        let anyLoaded = false;
+        for (const [entryPath, entry] of this.store) {
+            totalSize += entry.content.length;
+            latestUpdate = Math.max(latestUpdate, entry.lastModified);
+            totalUpdates += this.updateCounts.get(entryPath) || 0;
+            anyLoaded = anyLoaded || entry.isLoaded;
+        }
+        return {
+            contentSize: totalSize,
+            lastUpdated: latestUpdate,
+            updateCount: totalUpdates,
+            isLoaded: anyLoaded,
+        };
+    }
+    /**
+     * Check if content is loaded in memory
+     * For status checking
+     */
+    isLoaded(path) {
+        const entry = this.store.get(path);
+        return entry?.isLoaded || false;
+    }
+    /**
+     * Manually reload content from file
+     * For force refresh scenarios
+     */
+    async reloadContent(path) {
+        const previousEntry = this.store.get(path);
+        const previousSize = previousEntry?.content.length || 0;
+        await this.loadFromFile(path, "manual_reload", previousSize);
+    }
+    /**
+     * Remove content from memory store
+     * For cleanup when file is deleted
+     */
+    removeContent(path) {
+        const removed = this.store.delete(path);
+        this.updateCounts.delete(path);
+        if (removed) {
+            this.logger?.info(`Live Config: Removed ${path} from memory store`);
+        }
+        return removed;
+    }
+    /**
+     * Clear all content from memory store
+     * For cleanup and testing
+     */
+    clear() {
+        const pathCount = this.store.size;
+        this.store.clear();
+        this.updateCounts.clear();
+        if (pathCount > 0) {
+            this.logger?.info(`Live Config: Cleared ${pathCount} entries from memory store`);
+        }
+    }
+    /**
+     * Get all stored paths
+     * For monitoring and debugging
+     */
+    getStoredPaths() {
+        return Array.from(this.store.keys());
+    }
+    /**
+     * Check if file exists and is accessible
+     */
+    async fileExists(path) {
+        try {
+            await fs.access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async loadFromFile(path, reason, previousSize) {
+        try {
+            // Check if file exists
+            const exists = await this.fileExists(path);
+            if (!exists) {
+                // Handle file deletion gracefully
+                const entry = {
+                    content: "",
+                    path,
+                    lastModified: Date.now(),
+                    isLoaded: true,
+                };
+                this.store.set(path, entry);
+                this.incrementUpdateCount(path);
+                this.logger?.info(`Live Config: File ${path} not found, storing empty content`);
+                this.emitUpdateEvent(path, reason, previousSize, 0);
+                return "";
+            }
+            // Read file content
+            const content = await fs.readFile(path, "utf-8");
+            const stats = await fs.stat(path);
+            const entry = {
+                content,
+                path,
+                lastModified: stats.mtime.getTime(),
+                isLoaded: true,
+            };
+            this.store.set(path, entry);
+            this.incrementUpdateCount(path);
+            this.logger?.info(`Live Config: Loaded ${content.length} bytes from ${path} into memory`);
+            this.emitUpdateEvent(path, reason, previousSize, content.length);
+            return content;
+        }
+        catch (error) {
+            const errorMessage = `Live Config: Failed to load ${path} into memory: ${error.message}`;
+            this.logger?.error(errorMessage);
+            // Return existing content if available, otherwise empty string
+            const existingEntry = this.store.get(path);
+            if (existingEntry?.isLoaded) {
+                this.logger?.warn(`Live Config: Using cached content for ${path} due to read error`);
+                return existingEntry.content;
+            }
+            // Store empty content as fallback
+            const entry = {
+                content: "",
+                path,
+                lastModified: Date.now(),
+                isLoaded: true,
+            };
+            this.store.set(path, entry);
+            this.emitUpdateEvent(path, reason, previousSize, 0);
+            return "";
+        }
+    }
+    incrementUpdateCount(path) {
+        const current = this.updateCounts.get(path) || 0;
+        this.updateCounts.set(path, current + 1);
+    }
+    emitUpdateEvent(path, reason, previousSize, newSize) {
+        const event = {
+            path,
+            reason,
+            timestamp: Date.now(),
+            previousSize,
+            newSize,
+        };
+        this.emit("memoryUpdate", event);
+        this.logger?.debug(`Live Config: Memory update event for ${path}: ${reason}`);
+    }
+}

package/dist/services/session.d.ts

@@ -1,8 +1,6 @@
 import type { Message } from "../types/index.js";
 export interface SessionData {
     id: string;
-    timestamp: string;
-    version: string;
     messages: Message[];
     metadata: {
         workdir: string;
@@ -13,91 +11,108 @@ export interface SessionData {
 }
 export interface SessionMetadata {
     id: string;
-    timestamp: string;
+    sessionType: "main" | "subagent";
+    parentSessionId?: string;
+    subagentType?: string;
     workdir: string;
-    startedAt: string;
-    lastActiveAt: string;
+    startedAt: Date;
+    lastActiveAt: Date;
     latestTotalTokens: number;
 }
 /**
- * Resolve session directory path with fallback to default
- * @param sessionDir Optional custom session directory
- * @returns Resolved session directory path
+ * Generate a new UUIDv6-based session ID
+ * @returns UUIDv6 string for time-ordered sessions
  */
-export declare function resolveSessionDir(sessionDir?: string): string;
+export declare function generateSessionId(): string;
+export declare const SESSION_DIR: string;
 /**
  * Ensure session directory exists
- * @param sessionDir Optional custom session directory
  */
-export declare function ensureSessionDir(sessionDir?: string): Promise<void>;
+export declare function ensureSessionDir(): Promise<void>;
 /**
- * Generate session file path
+ * Generate session file path using project-based directory structure
+ * Note: With metadata-based approach, we no longer need separate subagent directories
+ * @param sessionId - UUIDv6 session identifier
+ * @param workdir - Working directory for the session
+ * @returns Promise resolving to full file path for the session JSONL file
+ */
+export declare function getSessionFilePath(sessionId: string, workdir: string): Promise<string>;
+/**
+ * Create a new session with metadata
+ * @param sessionId - UUIDv6 session identifier
+ * @param workdir - Working directory for the session
+ * @param sessionType - Type of session ('main' or 'subagent')
+ * @param parentSessionId - Parent session ID for subagent sessions
+ * @param subagentType - Type of subagent for subagent sessions
  */
-export declare function getSessionFilePath(sessionId: string, sessionDir?: string): string;
+export declare function createSession(sessionId: string, workdir: string, sessionType?: "main" | "subagent", parentSessionId?: string, subagentType?: string): Promise<void>;
 /**
- * Save session data to storage
+ * Append messages to session using JSONL format (new approach)
  *
- * @param sessionId - Unique identifier for the session
- * @param messages - Array of messages to save
+ * @param sessionId - UUIDv6 session identifier
+ * @param newMessages - Array of messages to append
  * @param workdir - Working directory for the session
- * @param latestTotalTokens - Total tokens used in the session
- * @param startedAt - ISO timestamp when session started (defaults to current time)
- * @param sessionDir - Optional custom directory for session storage (defaults to ~/.wave/sessions/)
- * @throws {Error} When session cannot be saved due to permission or disk space issues
  */
-export declare function saveSession(sessionId: string, messages: Message[], workdir: string, latestTotalTokens?: number, startedAt?: string, sessionDir?: string): Promise<void>;
+export declare function appendMessages(sessionId: string, newMessages: Message[], workdir: string): Promise<void>;
 /**
- * Load session data from storage
+ * Load session data from JSONL file (new approach)
  *
- * @param sessionId - Unique identifier for the session to load
- * @param sessionDir - Optional custom directory for session storage (defaults to ~/.wave/sessions/)
+ * @param sessionId - UUIDv6 session identifier
+ * @param workdir - Working directory for the session
  * @returns Promise that resolves to session data or null if session doesn't exist
- * @throws {Error} When session exists but cannot be read or contains invalid data
  */
-export declare function loadSession(sessionId: string, sessionDir?: string): Promise<SessionData | null>;
+export declare function loadSessionFromJsonl(sessionId: string, workdir: string): Promise<SessionData | null>;
+/**
+ * Get the most recently active session for a specific working directory (new JSONL approach)
+ * Only returns main sessions, skips subagent sessions
+ * Sessions are sorted by last active time (most recently active first)
+ *
+ * @param workdir - Working directory to find the most recently active session for
+ * @returns Promise that resolves to the most recently active session data or null if no sessions exist
+ */
+export declare function getLatestSessionFromJsonl(workdir: string): Promise<SessionData | null>;
 /**
- * Get the most recent session for a specific working directory
+ * List all sessions for a specific working directory (convenience wrapper)
+ * Only returns main sessions, skips subagent sessions
  *
- * @param workdir - Working directory to find the most recent session for
- * @param sessionDir - Optional custom directory for session storage (defaults to ~/.wave/sessions/)
- * @returns Promise that resolves to the most recent session data or null if no sessions exist
- * @throws {Error} When session directory cannot be accessed or session data is corrupted
+ * @param workdir - Working directory to filter sessions by
+ * @returns Promise that resolves to array of session metadata objects
  */
-export declare function getLatestSession(workdir: string, sessionDir?: string): Promise<SessionData | null>;
+export declare function listSessions(workdir: string): Promise<SessionMetadata[]>;
 /**
- * List all sessions for a specific working directory or across all working directories
+ * List all sessions for a specific working directory using JSONL format (new approach)
  *
  * @param workdir - Working directory to filter sessions by
  * @param includeAllWorkdirs - If true, returns sessions from all working directories
- * @param sessionDir - Optional custom directory for session storage (defaults to ~/.wave/sessions/)
+ * @param includeSubagentSessions - If true, includes subagent sessions (default: false for user-facing operations)
  * @returns Promise that resolves to array of session metadata objects
- * @throws {Error} When session directory cannot be accessed or read
  */
-export declare function listSessions(workdir: string, includeAllWorkdirs?: boolean, sessionDir?: string): Promise<SessionMetadata[]>;
+export declare function listSessionsFromJsonl(workdir: string, includeAllWorkdirs?: boolean, includeSubagentSessions?: boolean): Promise<SessionMetadata[]>;
 /**
- * Delete a session from storage
+ * Delete a session from JSONL storage (new approach)
  *
- * @param sessionId - Unique identifier for the session to delete
- * @param sessionDir - Optional custom directory for session storage (defaults to ~/.wave/sessions/)
+ * @param sessionId - UUIDv6 session identifier
+ * @param workdir - Working directory for the session
  * @returns Promise that resolves to true if session was deleted, false if it didn't exist
- * @throws {Error} When session exists but cannot be deleted due to permission issues
  */
-export declare function deleteSession(sessionId: string, sessionDir?: string): Promise<boolean>;
+export declare function deleteSessionFromJsonl(sessionId: string, workdir: string): Promise<boolean>;
 /**
- * Clean up expired sessions older than the configured maximum age
+ * Clean up expired sessions older than 14 days based on file modification time
  *
  * @param workdir - Working directory to clean up sessions for
- * @param sessionDir - Optional custom directory for session storage (defaults to ~/.wave/sessions/)
  * @returns Promise that resolves to the number of sessions that were deleted
- * @throws {Error} When session directory cannot be accessed or sessions cannot be deleted
  */
-export declare function cleanupExpiredSessions(workdir: string, sessionDir?: string): Promise<number>;
+export declare function cleanupExpiredSessionsFromJsonl(workdir: string): Promise<number>;
 /**
- * Check if a session exists in storage
+ * Clean up empty project directories in the session directory
+ */
+export declare function cleanupEmptyProjectDirectories(): Promise<void>;
+/**
+ * Check if a session exists in JSONL storage (new approach)
  *
- * @param sessionId - Unique identifier for the session to check
- * @param sessionDir - Optional custom directory for session storage (defaults to ~/.wave/sessions/)
+ * @param sessionId - UUIDv6 session identifier
+ * @param workdir - Working directory for the session
  * @returns Promise that resolves to true if session exists, false otherwise
  */
-export declare function sessionExists(sessionId: string, sessionDir?: string): Promise<boolean>;
+export declare function sessionExistsInJsonl(sessionId: string, workdir: string): Promise<boolean>;
 //# sourceMappingURL=session.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/services/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAOD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAIR;AAcD;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,iBAAiB,GAAE,MAAU,EAC7B,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAmB7B;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAa7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,kBAAkB,UAAQ,EAC1B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,EAAE,CAAC,CA4C5B;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CASlB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/services/session.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAMjD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,IAAI,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAGD,eAAO,MAAM,WAAW,QAAuC,CAAC;AAGhE;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAM,GAAG,UAAmB,EACzC,eAAe,CAAC,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO,EAAE,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAuD7B;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAY7B;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,kBAAkB,UAAQ,EAC1B,uBAAuB,UAAQ,GAC9B,OAAO,CAAC,eAAe,EAAE,CAAC,CAuI5B;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CA2BlB;AAED;;;;;GAKG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAsDjB;AAED;;GAEG;AACH,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,IAAI,CAAC,CA+BpE;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAQlB"}