/** Minimum @earendil-works/pi-coding-agent version the sidecar supports (same floor as pi-config orchestrator). */
export declare const MIN_PI_VERSION = "1.4.0";
/** Compares two semver-ish "x.y.z" strings. Returns <0, 0, or >0. Unparsable input compares as equal (0). */
export declare function compareVersions(a: string, b: string): number;
/**
 * Resolves the installed @earendil-works/pi-coding-agent version from its
 * package.json, or null if unresolvable.
 *
 * Uses resolveExtensionPathDetailed()'s search-path fallback rather than a
 * plain `require.resolve('pkg/package.json')`: the SDK is an ESM-only package
 * with a strict `exports` map, which makes the plain form throw
 * `ERR_PACKAGE_PATH_NOT_EXPORTED` (see AGENTS.md §9 / resolve-extension-path.ts).
 */
export declare function getInstalledPiVersion(): string | null;
/**
 * Extract a semver-ish token from `pi --version` output, preserving any
 * prerelease/build suffix (e.g. `0.81.1-beta.1`). Callers must treat suffixes
 * as below-floor via parseVersion()'s fail-closed rules.
 */
export declare function extractPiVersionToken(text: string): string | null;
/**
 * Enforces the minimum installed @earendil-works/pi-coding-agent version.
 * Throws (does not just log) when the resolved SDK version is below MIN_PI_VERSION
 * or cannot be resolved at all — callers should call this early during startup
 * so a stale SDK install fails fast instead of surfacing confusing runtime errors
 * (e.g. createProvider()-based ACPX/CLI providers silently failing to register).
 */
export declare function assertPiVersionFloor(): void;