import type { SiteLensReportV1 } from "../types/report-v1.js";
export declare const REPORT_SECTION_IDS: readonly ["summary", "steps", "assertions", "failures", "screenshots", "visualComparisons", "network", "console", "errors", "environment", "children", "sourceEvidence"];
export type ReportSectionId = (typeof REPORT_SECTION_IDS)[number];
export declare function listReportSections(_report?: SiteLensReportV1): ReportSectionId[];
export declare function isReportSectionId(value: string): value is ReportSectionId;
export interface ReadReportSectionOptions {
    limit?: number;
    offset?: number;
    /** Filter by status (steps, assertions, comparisons, children, failures). */
    status?: string;
    /** Filter steps by step index. */
    stepIndex?: number;
    /** Case-insensitive substring match across string fields. */
    query?: string;
    /** Max characters for string previews in returned items. */
    maxPreviewLength?: number;
}
export interface ReadReportSectionResult {
    section: ReportSectionId;
    totalMatching: number;
    returned: number;
    offset: number;
    limit: number;
    truncated: boolean;
    items: unknown[];
    /** Present for singleton sections (summary, environment, sourceEvidence). */
    value?: unknown;
}
/**
 * Read a bounded report section. Never returns an unbounded full report body.
 * Unknown section ids throw with a clear message.
 */
export declare function readReportSection(report: SiteLensReportV1, section: string, options?: ReadReportSectionOptions): ReadReportSectionResult;
//# sourceMappingURL=sections.d.ts.map