/**
 * Normalize a path to use forward slashes.
 *
 * On Windows, Node's path APIs and user-supplied paths often use backslashes,
 * while fast-glob returns forward-slash paths. Comparisons and stored paths
 * must agree, and Node's fs accepts forward slashes on win32 — so converting
 * backslashes to forward slashes keeps every path readable and comparable on
 * all platforms. A forward-slash path is returned unchanged.
 */
export declare function toPosixPath(p: string): string;
/**
 * Convert a forward-slash path back to native platform separators.
 *
 * Inverse of `toPosixPath`: on POSIX it is a no-op; on Windows it restores
 * backslash separators. Use it when a posix-normalized path must become a
 * real platform-native filesystem path again (e.g. before `join`, `dirname`,
 * or fs operations, which on win32 must agree with join-built paths).
 */
export declare function toNativePath(p: string): string;
/**
 * Separator-insensitive path comparison — the canonical way to test whether two
 * paths refer to the same location regardless of `\` vs `/`.
 *
 * This is a pure string → boolean function with **no platform branch**: it does
 * not consult `path.sep` or `process.platform`, so win32 semantics are fully
 * exercisable on POSIX (see tests/utils/paths.test.ts). Both operands are
 * normalized with `toPosixPath` and compared. Rationale for normalizing before
 * comparison matches src/resolver/skill-resolver.ts:57-63 — backslash-built
 * (win32 `join`) and forward-slash (fast-glob) paths must agree, and on POSIX
 * `toPosixPath` is a no-op so behavior is unchanged there.
 */
export declare function samePath(a: string, b: string): boolean;
/** `{baseDir}/{name}.md` */
export declare function functionPath(baseDir: string, name: string): string;
/** `{baseDir}/{name}/SKILL.md` */
export declare function skillDirPath(baseDir: string, name: string): string;
/** `{baseDir}/{name}.md` */
export declare function skillFilePath(baseDir: string, name: string): string;
/** `{roleDir}/subagents/{slug}` */
export declare function subagentDir(roleDir: string, slug: string): string;
/** `{configDir}/functions` */
export declare function globalFunctionsPath(configDir: string): string;
/**
 * `{defaultPlatformPaths().agentsDir}/{agentId}.md`
 *
 * Delegates to the PlatformPaths registry; no longer hardcodes
 * `~/.claude/agents` directly.
 */
export declare function agentFilePath(agentId: string): string;
/**
 * `defaultPlatformPaths().agentsDir`
 *
 * Delegates to the PlatformPaths registry.
 */
export declare function agentsDir(): string;
/**
 * Returns the platform-specific agent directory.
 * - `"pi"` → `piPlatformPaths().agentsDir`
 * - `"dsh"` → `dshPlatformPaths().agentsDir`
 * - default (or `"opencode"`) → `defaultPlatformPaths().agentsDir`
 */
export declare function platformAgentsDir(platformId?: string): string;
/**
 * Returns the platform-specific agent file path.
 * - `"pi"` → `{piPlatformPaths().agentsDir}/{agentId}/SKILL.md`
 * - default (or `"opencode"`) → `agentFilePath(agentId)`
 */
export declare function platformAgentFilePath(agentId: string, platformId?: string): string;
//# sourceMappingURL=paths.d.ts.map