import type { Config } from '../config/schema.js';
import type { FileReferenceLocationKind, FileReferenceScope } from './file-reference-registry.js';
export type { FileReferenceLocationKind };
export interface FilePathClassifierContext {
    workspaceRoot: string;
    profileMarkdownRoot?: string;
    stateDir: string;
    skillsDir: string;
    configFilePath: string;
    agentsHomeDir: string;
    sessionsDir: string;
    agentId: string;
}
export declare function buildFilePathClassifierContext(cfg: Config, sessionKeyRaw?: string): FilePathClassifierContext;
export declare function looksLikeHostAbsolutePath(pathRaw: string): boolean;
export declare function fileRefSessionKeysMatch(registered?: string, query?: string): boolean;
export interface ClassifiedFileLocation {
    scope: FileReferenceScope;
    locationKind?: FileReferenceLocationKind;
    manageRoute?: string;
}
export declare function classifyFileLocation(absPath: string, ctx: FilePathClassifierContext): ClassifiedFileLocation;
export interface ResolveFileReferenceCandidateResult {
    candidate: string | null;
    invalid: boolean;
}
/**
 * Resolve user path to an absolute candidate (workspace, absolute host, or profile fallback).
 */
export declare function resolveFileReferenceCandidate(rawPath: string, workspaceRoot: string, ctx: FilePathClassifierContext): Promise<ResolveFileReferenceCandidateResult>;
export declare function displayNameForPath(rawPath: string): string;
