export * from "./config/config-file";
/**
 * Get the base directory for resolving optional package assets (docs, examples).
 * Walk up from import.meta.dir until we find package.json, or fall back to cwd.
 */
export declare function getPackageDir(): string;
/** Get path to CHANGELOG.md (optional, may not exist in binary) */
export declare function getChangelogPath(): string;
export interface ConfigDirEntry {
    path: string;
    source: string;
    level: "user" | "project";
}
export interface GetConfigDirsOptions {
    /** Include user-level directories (~/.omp/agent/...). Default: true */
    user?: boolean;
    /** Include project-level directories (.omp/...). Default: true */
    project?: boolean;
    /** Current working directory for project paths. Default: getProjectDir() */
    cwd?: string;
    /** Only return directories that exist. Default: false */
    existingOnly?: boolean;
}
/**
 * Get all config directories for a subpath, ordered by priority (highest first).
 *
 * @param subpath - Subpath within config dirs (e.g., "commands", "hooks", "agents")
 * @param options - Options for filtering
 * @returns Array of directory entries, highest priority first
 *
 * @example
 * // Get all command directories
 * getConfigDirs("commands")
 * // → [{ path: "~/.omp/agent/commands", source: ".omp", level: "user" }, ...]
 *
 * @example
 * // Get only existing project skill directories
 * getConfigDirs("skills", { user: false, existingOnly: true })
 */
export declare function getConfigDirs(subpath: string, options?: GetConfigDirsOptions): ConfigDirEntry[];
/**
 * Get all config directory paths for a subpath (convenience wrapper).
 * Returns just the paths, highest priority first.
 */
export declare function getConfigDirPaths(subpath: string, options?: GetConfigDirsOptions): string[];
export interface ConfigFileResult<T> {
    path: string;
    source: string;
    level: "user" | "project";
    content: T;
}
/**
 * Find the first existing config file (for non-JSON files like SYSTEM.md).
 * Returns just the path, or undefined if not found.
 */
export declare function findConfigFile(subpath: string, options?: GetConfigDirsOptions): string | undefined;
/**
 * Find the first existing config file with metadata.
 */
export declare function findConfigFileWithMeta(subpath: string, options?: GetConfigDirsOptions): Omit<ConfigFileResult<never>, "content"> | undefined;
/**
 * Find all nearest config directories by walking up from cwd.
 * Returns one entry per config base (.omp, .claude) - the nearest one found.
 * Results are in priority order (highest first).
 */
export declare function findAllNearestProjectConfigDirs(subpath: string, cwd?: string): ConfigDirEntry[];