/**
 * Runtime environment detection utilities.
 *
 * Pure functions for env var / process checks. Effect-based for filesystem checks.
 *
 * CLI-specific detection (isCI, isNonInteractive, nonInteractiveFlag) lives in
 * cli-flags/non-interactive.ts. This module covers general environment detection.
 */
import * as FileSystem from "effect/FileSystem";
import * as Effect from "effect/Effect";
import * as Option from "effect/Option";
export declare const readEnv: (name: string) => string | undefined;
/** Snapshot the current environment for isolated child-process configuration. */
export declare const readEnvironment: () => Readonly<Record<string, string | undefined>>;
/** Read an optional env var. Centralized access point for process.env. */
export declare const envOption: (name: string) => Effect.Effect<Option.Option<string>>;
/** Read an env var with a default value. Centralized access point for process.env. */
export declare const envWithDefault: (name: string, fallback: string) => Effect.Effect<string>;
/** Returns true if SSH_CLIENT or SSH_TTY env var is set. */
export declare const isSSH: Effect.Effect<boolean>;
/** Returns true if running as root (uid 0). */
export declare const isRoot: () => boolean;
/** Returns true if /.dockerenv or /.containerenv exists. Requires FileSystem. */
export declare const isContainer: Effect.Effect<boolean, never, FileSystem.FileSystem>;
/** Returns true if /proc/version contains "microsoft". Requires FileSystem. */
export declare const isWSL: Effect.Effect<boolean, never, FileSystem.FileSystem>;
//# sourceMappingURL=environment.d.ts.map