import type { NutrientMap, ResponseFormat } from "../types.js";
export interface McpTextResponse {
    isError?: boolean;
    structuredContent?: Record<string, unknown>;
    content: Array<{
        type: "text";
        text: string;
    }>;
}
export declare function makeResponse(payload: unknown, responseFormat?: ResponseFormat, markdown?: string): McpTextResponse;
export declare function makeError(message: string): McpTextResponse;
export declare function makeError(code: string, message: string, responseFormat?: ResponseFormat): McpTextResponse;
export declare function makeActionRequired(message: string, responseFormat?: ResponseFormat): McpTextResponse;
export declare function makeValidationError(errors: Array<{
    path: string;
    message: string;
    code?: string | undefined;
}>, responseFormat?: ResponseFormat): McpTextResponse;
export declare function bulletList(title: string, values: Record<string, unknown> | unknown): string;
export declare function compactTable(rows: Array<Record<string, unknown>>, columns?: string[]): string;
/**
 * Render a nutrient map as a readable two-column markdown table instead of a
 * one-line JSON blob. Skips undefined/null values, keeps a stable nutrient
 * order, and appends any extra numeric keys not in the canonical order.
 * Returns "" when there is nothing meaningful to show.
 */
export declare function nutrientTable(nutrients: NutrientMap | Record<string, unknown> | undefined, valueHeader?: string): string;
/**
 * Render an arbitrary flat record as a two-column key/value markdown table.
 * Optional `labels` overrides display names; `order` fixes row order.
 */
export declare function keyValueTable(values: Record<string, unknown>, options?: {
    labels?: Record<string, string>;
    order?: readonly string[];
    keyHeader?: string;
    valueHeader?: string;
}): string;