export interface OpenApiOperation {
    summary?: string;
    description?: string;
    tags?: string[];
    parameters?: unknown[];
    requestBody?: unknown;
    responses?: unknown;
    [k: string]: unknown;
}
export interface OpenApiSpec {
    openapi?: string;
    info?: {
        title?: string;
        version?: string;
    };
    paths: Record<string, Record<string, OpenApiOperation>>;
    components?: {
        schemas?: Record<string, unknown>;
        [k: string]: unknown;
    };
    [k: string]: unknown;
}
export declare function isReadOnlyOperation(method: string, path: string): boolean;
/**
 * Returns the spec, cached for SPEC_TTL_MS. On fetch failure, serves the
 * last-known-good copy flagged `stale: true`; only throws if there is no
 * cache to fall back to.
 */
export declare function getSpec(): Promise<{
    spec: OpenApiSpec;
    stale: boolean;
}>;
export interface MatchedEndpoint {
    templatePath: string;
    methods: string[];
}
/** Match a concrete request path against the spec's (possibly templated) paths. */
export declare function matchEndpoint(spec: OpenApiSpec, concretePath: string): MatchedEndpoint | null;
export interface EndpointSummary {
    method: string;
    path: string;
    summary: string;
    tags?: string[];
}
export declare function listDataEndpoints(spec: OpenApiSpec, search?: string): EndpointSummary[];
export declare function getEndpointSchema(spec: OpenApiSpec, path: string, method: string): unknown;
export interface CallEndpointInput {
    method: string;
    path: string;
    params?: Record<string, unknown>;
}
export declare function callEndpoint(input: CallEndpointInput): Promise<unknown>;
//# sourceMappingURL=specClient.d.ts.map