export type WidgetPlacement = "aboveEditor" | "belowEditor";
export type WidgetState = "expanded" | "collapsed" | "hidden";
export interface PiPlanSettings {
    /** Which editor-relative slot the widget occupies. */
    placement: WidgetPlacement;
    /** Initial widget state on session start. */
    defaultState: WidgetState;
    /** Include done items by default (else hidden until `/plan filter done`). */
    showDone: boolean;
    /** Include design/note context by default (else plan work only). */
    showContext: boolean;
    /** Show the subagent fleet alongside the plan. */
    showAgents: boolean;
    /** Plan rows rendered before the expanded view caps with a "…N more" trailer. */
    maxRows: number;
}
/** pi's agent config dir, honoring a relocated dir via PI_CODING_AGENT_DIR
 *  (identical to the harness accessor: `PI_CODING_AGENT_DIR ?? ~/.pi/agent`). */
export declare function getAgentDir(): string;
/** pi-plan's settings file, in pi's extensions/ dir so it follows a relocated config dir. */
export declare function getSettingsPath(): string;
/** Read settings, falling back to defaults for a missing/invalid file or absent keys. */
export declare function readSettings(path?: string): PiPlanSettings;
/** Write the default settings file if none exists, so the options are discoverable. Best effort. */
export declare function ensureSettingsFile(path?: string): void;