import type { CatGenResult } from '../../utils/cat-gen/cat-gen.js';
/** @purpose Result of resolving a VCS URL to cat-gen file list — either successful with files or failed with an error. */
export type CatUrlResult = {
    ok: true;
    files: CatGenResult[];
} | {
    ok: false;
    error: string;
};
/**
 * @purpose Resolve a VCS URL (GitLab MR or GitHub PR) into CatGenResult files for cat output.
 * @param url VCS URL to parse and resolve.
 * @param [options] Optional filtering by exclude patterns or file extensions.
 * @returns CatUrlResult with either fetched files or a user-facing error message.
 */
export declare function resolveCatUrl(url: string, options?: {
    exclude?: string | string[];
    extensions?: string[];
}): Promise<CatUrlResult>;