import type { CatalogSource } from './catalog.js';
import type { CatalogNode } from './catalog-node.js';
export declare class SkillCatalogSource implements CatalogSource {
    private _nodes;
    private _loadedAt;
    private _inflight;
    /**
     * Pre-warm the cache synchronously before the catalog is first used.
     * Called by bootstrap so the first getCatalogNodes() call isn't empty.
     */
    preload(): Promise<void>;
    /**
     * Mark the cache stale so the next getCatalogNodes() triggers a reload.
     * Call this after createSkill() / deleteSkill() for immediate propagation.
     */
    invalidate(): void;
    /**
     * Returns current cached catalog nodes.
     * If the cache is older than TTL_MS, fires a background refresh —
     * the current request gets the existing nodes; the next request gets fresh ones.
     */
    getCatalogNodes(): CatalogNode[];
    private _load;
}
//# sourceMappingURL=skill-catalog-source.d.ts.map