export interface WellKnownIndex {
    skills: WellKnownSkillEntry[];
}
export interface WellKnownSkillEntry {
    name: string;
    description?: string;
    files: string[];
}
/**
 * Fetch the well-known skills index from a base URL.
 * Returns the parsed index or null on failure (404, network error, invalid JSON).
 */
export declare function fetchWellKnownIndex(baseUrl: string): Promise<WellKnownIndex | null>;
export interface WellKnownCacheResult {
    /** Path to the cached skills directory (contains one subdirectory per skill) */
    cacheDir: string;
}
/**
 * Ensure skills from a well-known HTTP source are cached locally.
 *
 * The caller MUST supply the cache root directory (`stateDir`); the lib
 * does not impose a default.
 *
 * Cache layout:  `<stateDir>/<cacheKey>/<skillName>/SKILL.md`
 *
 * Uses a TTL-based marker file for freshness. On fetch failure with
 * existing cache, returns stale cache (same offline behavior as git).
 */
export declare function ensureWellKnownCached(opts: {
    /** Cache root directory. Required — host owns this. */
    stateDir: string;
    url: string;
    cacheKey: string;
    ttlMs?: number;
}): Promise<WellKnownCacheResult | null>;
//# sourceMappingURL=wellknown.d.ts.map