/**
 * @fileoverview `brapi_find_observations` — pull observation records filtered
 * by study, germplasm, variable, season, or observation unit. Matches the
 * find_* pattern: paged single pull capped at loadLimit, distributions across
 * variable/study/germplasm/level, dataframe spillover when the upstream
 * total exceeds loadLimit.
 *
 * @module mcp-server/tools/definitions/brapi-find-observations.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const brapiFindObservations: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    alias: z.ZodOptional<z.ZodString>;
    studies: z.ZodOptional<z.ZodArray<z.ZodString>>;
    germplasm: z.ZodOptional<z.ZodArray<z.ZodString>>;
    variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
    observationUnits: z.ZodOptional<z.ZodArray<z.ZodString>>;
    observations: z.ZodOptional<z.ZodArray<z.ZodString>>;
    seasons: z.ZodOptional<z.ZodArray<z.ZodString>>;
    programs: z.ZodOptional<z.ZodArray<z.ZodString>>;
    trials: z.ZodOptional<z.ZodArray<z.ZodString>>;
    observationLevels: z.ZodOptional<z.ZodArray<z.ZodString>>;
    timestampFrom: z.ZodOptional<z.ZodString>;
    timestampTo: z.ZodOptional<z.ZodString>;
    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<{
        observationDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        observationUnitDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        observationUnitName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        observationVariableDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        observationVariableName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        studyDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        studyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        germplasmDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        germplasmName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        observationLevel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        season: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{}, z.core.$loose>, z.ZodNull]>>;
        value: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        observationTimeStamp: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        collector: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        uploadedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
    }, z.core.$loose>>;
    hasMore: z.ZodBoolean;
    distributions: z.ZodObject<{
        observationVariableName: z.ZodRecord<z.ZodString, z.ZodNumber>;
        studyName: z.ZodRecord<z.ZodString, z.ZodNumber>;
        germplasmName: z.ZodRecord<z.ZodString, z.ZodNumber>;
        observationLevel: z.ZodRecord<z.ZodString, z.ZodNumber>;
        season: 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_observations.";
}, {
    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 germplasm, variables, observationUnits, observations, seasons, programs, or trials — 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-observations.tool.d.ts.map