import type { WorkflowDefinition } from "./types.js";
export type DiscoveredWorkflow = {
    name: string;
    path: string;
    source: "project" | "global" | "builtin" | "path";
};
export type WorkflowSearchPaths = {
    cwd: string;
    homeDir?: string;
};
/** Directories scanned for workflow files, in precedence order. */
export declare function workflowSearchDirs(options: WorkflowSearchPaths): {
    dir: string;
    source: "project" | "global" | "builtin";
}[];
/** SHA-256 of a workflow source file, recorded in run state for resume pinning. */
export declare function hashWorkflowSource(filePath: string): Promise<string>;
export declare function workflowFileStem(filePath: string): string;
/** Load a workflow module from disk. The default export must be `defineWorkflow(...)`. */
export declare function loadWorkflowFile(filePath: string): Promise<WorkflowDefinition>;
/** Discover named workflows in the project and global workflow directories. */
export declare function discoverWorkflows(options: WorkflowSearchPaths): Promise<DiscoveredWorkflow[]>;
/**
 * Resolve a `/workflow` argument to a workflow file. Accepts a discovered
 * workflow name or a direct path to a `*.workflow.ts` file.
 */
export declare function resolveWorkflowRef(ref: string, options: WorkflowSearchPaths): Promise<{
    path: string;
    source: DiscoveredWorkflow["source"];
}>;