/**
 * @fileoverview `brapi_find_variables` — find observation variables (traits)
 * by name, trait class, ontology term, or free-text query. When `text` is
 * supplied, results are re-ranked client-side via OntologyResolver; when
 * the server exposes ontology metadata, matches can resolve to ontology
 * URIs. Otherwise falls back to pure substring ordering.
 *
 * @module mcp-server/tools/definitions/brapi-find-variables.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const brapiFindVariables: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    alias: z.ZodOptional<z.ZodString>;
    variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
    variableNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
    variablePUIs: z.ZodOptional<z.ZodArray<z.ZodString>>;
    traitClasses: z.ZodOptional<z.ZodArray<z.ZodString>>;
    ontologies: z.ZodOptional<z.ZodArray<z.ZodString>>;
    studies: z.ZodOptional<z.ZodArray<z.ZodString>>;
    methods: z.ZodOptional<z.ZodArray<z.ZodString>>;
    scales: z.ZodOptional<z.ZodArray<z.ZodString>>;
    crop: z.ZodOptional<z.ZodString>;
    text: 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<{
        observationVariableDbId: z.ZodString;
        observationVariableName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        observationVariablePUI: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        ontologyDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        ontologyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        commonCropName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        trait: z.ZodOptional<z.ZodNullable<z.ZodObject<{
            traitDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
            traitName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
            traitClass: z.ZodOptional<z.ZodNullable<z.ZodString>>;
            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
            synonyms: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
        }, z.core.$loose>>>;
        scale: z.ZodOptional<z.ZodNullable<z.ZodObject<{
            scaleDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
            scaleName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
            dataType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        }, z.core.$loose>>>;
        method: z.ZodOptional<z.ZodNullable<z.ZodObject<{
            methodDbId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
            methodName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
        }, z.core.$loose>>>;
    }, z.core.$loose>>;
    hasMore: z.ZodBoolean;
    distributions: z.ZodObject<{
        ontologyDbId: z.ZodRecord<z.ZodString, z.ZodNumber>;
        traitClass: z.ZodRecord<z.ZodString, z.ZodNumber>;
        scaleName: z.ZodRecord<z.ZodString, z.ZodNumber>;
    }, z.core.$strip>;
    ontologyCandidates: z.ZodArray<z.ZodObject<{
        observationVariableDbId: z.ZodOptional<z.ZodString>;
        termId: z.ZodOptional<z.ZodString>;
        name: z.ZodOptional<z.ZodString>;
        description: z.ZodOptional<z.ZodString>;
        synonyms: z.ZodOptional<z.ZodArray<z.ZodString>>;
        ontologyDbId: z.ZodOptional<z.ZodString>;
        source: z.ZodEnum<{
            puiMatch: "puiMatch";
            nameMatch: "nameMatch";
            synonymMatch: "synonymMatch";
            traitClassMatch: "traitClassMatch";
        }>;
    }, 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_variables.";
}, {
    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 variables, traitClasses, ontologyDbIds, methodDbIds, scaleDbIds, or text — 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-variables.tool.d.ts.map