/** * Configuration Path Utilities * * Centralized utilities for resolving Wave configuration file paths. * Supports both regular settings.json and local settings.local.json with proper priority. * * Priority system: * - User configs: ~/.wave/settings.json * - Local configs: {workdir}/.wave/settings.local.json > {workdir}/.wave/settings.json * - Project configs override user configs (existing behavior) */ export declare function getPackageRoot(): string; /** * Get the builtin skills directory path */ export declare function getBuiltinSkillsDir(): string; /** * Get the builtin subagents directory path */ export declare function getBuiltinSubagentsDir(): string; /** * Get the user-specific configuration file path (legacy function) * @deprecated Use getUserConfigPaths() for better priority support */ export declare function getUserConfigPath(): string; /** * Get the project-specific configuration file path (legacy function) * @deprecated Use getProjectConfigPaths() for better priority support */ export declare function getProjectConfigPath(workdir: string): string; /** * Get the user-specific configuration file paths in priority order * Returns array with .json only */ export declare function getUserConfigPaths(): string[]; /** * Get the plugins directory path */ export declare function getPluginsDir(): string; /** * Get the local configuration file paths in priority order * Returns array with .local.json first, then .json */ export declare function getProjectConfigPaths(workdir: string): string[]; /** * Get all configuration file paths (user and project) in priority order * Useful for comprehensive configuration detection */ export declare function getAllConfigPaths(workdir: string): { userPaths: string[]; projectPaths: string[]; builtinPaths: string[]; allPaths: string[]; }; /** * Get existing configuration file paths * Returns only the paths that actually exist on the filesystem */ export declare function getExistingConfigPaths(workdir: string): { userPaths: string[]; projectPaths: string[]; builtinPaths: string[]; existingPaths: string[]; }; /** * Get the first existing configuration file path with the specified priority * @param paths Array of paths in priority order * @returns The first path that exists, or undefined if none exist */ export declare function getFirstExistingPath(paths: string[]): string | undefined; /** * Get effective configuration paths (the ones that would actually be used) * Returns the highest priority existing path for each category */ export declare function getEffectiveConfigPaths(workdir: string): { userPath?: string; projectPath?: string; effectivePath?: string; }; /** * Check if any configuration files exist */ export declare function hasAnyConfig(workdir: string): boolean; /** * Get configuration information for debugging and monitoring */ export declare function getConfigurationInfo(workdir: string): { hasUser: boolean; hasProject: boolean; paths: string[]; userPaths: string[]; projectPaths: string[]; existingPaths: string[]; effectivePaths: { userPath?: string; projectPath?: string; effectivePath?: string; }; };