Member Junction
    Preparing search index...

    Complete configuration for a Computer Use engine run.

    Required: Goal (what to accomplish) Recommended: StartUrl (where to begin) Everything else has sensible defaults.

    Hierarchy (View Summary)

    Index

    Constructors

    Properties

    AllowedDomains?: string[]

    Domains the browser is allowed to visit. If set, all other domains are blocked. If empty/undefined, all domains are allowed (open navigation).

    ApplicationContext?: string

    Free-form markdown context about the application being tested. Rendered into the controller's system prompt under an "## Application Context" heading so the LLM doesn't rediscover navigation landmarks, route conventions, etc. on every test. When the engine is driven by the TestingFramework, this is typically sourced from TestSuite.Configuration. applicationContext and optionally extended per-test.

    Per-domain authentication configuration

    BlockedDomains?: string[]

    Domains explicitly blocked. Evaluated AFTER AllowedDomains — blocked always wins.

    BrowserConfig?: BrowserConfig

    Browser-specific configuration (viewport, user agent, timeouts)

    ControllerModel?: ModelConfig

    Model selection for the controller LLM

    ControllerPrompt?: string

    Override for the controller system prompt

    Goal: string = ''

    Natural-language goal for the agent to accomplish

    Headless: boolean = true

    Run browser in headless mode (default: true)

    JudgeFrequency?: JudgeFrequency

    Judge evaluation frequency (default: EveryStep). Use EveryNSteps or OnStagnation to reduce LLM costs.

    JudgeModel?: ModelConfig

    Model selection for the judge LLM

    JudgePrompt?: string

    Override for the judge prompt

    LogCallback?: (level: "info" | "warn" | "error", message: string) => void

    Optional callback for logging engine messages. If provided, all log messages will be sent to this callback in addition to (or instead of) console output. Useful for test drivers to capture logs for test run records.

    MaxSteps: number = 30

    Maximum number of controller loop steps before forced termination (default: 30)

    ScreenshotDelayMs: number = 500

    Delay in milliseconds before each screenshot capture. Gives the page time to render after actions (clicks, navigation, typing) before the screenshot is taken for the next LLM reasoning step. Set to 0 to disable. (default: 500)

    ScreenshotHistoryDepth: number = 20

    Number of recent screenshots to include in controller context. Acts as a ring buffer — older screenshots are dropped. Higher values give more context but increase token usage. (default: 20)

    StartUrl?: string

    Starting URL to navigate to

    Tools?: ComputerUseTool<Record<string, unknown>, unknown>[]

    Tools the LLM can invoke during execution