export type InstructionSize = 'compact' | 'full' | 'rules' | 'preflight';
export type AgentDocsStatus = 'missing' | 'healthy' | 'start-only' | 'end-only' | 'out-of-order' | 'multiple-markers';
export interface AgentDocsInspection {
    filePath: string;
    exists: boolean;
    status: AgentDocsStatus;
    startCount: number;
    endCount: number;
}
/**
 * Extract the version from a managed block's start marker.
 * Returns null if no version is found or marker doesn't exist.
 */
export declare function extractManagedBlockVersion(content: string): string | null;
/**
 * Get the instruction version from an installed agent docs file.
 * Returns null if file doesn't exist or has no version.
 */
export declare function getAgentDocsVersion(filePath: string): string | null;
export declare function inspectAgentDocs(filePath: string): AgentDocsInspection;
/**
 * Inject the managed agent docs block into a file.
 * If the file already contains the block, it is replaced (updated).
 * If the file doesn't exist, it is created.
 * Content outside the managed block is preserved.
 * @param version - Version string to embed in the start marker (e.g., "1.0.0")
 * @param preamble - Content prepended before the managed block when creating the file (e.g. YAML frontmatter)
 */
export declare function injectAgentDocs(filePath: string, size?: InstructionSize, dryRun?: boolean, clientName?: string, version?: string, preamble?: string): {
    action: 'created' | 'updated' | 'unchanged';
    filePath: string;
};
/**
 * Remove the managed agent docs block from a file.
 * Content outside the managed block is preserved.
 * If the file becomes empty, whitespace-only, or equal to the installer-owned preamble
 * after removal, it is deleted.
 */
export declare function removeAgentDocs(filePath: string, dryRun?: boolean, preamble?: string): {
    action: 'removed' | 'not-found' | 'file-deleted';
    filePath: string;
};
//# sourceMappingURL=agent-docs.d.ts.map