/**
 * User directory provisioning and path helpers for multi-tenant gateway.
 *
 * User directories live at {stateDir}/users/{userId}/ and contain:
 * - sessions/   — per-user session data (isolated session mode)
 * - memory/     — per-user memory files
 * - credentials/ — per-user OAuth tokens and credentials
 * - usage/      — per-user API usage tracking
 *
 * Provisioning is idempotent — safe to call on every authentication.
 */
/**
 * Resolve the root directory for a given user.
 * Returns: {stateDir}/users/{userId}
 */
export declare function resolveUserDir(stateDir: string, userId: string): string;
/**
 * Alias for resolveUserDir — returns the user workspace root.
 * Returns: {stateDir}/users/{userId}
 */
export declare function resolveUserWorkspacePath(stateDir: string, userId: string): string;
/**
 * Resolve the path to the user's session store JSON file.
 * Returns: {stateDir}/users/{userId}/sessions/sessions.json
 */
export declare function resolveUserSessionsPath(stateDir: string, userId: string): string;
/**
 * Resolve the path for an isolated user-agent session directory.
 * Returns: {stateDir}/users/{userId}/sessions/{agentId}:{label}
 */
export declare function resolveUserAgentSessionsPath(stateDir: string, userId: string, agentId: string, label: string): string;
/**
 * Resolve the path to the user's memory directory.
 * Returns: {stateDir}/users/{userId}/memory
 */
export declare function resolveUserMemoryPath(stateDir: string, userId: string): string;
/**
 * Resolve the path to the user's credentials directory.
 * Returns: {stateDir}/users/{userId}/credentials
 */
export declare function resolveUserCredentialsPath(stateDir: string, userId: string): string;
/**
 * Resolve the path to the user's usage tracking directory.
 * Returns: {stateDir}/users/{userId}/usage
 */
export declare function resolveUserUsagePath(stateDir: string, userId: string): string;
/**
 * Provision a user directory with all required subdirectories.
 *
 * Idempotent — uses `recursive: true` so calling multiple times
 * is safe even under concurrent creation.
 *
 * Creates:
 * - {stateDir}/users/{userId}/
 * - {stateDir}/users/{userId}/sessions/
 * - {stateDir}/users/{userId}/memory/
 * - {stateDir}/users/{userId}/credentials/
 * - {stateDir}/users/{userId}/usage/
 */
export declare function provisionUserDirectory(stateDir: string, userId: string): Promise<void>;
