import type { Settings } from "../config/settings";
import type { AgentDefinition } from "./types";
/** Result of agent discovery */
export interface DiscoveryResult {
    agents: AgentDefinition[];
    projectAgentsDir: string | null;
}
export declare function filterVisibleAgents(agents: readonly AgentDefinition[]): AgentDefinition[];
/**
 * Discover agents from filesystem and merge with bundled agents.
 *
 * Precedence (highest wins): .gjc project, .gjc user, GJC plugins, then bundled
 *
 * @param cwd - Current working directory for project agent discovery
 * @param activeSettings - Settings used to resolve enabled providers.
 */
export declare function discoverAgents(cwd: string, home?: string, activeSettings?: Settings): Promise<DiscoveryResult>;
/**
 * Get an agent by name from discovered agents.
 */
export declare function getAgent(agents: AgentDefinition[], name: string): AgentDefinition | undefined;