/**
 * @fileoverview SoQL query execution tool for Socrata datasets.
 * @module mcp-server/tools/definitions/query-dataset.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const queryDataset: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    domain: z.ZodOptional<z.ZodString>;
    dataset_id: z.ZodString;
    search: z.ZodOptional<z.ZodString>;
    select: z.ZodOptional<z.ZodString>;
    where: z.ZodOptional<z.ZodString>;
    group: z.ZodOptional<z.ZodString>;
    having: z.ZodOptional<z.ZodString>;
    order: z.ZodOptional<z.ZodString>;
    limit: z.ZodDefault<z.ZodNumber>;
    offset: z.ZodDefault<z.ZodNumber>;
    canvas_id: z.ZodOptional<z.ZodString>;
}, z.core.$strip>, z.ZodObject<{
    rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    row_count: z.ZodNumber;
    total_count: z.ZodOptional<z.ZodNumber>;
    assembled_query: z.ZodString;
    domain: z.ZodString;
    dataset_id: z.ZodString;
    canvas_id: z.ZodOptional<z.ZodString>;
    canvas_row_count: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>, readonly [{
    readonly reason: "invalid_id";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "Dataset ID does not match the four-by-four pattern.";
    readonly recovery: "Dataset IDs are always 9 characters like kzjm-xkqj. Obtain from socrata_find_datasets.";
}, {
    readonly reason: "not_found";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "Dataset does not exist on this domain.";
    readonly recovery: "Search again with socrata_find_datasets — the dataset may be on a different domain or was retired.";
}, {
    readonly reason: "soql_error";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "SoQL syntax error or unknown column name.";
    readonly recovery: "Check column names with socrata_get_dataset. Text columns need single-quoted strings (year='2020'); Number columns use bare literals (year=2020).";
}, {
    readonly reason: "rate_limited";
    readonly code: JsonRpcErrorCode.ServiceUnavailable;
    readonly when: "SODA endpoint returned 429.";
    readonly retryable: true;
    readonly recovery: "Retry after a short delay. Set SOCRATA_APP_TOKEN for higher per-IP rate limits.";
}], {
    readonly notice: z.ZodOptional<z.ZodString>;
    readonly truncated: z.ZodOptional<z.ZodBoolean>;
    readonly shown: z.ZodOptional<z.ZodNumber>;
    readonly cap: z.ZodOptional<z.ZodNumber>;
}>;
//# sourceMappingURL=query-dataset.tool.d.ts.map