/**
 * @fileoverview `brapi_connect` — session-bootstrap tool. Authenticates to a
 * BrAPI v2 server, registers the connection under a named alias, loads the
 * capability profile (via CapabilityRegistry), and returns the full
 * orientation envelope inline. One call fully orients the agent — the same
 * envelope is available on-demand via `brapi_server_info`.
 *
 * @module mcp-server/tools/definitions/brapi-connect.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const brapiConnect: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    baseUrl: z.ZodOptional<z.ZodString>;
    auth: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
        mode: z.ZodLiteral<"none">;
    }, z.core.$strip>, z.ZodObject<{
        mode: z.ZodLiteral<"bearer">;
        token: z.ZodString;
    }, z.core.$strip>, z.ZodObject<{
        mode: z.ZodLiteral<"api_key">;
        apiKey: z.ZodString;
        headerName: z.ZodOptional<z.ZodString>;
    }, z.core.$strip>, z.ZodObject<{
        mode: z.ZodLiteral<"sgn">;
        username: z.ZodString;
        password: z.ZodString;
    }, z.core.$strip>, z.ZodObject<{
        mode: z.ZodLiteral<"oauth2">;
        clientId: z.ZodString;
        clientSecret: z.ZodString;
        tokenUrl: z.ZodOptional<z.ZodString>;
    }, z.core.$strip>], "mode">>;
    alias: z.ZodDefault<z.ZodString>;
}, z.core.$strip>, z.ZodObject<{
    alias: z.ZodString;
    baseUrl: z.ZodString;
    server: z.ZodObject<{
        name: z.ZodOptional<z.ZodString>;
        description: z.ZodOptional<z.ZodString>;
        organizationName: z.ZodOptional<z.ZodString>;
        organizationURL: z.ZodOptional<z.ZodString>;
        documentationURL: z.ZodOptional<z.ZodString>;
        contactEmail: z.ZodOptional<z.ZodString>;
        brapiVersion: z.ZodOptional<z.ZodString>;
    }, z.core.$strip>;
    auth: z.ZodObject<{
        mode: z.ZodEnum<{
            none: "none";
            sgn: "sgn";
            oauth2: "oauth2";
            api_key: "api_key";
            bearer: "bearer";
        }>;
        headerName: z.ZodOptional<z.ZodString>;
        expiresAt: z.ZodOptional<z.ZodString>;
    }, z.core.$strip>;
    capabilities: z.ZodObject<{
        supportedCount: z.ZodNumber;
        supported: z.ZodArray<z.ZodString>;
        notableGaps: z.ZodArray<z.ZodString>;
    }, z.core.$strip>;
    dialect: z.ZodObject<{
        id: z.ZodString;
        source: z.ZodEnum<{
            "env-override": "env-override";
            "url-pattern": "url-pattern";
            "server-name": "server-name";
            "organization-name": "organization-name";
            fallback: "fallback";
        }>;
        envVar: z.ZodString;
        disabledSearchEndpoints: z.ZodArray<z.ZodString>;
        notes: z.ZodArray<z.ZodString>;
        verifiedMappingCount: z.ZodOptional<z.ZodNumber>;
        inferredMappingCount: z.ZodOptional<z.ZodNumber>;
    }, z.core.$strip>;
    content: z.ZodObject<{
        crops: z.ZodArray<z.ZodString>;
        studyCount: z.ZodOptional<z.ZodNumber>;
        germplasmCount: z.ZodOptional<z.ZodNumber>;
        programCount: z.ZodOptional<z.ZodNumber>;
        locationCount: z.ZodOptional<z.ZodNumber>;
    }, z.core.$strip>;
    attribution: z.ZodOptional<z.ZodObject<{
        homepage: z.ZodString;
        license: z.ZodString;
        citation: z.ZodString;
        isDemo: z.ZodOptional<z.ZodBoolean>;
    }, z.core.$strip>>;
    notes: z.ZodArray<z.ZodString>;
    fetchedAt: z.ZodString;
}, z.core.$strip>, readonly [{
    readonly reason: "auth_token_exchange_failed";
    readonly code: 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: 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.";
}], undefined>;
//# sourceMappingURL=brapi-connect.tool.d.ts.map