import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
/**
 * Per-project defensive recovery on every session_start:
 *   0. Run one-time legacy migrations (kept out of the extension factory,
 *      which must stay side-effect free per pi extension guidance).
 *   1. Release any lock whose recorded pid is ours (process reuse edge case).
 *   2. Remove orphan `.tmp-*` files left over by a previous session that
 *      crashed between writing the temp file and the atomic rename.
 *   3. Surface the current lock state to the user when a run is active.
 * Runs against `ctx.cwd` so multi-project workspaces get the right cleanup.
 */
export declare function registerSessionStartHook(pi: ExtensionAPI): void;