export declare const CONFIG_FILENAME = "pi-using-hermes-memories.json";
export declare const DEFAULT_MEMORY_DIRECTORY = "~/.hermes/memories";
export type ConfigSource = "default" | "global" | "project";
export type ResolvedConfig = {
    memoryDirectory: string;
    source: ConfigSource;
    /** Absolute path of the config file that supplied memoryDirectory, if any. */
    configFilePath: string | null;
    globalConfigPath: string;
    /** Caps from Hermes config.yaml (or built-in defaults). */
    memoryCharLimit: number;
    userCharLimit: number;
    /** `hermes-yaml` when at least one cap was read from config.yaml. */
    limitsSource: "hermes-yaml" | "defaults";
    hermesConfigPath: string;
    limitsWarning: string | null;
};
export type EnsureGlobalConfigOptions = {
    piCodingAgentDir: string;
    shareTemplatePath?: string;
};
export type EnsureGlobalConfigResult = "created" | "exists";
export type LoadConfigOptions = {
    cwd: string;
    home: string;
    isProjectTrusted: boolean;
    /** Explicit agent dir; wins over env when set. */
    piCodingAgentDir?: string;
    env?: NodeJS.ProcessEnv;
    shareTemplatePath?: string;
    /** Default true — copy share template when global config is absent. */
    ensureFirstRun?: boolean;
};
/** Locate package root by walking up until share settings template exists. */
export declare function findPackageRoot(fromMetaUrl?: string): string;
export declare function defaultShareTemplatePath(): string;
export declare function resolvePiCodingAgentDir(home: string, env?: NodeJS.ProcessEnv, explicit?: string): string;
export declare function globalConfigPath(piCodingAgentDir: string): string;
export declare function projectConfigPath(cwd: string): string;
/**
 * First-run: if global config is missing, create parent dir and copy template.
 * Never overwrites an existing file.
 */
export declare function ensureGlobalConfig(options: EnsureGlobalConfigOptions): EnsureGlobalConfigResult;
/**
 * Resolve effective memory directory: defaults → global → trusted project.
 */
export declare function loadConfig(options: LoadConfigOptions): ResolvedConfig;
//# sourceMappingURL=config.d.ts.map