import { type BotPackageManifest } from "./manifest.js";
import type { PluginDiagnostic, PluginOrigin } from "./types.js";
export type PluginCandidate = {
    idHint: string;
    source: string;
    rootDir: string;
    origin: PluginOrigin;
    workspaceDir?: string;
    packageName?: string;
    packageVersion?: string;
    packageDescription?: string;
    packageDir?: string;
    packageManifest?: BotPackageManifest;
};
export type PluginDiscoveryResult = {
    candidates: PluginCandidate[];
    diagnostics: PluginDiagnostic[];
};
export declare function clearPluginDiscoveryCache(): void;
export type CandidateBlockReason = "source_escapes_root" | "path_stat_failed" | "path_world_writable" | "path_suspicious_ownership";
export declare function discoverBotPlugins(params: {
    workspaceDir?: string;
    extraPaths?: string[];
    ownershipUid?: number | null;
    cache?: boolean;
    env?: NodeJS.ProcessEnv;
}): PluginDiscoveryResult;