export interface ToolTarget {
    id: string;
    label: string;
    /** 安装目标目录：user 级用 home，project 级用 cwd */
    dest: (home: string, cwd: string) => string;
    ext: string;
    scope: 'user' | 'project';
}
/** 各编码工具的安装目标（参考 agency-agents-app 的 destination 表）。 */
export declare const INSTALL_TARGETS: Record<string, ToolTarget>;
export interface RoleFile {
    rolePath: string;
    category: string;
    id: string;
    absPath: string;
}
/** 递归收集角色 .md（只取带 `name:` frontmatter 的真角色，跳过 README/示例等）。 */
export declare function collectRoleFiles(agentsDir: string): RoleFile[];
export interface InstallResult {
    installed: number;
    destDir: string;
    files: string[];
}
/**
 * 把角色装进目标工具目录。文件名用 `<category>-<id><ext>` 防跨分类重名。
 * 内容逐字复制（角色 .md 的 frontmatter 即各工具通用格式）。
 */
export declare function installRoles(agentsDir: string, target: ToolTarget, opts?: {
    home: string;
    cwd: string;
    category?: string;
    dryRun?: boolean;
}): InstallResult;