/**
 * Platform-specific directory paths.
 *
 * Each platform (Opencode, Pi, etc.) provides its own set of paths
 * for agent files, config, skills, sessions, and extensions.
 */
export interface PlatformPaths {
    /** Platform identifier (e.g. `"opencode"`, `"pi"`). */
    platformId: string;
    /** Directory where agent definition files are stored. */
    agentsDir: string;
    /** Platform configuration directory. */
    configDir: string;
    /** Directory where skill files are stored. */
    skillsDir: string;
    /** Optional sessions directory. */
    sessionsDir?: string;
    /** Optional extensions directory. */
    extensionsDir?: string;
}
/**
 * Returns platform paths for the Opencode platform.
 *
 * - `configDir`: respects `XDG_CONFIG_HOME`, defaults to `~/.config/opencode`
 * - `agentsDir`: `~/.claude/agents`
 * - `skillsDir`: `{configDir}/skills`
 */
export declare function defaultPlatformPaths(): PlatformPaths;
/**
 * Returns platform paths for the Pi platform.
 *
 * Per pi's documented environment variables, the config directory resolves
 * as `$PI_CODING_AGENT_DIR` when set (non-blank), otherwise `~/.pi/agent`;
 * a blank env value is treated as unset.
 *
 * - `configDir`: `$PI_CODING_AGENT_DIR` or `~/.pi/agent`
 * - `agentsDir`: `{configDir}/skills`
 * - `skillsDir`: `{configDir}/skills`
 * - `sessionsDir`: `{configDir}/sessions`
 * - `extensionsDir`: `{configDir}/extensions`
 */
export declare function piPlatformPaths(): PlatformPaths;
/**
 * Returns platform paths for the dsh (DeepSeek Harness) platform.
 *
 * Per the dsh plugin contract (§5.1), the dsh home directory resolves as
 * `$DSH_HOME` when set (non-blank), otherwise `~/.dsh`; a blank env value is
 * treated as unset.
 *
 * - `configDir`: dsh home (`$DSH_HOME` or `~/.dsh`)
 * - `agentsDir`: `{configDir}/skills` (mirrors the pi pattern — dsh has no
 *   native agents directory, so rolebox agent files live under the home tree)
 * - `skillsDir`: `{configDir}/skills`
 * - `sessionsDir`: `{configDir}/sessions` (documented `dshHomePath('sessions')`)
 */
export declare function dshPlatformPaths(): PlatformPaths;
/**
 * Returns platform paths for the Codex platform.
 *
 * Per Codex's documented environment variables, the Codex home directory
 * resolves as `$CODEX_HOME` when set (non-blank), otherwise `~/.codex`; a blank
 * env value is treated as unset.
 *
 * - `configDir`: Codex home (`$CODEX_HOME` or `~/.codex`)
 * - `agentsDir`: `{configDir}/skills` (mirrors the pi/dsh pattern — Codex has
 *   no native agent-file registry, so rolebox agent files live under the home
 *   tree)
 * - `skillsDir`: `{configDir}/skills`
 *
 * Codex has no rolebox-owned sessions directory, so `sessionsDir` is omitted.
 */
export declare function codexPlatformPaths(): PlatformPaths;
//# sourceMappingURL=paths.d.ts.map