import { type SpawnSyncReturns } from "node:child_process";
declare const RESULT_SCHEMA: "pi-workflows.herdr-sync.v1";
export type HerdrSyncStatus = "linked" | "relinked" | "enabled" | "unchanged" | "unavailable";
export type HerdrSyncResult = {
    schema: typeof RESULT_SCHEMA;
    status: HerdrSyncStatus;
    changed: boolean;
    pluginId: string;
    expectedVersion: string;
    effectiveVersion: string | null;
    enabled: boolean | null;
    runningPiProcessesNeedReload: true;
    message: string;
};
export type HerdrSetupResult = HerdrSyncResult;
type Spawn = (command: string, args: readonly string[]) => SpawnSyncReturns<string>;
export declare function syncHerdrPlugin(packageRoot: string, spawn?: Spawn): HerdrSyncResult;
/** Compatibility alias for callers that used the original setup API. */
export declare function setupHerdrPlugin(packageRoot: string, spawn?: Spawn): HerdrSetupResult;
export {};