/** Shape forwarded from the plan-mode resolve handler to InteractiveMode's
 *  approval popup. Populated by the standing handler that the resolve tool
 *  dispatches to when the agent submits `resolve { action: "apply" }`. */
export interface PlanApprovalDetails {
    planFilePath: string;
    finalPlanFilePath: string;
    title: string;
    planExists: boolean;
}
/** Validate and normalize the agent-supplied plan title into a safe filename stem.
 *  Spaces and other URL-safe punctuation are replaced with hyphens so models that
 *  produce natural-language titles (e.g. "My feature plan") still succeed.
 *  Characters that cannot be safely represented after replacement are dropped.
 *  The result is restricted to letters, numbers, underscores, and hyphens so it
 *  is safe to splice into a `local://` URL without escaping. */
export declare function normalizePlanTitle(title: string): {
    title: string;
    fileName: string;
};
/** Best-effort derivation of a plan title from inputs the agent already produced.
 *  Returns the first non-empty candidate that survives `normalizePlanTitle`:
 *    1. an explicit `suppliedTitle` (e.g. `extra.title` from the resolve call),
 *    2. the first level-1 markdown heading inside `planContent`,
 *    3. the filename stem of `planFilePath` (e.g. `PLAN` from `local://PLAN.md`),
 *    4. the literal `"plan"` so callers never have to handle `null`.
 *  The fallback exists because some grammar-constrained models cannot emit a
 *  string into the open `extra` schema and instead drop in `{}` (issue #1179);
 *  plan-mode would otherwise loop forever on an unreachable validation. */
export declare function resolvePlanTitle(input: {
    suppliedTitle?: unknown;
    planContent: string;
    planFilePath: string;
}): {
    title: string;
    fileName: string;
    source: "supplied" | "heading" | "filename" | "default";
};
/** Humanize a normalized plan title for use as a session display name.
 *  Replaces `-`/`_` separators with spaces and capitalizes the first letter.
 *  Returns an empty string when the input collapses to whitespace. */
export declare function humanizePlanTitle(title: string): string;
interface RenameApprovedPlanFileOptions {
    planFilePath: string;
    finalPlanFilePath: string;
    getArtifactsDir: () => string | null;
    getSessionId: () => string | null;
}
export declare function renameApprovedPlanFile(options: RenameApprovedPlanFileOptions): Promise<void>;
export {};