import type { SigilPaths } from './paths.js';
/**
 * `sigil rpc init <handle> --upstream <url> [--port <n>]` — provision the
 * [rpc] block that enables the JSON-RPC signing proxy, so nobody has to
 * hand-edit TOML or remember to generate a strong token.
 *
 * Config-file handling is append-only: the config file is user-owned and
 * may carry a [confirm] block and comments we must not clobber, so we never
 * parse-and-rewrite — we validate the existing content, then append the new
 * block verbatim. An existing [rpc] block is a hard refusal (edit or remove
 * it yourself), matching `sigil policy init`'s refuse-to-overwrite stance.
 */
export interface RpcInitResult {
    configPath: string;
    /** True if the config file didn't exist and was created (mode 0600). */
    created: boolean;
    portal: string;
    port: number;
    token: string;
    /** Ready-to-paste endpoint with Basic auth embedded. */
    authedUrl: string;
}
export declare function rpcInit(paths: SigilPaths, handle: string, upstream: string, port?: number): RpcInitResult;
//# sourceMappingURL=rpc.d.ts.map