import type { HumansConfig, HumanOwner } from './types.js';
export declare const HUMANS_VERSION: 1;
export declare const HUMANS_HEADER = "# humans.yaml \u2014 owner identity and notification channels\n# Managed by agents-cli. See: agents humans --help\n";
/**
 * Read and parse humans.yaml. Returns null when the file does not exist or
 * is not a valid v1 config — never throws.
 */
export declare function readHumans(): HumansConfig | null;
/**
 * Write a HumansConfig to ~/.agents/humans.yaml. Creates the file with the
 * canonical header. Overwrites any existing content.
 */
export declare function writeHumans(config: HumansConfig): void;
/**
 * Return the effective owner notification destination from humans.yaml.
 * The owner's normal-severity policy selects the channel; when no normal
 * policy is declared, the first addressable channel is the default.
 */
export declare function getOwnerNotifyFromHumans(): {
    channel: string;
    to: string;
} | null;
/**
 * Return every addressable owner destination selected by the normal-severity
 * policy, in policy order. A config without a policy keeps the historical
 * single-channel behavior by selecting the first addressable channel.
 */
export declare function getOwnerNotifyDestinationsFromHumans(): Array<{
    channel: string;
    to: string;
}>;
/**
 * Read the owner block from humans.yaml. Returns null if missing.
 */
export declare function getOwnerFromHumans(): HumanOwner | null;
