/**
 * @fileoverview `brapi_find_studies` — locate studies matching crop / trial
 * type / season / location / program filters. Pulls an initial page and, if
 * the server reports more rows than loadLimit, materializes the union as a
 * dataframe and returns a handle. Companion response: per-field
 * distributions computed from the full row set plus a refinement hint.
 *
 * @module mcp-server/tools/definitions/brapi-find-studies.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const brapiFindStudies: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    alias: z.ZodOptional<z.ZodString>;
    crop: z.ZodOptional<z.ZodString>;
    trialTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
    seasons: z.ZodOptional<z.ZodArray<z.ZodString>>;
    locations: z.ZodOptional<z.ZodArray<z.ZodString>>;
    programs: z.ZodOptional<z.ZodArray<z.ZodString>>;
    trials: z.ZodOptional<z.ZodArray<z.ZodString>>;
    studyNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
    active: z.ZodOptional<z.ZodBoolean>;
    loadLimit: z.ZodOptional<z.ZodNumber>;
    extraFilters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
}, z.core.$strip>, z.ZodObject<{
    alias: z.ZodString;
    results: z.ZodArray<z.ZodObject<{
        studyDbId: z.ZodString;
        studyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        studyType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        studyDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        programDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        programName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        trialDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        trialName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        locationDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        locationName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        commonCropName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        seasons: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNullable<z.ZodString>>>>;
        active: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
        startDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        endDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        studyCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        studyPUI: z.ZodOptional<z.ZodNullable<z.ZodString>>;
    }, z.core.$loose>>;
    hasMore: z.ZodBoolean;
    distributions: z.ZodObject<{
        programName: z.ZodRecord<z.ZodString, z.ZodNumber>;
        studyType: z.ZodRecord<z.ZodString, z.ZodNumber>;
        seasons: z.ZodRecord<z.ZodString, z.ZodNumber>;
        locationName: z.ZodRecord<z.ZodString, z.ZodNumber>;
        commonCropName: z.ZodRecord<z.ZodString, z.ZodNumber>;
    }, z.core.$strip>;
    dataframe: z.ZodOptional<z.ZodObject<{
        tableName: z.ZodString;
        rowCount: z.ZodNumber;
        columns: z.ZodArray<z.ZodString>;
        columnLegend: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
        createdAt: z.ZodString;
        expiresAt: z.ZodString;
        truncated: z.ZodOptional<z.ZodBoolean>;
        maxRows: z.ZodOptional<z.ZodNumber>;
        totalCount: z.ZodOptional<z.ZodNumber>;
    }, z.core.$strip>>;
}, z.core.$strip>, readonly [{
    readonly reason: "unknown_alias";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "No connection has been registered under the requested alias";
    readonly recovery: "Run brapi_connect with this alias (or omit `alias` to use the default connection) before calling brapi_find_studies.";
}, {
    readonly reason: "all_filters_dropped";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline.";
    readonly recovery: "Drop the unsupported filters and rescope by crop, trialTypes, seasons, programs, trials, studyNames, or active — these filter paths are honored on the active dialect.";
}], {
    readonly totalCount: z.ZodNumber;
    readonly returnedCount: z.ZodNumber;
    readonly appliedFilters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
    readonly refinementHint: z.ZodOptional<z.ZodString>;
    readonly notice: z.ZodOptional<z.ZodString>;
    readonly warnings: z.ZodArray<z.ZodString>;
}>;
//# sourceMappingURL=brapi-find-studies.tool.d.ts.map