/**
 * Peer name resolution + name validation — the client-side half of addressing.
 *
 * The wire routes on the unforgeable instance id (the nkey carried in the subject); a human
 * **name** is only a convenience this resolves to an id. Resolution is deterministic and
 * fail-loud: it returns exactly one peer or throws {@link AmbiguousPeerError} — it never
 * silently picks among same-named peers. The id is authoritative; the name is best-effort.
 *
 * `owner/name` handles (per-owner namespaces) land with the accounts/auth feature; until then
 * `/` is reserved in a name ({@link assertValidName}) so they slot in without a migration.
 * See .internal/plans/peer-addressing.md.
 */
import type { Presence, PresenceStatus } from "./types.js";
/** A peer that matched an ambiguous name — structural, so each surface renders it itself
 *  (core never formats UI strings). The full `id` is the authoritative, routable address. */
export interface PeerCandidate {
    id: string;
    name: string;
    role?: string;
    status: PresenceStatus;
    /** Epoch ms of the peer's last heartbeat. */
    ts: number;
}
/** Thrown when a name resolves to two or more peers that could each be the target. Carries the
 *  candidates structurally so a caller can show them and re-address by the exact `id`. */
export declare class AmbiguousPeerError extends Error {
    readonly target: string;
    readonly candidates: PeerCandidate[];
    constructor(target: string, candidates: PeerCandidate[]);
}
/**
 * Resolve a `target` (an exact instance id, or a display name) to one peer on `roster`.
 *
 * - an exact instance-id match wins (any status — an id is unambiguous);
 * - otherwise a case-insensitive name match, preferring live peers over stale offline ghosts:
 *   one live match resolves; **2+ live matches throw**; with no live match a unique offline peer
 *   resolves (best-effort), but **2+ offline duplicates throw**;
 * - no match → `undefined` (the caller renders "no such peer").
 *
 * `opts.selfId`, when given, is excluded (you don't DM yourself). Throws
 * {@link AmbiguousPeerError} rather than ever silently picking.
 */
export declare function resolvePeer(roster: Presence[], target: string, opts?: {
    selfId?: string;
}): Presence | undefined;
/**
 * Validate a display name. A name must be non-empty, single-line, and free of surrounding
 * whitespace; `/` is reserved as the future `owner/name` separator (and already means "a path"
 * to the agent-file loader). Throws — no silent rewrite (per AGENTS.md, no fallbacks). Internal
 * spaces are allowed (human display names like "Ada Lovelace").
 */
export declare function assertValidName(name: string): void;
//# sourceMappingURL=resolve.d.ts.map