/**
 * @fileoverview GDELT coverage breakdown tool. Breaks down coverage volume by source
 * language or source country over time using the GDELT DOC API.
 * @module mcp-server/tools/definitions/get-coverage-breakdown.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const gdeltGetCoverageBreakdown: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    query: z.ZodString;
    breakdownBy: z.ZodEnum<{
        country: "country";
        language: "language";
    }>;
    timespan: z.ZodOptional<z.ZodString>;
    startDatetime: z.ZodOptional<z.ZodString>;
    endDatetime: z.ZodOptional<z.ZodString>;
    series: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strip>, z.ZodObject<{
    dateResolution: z.ZodOptional<z.ZodEnum<{
        "15min": "15min";
        day: "day";
        hour: "hour";
    }>>;
    topSeries: z.ZodArray<z.ZodObject<{
        label: z.ZodString;
        data: z.ZodArray<z.ZodObject<{
            date: z.ZodString;
            value: z.ZodNumber;
        }, z.core.$strip>>;
    }, z.core.$strip>>;
    otherAggregated: z.ZodOptional<z.ZodArray<z.ZodObject<{
        date: z.ZodString;
        value: z.ZodNumber;
    }, z.core.$strip>>>;
    otherSeriesLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
    selectedSeries: z.ZodOptional<z.ZodArray<z.ZodObject<{
        label: z.ZodString;
        data: z.ZodArray<z.ZodObject<{
            date: z.ZodString;
            value: z.ZodNumber;
        }, z.core.$strip>>;
    }, z.core.$strip>>>;
}, z.core.$strip>, readonly [{
    readonly reason: "unknown_series";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "A label passed in the series input matches no series in a non-empty breakdown.";
    readonly recovery: "Read the labels listed in the error and retry series with exact matches from that list.";
}, {
    readonly reason: "invalid_date_range";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "Only one of startDatetime / endDatetime was supplied, one of them is not a real UTC calendar timestamp, or startDatetime is not earlier than endDatetime.";
    readonly recovery: "Supply both startDatetime and endDatetime as real UTC calendar timestamps, with startDatetime earlier than endDatetime, or omit both and use timespan instead.";
}, {
    readonly reason: "invalid_query";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "GDELT rejected the query string as malformed — bad keyword length, unbalanced parentheses, or an illegal character.";
    readonly recovery: "Read the recovery hint for the specific rule GDELT rejected, then fix the query and retry.";
    readonly thrownBy: "service";
}, {
    readonly reason: "gdelt_rate_limited";
    readonly code: JsonRpcErrorCode.RateLimited;
    readonly when: "GDELT rejected the request for its one-request-per-five-seconds limit, or too many requests were already queued for this one to start in time.";
    readonly retryable: false;
    readonly recovery: "Wait at least 5 seconds before retrying; GDELT accepts at most one request every 5 seconds.";
    readonly thrownBy: "service";
}, {
    readonly reason: "gdelt_unavailable";
    readonly code: JsonRpcErrorCode.ServiceUnavailable;
    readonly when: "GDELT DOC API is unreachable or temporarily returned no usable data.";
    readonly retryable: true;
    readonly recovery: "Retry after a short delay; GDELT may be temporarily unavailable.";
    readonly thrownBy: "service";
}], {
    readonly effectiveQuery: z.ZodString;
    readonly breakdownBy: z.ZodEnum<{
        country: "country";
        language: "language";
    }>;
    readonly totalCount: z.ZodNumber;
    readonly startDatetime: z.ZodOptional<z.ZodString>;
    readonly endDatetime: z.ZodOptional<z.ZodString>;
    readonly notice: z.ZodOptional<z.ZodString>;
}>;
//# sourceMappingURL=get-coverage-breakdown.tool.d.ts.map