wave-agent-sdk 0.0.8 → 0.0.11

package/dist/services/configurationWatcher.js

@@ -1,439 +0,0 @@
-/**
- * Configuration Watcher Service
- *
- * Orchestrates live configuration reload functionality by coordinating file watching,
- * configuration validation, and error recovery. Provides automatic reload of settings.json
- * changes without restart.
- */
-import { EventEmitter } from "events";
-import { existsSync } from "fs";
-import { FileWatcherService } from "./fileWatcher.js";
-import { loadMergedWaveConfigWithFallback } from "./hook.js";
-import { isValidHookEvent, isValidHookEventConfig } from "../types/hooks.js";
-import { CONFIGURATION_EVENTS, FILE_WATCHER_EVENTS, } from "../constants/events.js";
-export class ConfigurationWatcher extends EventEmitter {
-    constructor(workdir, logger) {
-        super();
-        this.currentConfiguration = null;
-        this.lastValidConfiguration = null;
-        this.isWatching = false;
-        this.reloadInProgress = false;
-        this.workdir = workdir;
-        this.logger = logger;
-        this.fileWatcher = new FileWatcherService(logger);
-        this.setupFileWatcherEvents();
-    }
-    /**
-     * Initialize configuration watching
-     * Maps to FR-004: System MUST watch settings.json files
-     * Supports watching multiple file paths (e.g., settings.local.json and settings.json)
-     */
-    async initializeWatching(userPaths, projectPaths) {
-        try {
-            this.logger?.info("Live Config: Initializing configuration watching...");
-            this.userConfigPaths = userPaths;
-            this.projectConfigPaths = projectPaths;
-            // Load initial configuration
-            await this.reloadConfiguration();
-            // Start watching user configs that exist
-            for (const userPath of userPaths) {
-                if (existsSync(userPath)) {
-                    this.logger?.debug(`Live Config: Starting to watch user config: ${userPath}`);
-                    await this.fileWatcher.watchFile(userPath, (event) => this.handleFileChange(event, "user"));
-                }
-                else {
-                    this.logger?.debug(`Live Config: User config file does not exist: ${userPath}`);
-                }
-            }
-            // Start watching project configs that exist
-            if (projectPaths) {
-                for (const projectPath of projectPaths) {
-                    if (existsSync(projectPath)) {
-                        this.logger?.debug(`Live Config: Starting to watch project config: ${projectPath}`);
-                        await this.fileWatcher.watchFile(projectPath, (event) => this.handleFileChange(event, "project"));
-                    }
-                    else {
-                        this.logger?.debug(`Live Config: Project config file does not exist: ${projectPath}`);
-                    }
-                }
-            }
-            this.isWatching = true;
-            this.logger?.info("Live Config: Configuration watching initialized successfully");
-        }
-        catch (error) {
-            const errorMessage = `Failed to initialize configuration watching: ${error.message}`;
-            this.logger?.error(`Live Config: ${errorMessage}`);
-            throw new Error(errorMessage);
-        }
-    }
-    /**
-     * Reload configuration from files
-     * Maps to FR-008: Continue with previous valid configuration on errors
-     */
-    async reloadConfiguration() {
-        if (this.reloadInProgress) {
-            this.logger?.debug("Live Config: Reload already in progress, skipping");
-            return this.currentConfiguration || {};
-        }
-        this.reloadInProgress = true;
-        try {
-            this.logger?.debug("Live Config: Reloading configuration from files...");
-            // Load merged configuration with fallback support
-            const loadResult = loadMergedWaveConfigWithFallback(this.workdir, this.lastValidConfiguration);
-            const newConfig = loadResult.config;
-            const timestamp = Date.now();
-            // Check for errors during loading
-            if (loadResult.errors.length > 0) {
-                const errorMessage = `Configuration load errors: ${loadResult.errors.join("; ")}`;
-                this.logger?.error(`Live Config: ${errorMessage}`);
-                // Emit error event
-                this.emit(CONFIGURATION_EVENTS.CONFIGURATION_CHANGE, {
-                    type: "settings_changed",
-                    path: this.getFirstExistingProjectPath() ||
-                        this.getFirstExistingUserPath() ||
-                        "unknown",
-                    timestamp,
-                    changes: { added: [], modified: [], removed: [] },
-                    isValid: false,
-                    errorMessage,
-                });
-                // Use fallback configuration if available
-                if (loadResult.usedFallback && this.lastValidConfiguration) {
-                    this.logger?.warn("Live Config: Using previous valid configuration due to load errors");
-                    this.currentConfiguration = this.lastValidConfiguration;
-                    return this.currentConfiguration;
-                }
-                else {
-                    this.logger?.warn("Live Config: No previous valid configuration available, using empty config");
-                    this.currentConfiguration = {};
-                    return this.currentConfiguration;
-                }
-            }
-            // Validate new configuration if it exists
-            if (newConfig) {
-                const validation = this.validateConfiguration(newConfig);
-                if (!validation.valid) {
-                    const errorMessage = `Invalid configuration: ${validation.errors.join(", ")}`;
-                    this.logger?.error(`Live Config: ${errorMessage}`);
-                    // Emit error event but continue with previous valid config
-                    this.emit(CONFIGURATION_EVENTS.CONFIGURATION_CHANGE, {
-                        type: "settings_changed",
-                        path: this.getFirstExistingProjectPath() ||
-                            this.getFirstExistingUserPath() ||
-                            "unknown",
-                        timestamp,
-                        changes: { added: [], modified: [], removed: [] },
-                        isValid: false,
-                        errorMessage,
-                    });
-                    // Use previous valid configuration for error recovery
-                    if (this.lastValidConfiguration) {
-                        this.logger?.warn("Live Config: Using previous valid configuration due to validation errors");
-                        this.currentConfiguration = this.lastValidConfiguration;
-                        return this.currentConfiguration;
-                    }
-                    else {
-                        this.logger?.warn("Live Config: No previous valid configuration available, using empty config");
-                        this.currentConfiguration = {};
-                        return this.currentConfiguration;
-                    }
-                }
-            }
-            // Detect changes between old and new configuration
-            const changes = this.detectChanges(this.currentConfiguration, newConfig);
-            // Update current configuration
-            this.currentConfiguration = newConfig || {};
-            // Save as last valid configuration if it's valid and not empty
-            if (newConfig && (newConfig.hooks || newConfig.env)) {
-                this.lastValidConfiguration = { ...newConfig };
-            }
-            this.logger?.info(`Live Config: Configuration reloaded successfully with ${Object.keys(newConfig?.hooks || {}).length} event types and ${Object.keys(newConfig?.env || {}).length} environment variables`);
-            // Emit configuration change event
-            this.emit(CONFIGURATION_EVENTS.CONFIGURATION_CHANGE, {
-                type: "settings_changed",
-                path: this.getFirstExistingProjectPath() ||
-                    this.getFirstExistingUserPath() ||
-                    "merged",
-                timestamp,
-                changes,
-                isValid: true,
-            });
-            return this.currentConfiguration;
-        }
-        catch (error) {
-            const errorMessage = `Failed to reload configuration: ${error.message}`;
-            this.logger?.error(`Live Config: ${errorMessage}`);
-            // Use previous valid configuration for error recovery
-            if (this.lastValidConfiguration) {
-                this.logger?.warn("Live Config: Using previous valid configuration due to reload error");
-                this.currentConfiguration = this.lastValidConfiguration;
-            }
-            else {
-                this.logger?.warn("Live Config: No previous valid configuration available, using empty config");
-                this.currentConfiguration = {};
-            }
-            // Emit error event
-            this.emit(CONFIGURATION_EVENTS.CONFIGURATION_CHANGE, {
-                type: "settings_changed",
-                path: "reload-error",
-                timestamp: Date.now(),
-                changes: { added: [], modified: [], removed: [] },
-                isValid: false,
-                errorMessage,
-            });
-            return this.currentConfiguration;
-        }
-        finally {
-            this.reloadInProgress = false;
-        }
-    }
-    /**
-     * Get current effective configuration
-     * Maps to FR-002: Merged configuration with project precedence
-     */
-    getCurrentConfiguration() {
-        return this.currentConfiguration ? { ...this.currentConfiguration } : null;
-    }
-    /**
-     * Validate environment variables
-     * Maps to FR-003: Validate env field format
-     */
-    validateEnvironmentVariables(env) {
-        const errors = [];
-        const warnings = [];
-        if (typeof env !== "object" || env === null) {
-            errors.push("Environment variables must be an object");
-            return { isValid: false, errors, warnings };
-        }
-        if (Array.isArray(env)) {
-            errors.push("Environment variables cannot be an array");
-            return { isValid: false, errors, warnings };
-        }
-        for (const [key, value] of Object.entries(env)) {
-            // Validate key format
-            if (typeof key !== "string" || key.trim() === "") {
-                errors.push(`Invalid environment variable key: '${key}' (must be non-empty string)`);
-                continue;
-            }
-            // Validate key naming convention (optional warning)
-            if (!/^[A-Z_][A-Z0-9_]*$/i.test(key)) {
-                warnings.push(`Environment variable '${key}' doesn't follow conventional naming (A-Z, 0-9, underscore)`);
-            }
-            // Validate value type
-            if (typeof value !== "string") {
-                errors.push(`Environment variable '${key}' must have a string value (got ${typeof value})`);
-            }
-        }
-        return {
-            isValid: errors.length === 0,
-            errors,
-            warnings,
-        };
-    }
-    /**
-     * Stop watching and cleanup resources
-     * Maps to cleanup requirements
-     */
-    async shutdown() {
-        this.logger?.info("Live Config: Shutting down configuration watcher...");
-        this.isWatching = false;
-        try {
-            await this.fileWatcher.cleanup();
-            this.removeAllListeners();
-            this.logger?.info("Live Config: Configuration watcher shutdown completed");
-        }
-        catch (error) {
-            this.logger?.error(`Live Config: Error during shutdown: ${error.message}`);
-            throw error;
-        }
-    }
-    /**
-     * Watch an additional file (like AGENTS.md) for changes
-     * Maps to T033: Add AGENTS.md file watching to HookManager
-     */
-    async watchAdditionalFile(filePath, callback) {
-        try {
-            await this.fileWatcher.watchFile(filePath, callback);
-            this.logger?.info(`Live Config: Started watching additional file: ${filePath}`);
-        }
-        catch (error) {
-            this.logger?.error(`Live Config: Failed to watch additional file ${filePath}: ${error.message}`);
-            throw error;
-        }
-    }
-    /**
-     * Stop watching an additional file
-     */
-    async unwatchAdditionalFile(filePath) {
-        try {
-            await this.fileWatcher.unwatchFile(filePath);
-            this.logger?.info(`Live Config: Stopped watching additional file: ${filePath}`);
-        }
-        catch (error) {
-            this.logger?.warn(`Live Config: Failed to stop watching file ${filePath}: ${error.message}`);
-        }
-    }
-    /**
-     * Check if watching is active
-     */
-    isWatchingActive() {
-        return this.isWatching;
-    }
-    /**
-     * Get watcher status for monitoring
-     */
-    getWatcherStatus() {
-        const statuses = this.fileWatcher.getAllWatcherStatuses();
-        return {
-            isActive: this.isWatching,
-            configurationLoaded: this.currentConfiguration !== null,
-            hasValidConfiguration: this.lastValidConfiguration !== null,
-            reloadInProgress: this.reloadInProgress,
-            watchedFiles: statuses.map((s) => ({
-                path: s.path,
-                isActive: s.isActive,
-                method: s.method,
-                errorCount: s.errorCount,
-            })),
-        };
-    }
-    setupFileWatcherEvents() {
-        this.fileWatcher.on("watcherError", (error) => {
-            this.logger?.error(`Live Config: File watcher error: ${error.message}`);
-            this.emit(CONFIGURATION_EVENTS.WATCHER_ERROR, error);
-        });
-    }
-    async handleFileChange(event, source) {
-        this.logger?.debug(`Live Config: File ${event.type} detected for ${source} config: ${event.path}`);
-        try {
-            // Handle file deletion
-            if (event.type === FILE_WATCHER_EVENTS.DELETE) {
-                this.logger?.info(`Live Config: ${source} config file deleted: ${event.path}`);
-                // Reload configuration without the deleted file
-                await this.reloadConfiguration();
-                return;
-            }
-            // Handle file creation or modification
-            if (event.type === FILE_WATCHER_EVENTS.CHANGE ||
-                event.type === FILE_WATCHER_EVENTS.CREATE) {
-                this.logger?.info(`Live Config: ${source} config file ${event.type}: ${event.path}`);
-                // Add small delay to ensure file write is complete
-                await new Promise((resolve) => setTimeout(resolve, 50));
-                // Reload configuration
-                await this.reloadConfiguration();
-            }
-        }
-        catch (error) {
-            this.logger?.error(`Live Config: Error handling file change for ${source} config: ${error.message}`);
-        }
-    }
-    /**
-     * Validate configuration structure and content
-     */
-    validateConfiguration(config) {
-        const errors = [];
-        if (!config || typeof config !== "object") {
-            return { valid: false, errors: ["Configuration must be an object"] };
-        }
-        // Validate hooks if present
-        if (config.hooks) {
-            if (typeof config.hooks !== "object") {
-                errors.push("hooks property must be an object");
-            }
-            else {
-                // Validate each hook event
-                for (const [eventName, eventConfigs] of Object.entries(config.hooks)) {
-                    // Validate event name
-                    if (!isValidHookEvent(eventName)) {
-                        errors.push(`Invalid hook event: ${eventName}`);
-                        continue;
-                    }
-                    // Validate event configurations
-                    if (!Array.isArray(eventConfigs)) {
-                        errors.push(`Hook event ${eventName} must be an array of configurations`);
-                        continue;
-                    }
-                    eventConfigs.forEach((eventConfig, index) => {
-                        if (!isValidHookEventConfig(eventConfig)) {
-                            errors.push(`Invalid hook event configuration at ${eventName}[${index}]`);
-                        }
-                    });
-                }
-            }
-        }
-        // Validate environment variables if present
-        if (config.env) {
-            if (typeof config.env !== "object" || Array.isArray(config.env)) {
-                errors.push("env property must be an object");
-            }
-            else {
-                for (const [key, value] of Object.entries(config.env)) {
-                    if (typeof key !== "string" || key.trim() === "") {
-                        errors.push(`Invalid environment variable key: ${key}`);
-                    }
-                    if (typeof value !== "string") {
-                        errors.push(`Environment variable ${key} must have a string value`);
-                    }
-                }
-            }
-        }
-        return {
-            valid: errors.length === 0,
-            errors,
-        };
-    }
-    detectChanges(oldConfig, newConfig) {
-        const added = [];
-        const modified = [];
-        const removed = [];
-        // Handle environment variables changes
-        const oldEnv = oldConfig?.env || {};
-        const newEnv = newConfig?.env || {};
-        for (const key of Object.keys(newEnv)) {
-            if (!(key in oldEnv)) {
-                added.push(`env.${key}`);
-            }
-            else if (oldEnv[key] !== newEnv[key]) {
-                modified.push(`env.${key}`);
-            }
-        }
-        for (const key of Object.keys(oldEnv)) {
-            if (!(key in newEnv)) {
-                removed.push(`env.${key}`);
-            }
-        }
-        // Handle hooks changes (simplified)
-        const oldHooks = oldConfig?.hooks || {};
-        const newHooks = newConfig?.hooks || {};
-        for (const event of Object.keys(newHooks)) {
-            if (isValidHookEvent(event)) {
-                if (!(event in oldHooks)) {
-                    added.push(`hooks.${event}`);
-                }
-                else if (JSON.stringify(oldHooks[event]) !== JSON.stringify(newHooks[event])) {
-                    modified.push(`hooks.${event}`);
-                }
-            }
-        }
-        for (const event of Object.keys(oldHooks)) {
-            if (isValidHookEvent(event) && !(event in newHooks)) {
-                removed.push(`hooks.${event}`);
-            }
-        }
-        return { added, modified, removed };
-    }
-    /**
-     * Get the first existing user config path for error reporting
-     */
-    getFirstExistingUserPath() {
-        return (this.userConfigPaths?.find((path) => existsSync(path)) ||
-            this.userConfigPaths?.[0]);
-    }
-    /**
-     * Get the first existing project config path for error reporting
-     */
-    getFirstExistingProjectPath() {
-        return (this.projectConfigPaths?.find((path) => existsSync(path)) ||
-            this.projectConfigPaths?.[0]);
-    }
-}

package/dist/services/memoryStore.d.ts

@@ -1,81 +0,0 @@
-/**
- * Memory Store Service
- *
- * Provides in-memory storage for file content with automatic updates.
- * Optimizes performance by keeping frequently accessed files in memory.
- */
-import { EventEmitter } from "events";
-import type { Logger } from "../types/index.js";
-export interface MemoryStoreEntry {
-    content: string;
-    path: string;
-    lastModified: number;
-    isLoaded: boolean;
-}
-export interface MemoryStoreStats {
-    contentSize: number;
-    lastUpdated: number;
-    updateCount: number;
-    isLoaded: boolean;
-}
-export interface MemoryUpdateEvent {
-    path: string;
-    reason: "file_change" | "initial_load" | "manual_reload";
-    timestamp: number;
-    previousSize?: number;
-    newSize: number;
-}
-export declare class MemoryStoreService extends EventEmitter {
-    private store;
-    private updateCounts;
-    private logger?;
-    constructor(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
-     */
-    getContent(path: string): Promise<string>;
-    /**
-     * Update memory content from file
-     * Maps to FR-007: Update memory content when file changes
-     */
-    updateContent(path: string): Promise<void>;
-    /**
-     * Get memory store statistics
-     * For monitoring and debugging
-     */
-    getStats(path?: string): MemoryStoreStats;
-    /**
-     * Check if content is loaded in memory
-     * For status checking
-     */
-    isLoaded(path: string): boolean;
-    /**
-     * Manually reload content from file
-     * For force refresh scenarios
-     */
-    reloadContent(path: string): Promise<void>;
-    /**
-     * Remove content from memory store
-     * For cleanup when file is deleted
-     */
-    removeContent(path: string): boolean;
-    /**
-     * Clear all content from memory store
-     * For cleanup and testing
-     */
-    clear(): void;
-    /**
-     * Get all stored paths
-     * For monitoring and debugging
-     */
-    getStoredPaths(): string[];
-    /**
-     * Check if file exists and is accessible
-     */
-    fileExists(path: string): Promise<boolean>;
-    private loadFromFile;
-    private incrementUpdateCount;
-    private emitUpdateEvent;
-}
-//# sourceMappingURL=memoryStore.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"memoryStore.d.ts","sourceRoot":"","sources":["../../src/services/memoryStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,GAAG,cAAc,GAAG,eAAe,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,MAAM,CAAC,EAAE,MAAM;IAK3B;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY/C;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAkCzC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK/B;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAWpC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAYb;;;OAGG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YASlC,YAAY;IA2E1B,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,eAAe;CAmBxB"}