/**
 * Shared initialization helpers for rolebox entry points.
 *
 * Both the Opencode plugin (src/index.ts) and the Pi extension
 * (src/pi-extension.ts) need to resolve directory paths and bootstrap
 * roles. This module provides two helpers that eliminate the ~80 lines
 * of duplicated logic between the two entry points:
 *
 *   resolveRoleboxDirectories() — delegates to R5's PlatformPaths
 *     registry to determine configDir, skillsDir, etc., with
 *     working-directory-aware roleboxDir fallback.
 *
 *   initializeRoleboxRuntime() — calls bootstrapRoles() and
 *     optionally syncAllAgents() via the provided registrar,
 *     returning the bootstrap result.
 */
import { type BootstrapRolesResult } from "../resolver/bootstrap.ts";
import type { IAgentRegistrar } from "./ports/agent-registrar.ts";
import type { ResolvedFunction } from "../types.ts";
/** Resolved directory paths for rolebox initialization. */
export interface RoleboxDirectories {
    /** Path to the rolebox directory containing role.yaml files. */
    roleboxDir: string;
    /** Path to the global skills directory. */
    globalSkillsDir: string;
    /** Platform configuration directory (e.g. ~/.config/opencode). */
    configDir: string;
    /** Path to the built-in functions directory (package root's functions/). */
    builtinDir: string;
}
/** Options for resolveRoleboxDirectories(). */
export interface ResolveDirectoriesOptions {
    /**
     * Working directory — used to check for a local `rolebox/` subdirectory.
     * Defaults to `process.cwd()`.
     */
    workingDir?: string;
    /**
     * Platform identifier — selects which PlatformPaths to delegate to.
     * - `"opencode"` (default) → `defaultPlatformPaths()` → `~/.config/opencode`
     * - `"pi"` → `piPlatformPaths()` → `~/.pi/agent`
     * - `"dsh"` → `dshPlatformPaths()` → `$DSH_HOME` or `~/.dsh`
     */
    platformId?: string;
}
/** Options for initializeRoleboxRuntime(). */
export interface InitializeRuntimeOptions {
    /** Resolved directory paths (from resolveRoleboxDirectories). */
    directories: RoleboxDirectories;
    /** Map to populate with roleId/subagentId → resolved functions (mutated in-place). */
    roleFunctionsMap: Map<string, ResolvedFunction[]>;
    /**
     * Optional agent registrar. When provided, syncAllAgents() is called
     * after bootstrapRoles() to register agents with the host platform.
     * When omitted, agent sync is skipped (caller handles it separately).
     */
    registrar?: IAgentRegistrar;
}
/**
 * Resolve rolebox directory paths for the given platform and working directory.
 *
 * Delegates to R5's `PlatformPaths` registry to determine platform-specific
 * paths (configDir, skillsDir). The `roleboxDir` is resolved with a working-
 * directory-aware fallback: it checks for `{workingDir}/rolebox` first, and
 * falls back to `{configDir}/rolebox` if that does not exist.
 *
 * The `builtinDir` is always resolved relative to the package root
 * (the `functions/` directory shipped with the rolebox package).
 */
export declare function resolveRoleboxDirectories(opts?: ResolveDirectoriesOptions): RoleboxDirectories;
/**
 * Bootstrap roles and optionally sync agents to the host platform.
 *
 * Calls `bootstrapRoles()` with the resolved directories and shared state
 * maps, then optionally calls `syncAllAgents()` if a registrar is provided.
 * Returns the bootstrap result with discovered/resolved/skipped counts and
 * the resolved role array.
 */
export declare function initializeRoleboxRuntime(opts: InitializeRuntimeOptions): Promise<BootstrapRolesResult>;
//# sourceMappingURL=factory.d.ts.map