import type { Artifact, Connector, ExportResult, TabScopedResult, TabView } from "../connector/connector.js";
import type { ConsoleEntry, ConsoleQuery, NetworkEntry, NetworkQuery, TabId } from "../connector/store.js";
import type { AuditCategory, AuditReport } from "../lighthouse/types.js";
export interface PageInfo {
    url: string;
    tabId: number | string | null;
    extensionConnected: boolean;
    connectedTabs: number;
}
export interface TabListing {
    tabs: TabView[];
    currentTabId: TabId | null;
    connectedTabs: number;
}
export type ScopedConsoleQuery = ConsoleQuery & {
    allTabs?: boolean;
};
export type ScopedNetworkQuery = NetworkQuery & {
    allTabs?: boolean;
};
export interface ConnectorStatus {
    version: string;
    extensionConnected: boolean;
    connections: number;
    tabs: number;
    currentTabId: TabId | null;
    screenshotDir: string;
    counts: {
        console: number;
        network: number;
    };
}
export interface ScreenshotResult {
    path: string;
    tabId?: TabId | null;
    url?: string;
    /** Data URL, carrying whichever format the browser settled on. */
    data: string;
    name: string;
    mimeType: string;
    bytes: number;
    /** False when the image is too large to hand to the model. */
    withinBudget: boolean;
}
/**
 * The operations the MCP tools need. Implemented both in-process (the normal
 * single-process setup) and over HTTP (when attaching to a connector that is
 * already running for another client).
 */
export interface ConnectorClient {
    console(query: ScopedConsoleQuery): Promise<TabScopedResult<ConsoleEntry>>;
    network(query: ScopedNetworkQuery): Promise<TabScopedResult<NetworkEntry>>;
    selectedElement(options?: {
        tabId?: TabId;
    }): Promise<unknown>;
    page(): Promise<PageInfo>;
    status(): Promise<ConnectorStatus>;
    tabs(): Promise<TabListing>;
    wipe(options?: {
        tabId?: TabId;
    }): Promise<void>;
    screenshot(options: {
        name?: string;
        tabId?: TabId;
    }): Promise<ScreenshotResult>;
    refresh(options?: {
        tabId?: TabId;
    }): Promise<void>;
    storage(kinds: string[], options?: {
        tabId?: TabId;
    }): Promise<Record<string, unknown>>;
    audit(category: AuditCategory, options?: {
        url?: string;
        tabId?: TabId;
    }): Promise<AuditReport>;
    exportConsole(options?: {
        tabId?: TabId;
        allTabs?: boolean;
    }): Promise<ExportResult<ConsoleEntry>>;
    exportNetwork(options?: {
        tabId?: TabId;
        allTabs?: boolean;
    }): Promise<ExportResult<NetworkEntry>>;
    readArtifact(kind: "screenshot" | "audit", name: string): Promise<Artifact>;
}
/** Talks straight to an embedded connector — no network hop, no discovery. */
export declare class InProcessConnectorClient implements ConnectorClient {
    #private;
    constructor(connector: Connector);
    console(query: ScopedConsoleQuery): Promise<TabScopedResult<ConsoleEntry>>;
    network(query: ScopedNetworkQuery): Promise<TabScopedResult<NetworkEntry>>;
    selectedElement(options?: {
        tabId?: TabId;
    }): Promise<unknown>;
    page(): Promise<PageInfo>;
    status(): Promise<ConnectorStatus>;
    tabs(): Promise<TabListing>;
    wipe(options?: {
        tabId?: TabId;
    }): Promise<void>;
    screenshot(options: {
        name?: string;
        tabId?: TabId;
    }): Promise<ScreenshotResult>;
    refresh(options?: {
        tabId?: TabId;
    }): Promise<void>;
    storage(kinds: string[], options?: {
        tabId?: TabId;
    }): Promise<Record<string, unknown>>;
    audit(category: AuditCategory, options?: {
        url?: string;
        tabId?: TabId;
    }): Promise<AuditReport>;
    exportConsole(options?: {
        tabId?: TabId;
        allTabs?: boolean;
    }): Promise<ExportResult<ConsoleEntry>>;
    exportNetwork(options?: {
        tabId?: TabId;
        allTabs?: boolean;
    }): Promise<ExportResult<NetworkEntry>>;
    readArtifact(kind: "screenshot" | "audit", name: string): Promise<Artifact>;
}
export interface HttpConnectorClientOptions {
    baseUrl: string;
    token: string;
    fetchImpl?: typeof fetch;
}
/** Talks to a connector running in another process. */
export declare class HttpConnectorClient implements ConnectorClient {
    #private;
    constructor(options: HttpConnectorClientOptions);
    console(query: ScopedConsoleQuery): Promise<TabScopedResult<ConsoleEntry>>;
    network(query: ScopedNetworkQuery): Promise<TabScopedResult<NetworkEntry>>;
    selectedElement(options?: {
        tabId?: TabId;
    }): Promise<unknown>;
    tabs(): Promise<TabListing>;
    page(): Promise<PageInfo>;
    status(): Promise<ConnectorStatus>;
    wipe(options?: {
        tabId?: TabId;
    }): Promise<void>;
    screenshot(options: {
        name?: string;
        tabId?: TabId;
    }): Promise<ScreenshotResult>;
    refresh(options?: {
        tabId?: TabId;
    }): Promise<void>;
    storage(kinds: string[], options?: {
        tabId?: TabId;
    }): Promise<Record<string, unknown>>;
    audit(category: AuditCategory, options?: {
        url?: string;
        tabId?: TabId;
    }): Promise<AuditReport>;
    exportConsole(options?: {
        tabId?: TabId;
        allTabs?: boolean;
    }): Promise<ExportResult<ConsoleEntry>>;
    exportNetwork(options?: {
        tabId?: TabId;
        allTabs?: boolean;
    }): Promise<ExportResult<NetworkEntry>>;
    readArtifact(kind: "screenshot" | "audit", name: string): Promise<Artifact>;
}