import type { ContributionFileKind, DiscoveredContribution } from "../contracts.js";
import type { PermissionPolicy, TrustPolicy } from "../security.js";
export interface DiscoveryOptions {
    readonly kinds: readonly ContributionFileKind[];
    /** Workspace root. Scans `<root>/.agents/<kind>s/<name>/`. Gated by `trust`. */
    readonly workspaceRoot?: string;
    readonly permission?: PermissionPolicy;
    readonly trust?: TrustPolicy;
}
/**
 * Discover contributions on disk. Scans the workspace `.agents/` tree only;
 * no global root. One `readdir` per kind-root; no `import()`. Inert output —
 * executable behavior is host-owned.
 */
export declare function discoverContributions(options: DiscoveryOptions): Promise<readonly DiscoveredContribution[]>;
export declare function readOptionalFile(path: string): Promise<string | undefined>;