/**
 * Test Generator from Documentation — Generate test suites from API docs, README, etc.
 *
 * Supports OpenAPI/Swagger specs, Markdown API docs, and raw endpoint lists.
 *
 * @example
 * ```bash
 * agentprobe gen-from-docs --openapi spec.yaml --agent my-agent
 * agentprobe gen-from-docs --markdown api.md --agent my-agent
 * ```
 */
import type { OpenAPISpec, OpenAPITestSuite } from './openapi';
export interface DocGenOptions {
    agent: string;
    includeHappyPath?: boolean;
    includeErrorHandling?: boolean;
    includeEdgeCases?: boolean;
    includeSecurity?: boolean;
    maxTestsPerEndpoint?: number;
    tags?: string[];
}
export interface DocGenResult {
    source: string;
    format: 'openapi' | 'markdown' | 'raw';
    suite: OpenAPITestSuite;
    stats: DocGenStats;
    yaml: string;
}
export interface DocGenStats {
    totalTests: number;
    happyPath: number;
    errorHandling: number;
    edgeCases: number;
    security: number;
    endpoints: number;
}
export interface MarkdownEndpoint {
    method: string;
    path: string;
    description?: string;
    parameters?: Array<{
        name: string;
        type: string;
        required: boolean;
    }>;
    responseExample?: string;
}
/**
 * Generate tests from an OpenAPI spec file.
 */
export declare function generateFromOpenAPIFile(filePath: string, options: DocGenOptions): DocGenResult;
/**
 * Generate tests from a parsed OpenAPI spec.
 */
export declare function generateFromOpenAPISpec(spec: OpenAPISpec, source: string, options: DocGenOptions): DocGenResult;
/**
 * Parse API endpoints from a Markdown document.
 * Looks for patterns like: `GET /api/users` or `## POST /api/items`
 */
export declare function parseMarkdownEndpoints(content: string): MarkdownEndpoint[];
/**
 * Generate tests from Markdown API documentation.
 */
export declare function generateFromMarkdown(content: string, source: string, options: DocGenOptions): DocGenResult;
/**
 * Generate from a Markdown file.
 */
export declare function generateFromMarkdownFile(filePath: string, options: DocGenOptions): DocGenResult;
/**
 * Format generation stats for display.
 */
export declare function formatDocGenStats(stats: DocGenStats): string;
/**
 * Auto-detect file format and generate tests.
 */
export declare function generateFromDocs(filePath: string, options: DocGenOptions): DocGenResult;
//# sourceMappingURL=doc-gen.d.ts.map