/**
 * Copyright (c) 2026, Salesforce, Inc.,
 * All rights reserved.
 * For full license text, see the LICENSE.txt file
 */
/**
 * Resolves the graphiti home directory at call time. Re-reads
 * `GRAPHITI_HOME` on every call so tests that mutate the env var after
 * module load (or fixtures that set it before each call) see the current
 * value rather than a frozen snapshot from import time.
 *
 * Single source of truth for every graphiti file/directory path: schema
 * cache, sessions, ObjectInfo cache, the active-session pointer.
 */
export declare function graphitiHome(): string;
/**
 * Write `text` to `finalPath` atomically. Writes to a sibling
 * `<base>.tmp.<pid>.<timestamp>.<rand>` file, then renames over the final
 * path. Concurrent readers see either the old contents or the fully-written
 * new contents — never a partial. The temp file is unlinked if the rename
 * fails, so failure paths do not leak partial files.
 */
export declare function atomicWriteText(finalPath: string, text: string): void;
/** Write JSON to `finalPath` atomically (pretty-printed). See {@link atomicWriteText}. */
export declare function atomicWriteJson(finalPath: string, payload: unknown): void;