export type DiscoveryKind = "capability" | "layer" | "module" | "workflow" | "runtime" | "store" | "provider" | "tool" | "api" | "command" | "skill" | "guide" | "config" | "operation";
export declare const DISCOVERY_KINDS: readonly ["capability", "layer", "module", "workflow", "runtime", "store", "provider", "tool", "api", "command", "skill", "guide", "config", "operation"];
export interface DiscoveryInterface {
    type: string;
    target: string;
    description?: string;
}
export interface DiscoveryReference {
    type: string;
    target: string;
    relation?: string;
}
export interface DiscoveryStep {
    step: string;
    action: string;
    interface?: string;
    expected?: string;
    on_failure?: string;
}
export interface DiscoveryExample {
    title?: string;
    command?: string;
    request?: Record<string, unknown>;
    notes?: string;
}
export interface DiscoveryFailureMode {
    symptom: string;
    likely_cause: string;
    recovery: string;
}
export interface DiscoveryVerification {
    check: string;
    expected: string;
}
export interface DiscoveryBootstrap {
    strategy: string[];
    start_here: string[];
    agent_profiles?: Record<string, string[]>;
    common_intents?: Array<{
        intent: string;
        query: string;
        expand?: string;
    }>;
    live_checks?: string[];
    safety_rules?: string[];
}
export interface DiscoveryEntry {
    id: string;
    kind: DiscoveryKind;
    title: string;
    summary: string;
    aliases?: string[];
    keywords?: string[];
    maturity?: string;
    layer?: string;
    audiences?: string[];
    use_when?: string[];
    avoid_when?: string[];
    inputs?: string[];
    outputs?: string[];
    source_of_truth?: string[];
    prerequisites?: string[];
    interfaces?: DiscoveryInterface[];
    references?: DiscoveryReference[];
    related?: string[];
    workflow?: DiscoveryStep[];
    examples?: DiscoveryExample[];
    verification?: DiscoveryVerification[];
    failure_modes?: DiscoveryFailureMode[];
    state?: Record<string, unknown>;
    safety?: Record<string, unknown>;
    [key: string]: unknown;
}
export interface DiscoveryCatalog {
    schema_version: string;
    generated_at?: string;
    package_version?: string;
    bootstrap?: DiscoveryBootstrap;
    entries: DiscoveryEntry[];
    [key: string]: unknown;
}
export interface DiscoveryQueryOptions {
    kind?: DiscoveryKind;
    limit?: number;
    offset?: number;
    audience?: string;
    layer?: string;
    includeInternal?: boolean;
}
export interface DiscoveryResult {
    score: number;
    entry: DiscoveryEntry;
}
export declare function findDiscoveryCatalogPath(): string | null;
export declare function loadDiscoveryCatalog(): DiscoveryCatalog;
export declare function discoverCapabilities(query?: string, options?: DiscoveryQueryOptions, catalog?: DiscoveryCatalog): DiscoveryResult[];
export declare function rankCapabilities(query?: string, kind?: DiscoveryKind, catalog?: DiscoveryCatalog, options?: Pick<DiscoveryQueryOptions, "audience" | "layer" | "includeInternal">): DiscoveryResult[];
export declare function showCapability(id: string, catalog?: DiscoveryCatalog): DiscoveryEntry | undefined;
export declare function renderDiscoveryEntry(entry: DiscoveryEntry): string;
export declare function discoveryBootstrap(catalog?: DiscoveryCatalog): DiscoveryBootstrap;
export declare function discoverySchemaVersion(): string;
export declare function discoveryDocsRoot(): string | null;
//# sourceMappingURL=discovery.d.ts.map