import { Hono } from 'hono';
import type { Profile } from '../../profiles/index.js';
import type { RepositoryVerifier } from '../../services/repository-classification.js';
import type { BridgeAuthService } from '../services/setup-agents-auth.js';
/**
 * Reference-fetch implementation, injectable so tests can assert it is invoked
 * without hitting the network. Defaults to the real {@link fetchReferences}.
 */
export type ReferenceFetcher = (dir: string, profileIds: string[]) => void;
/**
 * Kick off reference caching for the selected profiles WITHOUT blocking the
 * request. The CLI `init` does this too (maybeFetchReferences); the wizard
 * route must keep parity or wizard-configured projects end up with an empty
 * `.setup-agents/references/`. Fire-and-forget because the catalog can be
 * 100MB+ of PDFs — awaiting it would hang the Apply request for minutes.
 *
 * Best-effort and self-contained: every failure is swallowed so a blocked
 * network never surfaces as an unhandled rejection.
 */
export declare function startReferenceFetch(dir: string, profiles: Profile[], fetcher?: ReferenceFetcher): void;
export declare function initRoute(cwd: string, fetcher?: ReferenceFetcher, repositoryVerifier?: RepositoryVerifier, auth?: BridgeAuthService): Hono;