import { z } from 'zod';
/**
 * Shared schema for a single block option with its current value.
 */
export declare const blockOptionSchema: z.ZodObject<{
    type: z.ZodString;
    label: z.ZodString;
    description: z.ZodOptional<z.ZodString>;
    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
    min: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
    max: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
    step: z.ZodOptional<z.ZodNumber>;
    currentValue: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodString>]>;
}, z.core.$strip>;
/**
 * Shared schema for a record of block options keyed by property name.
 */
export declare const blockOptionsMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
    type: z.ZodString;
    label: z.ZodString;
    description: z.ZodOptional<z.ZodString>;
    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
    min: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
    max: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
    step: z.ZodOptional<z.ZodNumber>;
    currentValue: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodString>]>;
}, z.core.$strip>>;
export type BlockOptionsMap = z.infer<typeof blockOptionsMapSchema>;
/**
 * Schema for a parent entity (the container of a block).
 * A parent is an entity + field combination where blocks can be placed.
 * Used consistently across tools for specifying block locations.
 */
export declare const parentSchema: z.ZodObject<{
    type: z.ZodString;
    uuid: z.ZodString;
    field: z.ZodString;
}, z.core.$strip>;
/**
 * Schema for mutation tool results.
 * Mutation tools return either a MutationAction (handled by framework) or an error.
 */
export declare const mutationResultSchema: z.ZodUnion<readonly [z.ZodObject<{
    type: z.ZodEnum<{
        rewrite: "rewrite";
        add: "add";
        delete: "delete";
        move: "move";
        options: "options";
    }>;
    label: z.ZodString;
}, z.core.$strip>, z.ZodObject<{
    error: z.ZodString;
}, z.core.$strip>]>;
/**
 * A parameter that accepts an array of strings OR a single string (normalized
 * to a one-element array). LLMs frequently send a bare string for array params
 * and otherwise fail validation on the first call. The generated JSON Schema
 * still advertises an array, so the model is guided toward the array form while
 * a single string is accepted as a fallback.
 */
export declare function stringArrayParam(description: string): z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodArray<z.ZodString>>;
/**
 * Wraps an object params schema to tolerate a singular key when the schema
 * actually expects its plural form (e.g. `uuid` → `uuids`). LLMs — especially
 * the smaller models — frequently pick the singular form when a tool
 * description mentions both ("one or more UUIDs"). Without this, the call
 * fails validation and the model often retries with the same wrong key.
 *
 * The generated JSON Schema is unchanged (the wrapping happens via
 * `z.preprocess`), so the model is still guided to the plural form; the
 * singular form is silently accepted as a fallback.
 */
export declare function tolerantSingularKeys<T extends z.ZodType>(schema: T, aliases: Record<string, string>): z.ZodPipe<z.ZodTransform<unknown, unknown>, T>;
/**
 * Shared schema for option values (used by add_blocks and set_block_options).
 */
export declare const optionValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodString>]>;
/**
 * Shared schema for the `position` parameter used by mutation tools that insert blocks.
 *
 * Values:
 * - `"start"` — insert at the beginning of the field
 * - `"end"` (default when omitted) — append at the end of the field
 * - `"after:<UUID>"` — insert after the block with the given UUID
 * - `"before:<UUID>"` — insert before the block with the given UUID
 */
export declare const positionSchema: z.ZodDefault<z.ZodOptional<z.ZodString>>;
export declare const fieldDiffResultSchema: z.ZodObject<{
    acceptedCount: z.ZodNumber;
    rejectedByUser: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
        reasonForRejection: z.ZodString;
        partial: z.ZodOptional<z.ZodObject<{
            accepted: z.ZodNumber;
            total: z.ZodNumber;
            rejectedSegments: z.ZodArray<z.ZodObject<{
                tag: z.ZodString;
                beforeHtml: z.ZodString;
                afterHtml: z.ZodString;
                status: z.ZodEnum<{
                    deleted: "deleted";
                    matched: "matched";
                    inserted: "inserted";
                }>;
                reasonForRejection: z.ZodString;
            }, z.core.$strip>>;
        }, z.core.$strip>>;
    }, z.core.$strip>>>;
    label: z.ZodString;
    agentMessage: z.ZodOptional<z.ZodString>;
    historyIndex: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>;
/**
 * Schema for a single entry in a mutation's `newParagraphs` payload. Recursive
 * so nested children appear under their parent's `children` keyed by paragraph
 * field name — mirroring the input shape of `add_paragraphs`.
 */
type NewParagraphEntry = {
    uuid: string;
    bundle: string;
    paragraphFields?: string[];
    children?: Record<string, NewParagraphEntry[]>;
};
/**
 * Schema for the success result sent back to the AI after mutation is applied.
 */
export declare const mutationSuccessSchema: z.ZodUnion<readonly [z.ZodObject<{
    success: z.ZodLiteral<true>;
    newParagraphs: z.ZodOptional<z.ZodArray<z.ZodType<NewParagraphEntry, unknown, z.core.$ZodTypeInternals<NewParagraphEntry, unknown>>>>;
    historyIndex: z.ZodNumber;
}, z.core.$strip>, z.ZodObject<{
    success: z.ZodLiteral<false>;
    rejected: z.ZodOptional<z.ZodLiteral<true>>;
}, z.core.$strip>, z.ZodObject<{
    error: z.ZodString;
}, z.core.$strip>]>;
export {};