/**
 * @fileoverview `brapi_get_study` — fetch a single study by DbId, resolve
 * program/trial/location FKs via ReferenceDataCache, and attach cheap
 * `pageSize=1` counts (observations, observation units, variables) as
 * response companions so the agent can decide where to drill next.
 *
 * @module mcp-server/tools/definitions/brapi-get-study.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const brapiGetStudy: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    studyDbId: z.ZodString;
    alias: z.ZodOptional<z.ZodString>;
}, z.core.$strip>, z.ZodObject<{
    alias: z.ZodString;
    study: 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>;
    program: z.ZodOptional<z.ZodObject<{
        programDbId: z.ZodString;
        programName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        commonCropName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        abbreviation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        leadPersonName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        documentationURL: z.ZodOptional<z.ZodNullable<z.ZodString>>;
    }, z.core.$loose>>;
    trial: z.ZodOptional<z.ZodObject<{
        trialDbId: z.ZodString;
        trialName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        programDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        programName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        commonCropName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        startDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        endDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        active: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
        trialDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
    }, z.core.$loose>>;
    location: z.ZodOptional<z.ZodObject<{
        locationDbId: z.ZodString;
        locationName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        abbreviation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        countryCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        countryName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        locationType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        latitude: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
        longitude: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
        altitude: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
        coordinates: z.ZodOptional<z.ZodNullable<z.ZodObject<{}, z.core.$loose>>>;
    }, z.core.$loose>>;
    observationCount: z.ZodOptional<z.ZodNumber>;
    observationUnitCount: z.ZodOptional<z.ZodNumber>;
    variableCount: z.ZodOptional<z.ZodNumber>;
    warnings: z.ZodArray<z.ZodString>;
}, 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_get_study.";
}, {
    readonly reason: "study_not_found";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "Upstream returned no study record for the requested DbId";
    readonly recovery: "Verify the studyDbId on the target server, or run brapi_find_studies to discover valid IDs.";
}], undefined>;
//# sourceMappingURL=brapi-get-study.tool.d.ts.map