import type { SkillStore } from "../../core/ports.js";
import type { Scenario } from "../../core/types.js";
/**
 * The file store's reference is a file path (`cart.skill.json`), resolved against an
 * optional base directory — relative refs join `dir`, absolute refs are used as-is.
 * It delegates to `loadSkillFile`/`saveSkillFile`, so the port and the path helpers
 * are one mechanism, not two.
 */
export declare class FileSkillStore implements SkillStore {
    private readonly dir;
    constructor(dir?: string);
    private pathFor;
    load(ref: string): Promise<Scenario>;
    freeze(ref: string, scenario: Scenario): Promise<string>;
}
/** Freeze a scenario to a skill file. The file is the bare Scenario JSON, nothing wrapped. */
export declare function saveSkillFile(path: string, scenario: Scenario): Promise<void>;
export declare class InvalidSkillFileError extends Error {
    readonly path: string;
    constructor(path: string);
}
export declare function loadSkillFile(path: string): Promise<Scenario>;