mcp

package
v0.5.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 23, 2026 License: MIT Imports: 12 Imported by: 0

Documentation

Overview

Package mcp provides an MCP (Model Context Protocol) server for browser automation.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type AccessibilitySnapshotInput 

type AccessibilitySnapshotInput struct {
	InterestingOnly *bool  `json:"interesting_only,omitempty" jsonschema:"Only include interesting nodes with semantic meaning (default true)"`
	Root            string `json:"root,omitempty" jsonschema:"CSS selector for root element to snapshot"`
}

type AccessibilitySnapshotOutput 

type AccessibilitySnapshotOutput struct {
	Snapshot interface{} `json:"snapshot"`
}

type AddInitScriptInput 

type AddInitScriptInput struct {
	Script string `json:"script" jsonschema:"JavaScript code to inject before page scripts,required"`
}

type AddInitScriptOutput 

type AddInitScriptOutput struct {
	Message string `json:"message"`
}

type AddScriptInput 

type AddScriptInput struct {
	Source string `json:"source" jsonschema:"JavaScript source to inject,required"`
}

type AddScriptOutput 

type AddScriptOutput struct {
	Message string `json:"message"`
}

type AddStyleInput 

type AddStyleInput struct {
	Source string `json:"source" jsonschema:"CSS source to inject,required"`
}

type AddStyleOutput 

type AddStyleOutput struct {
	Message string `json:"message"`
}

type AssertElementInput 

type AssertElementInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type AssertElementOutput 

type AssertElementOutput struct {
	Found   bool   `json:"found"`
	Message string `json:"message"`
}

type AssertTextInput 

type AssertTextInput struct {
	Text     string `json:"text" jsonschema:"Text to search for,required"`
	Selector string `json:"selector" jsonschema:"Optional: limit search to element matching selector"`
}

type AssertTextOutput 

type AssertTextOutput struct {
	Found   bool   `json:"found"`
	Message string `json:"message"`
}

type BackInput 

type BackInput struct{}

type BackOutput 

type BackOutput struct {
	Message string `json:"message"`
}

type BringToFrontInput 

type BringToFrontInput struct{}

type BringToFrontOutput 

type BringToFrontOutput struct {
	Message string `json:"message"`
}

type BrowserLaunchInput 

type BrowserLaunchInput struct {
	Headless bool `json:"headless" jsonschema:"Run browser without GUI (default: true)"`
}

type BrowserLaunchOutput 

type BrowserLaunchOutput struct {
	Message string `json:"message"`
}

type BrowserQuitInput 

type BrowserQuitInput struct{}

type BrowserQuitOutput 

type BrowserQuitOutput struct {
	Message string `json:"message"`
}

type CheckInput 

type CheckInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the checkbox,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type CheckOutput 

type CheckOutput struct {
	Message string `json:"message"`
}

type ClearConsoleMessagesInput 

type ClearConsoleMessagesInput struct{}

ClearConsoleMessagesInput for clearing console messages.

type ClearConsoleMessagesOutput 

type ClearConsoleMessagesOutput struct {
	Message string `json:"message"`
}

ClearConsoleMessagesOutput confirms the clear operation.

type ClearCookiesInput 

type ClearCookiesInput struct{}

type ClearCookiesOutput 

type ClearCookiesOutput struct {
	Message string `json:"message"`
}

type ClearInput 

type ClearInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the input element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type ClearNetworkRequestsInput 

type ClearNetworkRequestsInput struct{}

ClearNetworkRequestsInput for clearing network requests.

type ClearNetworkRequestsOutput 

type ClearNetworkRequestsOutput struct {
	Message string `json:"message"`
}

ClearNetworkRequestsOutput confirms the clear operation.

type ClearOutput 

type ClearOutput struct {
	Message string `json:"message"`
}

type ClearRecordingInput 

type ClearRecordingInput struct{}

type ClearRecordingOutput 

type ClearRecordingOutput struct {
	Message string `json:"message"`
}

type ClearStorageInput 

type ClearStorageInput struct{}

type ClearStorageOutput 

type ClearStorageOutput struct {
	Message string `json:"message"`
}

type ClickInput 

type ClickInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element to click (can be empty if using semantic selectors)"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
	SemanticSelector
}

type ClickOutput 

type ClickOutput struct {
	Message string `json:"message"`
}

type ClosePageInput 

type ClosePageInput struct{}

type ClosePageOutput 

type ClosePageOutput struct {
	Message string `json:"message"`
}

type CloseTabInput 

type CloseTabInput struct {
	Index *int   `json:"index,omitempty" jsonschema:"Tab index to close (0-based). Defaults to current tab."`
	ID    string `json:"id,omitempty" jsonschema:"Tab ID to close (from list_tabs)"`
}

CloseTabInput for closing a specific tab.

type CloseTabOutput 

type CloseTabOutput struct {
	Message string `json:"message"`
}

CloseTabOutput confirms the tab closure.

type Config 

type Config struct {
	// Headless runs the browser without a GUI.
	Headless bool

	// Project is the project name for reports.
	Project string

	// DefaultTimeout is the default timeout for browser operations.
	DefaultTimeout time.Duration

	// InitScripts are JavaScript files to inject before any page scripts.
	// Each string is the content of a script (not a file path).
	InitScripts []string
}

Config holds server configuration.

func DefaultConfig 

func DefaultConfig() Config

DefaultConfig returns a Config with sensible defaults.

type ConsoleMessageInfo 

type ConsoleMessageInfo struct {
	Type string   `json:"type"`
	Text string   `json:"text"`
	Args []string `json:"args,omitempty"`
	URL  string   `json:"url,omitempty"`
	Line int      `json:"line,omitempty"`
}

ConsoleMessageInfo represents a console message.

type CookieOutput 

type CookieOutput struct {
	Name     string  `json:"name"`
	Value    string  `json:"value"`
	Domain   string  `json:"domain"`
	Path     string  `json:"path"`
	Expires  float64 `json:"expires"`
	HTTPOnly bool    `json:"httpOnly"`
	Secure   bool    `json:"secure"`
	SameSite string  `json:"sameSite"`
}

type DblClickInput 

type DblClickInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type DblClickOutput 

type DblClickOutput struct {
	Message string `json:"message"`
}

type DeleteCookieInput 

type DeleteCookieInput struct {
	Name   string `json:"name" jsonschema:"Cookie name to delete,required"`
	Domain string `json:"domain,omitempty" jsonschema:"Cookie domain (optional filter)"`
	Path   string `json:"path,omitempty" jsonschema:"Cookie path (optional filter)"`
}

type DeleteCookieOutput 

type DeleteCookieOutput struct {
	Message string `json:"message"`
}

type DispatchEventInput 

type DispatchEventInput struct {
	Selector  string         `json:"selector" jsonschema:"CSS selector for the element,required"`
	EventType string         `json:"event_type" jsonschema:"Event type (e.g. click focus blur),required"`
	EventInit map[string]any `json:"event_init" jsonschema:"Event initialization options"`
	TimeoutMS int            `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type DispatchEventOutput 

type DispatchEventOutput struct {
	Message string `json:"message"`
}

type DragToInput 

type DragToInput struct {
	SourceSelector string `json:"source_selector" jsonschema:"CSS selector for the element to drag,required"`
	TargetSelector string `json:"target_selector" jsonschema:"CSS selector for the drop target,required"`
	TimeoutMS      int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type DragToOutput 

type DragToOutput struct {
	Message string `json:"message"`
}

type ElementEvalInput 

type ElementEvalInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	Function  string `json:"function" jsonschema:"JavaScript function (receives element as first arg),required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type ElementEvalOutput 

type ElementEvalOutput struct {
	Result any `json:"result"`
}

type ElementScreenshotInput 

type ElementScreenshotInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type ElementScreenshotOutput 

type ElementScreenshotOutput struct {
	Data string `json:"data"`
}

type EmulateMediaInput 

type EmulateMediaInput struct {
	Media         string `json:"media,omitempty" jsonschema:"Media type: screen or print. Empty to reset."`
	ColorScheme   string `` /* 167-byte string literal not displayed */
	ReducedMotion string `` /* 164-byte string literal not displayed */
	ForcedColors  string `` /* 141-byte string literal not displayed */
	Contrast      string `` /* 164-byte string literal not displayed */
}

type EmulateMediaOutput 

type EmulateMediaOutput struct {
	Message  string   `json:"message"`
	Settings []string `json:"settings"`
}

type EvaluateInput 

type EvaluateInput struct {
	Script string `json:"script" jsonschema:"JavaScript to execute,required"`
}

type EvaluateOutput 

type EvaluateOutput struct {
	Result any `json:"result"`
}

type ExportScriptInput 

type ExportScriptInput struct {
	Format string `json:"format,omitempty" jsonschema:"Output format: json or yaml (default: json),enum=json,enum=yaml"`
}

type ExportScriptOutput 

type ExportScriptOutput struct {
	Script    string `json:"script"`
	StepCount int    `json:"stepCount"`
	Format    string `json:"format"`
}

type FillFormInput 

type FillFormInput struct {
	Fields    []FormField `json:"fields" jsonschema:"Array of fields to fill (each with selector and value),required"`
	TimeoutMS int         `json:"timeout_ms" jsonschema:"Timeout in milliseconds per field (default: 5000)"`
}

type FillFormOutput 

type FillFormOutput struct {
	Message string   `json:"message"`
	Filled  int      `json:"filled"`
	Errors  []string `json:"errors,omitempty"`
}

type FillInput 

type FillInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the input element (can be empty if using semantic selectors)"`
	Value     string `json:"value" jsonschema:"Value to fill,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
	SemanticSelector
}

type FillOutput 

type FillOutput struct {
	Message string `json:"message"`
}

type FocusInput 

type FocusInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type FocusOutput 

type FocusOutput struct {
	Message string `json:"message"`
}

type FormField 

type FormField struct {
	Selector string `json:"selector" jsonschema:"CSS selector for the input element,required"`
	Value    string `json:"value" jsonschema:"Value to fill,required"`
}

FormField represents a single field to fill.

type ForwardInput 

type ForwardInput struct{}

type ForwardOutput 

type ForwardOutput struct {
	Message string `json:"message"`
}

type FrameInfoOutput 

type FrameInfoOutput struct {
	URL  string `json:"url"`
	Name string `json:"name"`
}

type GenerateLocatorInput 

type GenerateLocatorInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	Strategy  string `` /* 140-byte string literal not displayed */
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type GenerateLocatorOutput 

type GenerateLocatorOutput struct {
	Locator  string            `json:"locator"`
	Strategy string            `json:"strategy"`
	Metadata map[string]string `json:"metadata"`
}

type GetAttributeInput 

type GetAttributeInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	Name      string `json:"name" jsonschema:"Attribute name,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type GetAttributeOutput 

type GetAttributeOutput struct {
	Value string `json:"value"`
}

type GetBoundingBoxInput 

type GetBoundingBoxInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type GetBoundingBoxOutput 

type GetBoundingBoxOutput struct {
	X      float64 `json:"x"`
	Y      float64 `json:"y"`
	Width  float64 `json:"width"`
	Height float64 `json:"height"`
}

type GetConfigInput 

type GetConfigInput struct{}

type GetConfigOutput 

type GetConfigOutput struct {
	Headless         bool   `json:"headless"`
	Project          string `json:"project"`
	DefaultTimeoutMS int64  `json:"default_timeout_ms"`
	BrowserLaunched  bool   `json:"browser_launched"`
}

type GetConsoleMessagesInput 

type GetConsoleMessagesInput struct {
	Level string `` /* 161-byte string literal not displayed */
	Clear bool   `json:"clear,omitempty" jsonschema:"Clear messages after retrieving them"`
}

GetConsoleMessagesInput for retrieving console messages.

type GetConsoleMessagesOutput 

type GetConsoleMessagesOutput struct {
	Messages []ConsoleMessageInfo `json:"messages"`
	Count    int                  `json:"count"`
}

GetConsoleMessagesOutput contains console messages.

type GetContentInput 

type GetContentInput struct{}

type GetContentOutput 

type GetContentOutput struct {
	Content string `json:"content"`
}

type GetCookiesInput 

type GetCookiesInput struct {
	URLs []string `json:"urls" jsonschema:"URLs to get cookies for (optional)"`
}

type GetCookiesOutput 

type GetCookiesOutput struct {
	Cookies []CookieOutput `json:"cookies"`
}

type GetDialogInput 

type GetDialogInput struct{}

GetDialogInput for getting the current dialog state.

type GetDialogOutput 

type GetDialogOutput struct {
	HasDialog    bool   `json:"has_dialog"`
	DialogType   string `json:"dialog_type,omitempty"`
	Message      string `json:"message,omitempty"`
	DefaultValue string `json:"default_value,omitempty"`
}

GetDialogOutput contains dialog information.

type GetFramesInput 

type GetFramesInput struct{}

type GetFramesOutput 

type GetFramesOutput struct {
	Frames []FrameInfoOutput `json:"frames"`
}

type GetInnerHTMLInput 

type GetInnerHTMLInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type GetInnerHTMLOutput 

type GetInnerHTMLOutput struct {
	HTML string `json:"html"`
}

type GetInnerTextInput 

type GetInnerTextInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type GetInnerTextOutput 

type GetInnerTextOutput struct {
	Text string `json:"text"`
}

type GetLabelInput 

type GetLabelInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type GetLabelOutput 

type GetLabelOutput struct {
	Label string `json:"label"`
}

type GetNetworkRequestsInput 

type GetNetworkRequestsInput struct {
	URLPattern   string `json:"url_pattern,omitempty" jsonschema:"Filter by URL pattern (glob or regex)"`
	Method       string `json:"method,omitempty" jsonschema:"Filter by HTTP method (GET/POST/PUT/DELETE/etc)"`
	ResourceType string `json:"resource_type,omitempty" jsonschema:"Filter by resource type (document/script/xhr/fetch/stylesheet/image/font/other)"`
	Clear        bool   `json:"clear,omitempty" jsonschema:"Clear requests after retrieving them"`
}

GetNetworkRequestsInput for retrieving network requests.

type GetNetworkRequestsOutput 

type GetNetworkRequestsOutput struct {
	Requests []NetworkRequestInfo `json:"requests"`
	Count    int                  `json:"count"`
}

GetNetworkRequestsOutput contains network requests.

type GetOuterHTMLInput 

type GetOuterHTMLInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type GetOuterHTMLOutput 

type GetOuterHTMLOutput struct {
	HTML string `json:"html"`
}

type GetPagesInput 

type GetPagesInput struct{}

type GetPagesOutput 

type GetPagesOutput struct {
	Count int `json:"count"`
}

type GetRoleInput 

type GetRoleInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type GetRoleOutput 

type GetRoleOutput struct {
	Role string `json:"role"`
}

type GetStorageStateInput 

type GetStorageStateInput struct{}

type GetStorageStateOutput 

type GetStorageStateOutput struct {
	State string `json:"state"`
}

type GetTestReportInput 

type GetTestReportInput struct {
	Format string `` /* 144-byte string literal not displayed */
}

type GetTestReportOutput 

type GetTestReportOutput struct {
	Report string `json:"report"`
}

type GetTextInput 

type GetTextInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type GetTextOutput 

type GetTextOutput struct {
	Text string `json:"text"`
}

type GetTitleInput 

type GetTitleInput struct{}

type GetTitleOutput 

type GetTitleOutput struct {
	Title string `json:"title"`
}

type GetURLInput 

type GetURLInput struct{}

type GetURLOutput 

type GetURLOutput struct {
	URL string `json:"url"`
}

type GetValueInput 

type GetValueInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the input element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type GetValueOutput 

type GetValueOutput struct {
	Value string `json:"value"`
}

type GetViewportInput 

type GetViewportInput struct{}

type GetViewportOutput 

type GetViewportOutput struct {
	Width  int `json:"width"`
	Height int `json:"height"`
}

type HandleDialogInput 

type HandleDialogInput struct {
	Action     string `json:"action" jsonschema:"Action to take: accept or dismiss,enum=accept,enum=dismiss,required"`
	PromptText string `json:"prompt_text,omitempty" jsonschema:"Text to enter for prompt dialogs (only used with accept action)"`
}

HandleDialogInput for handling browser dialogs.

type HandleDialogOutput 

type HandleDialogOutput struct {
	Message string `json:"message"`
	Action  string `json:"action"`
}

HandleDialogOutput confirms the dialog action.

type HoverInput 

type HoverInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type HoverOutput 

type HoverOutput struct {
	Message string `json:"message"`
}

type IsCheckedInput 

type IsCheckedInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the checkbox/radio,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type IsCheckedOutput 

type IsCheckedOutput struct {
	Checked bool `json:"checked"`
}

type IsEditableInput 

type IsEditableInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type IsEditableOutput 

type IsEditableOutput struct {
	Editable bool `json:"editable"`
}

type IsEnabledInput 

type IsEnabledInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type IsEnabledOutput 

type IsEnabledOutput struct {
	Enabled bool `json:"enabled"`
}

type IsHiddenInput 

type IsHiddenInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type IsHiddenOutput 

type IsHiddenOutput struct {
	Hidden bool `json:"hidden"`
}

type IsVisibleInput 

type IsVisibleInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type IsVisibleOutput 

type IsVisibleOutput struct {
	Visible bool `json:"visible"`
}

type KeyboardDownInput 

type KeyboardDownInput struct {
	Key string `json:"key" jsonschema:"Key to hold down,required"`
}

type KeyboardDownOutput 

type KeyboardDownOutput struct {
	Message string `json:"message"`
}

type KeyboardPressInput 

type KeyboardPressInput struct {
	Key string `json:"key" jsonschema:"Key to press (e.g. Enter Tab ArrowDown),required"`
}

type KeyboardPressOutput 

type KeyboardPressOutput struct {
	Message string `json:"message"`
}

type KeyboardTypeInput 

type KeyboardTypeInput struct {
	Text string `json:"text" jsonschema:"Text to type,required"`
}

type KeyboardTypeOutput 

type KeyboardTypeOutput struct {
	Message string `json:"message"`
}

type KeyboardUpInput 

type KeyboardUpInput struct {
	Key string `json:"key" jsonschema:"Key to release,required"`
}

type KeyboardUpOutput 

type KeyboardUpOutput struct {
	Message string `json:"message"`
}

type ListTabsInput 

type ListTabsInput struct{}

ListTabsInput for listing all open tabs.

type ListTabsOutput 

type ListTabsOutput struct {
	Tabs       []TabInfo `json:"tabs"`
	Count      int       `json:"count"`
	CurrentTab int       `json:"current_tab"`
}

ListTabsOutput contains all open tabs.

type LocalStorageClearInput 

type LocalStorageClearInput struct{}

LocalStorageClearInput for clearing all localStorage.

type LocalStorageClearOutput 

type LocalStorageClearOutput struct {
	Message string `json:"message"`
}

LocalStorageClearOutput confirms the operation.

type LocalStorageDeleteInput 

type LocalStorageDeleteInput struct {
	Key string `json:"key" jsonschema:"The key to remove from localStorage,required"`
}

LocalStorageDeleteInput for removing a localStorage item.

type LocalStorageDeleteOutput 

type LocalStorageDeleteOutput struct {
	Message string `json:"message"`
}

LocalStorageDeleteOutput confirms the operation.

type LocalStorageGetInput 

type LocalStorageGetInput struct {
	Key string `json:"key" jsonschema:"The key to get from localStorage,required"`
}

LocalStorageGetInput for getting a localStorage item.

type LocalStorageGetOutput 

type LocalStorageGetOutput struct {
	Key   string  `json:"key"`
	Value *string `json:"value"` // null if key doesn't exist
}

LocalStorageGetOutput contains the retrieved value.

type LocalStorageListInput 

type LocalStorageListInput struct{}

LocalStorageListInput for listing all localStorage items.

type LocalStorageListOutput 

type LocalStorageListOutput struct {
	Items map[string]string `json:"items"`
	Count int               `json:"count"`
}

LocalStorageListOutput contains all localStorage items.

type LocalStorageSetInput 

type LocalStorageSetInput struct {
	Key   string `json:"key" jsonschema:"The key to set in localStorage,required"`
	Value string `json:"value" jsonschema:"The value to store,required"`
}

LocalStorageSetInput for setting a localStorage item.

type LocalStorageSetOutput 

type LocalStorageSetOutput struct {
	Message string `json:"message"`
}

LocalStorageSetOutput confirms the operation.

type MouseClickInput 

type MouseClickInput struct {
	X          float64 `json:"x" jsonschema:"X coordinate,required"`
	Y          float64 `json:"y" jsonschema:"Y coordinate,required"`
	Button     string  `json:"button" jsonschema:"Mouse button: left right middle"`
	ClickCount int     `json:"click_count" jsonschema:"Number of clicks (default: 1)"`
}

type MouseClickOutput 

type MouseClickOutput struct {
	Message string `json:"message"`
}

type MouseDownInput 

type MouseDownInput struct {
	Button string `json:"button" jsonschema:"Mouse button: left right middle"`
}

type MouseDownOutput 

type MouseDownOutput struct {
	Message string `json:"message"`
}

type MouseDragInput 

type MouseDragInput struct {
	StartX float64 `json:"start_x" jsonschema:"Starting X coordinate,required"`
	StartY float64 `json:"start_y" jsonschema:"Starting Y coordinate,required"`
	EndX   float64 `json:"end_x" jsonschema:"Ending X coordinate,required"`
	EndY   float64 `json:"end_y" jsonschema:"Ending Y coordinate,required"`
	Steps  int     `json:"steps,omitempty" jsonschema:"Number of intermediate steps (default: 10)"`
}

type MouseDragOutput 

type MouseDragOutput struct {
	Message string `json:"message"`
}

type MouseMoveInput 

type MouseMoveInput struct {
	X float64 `json:"x" jsonschema:"X coordinate,required"`
	Y float64 `json:"y" jsonschema:"Y coordinate,required"`
}

type MouseMoveOutput 

type MouseMoveOutput struct {
	Message string `json:"message"`
}

type MouseUpInput 

type MouseUpInput struct {
	Button string `json:"button" jsonschema:"Mouse button: left right middle"`
}

type MouseUpOutput 

type MouseUpOutput struct {
	Message string `json:"message"`
}

type MouseWheelInput 

type MouseWheelInput struct {
	DeltaX float64 `json:"delta_x" jsonschema:"Horizontal scroll amount"`
	DeltaY float64 `json:"delta_y" jsonschema:"Vertical scroll amount"`
}

type MouseWheelOutput 

type MouseWheelOutput struct {
	Message string `json:"message"`
}
type NavigateInput struct {
	URL string `json:"url" jsonschema:"The URL to navigate to,required"`
}
type NavigateOutput struct {
	URL   string `json:"url"`
	Title string `json:"title"`
}

type NetworkRequestInfo 

type NetworkRequestInfo struct {
	URL          string `json:"url"`
	Method       string `json:"method"`
	ResourceType string `json:"resource_type"`
	Status       int    `json:"status,omitempty"`
	StatusText   string `json:"status_text,omitempty"`
	ResponseSize int64  `json:"response_size,omitempty"`
}

NetworkRequestInfo represents a network request.

type NetworkStateSetInput 

type NetworkStateSetInput struct {
	Offline bool `json:"offline" jsonschema:"Set to true to enable offline mode,required"`
}

type NetworkStateSetOutput 

type NetworkStateSetOutput struct {
	Message string `json:"message"`
	Offline bool   `json:"offline"`
}

type NewPageInput 

type NewPageInput struct{}

type NewPageOutput 

type NewPageOutput struct {
	Message string `json:"message"`
}

type PDFInput 

type PDFInput struct {
	Scale           float64 `json:"scale" jsonschema:"Scale of the PDF (default: 1)"`
	PrintBackground bool    `json:"print_background" jsonschema:"Print background graphics"`
	Landscape       bool    `json:"landscape" jsonschema:"Landscape orientation"`
	Format          string  `json:"format" jsonschema:"Paper format (Letter Legal A4 etc)"`
}

type PDFOutput 

type PDFOutput struct {
	Data string `json:"data"`
}

type PauseForHumanInput 

type PauseForHumanInput struct {
	Message   string `json:"message" jsonschema:"Message to display to the human (e.g. 'Please complete the login')"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Maximum time to wait in milliseconds (default: 300000 = 5 minutes)"`
}

type PauseForHumanOutput 

type PauseForHumanOutput struct {
	Message string `json:"message"`
}

type PressInput 

type PressInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element (can be empty if using semantic selectors)"`
	Key       string `json:"key" jsonschema:"Key to press (e.g. Enter Tab ArrowDown),required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
	SemanticSelector
}

type PressOutput 

type PressOutput struct {
	Message string `json:"message"`
}

type Recorder 

type Recorder struct {
	// contains filtered or unexported fields
}

Recorder captures MCP tool calls and converts them to a script.

func NewRecorder 

func NewRecorder() *Recorder

NewRecorder creates a new Recorder.

func (*Recorder) AddStep 

func (r *Recorder) AddStep(step script.Step)

AddStep records a step if recording is active.

func (*Recorder) Clear 

func (r *Recorder) Clear()

Clear removes all recorded steps.

func (*Recorder) Export 

func (r *Recorder) Export() *script.Script

Export returns the recorded session as a Script.

func (*Recorder) ExportJSON 

func (r *Recorder) ExportJSON() ([]byte, error)

ExportJSON returns the recorded session as JSON.

func (*Recorder) IsRecording 

func (r *Recorder) IsRecording() bool

IsRecording returns whether recording is active.

func (*Recorder) RecordAccessibilityCheck 

func (r *Recorder) RecordAccessibilityCheck(standard, failOn string)

RecordAccessibilityCheck records an assertAccessibility action.

func (*Recorder) RecordAssertElement 

func (r *Recorder) RecordAssertElement(selector string)

RecordAssertElement records an assertElement action.

func (*Recorder) RecordAssertText 

func (r *Recorder) RecordAssertText(selector, expected string)

RecordAssertText records an assertText action.

func (*Recorder) RecordAssertTitle 

func (r *Recorder) RecordAssertTitle(expected string)

RecordAssertTitle records an assertTitle action.

func (*Recorder) RecordAssertURL 

func (r *Recorder) RecordAssertURL(expected string)

RecordAssertURL records an assertUrl action.

func (*Recorder) RecordAssertVisible 

func (r *Recorder) RecordAssertVisible(selector string)

RecordAssertVisible records an assertVisible action.

func (*Recorder) RecordBack 

func (r *Recorder) RecordBack()

RecordBack records a back action.

func (*Recorder) RecordCheck 

func (r *Recorder) RecordCheck(selector string)

RecordCheck records a check action.

func (*Recorder) RecordClear 

func (r *Recorder) RecordClear(selector string)

RecordClear records a clear action.

func (*Recorder) RecordClick 

func (r *Recorder) RecordClick(selector string)

RecordClick records a click action.

func (*Recorder) RecordDblClick 

func (r *Recorder) RecordDblClick(selector string)

RecordDblClick records a double-click action.

func (*Recorder) RecordDragTo 

func (r *Recorder) RecordDragTo(selector, target string)

RecordDragTo records a dragTo action.

func (*Recorder) RecordEval 

func (r *Recorder) RecordEval(js string)

RecordEval records an eval action.

func (*Recorder) RecordFill 

func (r *Recorder) RecordFill(selector, value string)

RecordFill records a fill action.

func (*Recorder) RecordFocus 

func (r *Recorder) RecordFocus(selector string)

RecordFocus records a focus action.

func (*Recorder) RecordForward 

func (r *Recorder) RecordForward()

RecordForward records a forward action.

func (*Recorder) RecordHover 

func (r *Recorder) RecordHover(selector string)

RecordHover records a hover action.

func (*Recorder) RecordKeyboardPress 

func (r *Recorder) RecordKeyboardPress(key string)

RecordKeyboardPress records a keyboardPress action.

func (*Recorder) RecordKeyboardType 

func (r *Recorder) RecordKeyboardType(text string)

RecordKeyboardType records a keyboardType action.

func (*Recorder) RecordMouseClick 

func (r *Recorder) RecordMouseClick(x, y float64)

RecordMouseClick records a mouseClick action.

func (*Recorder) RecordMouseMove 

func (r *Recorder) RecordMouseMove(x, y float64)

RecordMouseMove records a mouseMove action.

func (*Recorder) RecordNavigate 

func (r *Recorder) RecordNavigate(url string)

RecordNavigate records a navigation action.

func (*Recorder) RecordPress 

func (r *Recorder) RecordPress(selector, key string)

RecordPress records a press action.

func (*Recorder) RecordReload 

func (r *Recorder) RecordReload()

RecordReload records a reload action.

func (*Recorder) RecordScreenshot 

func (r *Recorder) RecordScreenshot(file string, fullPage bool)

RecordScreenshot records a screenshot action.

func (*Recorder) RecordScrollIntoView 

func (r *Recorder) RecordScrollIntoView(selector string)

RecordScrollIntoView records a scroll action.

func (*Recorder) RecordSelect 

func (r *Recorder) RecordSelect(selector, value string)

RecordSelect records a select action.

func (*Recorder) RecordSetFiles 

func (r *Recorder) RecordSetFiles(selector string, files []string)

RecordSetFiles records a setFiles action.

func (*Recorder) RecordSetViewport 

func (r *Recorder) RecordSetViewport(width, height int)

RecordSetViewport records a setViewport action.

func (*Recorder) RecordTap 

func (r *Recorder) RecordTap(selector string)

RecordTap records a tap action.

func (*Recorder) RecordType 

func (r *Recorder) RecordType(selector, text string)

RecordType records a type action.

func (*Recorder) RecordUncheck 

func (r *Recorder) RecordUncheck(selector string)

RecordUncheck records an uncheck action.

func (*Recorder) RecordWait 

func (r *Recorder) RecordWait(duration string)

RecordWait records a wait action.

func (*Recorder) RecordWaitForLoad 

func (r *Recorder) RecordWaitForLoad(state string)

RecordWaitForLoad records a waitForLoad action.

func (*Recorder) RecordWaitForSelector 

func (r *Recorder) RecordWaitForSelector(selector, state string)

RecordWaitForSelector records a waitForSelector action.

func (*Recorder) RecordWaitForURL 

func (r *Recorder) RecordWaitForURL(pattern string)

RecordWaitForURL records a waitForUrl action.

func (*Recorder) Start 

func (r *Recorder) Start(metadata RecorderMetadata)

Start begins recording actions.

func (*Recorder) StepCount 

func (r *Recorder) StepCount() int

StepCount returns the number of recorded steps.

func (*Recorder) Steps 

func (r *Recorder) Steps() []script.Step

Steps returns a copy of the recorded steps.

func (*Recorder) Stop 

func (r *Recorder) Stop()

Stop ends recording.

type RecorderMetadata 

type RecorderMetadata struct {
	Name        string `json:"name,omitempty"`
	Description string `json:"description,omitempty"`
	BaseURL     string `json:"baseUrl,omitempty"`
}

RecorderMetadata contains metadata about the recording session.

type RecordingStatusInput 

type RecordingStatusInput struct{}

type RecordingStatusOutput 

type RecordingStatusOutput struct {
	Recording bool `json:"recording"`
	StepCount int  `json:"stepCount"`
}

type ReloadInput 

type ReloadInput struct{}

type ReloadOutput 

type ReloadOutput struct {
	Message string `json:"message"`
}

type ResetSessionInput 

type ResetSessionInput struct{}

type ResetSessionOutput 

type ResetSessionOutput struct {
	Message string `json:"message"`
}

type RouteInfoOutput 

type RouteInfoOutput struct {
	Pattern     string `json:"pattern"`
	Status      int    `json:"status,omitempty"`
	ContentType string `json:"content_type,omitempty"`
}

type RouteInput 

type RouteInput struct {
	Pattern     string            `json:"pattern" jsonschema:"URL pattern to match (glob or regex e.g. **/api/* or /api/.*),required"`
	Status      int               `json:"status" jsonschema:"HTTP status code (default: 200)"`
	Body        string            `json:"body" jsonschema:"Response body content"`
	ContentType string            `json:"content_type" jsonschema:"Content-Type header (default: application/json)"`
	Headers     map[string]string `json:"headers" jsonschema:"Additional response headers"`
}

type RouteListInput 

type RouteListInput struct{}

type RouteListOutput 

type RouteListOutput struct {
	Routes []RouteInfoOutput `json:"routes"`
	Count  int               `json:"count"`
}

type RouteOutput 

type RouteOutput struct {
	Message string `json:"message"`
	Pattern string `json:"pattern"`
}

type ScreenshotInput 

type ScreenshotInput struct {
	Format string `json:"format" jsonschema:"Output format: base64 (default) or file,enum=base64,enum=file"`
	Path   string `json:"path" jsonschema:"File path (required if format is file)"`
}

type ScreenshotOutput 

type ScreenshotOutput struct {
	Format string `json:"format"`
	Data   string `json:"data,omitempty"`
	Path   string `json:"path,omitempty"`
}

type ScrollInput 

type ScrollInput struct {
	Direction string `json:"direction" jsonschema:"Scroll direction: up down left right,required,enum=up,enum=down,enum=left,enum=right"`
	Amount    int    `json:"amount" jsonschema:"Amount to scroll in pixels (0 for full page scroll)"`
	Selector  string `json:"selector" jsonschema:"Optional CSS selector to scroll within a specific element"`
}

type ScrollIntoViewInput 

type ScrollIntoViewInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type ScrollIntoViewOutput 

type ScrollIntoViewOutput struct {
	Message string `json:"message"`
}

type ScrollOutput 

type ScrollOutput struct {
	Message string `json:"message"`
}

type SelectFrameInput 

type SelectFrameInput struct {
	NameOrURL string `json:"name_or_url" jsonschema:"Frame name or URL pattern to match,required"`
}

type SelectFrameOutput 

type SelectFrameOutput struct {
	Message string `json:"message"`
	URL     string `json:"url"`
	Name    string `json:"name"`
}

type SelectMainFrameInput 

type SelectMainFrameInput struct{}

type SelectMainFrameOutput 

type SelectMainFrameOutput struct {
	Message string `json:"message"`
}

type SelectOptionInput 

type SelectOptionInput struct {
	Selector  string   `json:"selector" jsonschema:"CSS selector for the select element,required"`
	Values    []string `json:"values" jsonschema:"Option values to select"`
	Labels    []string `json:"labels" jsonschema:"Option labels to select"`
	Indexes   []int    `json:"indexes" jsonschema:"Option indexes to select (0-based)"`
	TimeoutMS int      `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type SelectOptionOutput 

type SelectOptionOutput struct {
	Message string `json:"message"`
}

type SelectTabInput 

type SelectTabInput struct {
	Index *int   `json:"index,omitempty" jsonschema:"Tab index (0-based)"`
	ID    string `json:"id,omitempty" jsonschema:"Tab ID (from list_tabs)"`
}

SelectTabInput for switching to a specific tab.

type SelectTabOutput 

type SelectTabOutput struct {
	Message string `json:"message"`
	URL     string `json:"url"`
	Title   string `json:"title"`
}

SelectTabOutput confirms the tab switch.

type SemanticSelector 

type SemanticSelector struct {
	Role        string `json:"role,omitempty" jsonschema:"ARIA role (e.g. button, textbox, link)"`
	Text        string `json:"text,omitempty" jsonschema:"Element text content"`
	Label       string `json:"label,omitempty" jsonschema:"Associated label text"`
	Placeholder string `json:"placeholder,omitempty" jsonschema:"Input placeholder text"`
	TestID      string `json:"testid,omitempty" jsonschema:"data-testid attribute value"`
	Alt         string `json:"alt,omitempty" jsonschema:"Image alt text"`
	Title       string `json:"title,omitempty" jsonschema:"Element title attribute"`
	XPath       string `json:"xpath,omitempty" jsonschema:"XPath expression"`
	Near        string `json:"near,omitempty" jsonschema:"CSS selector of nearby element"`
}

SemanticSelector contains optional semantic selector fields for finding elements by accessibility attributes instead of just CSS selectors.

type Server 

type Server struct {
	// contains filtered or unexported fields
}

Server is the WebPilot MCP server.

func NewServer 

func NewServer(config Config) *Server

NewServer creates a new MCP server.

func (*Server) Close 

func (s *Server) Close(ctx context.Context) error

Close closes the server and browser session.

func (*Server) Run 

func (s *Server) Run(ctx context.Context) error

Run starts the MCP server.

type Session 

type Session struct {
	// contains filtered or unexported fields
}

Session manages a browser session and collects test results.

func NewSession 

func NewSession(config SessionConfig) *Session

NewSession creates a new Session.

func (*Session) ActiveContext 

func (s *Session) ActiveContext() string

ActiveContext returns the active browsing context ID.

func (*Session) CaptureContext 

func (s *Session) CaptureContext(ctx context.Context) *report.StepContext

CaptureContext captures the current page context.

func (*Session) CaptureScreenshot 

func (s *Session) CaptureScreenshot(ctx context.Context) *report.ScreenshotRef

CaptureScreenshot captures a screenshot and returns a ScreenshotRef.

func (*Session) Close 

func (s *Session) Close(ctx context.Context) error

Close closes the browser session.

func (*Session) FindSimilarSelectors 

func (s *Session) FindSimilarSelectors(ctx context.Context, selector string) []string

FindSimilarSelectors attempts to find similar selectors to the given one.

func (*Session) GetTestResult 

func (s *Session) GetTestResult() *report.TestResult

GetTestResult returns the current test result.

func (*Session) IsLaunched 

func (s *Session) IsLaunched() bool

IsLaunched returns whether the browser has been launched.

func (*Session) LaunchIfNeeded 

func (s *Session) LaunchIfNeeded(ctx context.Context) error

LaunchIfNeeded launches the browser if not already running.

func (*Session) NextStepID 

func (s *Session) NextStepID(action string) string

NextStepID returns the next step ID.

func (*Session) Pilot 

func (s *Session) Pilot(ctx context.Context) (*webpilot.Pilot, error)

Pilot returns the browser controller, launching if needed. If an active context is set (via SetActiveContext), returns the page for that context.

func (*Session) RecordStep 

func (s *Session) RecordStep(result report.StepResult)

RecordStep records a step result.

func (*Session) Recorder 

func (s *Session) Recorder() *Recorder

Recorder returns the session's recorder.

func (*Session) Reset 

func (s *Session) Reset()

Reset clears the session results.

func (*Session) SetActiveContext 

func (s *Session) SetActiveContext(contextID string)

SetActiveContext sets the active browsing context ID for tab management.

func (*Session) SetPilot 

func (s *Session) SetPilot(p *webpilot.Pilot)

SetPilot sets the active Pilot instance (page or frame). This is used for frame selection.

func (*Session) SetTarget 

func (s *Session) SetTarget(target string)

SetTarget sets the test target description.

type SessionConfig 

type SessionConfig struct {
	Headless       bool
	DefaultTimeout time.Duration
	Project        string
	Target         string
	InitScripts    []string
}

SessionConfig holds session configuration.

type SessionStorageClearInput 

type SessionStorageClearInput struct{}

SessionStorageClearInput for clearing all sessionStorage.

type SessionStorageClearOutput 

type SessionStorageClearOutput struct {
	Message string `json:"message"`
}

SessionStorageClearOutput confirms the operation.

type SessionStorageDeleteInput 

type SessionStorageDeleteInput struct {
	Key string `json:"key" jsonschema:"The key to remove from sessionStorage,required"`
}

SessionStorageDeleteInput for removing a sessionStorage item.

type SessionStorageDeleteOutput 

type SessionStorageDeleteOutput struct {
	Message string `json:"message"`
}

SessionStorageDeleteOutput confirms the operation.

type SessionStorageGetInput 

type SessionStorageGetInput struct {
	Key string `json:"key" jsonschema:"The key to get from sessionStorage,required"`
}

SessionStorageGetInput for getting a sessionStorage item.

type SessionStorageGetOutput 

type SessionStorageGetOutput struct {
	Key   string  `json:"key"`
	Value *string `json:"value"` // null if key doesn't exist
}

SessionStorageGetOutput contains the retrieved value.

type SessionStorageListInput 

type SessionStorageListInput struct{}

SessionStorageListInput for listing all sessionStorage items.

type SessionStorageListOutput 

type SessionStorageListOutput struct {
	Items map[string]string `json:"items"`
	Count int               `json:"count"`
}

SessionStorageListOutput contains all sessionStorage items.

type SessionStorageSetInput 

type SessionStorageSetInput struct {
	Key   string `json:"key" jsonschema:"The key to set in sessionStorage,required"`
	Value string `json:"value" jsonschema:"The value to store,required"`
}

SessionStorageSetInput for setting a sessionStorage item.

type SessionStorageSetOutput 

type SessionStorageSetOutput struct {
	Message string `json:"message"`
}

SessionStorageSetOutput confirms the operation.

type SetContentInput 

type SetContentInput struct {
	HTML string `json:"html" jsonschema:"HTML content to set,required"`
}

type SetContentOutput 

type SetContentOutput struct {
	Message string `json:"message"`
}

type SetCookieInput 

type SetCookieInput struct {
	Name     string  `json:"name"`
	Value    string  `json:"value"`
	URL      string  `json:"url,omitempty"`
	Domain   string  `json:"domain,omitempty"`
	Path     string  `json:"path,omitempty"`
	Expires  float64 `json:"expires,omitempty"`
	HTTPOnly bool    `json:"httpOnly,omitempty"`
	Secure   bool    `json:"secure,omitempty"`
	SameSite string  `json:"sameSite,omitempty"`
}

type SetCookiesInput 

type SetCookiesInput struct {
	Cookies []SetCookieInput `json:"cookies" jsonschema:"Cookies to set,required"`
}

type SetCookiesOutput 

type SetCookiesOutput struct {
	Message string `json:"message"`
}

type SetFilesInput 

type SetFilesInput struct {
	Selector  string   `json:"selector" jsonschema:"CSS selector for the file input,required"`
	Files     []string `json:"files" jsonschema:"File paths to set,required"`
	TimeoutMS int      `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type SetFilesOutput 

type SetFilesOutput struct {
	Message string `json:"message"`
}

type SetGeolocationInput 

type SetGeolocationInput struct {
	Latitude  float64 `json:"latitude" jsonschema:"Latitude,required"`
	Longitude float64 `json:"longitude" jsonschema:"Longitude,required"`
	Accuracy  float64 `json:"accuracy" jsonschema:"Accuracy in meters"`
}

type SetGeolocationOutput 

type SetGeolocationOutput struct {
	Message string `json:"message"`
}

type SetStorageStateInput 

type SetStorageStateInput struct {
	State string `json:"state" jsonschema:"JSON from get_storage_state containing cookies, localStorage, and sessionStorage,required"`
}

type SetStorageStateOutput 

type SetStorageStateOutput struct {
	Message string `json:"message"`
}

type SetTargetInput 

type SetTargetInput struct {
	Target string `json:"target" jsonschema:"Test target description,required"`
}

type SetTargetOutput 

type SetTargetOutput struct {
	Message string `json:"message"`
}

type SetViewportInput 

type SetViewportInput struct {
	Width  int `json:"width" jsonschema:"Viewport width,required"`
	Height int `json:"height" jsonschema:"Viewport height,required"`
}

type SetViewportOutput 

type SetViewportOutput struct {
	Message string `json:"message"`
}

type StartRecordingInput 

type StartRecordingInput struct {
	Name        string `json:"name,omitempty" jsonschema:"Name for the recorded script"`
	Description string `json:"description,omitempty" jsonschema:"Description of what the script tests"`
	BaseURL     string `json:"baseUrl,omitempty" jsonschema:"Base URL for relative URLs in the script"`
}

type StartRecordingOutput 

type StartRecordingOutput struct {
	Message string `json:"message"`
}

type StartTraceChunkInput 

type StartTraceChunkInput struct {
	Name  string `json:"name" jsonschema:"Chunk name"`
	Title string `json:"title" jsonschema:"Chunk title shown in trace viewer"`
}

type StartTraceChunkOutput 

type StartTraceChunkOutput struct {
	Message string `json:"message"`
}

type StartTraceGroupInput 

type StartTraceGroupInput struct {
	Name     string `json:"name" jsonschema:"Group name,required"`
	Location string `json:"location" jsonschema:"Source location to associate with this group"`
}

type StartTraceGroupOutput 

type StartTraceGroupOutput struct {
	Message string `json:"message"`
}

type StartTraceInput 

type StartTraceInput struct {
	Name        string `json:"name" jsonschema:"Trace name (used for file naming)"`
	Title       string `json:"title" jsonschema:"Title shown in trace viewer"`
	Screenshots bool   `json:"screenshots" jsonschema:"Include screenshots in trace (default: true)"`
	Snapshots   bool   `json:"snapshots" jsonschema:"Include DOM snapshots in trace (default: true)"`
	Sources     bool   `json:"sources" jsonschema:"Include source files in trace"`
}

type StartTraceOutput 

type StartTraceOutput struct {
	Message string `json:"message"`
	Name    string `json:"name,omitempty"`
}

type StartVideoInput 

type StartVideoInput struct {
	Dir    string `json:"dir,omitempty" jsonschema:"Directory to save video to"`
	Width  int    `json:"width,omitempty" jsonschema:"Video width in pixels"`
	Height int    `json:"height,omitempty" jsonschema:"Video height in pixels"`
}

type StartVideoOutput 

type StartVideoOutput struct {
	Path    string `json:"path"`
	Message string `json:"message"`
}

type StopRecordingInput 

type StopRecordingInput struct{}

type StopRecordingOutput 

type StopRecordingOutput struct {
	Message   string `json:"message"`
	StepCount int    `json:"stepCount"`
}

type StopTraceChunkInput 

type StopTraceChunkInput struct {
	Path string `json:"path" jsonschema:"File path to save the chunk ZIP (optional - if not provided returns base64 data)"`
}

type StopTraceChunkOutput 

type StopTraceChunkOutput struct {
	Message string `json:"message"`
	Path    string `json:"path,omitempty"`
	Data    string `json:"data,omitempty"`
	SizeKB  int    `json:"size_kb"`
}

type StopTraceGroupInput 

type StopTraceGroupInput struct{}

type StopTraceGroupOutput 

type StopTraceGroupOutput struct {
	Message string `json:"message"`
}

type StopTraceInput 

type StopTraceInput struct {
	Path string `json:"path" jsonschema:"File path to save the trace ZIP (optional - if not provided returns base64 data)"`
}

type StopTraceOutput 

type StopTraceOutput struct {
	Message  string `json:"message"`
	Path     string `json:"path,omitempty"`
	Data     string `json:"data,omitempty"`
	SizeKB   int    `json:"size_kb"`
	ViewHint string `json:"view_hint,omitempty"`
}

type StopVideoInput 

type StopVideoInput struct{}

type StopVideoOutput 

type StopVideoOutput struct {
	Path    string `json:"path"`
	Message string `json:"message"`
}

type TabInfo 

type TabInfo struct {
	Index int    `json:"index"`
	ID    string `json:"id"`
	URL   string `json:"url"`
	Title string `json:"title"`
}

TabInfo contains information about a single tab.

type TapInput 

type TapInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type TapOutput 

type TapOutput struct {
	Message string `json:"message"`
}

type TouchSwipeInput 

type TouchSwipeInput struct {
	StartX float64 `json:"start_x" jsonschema:"Starting X coordinate,required"`
	StartY float64 `json:"start_y" jsonschema:"Starting Y coordinate,required"`
	EndX   float64 `json:"end_x" jsonschema:"Ending X coordinate,required"`
	EndY   float64 `json:"end_y" jsonschema:"Ending Y coordinate,required"`
}

type TouchSwipeOutput 

type TouchSwipeOutput struct {
	Message string `json:"message"`
}

type TouchTapInput 

type TouchTapInput struct {
	X float64 `json:"x" jsonschema:"X coordinate,required"`
	Y float64 `json:"y" jsonschema:"Y coordinate,required"`
}

type TouchTapOutput 

type TouchTapOutput struct {
	Message string `json:"message"`
}

type TypeInput 

type TypeInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the input element (can be empty if using semantic selectors)"`
	Text      string `json:"text" jsonschema:"Text to type,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
	SemanticSelector
}

type TypeOutput 

type TypeOutput struct {
	Message string `json:"message"`
}

type UncheckInput 

type UncheckInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the checkbox,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type UncheckOutput 

type UncheckOutput struct {
	Message string `json:"message"`
}

type UnrouteInput 

type UnrouteInput struct {
	Pattern string `json:"pattern" jsonschema:"URL pattern to unregister,required"`
}

type UnrouteOutput 

type UnrouteOutput struct {
	Message string `json:"message"`
}

type VerifyCheckedInput 

type VerifyCheckedInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the checkbox/radio element,required"`
	Checked   bool   `json:"checked" jsonschema:"Expected checked state (default: true)"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type VerifyCheckedOutput 

type VerifyCheckedOutput struct {
	Passed  bool   `json:"passed"`
	Checked bool   `json:"checked"`
	Message string `json:"message"`
}

type VerifyDisabledInput 

type VerifyDisabledInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type VerifyDisabledOutput 

type VerifyDisabledOutput struct {
	Passed  bool   `json:"passed"`
	Message string `json:"message"`
}

type VerifyEnabledInput 

type VerifyEnabledInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type VerifyEnabledOutput 

type VerifyEnabledOutput struct {
	Passed  bool   `json:"passed"`
	Message string `json:"message"`
}

type VerifyHiddenInput 

type VerifyHiddenInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type VerifyHiddenOutput 

type VerifyHiddenOutput struct {
	Passed  bool   `json:"passed"`
	Message string `json:"message"`
}

type VerifyListVisibleInput 

type VerifyListVisibleInput struct {
	Items     []string `json:"items" jsonschema:"List of text items that should be visible on the page,required"`
	Selector  string   `json:"selector" jsonschema:"Optional CSS selector to scope the search"`
	TimeoutMS int      `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type VerifyListVisibleOutput 

type VerifyListVisibleOutput struct {
	Passed  bool     `json:"passed"`
	Found   []string `json:"found"`
	Missing []string `json:"missing"`
	Message string   `json:"message"`
}

type VerifyTextInput 

type VerifyTextInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	Expected  string `json:"expected" jsonschema:"Expected text content,required"`
	Exact     bool   `json:"exact" jsonschema:"Require exact match (default: false uses contains)"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type VerifyTextOutput 

type VerifyTextOutput struct {
	Passed  bool   `json:"passed"`
	Actual  string `json:"actual"`
	Message string `json:"message"`
}

type VerifyValueInput 

type VerifyValueInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the input element,required"`
	Expected  string `json:"expected" jsonschema:"Expected value to verify,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type VerifyValueOutput 

type VerifyValueOutput struct {
	Passed  bool   `json:"passed"`
	Actual  string `json:"actual"`
	Message string `json:"message"`
}

type VerifyVisibleInput 

type VerifyVisibleInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 5000)"`
}

type VerifyVisibleOutput 

type VerifyVisibleOutput struct {
	Passed  bool   `json:"passed"`
	Message string `json:"message"`
}

type WaitForFunctionInput 

type WaitForFunctionInput struct {
	Function  string `json:"function" jsonschema:"JavaScript function that returns truthy value,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 30000)"`
}

type WaitForFunctionOutput 

type WaitForFunctionOutput struct {
	Message string `json:"message"`
}

type WaitForLoadInput 

type WaitForLoadInput struct {
	State     string `` /* 129-byte string literal not displayed */
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 30000)"`
}

type WaitForLoadOutput 

type WaitForLoadOutput struct {
	Message string `json:"message"`
}

type WaitForSelectorInput 

type WaitForSelectorInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	State     string `` /* 149-byte string literal not displayed */
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 30000)"`
}

type WaitForSelectorOutput 

type WaitForSelectorOutput struct {
	Message string `json:"message"`
}

type WaitForTextInput 

type WaitForTextInput struct {
	Text      string `json:"text" jsonschema:"Text to wait for,required"`
	Selector  string `json:"selector,omitempty" jsonschema:"Optional selector to scope the search"`
	TimeoutMS int    `json:"timeout,omitempty" jsonschema:"Timeout in milliseconds (default 30000)"`
}

type WaitForTextOutput 

type WaitForTextOutput struct {
	Message string `json:"message"`
}

type WaitForURLInput 

type WaitForURLInput struct {
	Pattern   string `json:"pattern" jsonschema:"URL pattern to wait for,required"`
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 30000)"`
}

type WaitForURLOutput 

type WaitForURLOutput struct {
	Message string `json:"message"`
}

type WaitUntilInput 

type WaitUntilInput struct {
	Selector  string `json:"selector" jsonschema:"CSS selector for the element,required"`
	State     string `` /* 139-byte string literal not displayed */
	TimeoutMS int    `json:"timeout_ms" jsonschema:"Timeout in milliseconds (default: 30000)"`
}

type WaitUntilOutput 

type WaitUntilOutput struct {
	Message string `json:"message"`
}

Source Files

View all Source files

Directories

Path Synopsis
Package report provides test result tracking and report generation.
 Package report provides test result tracking and report generation.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.