import type { BlockRegistry } from "./registry.js";
import type { BlockPlacement } from "./types.js";
/**
 * Agent-facing description of one registered block. Generated from the registry
 * so the agent's block vocabulary always matches what the app can render and
 * serialize — no hand-maintained second list. React-free so an action / the
 * agent schema export can import it.
 */
export interface BlockAgentDoc {
    type: string;
    label: string;
    description: string;
    placement: BlockPlacement[];
    mdxTag: string;
    dataSchema: unknown;
    example?: unknown;
}
/** Describe every registered block for the agent (sorted by type for stability). */
export declare function describeBlocksForAgent(registry: BlockRegistry): BlockAgentDoc[];
/**
 * Render the registry into a compact markdown block-vocabulary reference for the
 * agent (skill / action surface). Lists each block's runtime `type`, MDX tag,
 * placement, the key data fields (pulled from the converted JSON schema), and the
 * one-line description — generated from the live registry so the agent's
 * vocabulary can never drift from what the app actually renders and serializes.
 */
export declare function renderBlockVocabularyReference(registry: BlockRegistry, options?: {
    heading?: string;
}): string;
//# sourceMappingURL=agent.d.ts.map