/**
 * Mesh addressing for plan/35 (malha direta). An "agent" ≡ a cwd (cwd_lock
 * guarantees at most one Pi per folder), so the folder *is* the address:
 *
 *   - **local**  → an absolute path on this machine. A local peer is reached by
 *     `POST`ing its inbox socket directly (see `apiSockPath`).
 *   - **remote** → `<label>:/path`, where `<label>` names a sibling machine
 *     (resolved to a pubkey via `mesh_versions`/siblings in Wave C) and `/path`
 *     is the folder on that machine. Routed cross-PC through the relay.
 *
 * The address an agent passes is ALWAYS the absolute folder path; the `.sock`
 * file itself lives OUTSIDE the cwd (decisão fixada — "Transporte local"). The
 * folder is hashed to the file name, so the mapping is deterministic and both
 * the inbox (its own socket) and a sender (the peer's socket) land on the same
 * file without coordinating.
 *
 * Wave 0 only *parses* what it is handed — contacts (known routes) live in the
 * agent's context/CLAUDE.md (decisão Q5), not in an allowlist module. The
 * `<label>→pubkey` resolution and remote send arrive in Wave C; here we keep
 * the parser and the local route→socket mapping.
 */
export type Address = {
    kind: "local";
    path: string;
} | {
    kind: "remote";
    label: string;
    path: string;
};
export declare class AddressError extends Error {
    constructor(message: string);
}
/**
 * Parses a mesh address. A `:` separates a remote `<label>` from its `/path`;
 * with no `:` the whole string is a local absolute path (decisão fixada:
 * "Sem ':' → local"). Both the local path and the remote path must be
 * absolute — the folder is the canonical route.
 */
export declare function parseAddress(raw: string): Address;
/**
 * The inbox socket path for a folder. Single source of truth shared by the
 * inbox server (its own socket) and the send client (a local peer's socket).
 *
 * `~/.pi/remote-pi/socks/<roomId>.sock`, where `roomId = roomIdForCwd(folder)`
 * (`sha256(realpath(folder))[:12]` — the same hash `cwd_lock` uses). The folder
 * is the address; the hash is only the file name. `realpath` canonicalization
 * means `/a` and a symlink to `/a` map to the same socket.
 */
export declare function apiSockPath(folderPath: string): string;