import type { AtomicLevel, ComponentSpec, PageSpec } from "../specs/types.js";
export declare const AGENT_FILE_SCAFFOLD_KINDS: readonly ["component", "page"];
export type AgentFileScaffoldKind = typeof AGENT_FILE_SCAFFOLD_KINDS[number];
export type AgentFileScaffoldStatus = "planned" | "approved" | "written";
export interface AgentFileScaffoldSection {
    name: string;
    component: string;
    layout?: "full-width" | "half" | "third" | "quarter" | "grid-2" | "grid-3" | "grid-4" | "stack" | "inline";
}
export interface AgentFileScaffoldOptions {
    projectRoot: string;
    kind: AgentFileScaffoldKind;
    name: string;
    purpose?: string;
    intent?: string;
    level?: AtomicLevel;
    layout?: PageSpec["layout"];
    shadcnBase?: string[];
    composesSpecs?: string[];
    sections?: AgentFileScaffoldSection[];
    dryRun?: boolean;
    approved?: boolean;
}
export interface AgentFileScaffoldPlan {
    action: "scaffold_agent_design_files";
    schemaVersion: 1;
    status: AgentFileScaffoldStatus;
    projectRoot: string;
    dryRun: boolean;
    approved: boolean;
    kind: AgentFileScaffoldKind;
    name: string;
    atomicLevel: AtomicLevel | "page";
    intent: string;
    specPath: string;
    generationCommand: string;
    writeCommand: string;
    nextCommands: string[];
    guardrails: string[];
    spec: ComponentSpec | PageSpec;
}
export declare function buildAgentFileScaffoldPlan(options: AgentFileScaffoldOptions): AgentFileScaffoldPlan;
export declare function markAgentFileScaffoldWritten(plan: AgentFileScaffoldPlan): AgentFileScaffoldPlan;
export declare function parseAgentFileScaffoldSection(value: string): AgentFileScaffoldSection;