import type { Config } from '../config/schema.js';
export type ResolveWebchatSessionKeyInput = {
    cfg: Config;
    sessionKey?: string;
    chatId?: string;
    newSession?: boolean;
};
export type ResolveWebchatSessionKeyResult = {
    ok: true;
    sessionKey: string;
} | {
    ok: false;
    error: string;
};
/**
 * Resolve the canonical `agent:` session key for webchat `/api/agent` requests.
 * Rejects bare legacy peer ids (e.g. `chat_*` without `agent:` prefix).
 */
export declare function resolveWebchatSessionKey(input: ResolveWebchatSessionKeyInput): ResolveWebchatSessionKeyResult;
