/**
 * @fileoverview `brapi_raw_search` — last-resort passthrough to any BrAPI
 * `POST /search/{noun}` endpoint with async-search polling handled
 * transparently. Returns the raw upstream envelope once the search completes,
 * and spills to a canvas dataframe when the upstream advertises more rows
 * than `loadLimit` AND the result is a list shape. Spillover is skipped
 * when the caller drives paging via `body.page` / `body.pageSize` — they're
 * walking pages explicitly. Emits a routing nudge when a curated goal-shaped
 * tool covers the noun.
 *
 * @module mcp-server/tools/definitions/brapi-raw-search.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const brapiRawSearch: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    alias: z.ZodOptional<z.ZodString>;
    noun: z.ZodString;
    body: z.ZodRecord<z.ZodString, z.ZodUnknown>;
    loadLimit: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>, z.ZodObject<{
    alias: z.ZodString;
    noun: z.ZodString;
    kind: z.ZodEnum<{
        sync: "sync";
        async: "async";
    }>;
    searchResultsDbId: z.ZodOptional<z.ZodString>;
    metadata: z.ZodObject<{
        pagination: z.ZodOptional<z.ZodObject<{
            currentPage: z.ZodNumber;
            pageSize: z.ZodNumber;
            totalCount: z.ZodNumber;
            totalPages: z.ZodNumber;
        }, z.core.$loose>>;
    }, z.core.$loose>;
    result: z.ZodUnknown;
    suggestion: z.ZodOptional<z.ZodString>;
    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_raw_search.";
}, {
    readonly reason: "search_endpoint_disabled";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "The active dialect declares this POST /search/{noun} route as known-dead on this server";
    readonly recovery: "Use the curated find_* tool for this noun — it routes through GET filters instead and avoids the dead search route.";
}], undefined>;
//# sourceMappingURL=brapi-raw-search.tool.d.ts.map