/**
 * API Provider
 *
 * Provides completion suggestions for tag and API names.
 * Supports hierarchical subcommand format where tag and api
 * are independent positional arguments.
 */
import { CompletionContext, CompletionOptions, CompletionProvider, CompletionSuggestion } from "../types.d.ts";
export interface ApiDataSource {
    /** Get tags for a spec */
    getTags(specName: string): Promise<string[]>;
    /** Get tags for a spec with descriptions (optional method) */
    getTagsWithDesc?(specName: string): Promise<Array<{
        name: string;
        description?: string;
    }>>;
    /** Get APIs for a spec/tag */
    getApis(specName: string, tagName?: string): Promise<Array<{
        name: string;
        description?: string;
    }>>;
}
export declare class ApiProvider implements CompletionProvider {
    private options;
    private dataSource;
    constructor(options: CompletionOptions, dataSource: ApiDataSource);
    canHandle(context: CompletionContext): boolean;
    provide(context: CompletionContext): Promise<CompletionSuggestion[]>;
    private provideTagSuggestions;
    private provideApiSuggestions;
}