/**
 * @fileoverview Drop one table from a DataCanvas staged by water_get_series or water_find_sites,
 * leaving the canvas and its other tables in place. Opt-in: callable only when
 * WATER_DATAFRAME_DROP_ENABLED=true, and listed as a disabled tool otherwise. Requires
 * CANVAS_PROVIDER_TYPE=duckdb at call time.
 * @module mcp-server/tools/definitions/water-dataframe-drop.tool
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
/**
 * Dropping a table discards staged data, so the tool is opt-in. With the flag off it stays in the
 * manifest and on the landing page as a disabled tool, and clients cannot call it.
 */
export declare const waterDataframeDrop: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    canvas_id: z.ZodString;
    table_name: z.ZodString;
}, z.core.$strip>, z.ZodObject<{
    canvas_id: z.ZodString;
    table_name: z.ZodString;
    row_count: z.ZodNumber;
    remaining_tables: z.ZodArray<z.ZodString>;
}, z.core.$strip>, readonly [{
    readonly reason: "canvas_disabled";
    readonly code: JsonRpcErrorCode.InvalidRequest;
    readonly when: "DataCanvas is not enabled on this server instance.";
    readonly recovery: "DataCanvas is not available on this server instance, so no tables are staged and no cleanup is needed — water_get_series and water_find_sites return their data inline here.";
}, {
    readonly reason: "canvas_not_found";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "The canvas_id does not exist or has expired.";
    readonly recovery: "An expired canvas has already released its tables, so there is nothing left to drop. If the id may be mistyped, compare it with the canvas_id water_get_series or water_find_sites returned.";
    readonly thrownBy: "service";
}, {
    readonly reason: "table_not_found";
    readonly code: JsonRpcErrorCode.NotFound;
    readonly when: "No table with this name is staged on the canvas — it was already dropped, has expired, or was never created.";
    readonly recovery: "Call water_dataframe_describe with this canvas_id to list the staged tables and copy the exact name; a table that was already dropped no longer appears there.";
}], undefined>;
//# sourceMappingURL=water-dataframe-drop.tool.d.ts.map