import type { SubagentFrontmatter, SubagentInfo } from '../types';
export interface ParsedFrontmatter {
    meta: Record<string, unknown>;
    body: string;
}
/**
 * Extracts YAML frontmatter and body from a Markdown file's contents.
 * Returns null if no frontmatter delimiter pair is present at the head of the file.
 */
export declare function parseFrontmatter(content: string): ParsedFrontmatter | null;
/**
 * Validates a parsed frontmatter object and reads the required and optional
 * fields into a typed SubagentFrontmatter. Returns the typed value on success
 * or an error message on failure.
 */
export declare function validateFrontmatter(meta: Record<string, unknown>, expectedName: string): {
    value: SubagentFrontmatter;
} | {
    error: string;
};
/**
 * Loads a single subagent file and produces a SubagentInfo.
 * Invalid files produce a SubagentInfo with valid=false and an error string.
 */
export declare function loadSubagentFile(filePath: string): Promise<SubagentInfo>;
export interface CopilotToolMapping {
    tools: string[];
    unknown: string[];
}
/**
 * Translates Claude tool names to Copilot aliases. Deduplicates results.
 * Unknown source tools are reported separately so callers can surface a warning.
 */
export declare function mapToolsForCopilot(sourceTools: string[]): CopilotToolMapping;