export type RaxPathResolutionErrorCode = "EMPTY_PATH" | "RELATIVE_HOME" | "INVALID_CWD" | "INVALID_AGENT_ID" | "PATH_ESCAPE";
export type RaxPathResolutionError = {
    code: RaxPathResolutionErrorCode;
    message: string;
    boundary: "input" | "filesystem" | "security";
    publicSafe: true;
};
export type RaxPathResolutionResult<TValue> = {
    ok: true;
    value: TValue;
    events: readonly string[];
} | {
    ok: false;
    error: RaxPathResolutionError;
    events: readonly string[];
};
export type RaxHomeResolutionInput = {
    explicitHome?: string;
    homeDir?: string;
    env?: Readonly<Record<string, string | undefined>>;
};
export type RaxHomeResolution = {
    root: string;
    source: "explicit" | "env" | "os";
};
export type RaxWorkspaceResolutionInput = {
    cwd?: string;
    explicitWorkspaceRoot?: string;
    workspaceFolderName?: string;
};
export type RaxWorkspaceResolution = {
    root: string;
    cwd: string;
    source: "explicit" | "discovered" | "planned";
    existing: boolean;
    workspaceFolderName: string;
};
export declare function resolveRaxHome(input?: RaxHomeResolutionInput): RaxPathResolutionResult<RaxHomeResolution>;
export declare function resolveRaxWorkspace(input?: RaxWorkspaceResolutionInput): RaxPathResolutionResult<RaxWorkspaceResolution>;
export declare function safeAgentStorageId(agentId: string): RaxPathResolutionResult<string>;
export declare function assertChildPath(parent: string, child: string): RaxPathResolutionResult<string>;
