network-intelligence-tools.d.ts•5.72 kB
/**
* Network Intelligence Tools for WebSee MCP Server
*
* Provides detailed network request analysis, timing, headers, and source tracing
* for debugging and performance optimization.
*
* @module network-intelligence-tools
*/
import { z } from 'zod';
import { Page } from 'playwright';
export declare const NetworkGetRequestsSchema: z.ZodObject<{
url: z.ZodString;
waitTime: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
}, "strip", z.ZodTypeAny, {
url?: string;
waitTime?: number;
}, {
url?: string;
waitTime?: number;
}>;
export declare const NetworkGetByUrlSchema: z.ZodObject<{
url: z.ZodString;
pattern: z.ZodString;
}, "strip", z.ZodTypeAny, {
pattern?: string;
url?: string;
}, {
pattern?: string;
url?: string;
}>;
export declare const NetworkGetTimingSchema: z.ZodObject<{
url: z.ZodString;
requestUrl: z.ZodString;
}, "strip", z.ZodTypeAny, {
url?: string;
requestUrl?: string;
}, {
url?: string;
requestUrl?: string;
}>;
export declare const NetworkTraceInitiatorSchema: z.ZodObject<{
url: z.ZodString;
requestUrl: z.ZodString;
}, "strip", z.ZodTypeAny, {
url?: string;
requestUrl?: string;
}, {
url?: string;
requestUrl?: string;
}>;
export declare const NetworkGetHeadersSchema: z.ZodObject<{
url: z.ZodString;
requestUrl: z.ZodString;
}, "strip", z.ZodTypeAny, {
url?: string;
requestUrl?: string;
}, {
url?: string;
requestUrl?: string;
}>;
export declare const NetworkGetBodySchema: z.ZodObject<{
url: z.ZodString;
requestUrl: z.ZodString;
}, "strip", z.ZodTypeAny, {
url?: string;
requestUrl?: string;
}, {
url?: string;
requestUrl?: string;
}>;
export interface NetworkRequest {
url: string;
method: string;
status?: number;
duration?: number;
size?: number;
timestamp: number;
initiator?: {
type: 'fetch' | 'xhr' | 'script' | 'parser' | 'other';
lineNumber?: number;
columnNumber?: number;
url?: string;
};
stackTrace?: string[];
requestHeaders?: Record<string, string>;
responseHeaders?: Record<string, string>;
}
export interface NetworkTiming {
dns: number;
connect: number;
ssl: number;
ttfb: number;
download: number;
total: number;
}
export interface InitiatorTrace {
file: string;
line: number;
column: number;
function?: string;
stackTrace: Array<{
file: string;
line: number;
column: number;
function?: string;
}>;
}
export interface NetworkHeaders {
requestHeaders: Record<string, string>;
responseHeaders: Record<string, string>;
}
export interface NetworkBody {
requestBody: string | null;
responseBody: string | null;
contentType: string;
}
/**
* Get all network requests for a page
*/
export declare function networkGetRequests(page: Page, params: z.infer<typeof NetworkGetRequestsSchema>): Promise<{
requests: NetworkRequest[];
}>;
/**
* Filter network requests by URL pattern
*/
export declare function networkGetByUrl(page: Page, params: z.infer<typeof NetworkGetByUrlSchema>): Promise<{
requests: NetworkRequest[];
}>;
/**
* Get detailed timing information for a specific request
*/
export declare function networkGetTiming(page: Page, params: z.infer<typeof NetworkGetTimingSchema>): Promise<NetworkTiming | {
error: string;
}>;
/**
* Trace network request to its source code origin
*/
export declare function networkTraceInitiator(page: Page, params: z.infer<typeof NetworkTraceInitiatorSchema>): Promise<InitiatorTrace | {
error: string;
}>;
/**
* Get request and response headers for a specific request
*/
export declare function networkGetHeaders(page: Page, params: z.infer<typeof NetworkGetHeadersSchema>): Promise<NetworkHeaders | {
error: string;
}>;
/**
* Get request and response body for a specific request
*/
export declare function networkGetBody(page: Page, params: z.infer<typeof NetworkGetBodySchema>): Promise<NetworkBody | {
error: string;
}>;
/**
* Tool definitions compatible with MCP server
*/
export declare const networkIntelligenceTools: ({
name: string;
description: string;
inputSchema: {
type: string;
properties: {
url: {
type: string;
description: string;
};
waitTime: {
type: string;
description: string;
default: number;
};
pattern?: undefined;
requestUrl?: undefined;
};
required: string[];
};
} | {
name: string;
description: string;
inputSchema: {
type: string;
properties: {
url: {
type: string;
description: string;
};
pattern: {
type: string;
description: string;
};
waitTime?: undefined;
requestUrl?: undefined;
};
required: string[];
};
} | {
name: string;
description: string;
inputSchema: {
type: string;
properties: {
url: {
type: string;
description: string;
};
requestUrl: {
type: string;
description: string;
};
waitTime?: undefined;
pattern?: undefined;
};
required: string[];
};
})[];
/**
* Create a tool handler for the MCP server
*/
export declare function createNetworkToolHandler(page: Page): (toolName: string, args: any) => Promise<any>;
//# sourceMappingURL=network-intelligence-tools.d.ts.map