export interface CodexWslBridgeStatus {
    ok: boolean;
    detail: string;
    threadIdPresent: boolean;
    wslenvForwardsThreadId: boolean;
}
export interface CodexWslBridgeOptions {
    /** The caller already knows this is a Codex adapter process. */
    expected?: boolean;
}
export interface CodexWslWorkspaceLinkMapping {
    /** Absolute path seen by Linux-side tools. */
    linuxRoot: string;
    /** Forward-slash UNC path that Codex Desktop can use as a Markdown destination. */
    hostRoot: string;
    distro: string;
}
export interface CodexWslFileLinkTelemetry {
    /** Markdown destinations that still use the Linux root in a Windows-hosted WSL task. */
    wsl_linux_file_link_count: number;
    /** Bounded examples for local diagnosis; omitted when the count is zero. */
    wsl_linux_file_link_examples?: string[];
}
/** Whether an adapter-reported workspace is a Linux path exposed through WSL UNC. */
export declare function isWslUncPath(value: unknown): boolean;
/**
 * Derive the Linux-to-host path pair from the actual adapter workspace. The
 * roots must overlap so an unrelated WSL UNC path cannot authorize a mapping
 * for some other checkout.
 */
export declare function codexWslWorkspaceLinkMapping(coordRootRaw: string, workspaceCwd: unknown): CodexWslWorkspaceLinkMapping | null;
/** Translate an overlapping WSL UNC workspace into its Linux-native path. */
export declare function codexWslWorkspaceLinuxPath(coordRootRaw: string, workspaceCwd: unknown): string | null;
/** Fresh adapter context for the model. Shell paths stay Linux-native; only
 * Markdown destinations use the host-visible root. */
export declare function renderCodexWslFileLinkContext(coordRoot: string, workspaceCwd: unknown): string;
/**
 * Count Markdown links that point at the Linux workspace root even though the
 * adapter workspace is Windows-visible UNC. This is telemetry only: the Stop
 * hook must not replace or retry an otherwise complete Codex reply.
 */
export declare function codexWslFileLinkTelemetry(coordRoot: string, workspaceCwd: unknown, assistantMessage: string): CodexWslFileLinkTelemetry | null;
/**
 * Inspect the environment contract used when Windows-native Codex launches a
 * Harnery hook or shell inside WSL. Returns null outside that hybrid mode.
 */
export declare function inspectCodexWslBridge(env?: NodeJS.ProcessEnv, options?: CodexWslBridgeOptions): CodexWslBridgeStatus | null;
//# sourceMappingURL=codex-wsl-bridge.d.ts.map