/**
 * @fileoverview `brapi_dataframe_describe` — list dataframes (or describe one)
 * with column schema, row count, and originating-source provenance.
 * Auto-registered spillover dataframes (`df_<uuid>`) carry full provenance
 * (originating tool, baseUrl, query, expiry); user-derived dataframes
 * created via `brapi_dataframe_query({ registerAs })` only show structural info.
 *
 * Start here after a find_* tool spillover — the dataframe handle on the
 * find result and `brapi_dataframe_describe` together orient you to schema +
 * provenance before you write the first SQL query.
 *
 * @module mcp-server/tools/definitions/brapi-dataframe-describe.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const brapiDataframeDescribe: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    dataframe: z.ZodOptional<z.ZodString>;
}, z.core.$strip>, z.ZodObject<{
    tables: z.ZodArray<z.ZodObject<{
        name: z.ZodString;
        rowCount: z.ZodNumber;
        columns: z.ZodArray<z.ZodObject<{
            name: z.ZodString;
            type: z.ZodString;
            nullable: z.ZodOptional<z.ZodBoolean>;
        }, z.core.$strip>>;
        approxSizeBytes: z.ZodOptional<z.ZodNumber>;
        provenance: z.ZodOptional<z.ZodObject<{
            source: z.ZodString;
            baseUrl: z.ZodString;
            query: z.ZodUnknown;
            createdAt: z.ZodString;
            expiresAt: z.ZodString;
        }, z.core.$strip>>;
    }, z.core.$strip>>;
}, z.core.$strip>, readonly [{
    readonly reason: "list_all_disabled_on_shared_http";
    readonly code: JsonRpcErrorCode.Forbidden;
    readonly when: "This server is running as a shared HTTP endpoint without per-caller auth — listing every dataframe would expose other concurrent clients' workspaces, since all callers resolve to one shared tenant.";
    readonly recovery: "Pass `dataframe` with a specific name — either from a prior find_* spillover result (`result.dataframe.tableName`) or one you registered via `brapi_dataframe_query` with `registerAs`. Listing all dataframes is not available on this deployment.";
}], undefined>;
//# sourceMappingURL=brapi-dataframe-describe.tool.d.ts.map