import type { WorkflowDefinition } from "./types";
/**
 * A workflow definition discovered from the filesystem.
 */
export interface DiscoveredWorkflow {
    definition: WorkflowDefinition;
    path: string;
    scope: "project" | "user";
}
/**
 * Load and validate a single workflow definition from a JSONC file path.
 * Returns null if the file can't be read, parsed, or fails validation.
 */
export declare function loadWorkflowDefinition(filePath: string): WorkflowDefinition | null;
/**
 * Discover all valid workflow definitions from project, custom, and user directories.
 * Override precedence (highest wins): project > custom > user.
 *
 * @param directory - Project root directory (used to resolve relative custom paths)
 * @param customDirs - Optional extra directories to scan (from config `workflows.directories`)
 */
export declare function discoverWorkflows(directory: string, customDirs?: string[]): DiscoveredWorkflow[];