import { type RuntimeProfileId } from "./runtime-profile.ts";
export type InitializationStatus = "installed" | "unchanged";
export interface InitializeProjectResult {
    readonly status: InitializationStatus;
    readonly version: string;
    readonly installedPaths: readonly string[];
    readonly preservedLegacyPaths: readonly string[];
}
export type ProjectInitializationErrorCode = "conflict" | "incompatible-version" | "invalid-project" | "unsafe-path" | "write-failed";
export declare class ProjectInitializationError extends Error {
    readonly code: ProjectInitializationErrorCode;
    constructor(code: ProjectInitializationErrorCode, message: string, options?: ErrorOptions);
}
/** Resolves the OpenCode global configuration directory without platform-specific paths. */
export declare function resolveGlobalConfigRoot(env?: NodeJS.ProcessEnv, home?: string): Promise<string>;
export declare function initializeProject(projectRoot?: string, profile?: RuntimeProfileId): Promise<InitializeProjectResult>;
/** Installs the packaged runtime into OpenCode's global configuration directory. */
export declare function initializeGlobal(globalRoot?: string, profile?: RuntimeProfileId): Promise<InitializeProjectResult>;