/**
 * @fileoverview GKG theme search tool. Finds GDELT Global Knowledge Graph theme identifiers for
 * the `theme:` query operator the DOC tools accept, by matching query words against GDELT's
 * theme lookup.
 * @module mcp-server/tools/definitions/search-themes.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const gdeltSearchThemes: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    query: z.ZodString;
    offset: z.ZodDefault<z.ZodNumber>;
    limit: z.ZodDefault<z.ZodNumber>;
}, z.core.$strip>, z.ZodObject<{
    matches: z.ZodArray<z.ZodObject<{
        theme: z.ZodString;
        count: z.ZodNumber;
        operator: z.ZodString;
    }, z.core.$strip>>;
    totalMatches: z.ZodNumber;
    offset: z.ZodNumber;
    limit: z.ZodNumber;
    nextOffset: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>, readonly [{
    readonly reason: "invalid_query";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "The query has no letter or digit to match — blank, whitespace, or only punctuation such as \"___\".";
    readonly recovery: "Retry gdelt_search_themes with at least one word of letters or digits, such as \"drought\" or \"cyber attack\".";
}, {
    readonly reason: "offset_out_of_range";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "The requested offset is at or beyond the end of a non-empty match list.";
    readonly recovery: "Retry with an offset between 0 and totalMatches - 1 from the preceding response.";
}, {
    readonly reason: "gdelt_unavailable";
    readonly code: JsonRpcErrorCode.ServiceUnavailable;
    readonly when: "The GDELT GKG theme lookup could not be downloaded, or came back empty or not as THEME<TAB>count lines.";
    readonly retryable: true;
    readonly recovery: "Retry after a short delay; GDELT may be temporarily unavailable.";
    readonly thrownBy: "service";
}], {
    readonly effectiveQuery: z.ZodString;
    readonly totalCount: z.ZodNumber;
    readonly notice: z.ZodOptional<z.ZodString>;
}>;
//# sourceMappingURL=search-themes.tool.d.ts.map