import type { ReferenceEntry, ResolvedReference } from "../types.ts";
import type { ReferenceScope } from "../constants.ts";
/**
 * Auto-discover all .md files in a `references/` directory.
 * Returns resolved references with descriptions from frontmatter or auto-generated.
 */
export declare function discoverReferences(baseDir: string, scope: ReferenceScope): Promise<ResolvedReference[]>;
/**
 * Resolve explicit reference declarations from role.yaml or SKILL.md frontmatter.
 * Merges with auto-discovered references, with explicit entries taking priority
 * for description overrides.
 */
export declare function resolveExplicitReferences(declarations: Record<string, string | ReferenceEntry>, baseDir: string, scope: ReferenceScope): Promise<ResolvedReference[]>;
/**
 * Resolve all references for a given directory:
 * 1. Auto-discover references/ directory
 * 2. Apply explicit declarations as overrides (for descriptions)
 * 3. Merge with explicit-only entries (files outside references/)
 *
 * Deduplication: explicit entries override auto-discovered ones by filePath.
 */
export declare function resolveAllReferences(baseDir: string, scope: ReferenceScope, explicitDeclarations?: Record<string, string | ReferenceEntry>): Promise<ResolvedReference[]>;
//# sourceMappingURL=reference-resolver.d.ts.map