/** * Storage path resolution for @a5c-ai/agent-mux. * * Resolves the global config directory and project config directory * based on options, environment variables, and filesystem walk-up. */ /** Resolved paths for both global and project storage directories. */ export interface StoragePaths { /** Absolute path to the global config directory (e.g., ~/.agent-mux). */ readonly configDir: string; /** Absolute path to the project config directory (e.g., .agent-mux). */ readonly projectConfigDir: string; /** Absolute path to the global config.json file. */ readonly globalConfigFile: string; /** Absolute path to the project config.json file. */ readonly projectConfigFile: string; /** Absolute path to the global profiles directory. */ readonly globalProfilesDir: string; /** Absolute path to the project profiles directory. */ readonly projectProfilesDir: string; /** Absolute path to the auth-hints.json file. */ readonly authHintsFile: string; /** Absolute path to the run-index.jsonl file. */ readonly runIndexFile: string; } /** Options that influence storage path resolution. */ export interface StoragePathOptions { /** Override the global config directory. Must be absolute. */ configDir?: string; /** Override the project config directory. Must be absolute. */ projectConfigDir?: string; } /** * Resolve the global and project config directory paths. * * Resolution order for the global config directory: * 1. `options.configDir` if provided. * 2. `AGENT_MUX_CONFIG_DIR` environment variable if set. * 3. `path.join(os.homedir(), '.agent-mux')`. * * Resolution order for the project config directory: * 1. `options.projectConfigDir` if provided. * 2. `AGENT_MUX_PROJECT_DIR` environment variable if set. * 3. Walk up from `process.cwd()` looking for a `.agent-mux/` directory. * 4. If not found, use `path.join(process.cwd(), '.agent-mux')`. */ export declare function resolveStoragePaths(options?: StoragePathOptions): StoragePaths;