export type ExternalSoftwareSource = "npm" | "github";
export type ExternalAdoptionMethod = "native-capability" | "npm-cli" | "mcp" | "openapi" | "repository-mine" | "manual-adapter";
export type ExternalAdoptionHint = {
    method: ExternalAdoptionMethod;
    confidence: "high" | "medium" | "low";
    reason: string;
};
export type ExternalSoftwareCandidate = {
    kind: "external";
    source: ExternalSoftwareSource;
    locator: string;
    name: string;
    version?: string;
    description: string;
    repository?: string;
    homepage?: string;
    language?: string;
    license?: string;
    popularity?: number;
    sourceRank: number;
    score: number;
    signals: readonly string[];
    adoption: readonly ExternalAdoptionHint[];
};
export type NpmPackageInspection = {
    source: "npm";
    name: string;
    version: string;
    description: string;
    repository?: string;
    homepage?: string;
    license?: string;
    keywords: readonly string[];
    bins: Readonly<Record<string, string>>;
    capabilityDeclared: boolean;
    integrity?: string;
    shasum?: string;
    gitHead?: string;
    main?: string;
    exports?: unknown;
};
export type ExternalDiscoveryError = {
    source: ExternalSoftwareSource | "capability";
    message: string;
};
export type ExternalDiscoveryOptions = {
    fetch?: typeof fetch;
    npm?: boolean;
    github?: boolean;
    githubToken?: string;
    limitPerSource?: number;
    signal?: AbortSignal;
};
export type SoftwareWorldDiscoveryOptions = ExternalDiscoveryOptions & {
    indexes?: readonly string[];
    includeNative?: boolean;
    includeExternal?: boolean;
    limit?: number;
};
export type NativeSoftwareResult = {
    kind: "capability";
    id: string;
    version: string;
    name: string;
    description: string;
    effects: readonly string[];
    package: string;
    score: number;
    reasons: readonly string[];
};
export type SoftwareWorldDiscovery = {
    query: string;
    native: readonly NativeSoftwareResult[];
    external: readonly ExternalSoftwareCandidate[];
    errors: readonly ExternalDiscoveryError[];
};
export declare function searchNpmSoftware(query: string, options?: ExternalDiscoveryOptions): Promise<ExternalSoftwareCandidate[]>;
export declare function inspectNpmPackage(name: string, version?: string, options?: ExternalDiscoveryOptions): Promise<NpmPackageInspection>;
export declare function searchGitHubSoftware(query: string, options?: ExternalDiscoveryOptions): Promise<ExternalSoftwareCandidate[]>;
/** Build bounded focused search expressions from a natural-language outcome. */
export declare function planExternalSearchQueries(query: string, maxQueries?: number): string[];
export declare function discoverExternalSoftware(query: string, options?: ExternalDiscoveryOptions): Promise<{
    results: readonly ExternalSoftwareCandidate[];
    errors: readonly ExternalDiscoveryError[];
}>;
export declare function discoverSoftwareWorld(query: string, options?: SoftwareWorldDiscoveryOptions): Promise<SoftwareWorldDiscovery>;
//# sourceMappingURL=external-discovery.d.ts.map