import { type Playbook } from "./types.ts";
/**
 * Load + validate a playbook from the user's playbook directory.
 *
 * Playbooks live at `~/.sandbox-seed/playbooks/<name>.yml` — user scope
 * only, never project/team scope (per
 * `feedback_playbooks_user_scope_only.md`). The filename stem is the
 * playbook's lookup name; the file's `name` field is informational and
 * does not need to match.
 */
export type PlaybookListing = {
    name: string;
    path: string;
    stepCount: number;
    description: string | null;
};
export declare function playbooksDir(rootDir?: string): string;
export declare function listPlaybooks(rootDir?: string): Promise<PlaybookListing[]>;
/**
 * Load a single playbook by name (no `.yml` extension) from the user's
 * playbook directory. Throws UserError with a clear message on missing
 * file or validation failure.
 */
export declare function loadPlaybookByName(name: string, rootDir?: string): Promise<{
    playbook: Playbook;
    path: string;
}>;