import type { PluginPackage, PluginSource } from "./types.js";
/** Immutable lookup over validated plugin packages supplied by the built-in catalog. */
export declare class PluginCatalog {
    private readonly packages;
    constructor(packages: readonly PluginPackage[]);
    list(): PluginPackage[];
    get(shortName: string): PluginPackage | undefined;
}
/** Loads and fully validates every child package in a built-in plugins directory. */
export declare function pluginCatalogLoad(root: string): Promise<PluginCatalog>;
/** Loads one built-in package while rejecting unsafe paths, malformed manifests, invalid skills, and non-square icons. */
export declare function pluginPackageLoad(directory: string, sourceReference?: string): Promise<PluginPackage>;
/** Loads one downloaded package with the same validation as a built-in package without coupling its short name to an archive directory. */
export declare function pluginPackageLoadSource(directory: string, source: PluginSource, requireDirectoryName?: boolean): Promise<PluginPackage>;
/** Revalidates an installed package while excluding Happy's reserved writable data subtree from its immutable package digest. */
export declare function pluginPackageLoadInstalled(directory: string, source: PluginSource, expectedShortName: string): Promise<PluginPackage>;
//# sourceMappingURL=catalog.d.ts.map