import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
import type { NotesContext } from "../../notes/context.js";
/** Pi's default notes root; environment access stays on the host side of the library boundary. */
export declare function notesRoot(): string;
/** Translate the current Pi runtime into a fresh, explicit identity snapshot. */
export declare function agentSlug(_ctx: ExtensionContext): string;
/** Pi's active model identity is resolved live so a mid-session switch retargets @model. */
export declare function modelSlug(ctx: ExtensionContext): string;
/** Translate the current Pi runtime into one explicit notes identity snapshot. */
export declare function notesContextFromPi(ctx: ExtensionContext, home?: string): NotesContext;
/** One-time host activation migration from the legacy personal/ directory. */
export declare function migrateLegacyHomes(home?: string): string | undefined;