/**
 * 项目目录映射：路径规范化与宿主绝对路径求解。
 */
/** IM 信令 / 项目配置中 localRoot.kind 的合法取值（仅此两种） */
export declare const LOCAL_ROOT_KINDS: readonly ["workspace_relative", "host_absolute"];
export type LocalRootKind = (typeof LOCAL_ROOT_KINDS)[number];
export interface LocalRootSpec {
    kind: LocalRootKind;
    path: string;
}
/** 知识库目录 fileId（IM 信令 remoteRootFolderId → 同步服务 remoteRootFileId） */
export declare function normalizeRemoteRootFolderId(raw: string): string;
/** 知识库逻辑路径：去掉首部 `/`，统一为正斜杠分段 */
export declare function normalizeRemoteRootFolderPath(raw: string): string;
export interface ResolvedRemoteRoot {
    /** 写入同步服务 body 的 remoteRootFileId */
    remoteRootFileId?: string;
    remoteRootFolderPath?: string;
}
/**
 * 解析 upsert 远端根：remoteRootFolderId 优先；两者都填时 id 决定同步根，path 仍透传供 upload 前缀。
 */
export declare function resolveRemoteRootForSync(params: {
    remoteRootFolderId?: string;
    remoteRootFolderPath?: string;
}): ResolvedRemoteRoot;
/** 规范化 workspace 相对段（去 ./、前导 /、尾部 /，禁止 ..） */
export declare function normalizeWorkspaceRelativeSegment(userPath: string): string;
export declare function resolveLocalAbsolutePath(localRoot: LocalRootSpec, workspaceHostRoot: string | undefined): string;
//# sourceMappingURL=project-path-normalize.d.ts.map