/**
 * BaseRemoteAdapter — abstract base class for remote (HTTP/WebSocket/Unix) adapters.
 *
 * Provides shared utilities for connection management, server lifecycle,
 * and common remote adapter functionality.
 */
import type { AgentName, AgentCapabilities, ModelCapabilities, AgentConfig, AgentConfigSchema, AuthState, AuthSetupGuidance, Session, InstalledPlugin, PluginInstallOptions, PluginSearchOptions, PluginListing, RunOptions, RemoteAdapter, RemoteConnection, ServerOptions, ServerInfo, ServerHealth, SpawnArgs, ParseContext, AgentEvent } from '@a5c-ai/comm-adapter';
/**
 * Abstract base class for remote adapters. Provides shared utilities
 * and sensible defaults for HTTP, WebSocket, and Unix socket adapters.
 */
export declare abstract class BaseRemoteAdapter implements RemoteAdapter {
    readonly adapterType: "remote";
    readonly cliCommand = "[remote]";
    buildSpawnArgs(_options: RunOptions): SpawnArgs;
    parseEvent(_line: string, _context: ParseContext): AgentEvent | AgentEvent[] | null;
    abstract readonly agent: AgentName;
    abstract readonly displayName: string;
    abstract readonly connectionType: 'http' | 'websocket' | 'unix';
    abstract readonly minVersion?: string;
    abstract readonly capabilities: AgentCapabilities;
    abstract readonly models: ModelCapabilities[];
    abstract readonly defaultModelId?: string;
    abstract readonly configSchema: AgentConfigSchema;
    abstract connect(options: RunOptions): Promise<RemoteConnection>;
    abstract disconnect(connection: RemoteConnection): Promise<void>;
    abstract detectAuth(): Promise<AuthState>;
    abstract getAuthGuidance(): AuthSetupGuidance;
    abstract sessionDir(cwd?: string): string;
    abstract parseSessionFile(filePath: string): Promise<Session>;
    abstract listSessionFiles(cwd?: string): Promise<string[]>;
    abstract readConfig(cwd?: string): Promise<AgentConfig>;
    abstract writeConfig(config: Partial<AgentConfig>, cwd?: string): Promise<void>;
    readonly hostEnvSignals?: readonly string[];
    listPlugins?(): Promise<InstalledPlugin[]>;
    installPlugin?(pluginId: string, options?: PluginInstallOptions): Promise<InstalledPlugin>;
    uninstallPlugin?(pluginId: string): Promise<void>;
    searchPlugins?(query: string, options?: PluginSearchOptions): Promise<PluginListing[]>;
    readHostMetadata?(env: NodeJS.ProcessEnv): Record<string, string | number | boolean | null>;
    startServer?(options?: ServerOptions): Promise<ServerInfo>;
    stopServer?(serverInfo: ServerInfo): Promise<void>;
    healthCheck?(serverInfo: ServerInfo): Promise<ServerHealth>;
    /**
     * Tracks active connections for cleanup.
     */
    protected activeConnections: Map<string, RemoteConnection>;
    /**
     * Tracks managed servers for cleanup.
     */
    protected managedServers: Map<string, ServerInfo>;
    /**
     * Register an active connection for tracking.
     */
    protected registerConnection(connection: RemoteConnection): void;
    /**
     * Unregister a connection (called on disconnect).
     */
    protected unregisterConnection(connectionId: string): void;
    /**
     * Register a managed server for tracking.
     */
    protected registerServer(serverInfo: ServerInfo): void;
    /**
     * Unregister a server (called on stop).
     */
    protected unregisterServer(serverId: string): void;
    /**
     * Cleanup all active connections and servers.
     * Should be called during adapter shutdown.
     */
    cleanup(): Promise<void>;
    /**
     * Generate a unique connection ID.
     */
    protected generateConnectionId(): string;
    /**
     * Generate a unique server ID.
     */
    protected generateServerId(): string;
    /**
     * Find an available port for server startup.
     */
    protected findAvailablePort(startPort?: number): Promise<number>;
}