import { type LocalFileEntry, type LocalProtocolOptions } from "../internal-urls/index.js";
import type { SessionManager } from "../session/session-manager.js";
import type { InteractiveModeContext } from "./types.js";
export declare function sessionLocalProtocolOptions(sessionManager: Pick<SessionManager, "getArtifactsDir" | "getSessionId">): LocalProtocolOptions;
/** Encode a filesystem name as `local://` path segments. `/` stays a separator; `%`, `#`, `?` are encoded once. */
export declare function encodeLocalPath(name: string): string;
/** Resolve a user-typed local file target to its on-disk real path. Throws user-facing Errors. */
export declare function resolveLocalEditorTarget(target: string, options: LocalProtocolOptions): Promise<{
    url: string;
    path: string;
}>;
/** Revalidate an already-selected local file entry: realpath + root containment, keeping exact name without trimming. */
export declare function revalidateLocalEditorEntry(entry: LocalFileEntry, options: LocalProtocolOptions): Promise<{
    url: string;
    path: string;
}>;
/** `/local [target]` and the `app.local.open` key: picker when target is blank, else open target directly. */
export declare function openLocalFileInEditor(ctx: InteractiveModeContext, target?: string): Promise<void>;