import type { CachedArtifact, DownloadSkillsOptions, ReleaseInfo, SkillSet } from './types.js';
/**
 * Get the cache directory for skills.
 * Uses XDG_CACHE_HOME on Linux, ~/.cache otherwise.
 */
export declare function getCacheDir(): string;
/**
 * Fetch release information from GitHub API.
 *
 * @param version - Release version to fetch. Can be 'latest' (default), a version number, or a full tag.
 * @returns Release information including asset URLs and version metadata.
 * @throws Error if release not found or GitHub API error.
 */
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 recent release information.
 */
export declare function listReleases(limit?: number): Promise<ReleaseInfo[]>;
/**
 * Get cached artifact metadata if available.
 */
export declare function getCachedArtifact(version: string, skillSet: SkillSet): CachedArtifact | null;
/**
 * Download and extract skills artifact.
 * Dispatches to the appropriate download strategy based on the skill source type.
 *
 * @param skillSet - Which skill set to download
 * @param options - Download options
 * @returns Path to extracted skills directory
 */
export declare function downloadSkillsArtifact(skillSet: SkillSet, options?: DownloadSkillsOptions): Promise<string>;
/**
 * Clear the skills cache.
 *
 * @param version - Optional specific version to clear. If omitted, clears the entire cache.
 */
export declare function clearCache(version?: string): Promise<void>;