import type { CachedArtifact, DownloadSkillsOptions, ReleaseInfo, SkillSet } from './types.js';
/**
 * Get the cache directory for skills.
 * Uses XDG_CACHE_HOME on Linux, ~/.cache otherwise.
 *
 * @returns Absolute path to cache directory
 */
export declare function getCacheDir(): string;
/**
 * Fetch release information from GitHub API.
 *
 * @param version - 'latest' or specific version (e.g., 'v0.1.0')
 * @returns Release information
 * @throws Error if release not found or API request fails
 */
export declare function getRelease(version?: string): Promise<ReleaseInfo>;
/**
 * List available releases with skills artifacts.
 *
 * @param limit - Maximum number of releases to return (default: 10)
 * @returns Array of release information
 */
export declare function listReleases(limit?: number): Promise<ReleaseInfo[]>;
/**
 * Get cached artifact metadata if available.
 *
 * @param version - Release version
 * @param skillSet - Skill set to check
 * @returns Cached artifact info or null if not cached
 */
export declare function getCachedArtifact(version: string, skillSet: SkillSet): CachedArtifact | null;
/**
 * Download and extract skills artifact.
 * Uses direct download URLs to avoid GitHub API rate limits.
 *
 * @param skillSet - Which skill set to download ('b2c' or 'b2c-cli')
 * @param options - Download options
 * @returns Path to extracted skills directory
 * @throws Error if download fails or artifact not available
 */
export declare function downloadSkillsArtifact(skillSet: SkillSet, options?: DownloadSkillsOptions): Promise<string>;
/**
 * Clear the skills cache.
 *
 * @param version - Optional specific version to clear (default: all)
 */
export declare function clearCache(version?: string): Promise<void>;
