import { type AgentSkillFormat } from "./agent-skills.js";
import type { SkillMigrationEntrypointPath } from "./skill-path-contract.js";
import type { ParsedDocument } from "./types/metadata.js";
export interface SkillMigrationBlock {
    field: string;
    reason: string;
}
export interface AgentSkillMigrationSuggestion {
    sourceFormat: AgentSkillFormat;
    direction: "legacy-to-agent-skills" | "none";
    proposalKind: "historical-migration" | "canonical-metadata-retrofit" | "none";
    sourcePath: string;
    targetPath: string;
    entrypointMigration: "none" | "rename" | "move-and-rename";
    bodyPreserved: true;
    candidateAgentSkillsFields: Record<string, string>;
    candidateRenmaMetadata: Record<string, string>;
    preservedMetadata: Record<string, string>;
    canonicalFrontmatter?: string;
    blocked: SkillMigrationBlock[];
    reviewPrompt: string;
}
export interface AgentSkillMigrationOptions {
    explicitOwner?: string;
    entrypoint?: SkillMigrationEntrypointPath;
    additionalBlocks?: SkillMigrationBlock[];
}
/** Build a one-way, non-editing migration proposal for a Skill target. */
export declare function buildAgentSkillMigrationSuggestion(document: ParsedDocument, options?: AgentSkillMigrationOptions): AgentSkillMigrationSuggestion;