import type { DebugSessionManager, SourceMapper } from '@salesforce/b2c-tooling-sdk/operations/debug';
import type { CartridgeMapping } from '@salesforce/b2c-tooling-sdk/operations/code';
import type { ToolExecutionContext } from '../adapter.js';
import type { ToolResolution } from '../project-context.js';
export interface DebugSessionEntry {
    sessionId: string;
    hostname: string;
    clientId: string;
    manager: DebugSessionManager;
    sourceMapper: SourceMapper;
    cartridges: CartridgeMapping[];
    createdAt: number;
    lastActivityAt: number;
    resolution?: ToolResolution;
}
export interface RegisterSessionOptions {
    hostname: string;
    clientId: string;
    manager: DebugSessionManager;
    sourceMapper: SourceMapper;
    cartridges: CartridgeMapping[];
    resolution?: ToolResolution;
}
export declare class DebugSessionRegistry {
    private cleanupTimer;
    private readonly sessions;
    constructor();
    destroyAll(): Promise<void>;
    destroySession(sessionId: string): Promise<void>;
    findByHostAndClientId(hostname: string, clientId: string): DebugSessionEntry | undefined;
    getSession(sessionId: string): DebugSessionEntry | undefined;
    getSessionOrThrow(sessionId: string): DebugSessionEntry;
    listSessions(): DebugSessionEntry[];
    registerSession(opts: RegisterSessionOptions): DebugSessionEntry;
    private cleanupIdleSessions;
}
/**
 * Resolve the registry from the tool execution context, throwing a clear
 * error if it's missing, then look up the session by ID. Used by every
 * debug tool that takes a session_id.
 */
export declare function getSessionEntry(context: ToolExecutionContext, sessionId: string): DebugSessionEntry;
/** Resolve the registry from the tool context (for tools that don't need a specific session). */
export declare function getRegistry(context: ToolExecutionContext): DebugSessionRegistry;