export declare const MCP_ANALYTICS_EVENTS: {
    readonly initialize: "$mcp_initialize";
    readonly toolsList: "$mcp_tools_list";
    readonly toolCall: "$mcp_tool_call";
    readonly resourcesList: "$mcp_resources_list";
    readonly resourceRead: "$mcp_resource_read";
    readonly oauthAuthorizeOpened: "$mcp_oauth_authorize_opened";
    readonly oauthLoginWallShown: "$mcp_oauth_login_wall_shown";
};
export interface McpAnalyticsContext {
    source: "http" | "stdio";
    serverName: string;
    serverVersion?: string;
    appId?: string;
    clientName?: string;
    clientVersion?: string;
    clientUserAgent?: string;
    clientKey?: string;
    redirectHost?: string;
    protocolVersion?: string;
    userId?: string;
    anonymousId?: string;
    sessionId?: string;
}
interface McpRequestLike {
    params?: {
        _meta?: Record<string, unknown>;
    } | undefined;
    _meta?: Record<string, unknown> | undefined;
}
export declare function detectVendorClient(...candidates: Array<string | undefined>): string | undefined;
export declare function vendorForRedirectHost(host: string | undefined): string | undefined;
export declare function readClientInfoFromRequest(request: McpRequestLike | undefined): {
    clientName?: string;
    clientVersion?: string;
    protocolVersion?: string;
};
export declare function mcpVendorForContext(ctx: Pick<McpAnalyticsContext, "clientName" | "clientUserAgent" | "redirectHost">): string | undefined;
export declare function trackMcpInitialize(ctx: McpAnalyticsContext): void;
export declare function trackMcpToolsList(ctx: McpAnalyticsContext, args: {
    toolNames: string[];
    durationMs: number;
}): void;
export declare function trackMcpToolCall(ctx: McpAnalyticsContext, args: {
    toolName: string;
    toolDescription?: string;
    toolCategory?: string;
    parameters?: Record<string, unknown>;
    durationMs: number;
    isError: boolean;
    errorType?: string;
    errorMessage?: string;
}): void;
export declare function trackMcpResourcesList(ctx: McpAnalyticsContext, args: {
    resourceCount: number;
    durationMs: number;
}): void;
export declare function trackMcpResourceRead(ctx: McpAnalyticsContext, args: {
    resourceName?: string;
    resourceUri?: string;
    durationMs: number;
    isError: boolean;
    errorType?: string;
    errorMessage?: string;
}): void;
export type McpOAuthRoute = "directory" | "mcp";
export declare function trackMcpOAuthAuthorizeOpened(ctx: McpAnalyticsContext, args: {
    route: McpOAuthRoute;
    signedIn: boolean;
}): void;
export declare function trackMcpOAuthLoginWallShown(ctx: McpAnalyticsContext, args: {
    route: McpOAuthRoute;
}): void;
export declare function describeMcpError(err: unknown): {
    errorType: string;
    errorMessage: string;
};
export {};