/**
 * @fileoverview DataCanvas describe tool — list registered tables in a canvas session.
 * Only meaningful when CANVAS_PROVIDER_TYPE=duckdb.
 * @module mcp-server/tools/definitions/dataframe-describe.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const dataframeDescribe: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    canvas_id: z.ZodOptional<z.ZodString>;
}, z.core.$strip>, z.ZodObject<{
    tables: z.ZodArray<z.ZodObject<{
        table_id: z.ZodString;
        row_count: z.ZodNumber;
        columns: z.ZodArray<z.ZodObject<{
            name: z.ZodString;
            type: z.ZodString;
        }, z.core.$strip>>;
    }, z.core.$strip>>;
    canvas_id: z.ZodOptional<z.ZodString>;
}, z.core.$strip>, readonly [{
    readonly reason: "canvas_id_required";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "Canvas is enabled but canvas_id was omitted.";
    readonly recovery: "Pass the canvas_id returned by socrata_query_dataset when its result spilled to canvas. Canvases cannot be enumerated — if the token was lost, re-run socrata_query_dataset to stage a fresh canvas.";
}, {
    readonly reason: "canvas_not_found";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "Provided canvas_id does not match any registered canvas.";
    readonly recovery: "Canvas tokens expire after inactivity and cannot be listed. Re-run socrata_query_dataset to stage a fresh canvas and pass the canvas_id it returns.";
}], {
    readonly notice: z.ZodOptional<z.ZodString>;
}>;
//# sourceMappingURL=dataframe-describe.tool.d.ts.map