/**
 * Agent Paths — Centralized dot-directory name and path helpers.
 *
 * All filesystem paths under `~/.qlogicagent/` (user-level) or
 * `<project>/.qlogicagent/` (project-level) must go through these
 * helpers so the dot-dir name is defined in exactly one place.
 */
/** Dot-directory name used for both user-level and project-level storage. */
export declare const AGENT_DOT_DIR = ".qlogicagent";
/** `~/.qlogicagent/` (or QLOGICAGENT_HOME override) */
export declare function getUserAgentHome(): string;
export declare function resolveActiveOwnerUserId(): string;
export declare function encodeOwnerProfileSegment(ownerUserId: string): string;
export declare function getOwnerProfileDir(ownerUserId?: string): string;
export declare function getProfileMemoryDir(ownerUserId?: string): string;
/**
 * Ensure the user agent home directory exists and is writable.
 * Returns the path if accessible, throws with a friendly message otherwise.
 * Call this once at startup rather than on every path resolution.
 */
export declare function ensureUserAgentHome(): string;
/** `~/.qlogicagent/profiles/<owner>/.credentials.json` */
export declare function getUserCredentialsPath(): string;
/** `~/.qlogicagent/profiles/<owner>/plugins/` */
export declare function getUserPluginsDir(): string;
/** `~/.qlogicagent/profiles/<owner>/skills/` */
export declare function getUserSkillsDir(): string;
/** `~/.qlogicagent/profiles/<owner>/settings.json` */
export declare function getUserSettingsPath(): string;
/** `~/.qlogicagent/cache/` */
export declare function getUserCacheDir(): string;
/** `~/.qlogicagent/debug-logs/` */
export declare function getUserDebugLogsDir(): string;
/** `~/.qlogicagent/profiles/<owner>/plugin-cache/` */
export declare function getUserPluginCacheDir(): string;
/** `~/.qlogicagent/profiles/<owner>/mcp.json` */
export declare function getUserMcpConfigPath(): string;
/** `~/.qlogicagent/profiles/<owner>/marketplace.json` */
export declare function getUserMarketplaceConfigPath(): string;
/** `~/.qlogicagent/profiles/<owner>/workflows/` */
export declare function getUserWorkflowsDir(): string;
/** `~/.qlogicagent/profiles/<owner>/INSTRUCTIONS.md` */
export declare function getUserInstructionsPath(): string;
/** `~/.qlogicagent/profiles/<owner>/rules/` */
export declare function getUserRulesDir(): string;
/** `<cwd>/.qlogicagent/` */
export declare function getProjectAgentDir(cwd: string): string;
/** `<cwd>/.qlogicagent/workflows/` */
export declare function getProjectWorkflowsDir(cwd: string): string;
/** `<cwd>/.qlogicagent/plugins/` */
export declare function getProjectPluginsDir(cwd: string): string;
/** `<cwd>/.qlogicagent/skills-enabled.json` — per-project skill enablement manifest. */
export declare function getProjectSkillManifestPath(cwd: string): string;
/** `<cwd>/.qlogicagent/settings.json` */
export declare function getProjectSettingsPath(cwd: string): string;
/** `<cwd>/.qlogicagent/INSTRUCTIONS.md` */
export declare function getProjectInstructionsPath(cwd: string): string;
/** `<cwd>/.qlogicagent/rules/` — unified rules + instructions directory */
export declare function getProjectRulesDir(cwd: string): string;
/** `<cwd>/.qlogicagent/sessions/` */
export declare function getProjectSessionsRoot(cwd: string): string;
/** `<cwd>/.qlogicagent/sessions/{sessionId}` */
export declare function getProjectSessionDir(cwd: string, sessionId: string): string;
/** `<cwd>/.qlogicagent/checkpoints/` or `<cwd>/.qlogicagent/checkpoints/{sessionId}` */
export declare function getProjectCheckpointsDir(cwd: string, sessionId?: string): string;
/** `<gitRoot>/.qlogicagent/hooks/` */
export declare function getGitRootHooksDir(gitRoot: string): string;
