@cyanheads/brapi-mcp-server 0.3.6 → 0.3.8

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -0,0 +1,1033 @@
+/**
+ * @fileoverview Tool registration barrel. The write tool
+ * (`brapi_submit_observations`) is exported separately so callers can decide
+ * whether to register it based on the `BRAPI_ENABLE_WRITES` flag — keeping
+ * this module free of eager config reads.
+ * @module mcp-server/tools/definitions/index
+ */
+/** Read-only tools registered unconditionally on every server. */
+export declare const readOnlyToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    endpoint: import("zod").ZodEnum<{
+        [x: string]: string;
+    }>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    endpoint: import("zod").ZodString;
+    filterCount: import("zod").ZodNumber;
+    filters: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        type: import("zod").ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            date: "date";
+            integer: "integer";
+            "string[]": "string[]";
+            "integer[]": "integer[]";
+        }>;
+        description: import("zod").ZodString;
+        example: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    specReference: import("zod").ZodOptional<import("zod").ZodString>;
+    availableEndpoints: import("zod").ZodArray<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "unknown_endpoint";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No filter catalog is registered for the requested endpoint";
+    readonly recovery: "Pick an endpoint from data.availableEndpoints — same set as the input enum (studies, germplasm, observations, variables, images, variants, locations).";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    germplasmDbId: import("zod").ZodString;
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    germplasm: import("zod").ZodObject<{
+        germplasmDbId: import("zod").ZodString;
+        germplasmName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmPUI: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        commonCropName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        accessionNumber: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        genus: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        species: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        subtaxa: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        defaultDisplayName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        pedigree: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        biologicalStatusOfAccessionDescription: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmOrigin: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>>>;
+        countryOfOriginCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        collection: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        instituteCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        instituteName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        synonyms: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodObject<{
+            synonym: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+            type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        }, import("zod/v4/core").$loose>>>>;
+    }, import("zod/v4/core").$loose>;
+    parents: import("zod").ZodArray<import("zod").ZodObject<{
+        germplasmDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        parentType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$loose>>;
+    attributes: import("zod").ZodArray<import("zod").ZodObject<{
+        attributeDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        attributeName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        attributeValue: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        determinedDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$loose>>;
+    studyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    directParentCount: import("zod").ZodNumber;
+    directDescendantCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "germplasm_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Upstream returned no germplasm record for the requested DbId";
+    readonly recovery: "Verify the germplasmDbId on the target server, or run brapi_find_germplasm to discover valid IDs.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    forceRefresh: import("zod").ZodDefault<import("zod").ZodBoolean>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    baseUrl: import("zod").ZodString;
+    server: import("zod").ZodObject<{
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        organizationName: import("zod").ZodOptional<import("zod").ZodString>;
+        organizationURL: import("zod").ZodOptional<import("zod").ZodString>;
+        documentationURL: import("zod").ZodOptional<import("zod").ZodString>;
+        contactEmail: import("zod").ZodOptional<import("zod").ZodString>;
+        brapiVersion: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    auth: import("zod").ZodObject<{
+        mode: import("zod").ZodEnum<{
+            none: "none";
+            sgn: "sgn";
+            oauth2: "oauth2";
+            api_key: "api_key";
+            bearer: "bearer";
+        }>;
+        headerName: import("zod").ZodOptional<import("zod").ZodString>;
+        expiresAt: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    capabilities: import("zod").ZodObject<{
+        supportedCount: import("zod").ZodNumber;
+        supported: import("zod").ZodArray<import("zod").ZodString>;
+        notableGaps: import("zod").ZodArray<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    content: import("zod").ZodObject<{
+        crops: import("zod").ZodArray<import("zod").ZodString>;
+        studyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        germplasmCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        programCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        locationCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    notes: import("zod").ZodArray<import("zod").ZodString>;
+    fetchedAt: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    studyDbId: import("zod").ZodString;
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    study: import("zod").ZodObject<{
+        studyDbId: import("zod").ZodString;
+        studyName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyDescription: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        programDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        programName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        trialDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        trialName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        locationDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        locationName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        commonCropName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        seasons: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
+        active: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
+        startDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        endDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyPUI: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$loose>;
+    program: import("zod").ZodOptional<import("zod").ZodObject<{
+        programDbId: import("zod").ZodString;
+        programName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        commonCropName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        abbreviation: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        leadPersonName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        documentationURL: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$loose>>;
+    trial: import("zod").ZodOptional<import("zod").ZodObject<{
+        trialDbId: import("zod").ZodString;
+        trialName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        programDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        programName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        commonCropName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        startDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        endDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        active: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
+        trialDescription: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$loose>>;
+    location: import("zod").ZodOptional<import("zod").ZodObject<{
+        locationDbId: import("zod").ZodString;
+        locationName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        abbreviation: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        countryCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        countryName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        locationType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        latitude: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        longitude: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        altitude: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        coordinates: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>>;
+    }, import("zod/v4/core").$loose>>;
+    observationCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    observationUnitCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    variableCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "study_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").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.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    baseUrl: import("zod").ZodOptional<import("zod").ZodString>;
+    auth: import("zod").ZodOptional<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"none">;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"bearer">;
+        token: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"api_key">;
+        apiKey: import("zod").ZodString;
+        headerName: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"sgn">;
+        username: import("zod").ZodString;
+        password: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"oauth2">;
+        clientId: import("zod").ZodString;
+        clientSecret: import("zod").ZodString;
+        tokenUrl: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>], "mode">>;
+    alias: import("zod").ZodDefault<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    baseUrl: import("zod").ZodString;
+    server: import("zod").ZodObject<{
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        organizationName: import("zod").ZodOptional<import("zod").ZodString>;
+        organizationURL: import("zod").ZodOptional<import("zod").ZodString>;
+        documentationURL: import("zod").ZodOptional<import("zod").ZodString>;
+        contactEmail: import("zod").ZodOptional<import("zod").ZodString>;
+        brapiVersion: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    auth: import("zod").ZodObject<{
+        mode: import("zod").ZodEnum<{
+            none: "none";
+            sgn: "sgn";
+            oauth2: "oauth2";
+            api_key: "api_key";
+            bearer: "bearer";
+        }>;
+        headerName: import("zod").ZodOptional<import("zod").ZodString>;
+        expiresAt: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    capabilities: import("zod").ZodObject<{
+        supportedCount: import("zod").ZodNumber;
+        supported: import("zod").ZodArray<import("zod").ZodString>;
+        notableGaps: import("zod").ZodArray<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    content: import("zod").ZodObject<{
+        crops: import("zod").ZodArray<import("zod").ZodString>;
+        studyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        germplasmCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        programCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        locationCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    notes: import("zod").ZodArray<import("zod").ZodString>;
+    fetchedAt: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "auth_token_exchange_failed";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
+    readonly when: "SGN or OAuth token exchange against the BrAPI /token endpoint failed";
+    readonly recovery: "Verify the credentials and that the server exposes /token before retrying.";
+}, {
+    readonly reason: "auth_no_access_token";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
+    readonly when: "Token endpoint responded but did not return an access_token";
+    readonly recovery: "Confirm the credentials are valid and the upstream IdP issues access tokens for this grant.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    variantSetDbId: import("zod").ZodOptional<import("zod").ZodString>;
+    variantSetDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    germplasmDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    callSetDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    variantDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    callFormat: import("zod").ZodOptional<import("zod").ZodEnum<{
+        VCF: "VCF";
+        FLAPJACK: "FLAPJACK";
+        DARTSEQ: "DARTSEQ";
+        JSON: "JSON";
+    }>>;
+    maxCalls: import("zod").ZodOptional<import("zod").ZodNumber>;
+    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        callSetDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        callSetName: import("zod").ZodOptional<import("zod").ZodString>;
+        variantDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        variantName: import("zod").ZodOptional<import("zod").ZodString>;
+        variantSetDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        genotype: import("zod").ZodOptional<import("zod").ZodObject<{
+            values: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        }, import("zod/v4/core").$loose>>;
+        genotypeValue: import("zod").ZodOptional<import("zod").ZodString>;
+        phaseSet: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$loose>>;
+    returnedCount: import("zod").ZodNumber;
+    totalCount: import("zod").ZodNumber;
+    hasMore: import("zod").ZodBoolean;
+    callFormatting: import("zod").ZodObject<{
+        expandHomozygotes: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        unknownString: import("zod").ZodOptional<import("zod").ZodString>;
+        sepPhased: import("zod").ZodOptional<import("zod").ZodString>;
+        sepUnphased: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    distributions: import("zod").ZodObject<{
+        callSetName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        variantName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        variantSetDbId: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        datasetId: import("zod").ZodString;
+        rowCount: import("zod").ZodNumber;
+        sizeBytes: import("zod").ZodNumber;
+        columns: import("zod").ZodArray<import("zod").ZodString>;
+        createdAt: import("zod").ZodString;
+        expiresAt: import("zod").ZodString;
+        truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    truncated: import("zod").ZodBoolean;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+    searchBody: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_filters";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "No variant set, germplasm, call set, or variant filter was provided";
+    readonly recovery: "Provide variantSetDbId or germplasmDbIds before retrying — unfiltered pulls are too expensive.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    names: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    germplasmDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    germplasmPUIs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    accessionNumbers: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    crops: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    synonyms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    collections: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    genus: import("zod").ZodOptional<import("zod").ZodString>;
+    species: import("zod").ZodOptional<import("zod").ZodString>;
+    text: import("zod").ZodOptional<import("zod").ZodString>;
+    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+    extraFilters: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        germplasmDbId: import("zod").ZodString;
+        germplasmName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmPUI: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        commonCropName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        accessionNumber: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        genus: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        species: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        subtaxa: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        defaultDisplayName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        pedigree: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        biologicalStatusOfAccessionDescription: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        germplasmOrigin: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>>>;
+        countryOfOriginCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        collection: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        instituteCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        instituteName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        synonyms: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodObject<{
+            synonym: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+            type: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        }, import("zod/v4/core").$loose>>>>;
+    }, import("zod/v4/core").$loose>>;
+    returnedCount: import("zod").ZodNumber;
+    totalCount: import("zod").ZodNumber;
+    hasMore: import("zod").ZodBoolean;
+    distributions: import("zod").ZodObject<{
+        commonCropName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        genus: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        species: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        collection: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        countryOfOriginCode: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        datasetId: import("zod").ZodString;
+        rowCount: import("zod").ZodNumber;
+        sizeBytes: import("zod").ZodNumber;
+        columns: import("zod").ZodArray<import("zod").ZodString>;
+        createdAt: import("zod").ZodString;
+        expiresAt: import("zod").ZodString;
+        truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+    appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    images: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    observationUnits: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    observations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    studies: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    imageFileNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    mimeTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    descriptiveOntologyTerms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+    extraFilters: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        imageDbId: import("zod").ZodString;
+        imageName: import("zod").ZodOptional<import("zod").ZodString>;
+        imageFileName: import("zod").ZodOptional<import("zod").ZodString>;
+        imageFileSize: import("zod").ZodOptional<import("zod").ZodNumber>;
+        imageHeight: import("zod").ZodOptional<import("zod").ZodNumber>;
+        imageWidth: import("zod").ZodOptional<import("zod").ZodNumber>;
+        mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+        imageTimeStamp: import("zod").ZodOptional<import("zod").ZodString>;
+        imageURL: import("zod").ZodOptional<import("zod").ZodString>;
+        observationUnitDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        observationUnitName: import("zod").ZodOptional<import("zod").ZodString>;
+        observationDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        studyDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        studyName: import("zod").ZodOptional<import("zod").ZodString>;
+        descriptiveOntologyTerms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        copyright: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$loose>>;
+    returnedCount: import("zod").ZodNumber;
+    totalCount: import("zod").ZodNumber;
+    hasMore: import("zod").ZodBoolean;
+    distributions: import("zod").ZodObject<{
+        mimeType: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        studyName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        observationUnitName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        descriptiveOntologyTerms: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        datasetId: import("zod").ZodString;
+        rowCount: import("zod").ZodNumber;
+        sizeBytes: import("zod").ZodNumber;
+        columns: import("zod").ZodArray<import("zod").ZodString>;
+        createdAt: import("zod").ZodString;
+        expiresAt: import("zod").ZodString;
+        truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+    appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    locations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    locationNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    countryCodes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    locationTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    abbreviations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    bbox: import("zod").ZodOptional<import("zod").ZodObject<{
+        minLat: import("zod").ZodOptional<import("zod").ZodNumber>;
+        maxLat: import("zod").ZodOptional<import("zod").ZodNumber>;
+        minLon: import("zod").ZodOptional<import("zod").ZodNumber>;
+        maxLon: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+    extraFilters: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        locationDbId: import("zod").ZodString;
+        locationName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        abbreviation: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        countryCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        countryName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        locationType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        latitude: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        longitude: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        altitude: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        coordinates: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{}, import("zod/v4/core").$loose>>>;
+        instituteName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        instituteAddress: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        documentationURL: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$loose>>;
+    returnedCount: import("zod").ZodNumber;
+    totalCount: import("zod").ZodNumber;
+    hasMore: import("zod").ZodBoolean;
+    distributions: import("zod").ZodObject<{
+        countryCode: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        locationType: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        datasetId: import("zod").ZodString;
+        rowCount: import("zod").ZodNumber;
+        sizeBytes: import("zod").ZodNumber;
+        columns: import("zod").ZodArray<import("zod").ZodString>;
+        createdAt: import("zod").ZodString;
+        expiresAt: import("zod").ZodString;
+        truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+    appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    studies: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    germplasm: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    variables: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    observationUnits: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    observations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    seasons: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    programs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    trials: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    observationLevels: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    timestampFrom: import("zod").ZodOptional<import("zod").ZodString>;
+    timestampTo: import("zod").ZodOptional<import("zod").ZodString>;
+    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+    extraFilters: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        observationDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        observationUnitDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        observationUnitName: import("zod").ZodOptional<import("zod").ZodString>;
+        observationVariableDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        observationVariableName: import("zod").ZodOptional<import("zod").ZodString>;
+        studyDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        studyName: import("zod").ZodOptional<import("zod").ZodString>;
+        germplasmDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        germplasmName: import("zod").ZodOptional<import("zod").ZodString>;
+        observationLevel: import("zod").ZodOptional<import("zod").ZodString>;
+        season: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodObject<{
+            seasonDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            year: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber]>>;
+            season: import("zod").ZodOptional<import("zod").ZodString>;
+            seasonName: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$loose>]>>;
+        value: import("zod").ZodOptional<import("zod").ZodString>;
+        observationTimeStamp: import("zod").ZodOptional<import("zod").ZodString>;
+        collector: import("zod").ZodOptional<import("zod").ZodString>;
+        uploadedBy: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$loose>>;
+    returnedCount: import("zod").ZodNumber;
+    totalCount: import("zod").ZodNumber;
+    hasMore: import("zod").ZodBoolean;
+    distributions: import("zod").ZodObject<{
+        observationVariableName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        studyName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        germplasmName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        observationLevel: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        season: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        datasetId: import("zod").ZodString;
+        rowCount: import("zod").ZodNumber;
+        sizeBytes: import("zod").ZodNumber;
+        columns: import("zod").ZodArray<import("zod").ZodString>;
+        createdAt: import("zod").ZodString;
+        expiresAt: import("zod").ZodString;
+        truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+    appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    crop: import("zod").ZodOptional<import("zod").ZodString>;
+    trialTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    seasons: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    locations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    programs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    trials: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    studyNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    active: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    text: import("zod").ZodOptional<import("zod").ZodString>;
+    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+    extraFilters: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        studyDbId: import("zod").ZodString;
+        studyName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyDescription: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        programDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        programName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        trialDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        trialName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        locationDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        locationName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        commonCropName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        seasons: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
+        active: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
+        startDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        endDate: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyCode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        studyPUI: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$loose>>;
+    returnedCount: import("zod").ZodNumber;
+    totalCount: import("zod").ZodNumber;
+    hasMore: import("zod").ZodBoolean;
+    distributions: import("zod").ZodObject<{
+        programName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        studyType: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        seasons: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        locationName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        commonCropName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        datasetId: import("zod").ZodString;
+        rowCount: import("zod").ZodNumber;
+        sizeBytes: import("zod").ZodNumber;
+        columns: import("zod").ZodArray<import("zod").ZodString>;
+        createdAt: import("zod").ZodString;
+        expiresAt: import("zod").ZodString;
+        truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+    appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    variables: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    variableNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    variablePUIs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    traitClasses: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    ontologies: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    studies: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    methods: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    scales: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    crop: import("zod").ZodOptional<import("zod").ZodString>;
+    text: import("zod").ZodOptional<import("zod").ZodString>;
+    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+    extraFilters: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        observationVariableDbId: import("zod").ZodString;
+        observationVariableName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        observationVariablePUI: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        ontologyDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        ontologyName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        commonCropName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        trait: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{
+            traitDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+            traitName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+            traitClass: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+            description: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+            synonyms: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
+        }, import("zod/v4/core").$loose>>>;
+        scale: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{
+            scaleDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+            scaleName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+            dataType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        }, import("zod/v4/core").$loose>>>;
+        method: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{
+            methodDbId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+            methodName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        }, import("zod/v4/core").$loose>>>;
+    }, import("zod/v4/core").$loose>>;
+    returnedCount: import("zod").ZodNumber;
+    totalCount: import("zod").ZodNumber;
+    hasMore: import("zod").ZodBoolean;
+    distributions: import("zod").ZodObject<{
+        ontologyDbId: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        traitClass: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        scaleName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    ontologyCandidates: import("zod").ZodArray<import("zod").ZodObject<{
+        observationVariableDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        termId: import("zod").ZodOptional<import("zod").ZodString>;
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        synonyms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        ontologyDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        source: import("zod").ZodEnum<{
+            puiMatch: "puiMatch";
+            nameMatch: "nameMatch";
+            synonymMatch: "synonymMatch";
+            traitClassMatch: "traitClassMatch";
+        }>;
+    }, import("zod/v4/core").$strip>>;
+    refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        datasetId: import("zod").ZodString;
+        rowCount: import("zod").ZodNumber;
+        sizeBytes: import("zod").ZodNumber;
+        columns: import("zod").ZodArray<import("zod").ZodString>;
+        createdAt: import("zod").ZodString;
+        expiresAt: import("zod").ZodString;
+        truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+    appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    variantSets: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    variants: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    references: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    referenceName: import("zod").ZodOptional<import("zod").ZodString>;
+    start: import("zod").ZodOptional<import("zod").ZodNumber>;
+    end: import("zod").ZodOptional<import("zod").ZodNumber>;
+    loadLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+    extraFilters: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        variantDbId: import("zod").ZodString;
+        variantNames: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        variantSetDbId: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>]>>;
+        variantSetDbIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        variantType: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        referenceBases: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        alternateBases: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
+        referenceName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        start: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        end: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+        filtersPassed: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
+        filtersApplied: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
+        filtersFailed: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodArray<import("zod").ZodString>>>;
+    }, import("zod/v4/core").$loose>>;
+    returnedCount: import("zod").ZodNumber;
+    totalCount: import("zod").ZodNumber;
+    hasMore: import("zod").ZodBoolean;
+    distributions: import("zod").ZodObject<{
+        variantType: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        referenceName: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+        variantSetDbId: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    refinementHint: import("zod").ZodOptional<import("zod").ZodString>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        datasetId: import("zod").ZodString;
+        rowCount: import("zod").ZodNumber;
+        sizeBytes: import("zod").ZodNumber;
+        columns: import("zod").ZodArray<import("zod").ZodString>;
+        createdAt: import("zod").ZodString;
+        expiresAt: import("zod").ZodString;
+        truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+    appliedFilters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    imageDbIds: import("zod").ZodArray<import("zod").ZodString>;
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    images: import("zod").ZodArray<import("zod").ZodObject<{
+        imageDbId: import("zod").ZodString;
+        mimeType: import("zod").ZodString;
+        sizeBytes: import("zod").ZodNumber;
+        source: import("zod").ZodEnum<{
+            imageURL: "imageURL";
+            imagecontent: "imagecontent";
+        }>;
+        data: import("zod").ZodString;
+        metadata: import("zod").ZodObject<{
+            imageDbId: import("zod").ZodString;
+            imageName: import("zod").ZodOptional<import("zod").ZodString>;
+            imageFileName: import("zod").ZodOptional<import("zod").ZodString>;
+            imageHeight: import("zod").ZodOptional<import("zod").ZodNumber>;
+            imageWidth: import("zod").ZodOptional<import("zod").ZodNumber>;
+            mimeType: import("zod").ZodOptional<import("zod").ZodString>;
+            imageURL: import("zod").ZodOptional<import("zod").ZodString>;
+            observationUnitDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            observationUnitName: import("zod").ZodOptional<import("zod").ZodString>;
+            studyDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            studyName: import("zod").ZodOptional<import("zod").ZodString>;
+            imageTimeStamp: import("zod").ZodOptional<import("zod").ZodString>;
+            copyright: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$loose>;
+    }, import("zod/v4/core").$strip>>;
+    errors: import("zod").ZodArray<import("zod").ZodObject<{
+        imageDbId: import("zod").ZodString;
+        error: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    warnings: import("zod").ZodArray<import("zod").ZodObject<{
+        imageDbId: import("zod").ZodString;
+        warning: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "images_unsupported";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "BrAPI server does not advertise /images in /serverinfo";
+    readonly recovery: "Run brapi_server_info to inspect the advertised endpoints, or call brapi_connect with a different alias for a server that exposes /images.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    mode: import("zod").ZodEnum<{
+        delete: "delete";
+        list: "list";
+        summary: "summary";
+        load: "load";
+    }>;
+    datasetId: import("zod").ZodOptional<import("zod").ZodString>;
+    cursor: import("zod").ZodOptional<import("zod").ZodString>;
+    limit: import("zod").ZodOptional<import("zod").ZodNumber>;
+    page: import("zod").ZodOptional<import("zod").ZodNumber>;
+    pageSize: import("zod").ZodOptional<import("zod").ZodNumber>;
+    columns: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    result: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"list">;
+        datasets: import("zod").ZodArray<import("zod").ZodObject<{
+            datasetId: import("zod").ZodString;
+            source: import("zod").ZodString;
+            baseUrl: import("zod").ZodString;
+            query: import("zod").ZodUnknown;
+            rowCount: import("zod").ZodNumber;
+            columns: import("zod").ZodArray<import("zod").ZodString>;
+            sizeBytes: import("zod").ZodNumber;
+            createdAt: import("zod").ZodString;
+            expiresAt: import("zod").ZodString;
+            truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>>;
+        cursor: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"summary">;
+        dataset: import("zod").ZodObject<{
+            datasetId: import("zod").ZodString;
+            source: import("zod").ZodString;
+            baseUrl: import("zod").ZodString;
+            query: import("zod").ZodUnknown;
+            rowCount: import("zod").ZodNumber;
+            columns: import("zod").ZodArray<import("zod").ZodString>;
+            sizeBytes: import("zod").ZodNumber;
+            createdAt: import("zod").ZodString;
+            expiresAt: import("zod").ZodString;
+            truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"load">;
+        datasetId: import("zod").ZodString;
+        page: import("zod").ZodNumber;
+        pageSize: import("zod").ZodNumber;
+        totalRows: import("zod").ZodNumber;
+        totalPages: import("zod").ZodNumber;
+        rows: import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"delete">;
+        datasetId: import("zod").ZodString;
+        deleted: import("zod").ZodLiteral<true>;
+    }, import("zod/v4/core").$strip>], "mode">;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "datasetid_required";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "Mode summary, load, or delete was selected without a datasetId";
+    readonly recovery: "Call mode=list first to discover available dataset IDs, then retry with one.";
+}, {
+    readonly reason: "dataset_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Requested dataset is not present in the store (never existed or already expired)";
+    readonly recovery: "Run mode=list to confirm available datasets, or rerun the find_* tool that produced it.";
+}, {
+    readonly reason: "dataset_rows_missing";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Dataset metadata is present but the row payload was lost or partially expired";
+    readonly recovery: "Delete the stale dataset via mode=delete and rerun the find_* tool that produced it.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    path: import("zod").ZodString;
+    params: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber, import("zod").ZodBoolean, import("zod").ZodArray<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber]>>]>>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    url: import("zod").ZodString;
+    path: import("zod").ZodString;
+    metadata: import("zod").ZodObject<{
+        pagination: import("zod").ZodOptional<import("zod").ZodObject<{
+            currentPage: import("zod").ZodNumber;
+            pageSize: import("zod").ZodNumber;
+            totalCount: import("zod").ZodNumber;
+            totalPages: import("zod").ZodNumber;
+        }, import("zod/v4/core").$loose>>;
+    }, import("zod/v4/core").$loose>;
+    result: import("zod").ZodUnknown;
+    suggestion: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "cross_origin_path";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "path argument was a full URL instead of a relative BrAPI route";
+    readonly recovery: "Pass a path like \"/samples\" or \"/methods\" — the connection alias supplies the baseUrl.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    noun: import("zod").ZodString;
+    body: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    noun: import("zod").ZodString;
+    kind: import("zod").ZodEnum<{
+        sync: "sync";
+        async: "async";
+    }>;
+    searchResultsDbId: import("zod").ZodOptional<import("zod").ZodString>;
+    metadata: import("zod").ZodObject<{
+        pagination: import("zod").ZodOptional<import("zod").ZodObject<{
+            currentPage: import("zod").ZodNumber;
+            pageSize: import("zod").ZodNumber;
+            totalCount: import("zod").ZodNumber;
+            totalPages: import("zod").ZodNumber;
+        }, import("zod/v4/core").$loose>>;
+    }, import("zod/v4/core").$loose>;
+    result: import("zod").ZodUnknown;
+    suggestion: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    germplasmDbIds: import("zod").ZodArray<import("zod").ZodString>;
+    direction: import("zod").ZodDefault<import("zod").ZodEnum<{
+        ancestors: "ancestors";
+        descendants: "descendants";
+        both: "both";
+    }>>;
+    maxDepth: import("zod").ZodDefault<import("zod").ZodNumber>;
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    direction: import("zod").ZodEnum<{
+        ancestors: "ancestors";
+        descendants: "descendants";
+        both: "both";
+    }>;
+    maxDepth: import("zod").ZodNumber;
+    nodes: import("zod").ZodArray<import("zod").ZodObject<{
+        germplasmDbId: import("zod").ZodString;
+        germplasmName: import("zod").ZodOptional<import("zod").ZodString>;
+        depth: import("zod").ZodNumber;
+        isRoot: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>>;
+    edges: import("zod").ZodArray<import("zod").ZodObject<{
+        from: import("zod").ZodString;
+        to: import("zod").ZodString;
+        relationship: import("zod").ZodEnum<{
+            parent: "parent";
+            child: "child";
+        }>;
+        parentType: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    depthReached: import("zod").ZodNumber;
+    rootCount: import("zod").ZodNumber;
+    leafCount: import("zod").ZodNumber;
+    cycleCount: import("zod").ZodNumber;
+    deadEndCount: import("zod").ZodNumber;
+    truncated: import("zod").ZodBoolean;
+    warnings: import("zod").ZodArray<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, undefined>)[];
+/** Write tools — registered only when `BRAPI_ENABLE_WRITES=true`. */
+export declare const writeToolDefinitions: import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    alias: import("zod").ZodOptional<import("zod").ZodString>;
+    studyDbId: import("zod").ZodString;
+    observations: import("zod").ZodArray<import("zod").ZodObject<{
+        observationDbId: import("zod").ZodOptional<import("zod").ZodString>;
+        observationUnitDbId: import("zod").ZodString;
+        observationVariableDbId: import("zod").ZodString;
+        value: import("zod").ZodString;
+        collector: import("zod").ZodOptional<import("zod").ZodString>;
+        observationTimeStamp: import("zod").ZodOptional<import("zod").ZodString>;
+        season: import("zod").ZodOptional<import("zod").ZodObject<{
+            seasonDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            year: import("zod").ZodOptional<import("zod").ZodString>;
+            season: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        geoCoordinates: import("zod").ZodOptional<import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"Feature">;
+            geometry: import("zod").ZodObject<{
+                type: import("zod").ZodLiteral<"Point">;
+                coordinates: import("zod").ZodArray<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$strip>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+    mode: import("zod").ZodDefault<import("zod").ZodEnum<{
+        preview: "preview";
+        apply: "apply";
+    }>>;
+    force: import("zod").ZodDefault<import("zod").ZodBoolean>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    alias: import("zod").ZodString;
+    result: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"preview">;
+        studyDbId: import("zod").ZodString;
+        studyName: import("zod").ZodOptional<import("zod").ZodString>;
+        valid: import("zod").ZodNumber;
+        invalid: import("zod").ZodNumber;
+        routing: import("zod").ZodObject<{
+            postCount: import("zod").ZodNumber;
+            putCount: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strip>;
+        perRowWarnings: import("zod").ZodArray<import("zod").ZodObject<{
+            rowIndex: import("zod").ZodNumber;
+            observationVariableDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            observationUnitDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            warning: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>>;
+        knownVariableCount: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        mode: import("zod").ZodLiteral<"apply">;
+        studyDbId: import("zod").ZodString;
+        studyName: import("zod").ZodOptional<import("zod").ZodString>;
+        posted: import("zod").ZodArray<import("zod").ZodObject<{
+            observationDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            observationUnitDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            observationVariableDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            value: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        updated: import("zod").ZodArray<import("zod").ZodObject<{
+            observationDbId: import("zod").ZodString;
+            observationUnitDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            observationVariableDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            value: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        studyObservationCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        latestObservationTimestamp: import("zod").ZodOptional<import("zod").ZodString>;
+        perRowWarnings: import("zod").ZodArray<import("zod").ZodObject<{
+            rowIndex: import("zod").ZodNumber;
+            observationVariableDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            observationUnitDbId: import("zod").ZodOptional<import("zod").ZodString>;
+            warning: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>], "mode">;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "observations_unsupported";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "BrAPI server does not advertise /observations";
+    readonly recovery: "Run brapi_server_info to inspect the advertised endpoints, or call brapi_connect with a different alias for a server that exposes /observations.";
+}, {
+    readonly reason: "study_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Upstream returned no study record for the requested studyDbId";
+    readonly recovery: "Verify the studyDbId on the target server, or run brapi_find_studies to discover valid IDs before retrying.";
+}, {
+    readonly reason: "post_unsupported";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "Server does not advertise POST on /observations but new rows were submitted";
+    readonly recovery: "Remove the rows that lack observationDbId (those are the new rows) before retrying, or connect to a different server that supports POST on /observations.";
+}, {
+    readonly reason: "put_unsupported";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "Server does not advertise PUT on /observations but update rows were submitted";
+    readonly recovery: "Connect to a different server that supports PUT on /observations — dropping observationDbId would route as POST and create duplicates instead of updating the existing rows.";
+}, {
+    readonly reason: "elicit_unavailable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
+    readonly when: "Apply mode invoked but client does not expose ctx.elicit and force was false";
+    readonly recovery: "Set force=true only with explicit user authorization, or use a client that supports elicitation.";
+}, {
+    readonly reason: "user_declined";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
+    readonly when: "User declined the elicitation prompt for the apply write";
+    readonly recovery: "Re-run the tool when the user is ready to confirm the write.";
+}]>[];
+//# sourceMappingURL=index.d.ts.map