import type { ToolSession } from "../../tools";
import { type JsStatusEvent } from "../js/tool-bridge";
export interface PyToolBridgeEntry {
    toolSession: ToolSession;
    signal?: AbortSignal;
    emitStatus?: (event: JsStatusEvent) => void;
}
export interface PyToolBridgeInfo {
    url: string;
    token: string;
}
/** Starts the bridge server lazily and returns its connection info. */
export declare function ensurePyToolBridge(): Promise<PyToolBridgeInfo>;
/**
 * Register a tool session for the duration of one execution. The returned
 * function MUST be called to remove the entry once execution finishes.
 */
export declare function registerPyToolBridge(sessionId: string, entry: PyToolBridgeEntry): () => void;
/** Stop the bridge and clear registrations. Test-only / shutdown helper. */
export declare function disposePyToolBridge(): Promise<void>;