/**
 * OpenAPI 3.0 spec generator from observed network traffic.
 *
 * Takes the ApiEndpointObservationInput[] collected by the network observer
 * during crawl and generates a minimal but valid OpenAPI 3.0 spec.
 *
 * The spec captures: endpoints, methods, observed response shapes, status codes.
 * It does NOT capture request bodies (we'd need to intercept requests too) — that's
 * marked as a TODO. But it's enough for generating smoke-test suites.
 */
import type { ApiEndpointObservationInput } from './network-observer.js';
export interface OpenApiSpec {
    openapi: '3.0.3';
    info: {
        title: string;
        version: string;
        description?: string;
    };
    servers: Array<{
        url: string;
    }>;
    paths: Record<string, Record<string, OpenApiOperation>>;
}
interface OpenApiOperation {
    summary: string;
    parameters?: OpenApiParam[];
    responses: Record<string, {
        description: string;
        content?: Record<string, {
            schema: unknown;
        }>;
    }>;
    tags?: string[];
}
interface OpenApiParam {
    name: string;
    in: 'path' | 'query';
    required: boolean;
    schema: {
        type: string;
    };
}
export declare function generateOpenApiSpec(observations: ApiEndpointObservationInput[], opts?: {
    title?: string;
    baseUrl?: string;
    version?: string;
}): OpenApiSpec;
export declare function specToYaml(spec: OpenApiSpec): string;
export {};