import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
import { type InitCompleteEvent } from "../hook-dispatcher.js";
/** Payload for the init-complete synthetic event (alias for test imports). */
export type InitCompleteEventPayload = InitCompleteEvent;
/**
 * Create the init-complete handler bound to the given pi ExtensionAPI.
 * Exported for unit testing — production code calls registerPostInitHook.
 */
export declare function createPostInitHookHandler(pi: ExtensionAPI): (event: InitCompleteEvent, ctx: ExtensionCommandContext) => Promise<void>;
/**
 * Register the post-init hook handler on the `init-complete` synthetic event.
 * MUST be called BEFORE registerForgeInit in index.ts to prevent the
 * emit-before-consumer race described in SPRINT_REQUIREMENTS.md §Risks row 3.
 */
export declare function registerPostInitHook(pi: ExtensionAPI): void;