/**
 * @license
 * Copyright 2026 Qwen
 * SPDX-License-Identifier: Apache-2.0
 */
import type { SocketLike } from '../realtime/socket.js';
import type { DebugArchive } from './debug-archive.js';
type ConnectionInfo = Parameters<DebugArchive['beginConnection']>[0];
/** No headers or constructor settings enter the archive through this seam. */
export interface DebugSocketOptions {
    debugArchive?: DebugArchive;
    info: ConnectionInfo;
}
/**
 * Observe the transport before any provider parser, without changing its wire
 * messages. A successful send means local acceptance, not a provider ACK.
 * When debug is disabled even object identity and listeners remain unchanged.
 */
export declare function createDebugSocket<T extends SocketLike>(create: () => T, options: DebugSocketOptions): T;
export {};