/** Agent path and list resolution backed by the SQLite Agent catalog. */
import type { AgentEntry } from '../agent-config/index.js';
import { DEFAULT_AGENT_ID, deriveAgentIdFromDisplayName, normalizeAgentId, STRICT_AGENT_ID_RE, validateAgentIdForNewAgent } from '../agent-catalog/id.js';
export { DEFAULT_AGENT_ID, deriveAgentIdFromDisplayName, normalizeAgentId, STRICT_AGENT_ID_RE, validateAgentIdForNewAgent, };
/** Expand `~` and resolve to an absolute path. */
export declare function resolveUserPath(raw: string): string;
export declare function listAgentEntries(): AgentEntry[];
export declare function resolveDefaultAgentId(): string;
/** Markdown workspace root for an Agent. */
export declare function resolveAgentWorkspaceDir(agentId: string): string;
/** Internal Agent state dir: credentials, `agent.json`, pid, inbox (`…/agent/`). */
export declare function resolveAgentDir(agentId: string): string;
/** Parent of `sessions/` and `agent/`: `<stateDir>/agents/<id>/`. */
export declare function resolveAgentHomeDir(agentId: string): string;
/** Profile Markdown + gateway avatar files: `<stateDir>/agents/<id>/profile/`. */
export declare function resolveAgentProfileDir(agentId: string): string;
/** Resolved path for a single profile Markdown basename (e.g. `SOUL.md`). */
export declare function resolveAgentProfileMarkdownPath(agentId: string, filename: string): string;
/** Agent ids whose workspace root contains `workspacePath` (longest match first). */
export declare function resolveAgentIdsByWorkspacePath(workspacePath: string): string[];
/** Best-matching Agent id for cwd, or `undefined` when no workspace contains the path. */
export declare function resolveAgentIdByWorkspacePath(workspacePath: string): string | undefined;
/** Resolve an Agent from a workspace, falling back to the catalog default. */
export declare function resolveAgentIdForWorkspacePath(resolvedWorkspacePath: string): string;
export declare function getDefaultWorkspacePath(): string;