@builder.io/dev-tools/types/cli/utils/agent-discovery.d.ts

Builder.io Visual CMS Devtools

/**
 * Agent discovery utilities
 * Handles finding and loading custom agent definitions from the filesystem
 */
import type { DevToolsSys } from "../../types";
import { type SubAgent } from "./agent-parser";
export type { SubAgent };
/**
 * Get custom agents from the filesystem
 * Searches for agent definitions in .claude/agents, .builder/agents, and .cursor/agents
 *
 * Also scans the equivalent folders under the user's home directory
 * (`~/.builder/agents/`, `~/.claude/agents/`, etc.) so user-level agents are
 * available in every project.
 *
 * @param sys - System utilities
 * @param projectDir - Project directory (used for relative paths)
 * @param currentDir - Starting directory or directories for search
 * @param rootDir - Root directory to stop search
 * @param homeDir - Override for the user's home directory (for testing)
 * @returns Array of discovered agents
 */
export declare function getCustomAgents({ sys, projectDir, currentDir, rootDir, homeDir }: {
    sys: DevToolsSys;
    projectDir: string;
    currentDir: string | string[];
    rootDir: string;
    homeDir?: string;
}): Promise<SubAgent[]>;