/**
 * Agent filtering for the --agent flag.
 *
 * Filters a list of detected agents down to only the ones the user
 * explicitly requested. Throws a descriptive error when any requested
 * ID is not found among the detected agents.
 */
import type { AgentDefinition } from "../agents/agents-registry.js";
/**
 * Filter `agents` to only those whose `id` appears in `requestedIds`.
 *
 * - If `requestedIds` is `undefined` or an empty array, all agents are returned.
 * - If any requested ID does not match a detected agent, an error is thrown
 *   listing the available agent IDs.
 */
export declare function filterAgents(agents: AgentDefinition[], requestedIds?: string | string[]): AgentDefinition[];