/**
 * Bounded local adapter for KINGDOM OS repository discovery.
 *
 * This client invokes only the committed machine-readable `kingdom repos`
 * surfaces. It never uses the hosted AgentTool transport, opens a shell,
 * mutates repository state, runs Kingdom routines, or uploads local paths.
 *
 * Doctrine: docs/KINGDOM-OS-SDK.md.
 */
/** One local Git root reported by `kingdom repos --json`. */
export interface KingdomOSRepository {
    path: string;
    name: string;
    kind: string;
    layer: string;
    domain: string;
    state: string;
    place: string;
    metadataSource: string;
    purpose: string;
}
/** Exact fixed command presented to an injected local runner. */
export interface KingdomOSCommand {
    executable: string;
    args: readonly string[];
    timeoutMs: number;
    maxOutputBytes: number;
    env: Readonly<Record<string, string>>;
}
/** Captured outcome from an injected local runner. */
export interface KingdomOSCommandResult {
    exitCode: number;
    stdout: string;
    stderr: string;
}
/** Injectable seam for tests and non-Node hosts. */
export type KingdomOSRunner = (command: KingdomOSCommand) => Promise<KingdomOSCommandResult>;
/** Local KINGDOM OS adapter configuration. */
export interface KingdomOSOptions {
    /** Executable path or PATH-resolved command. Defaults to `kingdom`. */
    executable?: string;
    /** Command timeout in seconds. Defaults to 10. */
    timeout?: number;
    /** Combined stdout/stderr ceiling. Defaults to 1 MiB. */
    maxOutputBytes?: number;
    /** Optional host-owned runner. No arbitrary command method is exposed. */
    runner?: KingdomOSRunner;
}
/** Read-only local client for the committed KINGDOM OS repository seams. */
export declare class KingdomOSClient {
    private readonly executable;
    private readonly timeoutMs;
    private readonly maxOutputBytes;
    private readonly runner;
    constructor(options?: KingdomOSOptions);
    /** List discovered local Git roots matching every supplied term. */
    repositories(terms?: readonly string[]): Promise<KingdomOSRepository[]>;
    /** Resolve one query to exactly one canonical absolute Git root. */
    resolve(terms: readonly string[]): Promise<string>;
    private execute;
    private commandFailure;
}